CodAI Dev Base — Padrão de Implementação OpenClaw / Paperclip / OpenCode AI

Monorepo com estrutura mock para testes locais de agentes IA.

📁 Estrutura

codai-dev-base/
├── backend/          # Node.js + Express + MySQL
│   ├── server.js     # API com rotas CRUD de agents
│   ├── package.json
│   └── Dockerfile
├── frontend/         # Vue 3 + Vite
│   ├── src/App.vue   # Lista e registro de agentes IA
│   ├── vite.config.js
│   ├── package.json
│   └── Dockerfile
├── docker-compose.yml # Sobe tudo: backend, frontend, mysql
└── README.md

🚀 Como rodar

# Subir todos os containers
docker compose up --build -d

# Parar
docker compose down

Serviço	Porta	URL
Frontend	9000	http://localhost:9000
Backend	1337	http://localhost:1337/health
MySQL	3307	localhost:3307

📡 API Endpoints

• GET /health — Health check do backend
• GET /api/agents — Lista todos os agentes registrados
• POST /api/agents — Registra um novo agente (body: { name, provider, port })

🔧 Providers suportados

Cada IA agent pode se registrar no backend informando seu provider:

• openclaw — OpenClaw agent
• paperclip — Paperclip instance
• opencode — OpenCode AI agent

Cada agente escolhe uma porta diferente para rodar seus testes.

🗄 Database

MySQL 8.0 com tabela agents criada automaticamente:

CREATE TABLE agents (
  id INT AUTO_INCREMENT PRIMARY KEY,
  name VARCHAR(100) NOT NULL,
  provider VARCHAR(50) NOT NULL,
  port INT DEFAULT 0,
  status VARCHAR(20) DEFAULT 'stopped',
  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

https://github.com/poshan0126/dotclaude/tree/main

https://mcpmarket.com/tools/skills/git-worktree-manager-opencode-kit