Portugues | English
Painel visual em estilo pixel art para orquestrar e monitorar agentes BMAD em tempo real.
npx aiteam-x@latestO AITeam Team Overview e um dashboard interativo que transforma a gestao de agentes de IA em uma experiencia visual e intuitiva. Inspirado em jogos de simulacao tipo sim manager, o painel exibe agentes BMAD como personagens pixel art em um escritorio virtual, permitindo:
- Visualizar o status e a localizacao de cada agente em tempo real
- Interagir diretamente com agentes atraves de janelas de chat integradas
- Orquestrar workflows como Party Mode e brainstorming sessions
- Monitorar metricas de uso (mensagens, tokens in/out) por agente
- Persistir contexto e memorias entre sessoes de trabalho com extracao via LLM
O projeto utiliza o BMAD Method como framework de agentes, integrando-se nativamente com o Cursor Agent CLI e o Cursor ACP (Agent Client Protocol) para comunicacao bidirecional com LLMs.
Escritorio virtual com Jarvis Office, Kitchen e workspaces individuais. Barra inferior com avatares e progresso do sprint (14/14 — 100%).
Janela de conversa com BMad Master em tempo real. Cada agente responde com streaming de texto e suporte a Markdown.
Painel de gerenciamento de memorias por agente. Categorias: decisions, lessons, tasks, projects, handoffs. Busca BM25 em tempo real.
Filtros de Status (Todos / Trabalhando) e Modulo (BMGD / BMM / CORE) para visualizacao segmentada dos agentes.
- Salas compartilhadas: Jarvis Office, Kitchen — com contexto de atividade dos agentes
- Grid de workspaces individuais por agente com indicadores de modulo (BMGD / BMM / CORE)
- Avatares pixel art com status visual em tempo real
- Barra inferior com avatares compactos e timeline do sprint com progresso granular por story
- Ciclo dia/noite e efeitos de ambiente
- Selecao de agente (click) ou multi-selecao (Ctrl+click) para comandos em lote
- Janelas de conversa redimensionaveis com streaming SSE em tempo real
- Bubble de "pensando" animado durante processamento
- Rendering completo de Markdown nas respostas
- Botao de copiar: aparece no hover sobre respostas de agentes para copiar texto
- Menu de contexto: clique direito sobre um agente exibe comandos personalizados do MDC
- Botao de stop para cancelar processamento em andamento
- Historico de conversa persistido entre reloads
- Sistema de z-index dinamico (bring-to-front ao clicar)
- Model Bar: selecao do modelo LLM aplicado a todos os agentes
- Cursor ACP: submenu dinamico que lista todos os modelos disponiveis na conta Cursor (Claude, GPT, Gemini, Grok, etc.)
- Modelos diretos: Composer 2, Claude Opus/Sonnet, GPT-5.x, Gemini, Grok, Kimi
- Filtro de Status: Todos / Trabalhando — exibe contador em tempo real (ex: 14/14)
- Filtro de Modulo: BMGD / BMM / CORE — segmenta agentes por area de atuacao
- Comunicacao direta com o Cursor via JSON-RPC 2.0 sobre stdio (
agent acp) - Descoberta automatica de modelos disponiveis via
configOptionsda sessao ACP - Troca de modelo por sessao via
session/set_config_option - Processo ACP persistente com sessoes de 30 min e reconexao automatica
- Fallback de erro com mensagens actionaveis para o usuario
- Deteccao automatica de Party Mode e workflows ativos
- Agentes se movem dinamicamente para salas conforme o workflow
- Sessao de estado persistida em disco e sincronizada via SSE
- Metricas de mensagens e tokens por agente
- Memory Vault: painel visual completo com 5 categorias (decisions, lessons, tasks, projects, handoffs)
- Auto-extract via LLM: ao fechar uma sessao, o sistema analisa a conversa e extrai memorias estruturadas automaticamente
- Badge 🤖 llm: entradas extraidas automaticamente ficam marcadas por 10 minutos com opcao de veto
- Busca BM25: busca semantica por relevancia dentro do vault de cada agente
- Injecao de contexto: memorias relevantes injetadas automaticamente ao iniciar novas sessoes (budget de 2.000 tokens)
- Auto-save: conversas salvas a cada 30s + save on unload via
sendBeacon - Checkpoint de sessao: historico preservado mesmo em reinicios inesperados
- Memoria compartilhada:
_project.mdinjetado em todos os agentes como contexto global
- Discovery dinamico: detecta agentes BMAD automaticamente via CSV/YAML — sem hardcode
- Cross-platform: funciona em Windows, macOS e Linux
- Wizard de setup web:
/setupno browser — 3 fases animadas: scan da maquina, revisao, configuracao passo a passo - Wizard de setup CLI:
npm run setup— alternativa interativa no terminal (6 passos) - Health gate: se nao configurado, redireciona para
/setupautomaticamente - Config flexivel:
aiteam.config.jsonlocal +AITEAM_BMAD_ROOTpara instancias externas/CI
| Camada | Tecnologia | Versao |
|---|---|---|
| Framework | Next.js (App Router) | 15.x |
| UI | React | 19.x |
| Linguagem | TypeScript | 5.x |
| Estilo | CSS custom (pixel art design system) | — |
| Fonte | VT323 (Google Fonts) | — |
| Backend | Next.js API Routes + SSE | — |
| Busca | MiniSearch (BM25) | — |
| Agentes | Cursor Agent CLI + ACP | latest |
| Protocolo | ACP (JSON-RPC 2.0 / stdio) | v1 |
| Parsing | yaml (npm) | 2.8.x |
| Framework de Agentes | BMAD Method | — |
| Requisito | Obrigatorio | Notas |
|---|---|---|
| Node.js >= 18 | Sim | node --version |
| BMAD Framework | Sim | Ver Guia de Instalacao |
| Cursor IDE | Sim | Gera o Cursor Agent CLI na primeira abertura |
| Git | Sim | — |
Plataformas suportadas: Windows 10/11, macOS, Linux
Opcao 1 — Um comando (recomendado):
npx aiteam-x@latestCria o projeto no diretorio atual (deve estar vazio). Ou especifique o nome da pasta:
npx aiteam-x@latest meu-projetoO comando baixa o template, instala dependencias, executa o wizard de configuracao e inicia o servidor automaticamente.
Opcao 2 — Instalacao manual:
# 1. Clonar o repositorio
git clone https://github.com/INOSX/AITeam.git
cd AITeam
# 2. Instalar dependencias
npm install
# 3. Executar wizard de configuracao
npm run setup
# 4. Iniciar o servidor de desenvolvimento
npm run devO painel estara disponivel em http://localhost:3000.
Se o setup nao foi concluido, o sistema redireciona automaticamente para
http://localhost:3000/setup— um wizard animado que detecta o ambiente, mostra o que esta pronto e permite configurar tudo pelo browser.
Alternativa CLI:
npm run setupexecuta o wizard interativo no terminal.
| Comando | Descricao |
|---|---|
npm run setup |
Wizard interativo de configuracao (primeira instalacao) |
npm run dev |
Inicia o servidor de desenvolvimento (porta 3000) |
npm run build |
Gera o build de producao |
npm run start |
Inicia o servidor de producao |
npm run lint |
Executa o linter (ESLint) |
| Script | Descricao |
|---|---|
node scripts/extract-memories.mjs --all |
Extrai memorias de conversas historicas via LLM |
node scripts/extract-memories.mjs --agent bmad-master |
Extrai memorias de um agente especifico |
node scripts/extract-memories.mjs --all --dry-run |
Simula extracao sem salvar |
node scripts/import-conversations.mjs |
Importa historico de conversas para o vault |
Todos os scripts requerem o servidor rodando em
localhost:3000.
AITeam/
├── app/ # Next.js App Router
│ ├── api/ # API Routes (backend)
│ │ ├── acp/
│ │ │ └── models/route.ts # GET: modelos disponiveis via ACP
│ │ ├── agents/
│ │ │ ├── route.ts # GET: lista agentes com status
│ │ │ ├── command/route.ts # POST: envia comando via SSE (CLI ou ACP)
│ │ │ └── menus/route.ts # GET: menus de contexto dos agentes
│ │ ├── bridge/route.ts # GET: health check do ACP
│ │ ├── config/route.ts # GET: configuracao BMAD
│ │ ├── memory/
│ │ │ ├── route.ts # GET/POST: memoria e conversas (legado)
│ │ │ ├── vault/route.ts # GET/POST/PUT/DELETE: vault estruturado
│ │ │ ├── search/route.ts # GET: busca BM25
│ │ │ ├── checkpoint/route.ts # POST: checkpoint de sessao
│ │ │ ├── sleep/route.ts # POST: encerra sessao + enfileira extracao LLM
│ │ │ └── extract/route.ts # POST: trigger manual de extracao LLM
│ │ ├── session/
│ │ │ ├── route.ts # GET/POST: sessao ativa
│ │ │ └── stream/route.ts # GET: SSE de mudancas de sessao
│ │ ├── sprint/route.ts # GET/POST: status do sprint
│ │ └── workflows/route.ts # GET: workflows disponiveis
│ ├── actions/
│ │ └── setup-save.ts # Server Action: salva aiteam.config.json
│ ├── setup/
│ │ ├── page.tsx # Pagina de setup (health gate + Server Component)
│ │ └── SetupWizard.tsx # Wizard animado 3 fases (Client Component)
│ ├── globals.css # Design system pixel art (800+ linhas)
│ ├── layout.tsx # Root layout (VT323, pt-BR)
│ ├── error.tsx # Error boundary
│ └── page.tsx # Pagina principal (health gate)
│
├── components/ # Componentes React
│ ├── rooms/ # Salas do escritorio virtual
│ │ ├── ConferenceRoom.tsx
│ │ ├── JarvisOffice.tsx
│ │ └── Kitchen.tsx
│ ├── AgentContextMenu.tsx # Menu de contexto por agente
│ ├── AgentsProvider.tsx # Context Provider global
│ ├── CommandPopup.tsx # Popup multi-agente
│ ├── CopyButton.tsx # Botao copiar em respostas
│ ├── FilterContext.tsx # Context de filtros (status + modulo)
│ ├── Layout.tsx # Shell (TopBar + ModelBar + BottomBar)
│ ├── MainContent.tsx # Orquestrador principal (~500 linhas)
│ ├── MarkdownRenderer.tsx # Renderer custom de Markdown
│ ├── MemoryVault.tsx # Dashboard do Memory Vault (modal)
│ ├── ModelBar.tsx # Barra de selecao de modelo e filtros
│ ├── PixelAvatar.tsx # Avatar SVG pixel art
│ ├── SpeechBubbleOverlay.tsx # Sistema de chat overlay
│ ├── ThinkingBubble.tsx # Indicador de pensamento animado
│ ├── WorkspaceCell.tsx # Celula de workspace individual
│ └── WorkspaceGrid.tsx # Grid de workspaces
│
├── lib/ # Logica de negocio e utilitarios
│ ├── acp-client.ts # Cliente ACP (JSON-RPC 2.0 over stdio)
│ ├── acp-manager.ts # Gerenciador de sessoes ACP
│ ├── aiteam-config.ts # Config loader (env var > arquivo > defaults)
│ ├── health.ts # Health check: BMAD, Cursor CLI, config
│ ├── setup-discovery.ts # Discovery ampliado para o wizard web
│ ├── bmad/ # Integracao BMAD
│ │ ├── discovery.ts # Scanner dinamico BMAD + deteccao Cursor CLI
│ │ ├── agent-mapping.ts # Mapeamento BmadAgent -> Agent
│ │ ├── chat-sessions.ts # Persistencia de sessoes de chat
│ │ ├── parse-agents.ts # Parser do agent-manifest.csv
│ │ ├── parse-config.ts # Parser do config.yaml
│ │ ├── parse-persona.ts # Parser de persona (.mdc)
│ │ ├── parse-session.ts # Estado de sessao + SSE
│ │ ├── parse-sprint.ts # Parser do sprint-status.yaml
│ │ └── parse-workflows.ts # Parser de workflows
│ ├── memory/ # Sistema de memoria v2
│ │ ├── extract.ts # Motor de extracao LLM
│ │ ├── inject.ts # Injecao de contexto (BM25 + budget)
│ │ ├── session.ts # Ciclo de vida de sessao (sleep/recover)
│ │ ├── types.ts # Tipos do sistema de memoria
│ │ └── vault.ts # CRUD do vault estruturado
│ ├── model-config.ts # Opcoes de modelos LLM disponiveis
│ └── types.ts # Tipos TypeScript globais
│
├── .memory/ # Memory Bank (persistente, gitignored)
│ ├── _project.md # Contexto global — injetado em todos agentes
│ ├── {agent-id}.md # Memory bank individual por agente
│ ├── conversations/ # Historico de conversas (JSON)
│ └── .vault/ # Vault estruturado e fila de extracao
│
├── docs/ # Documentacao do projeto
│ ├── screenshots/ # Screenshots da interface
│ ├── installation-guide.md # Guia completo de instalacao
│ ├── architecture.md # Arquitetura do sistema
│ ├── api-reference.md # Referencia completa da API
│ ├── developer-guide.md # Guia do desenvolvedor
│ ├── user-guide.md # Guia do usuario final
│ ├── memory-system.md # Arquitetura tecnica do sistema de memoria
│ ├── memory-system-guide.md # Guia funcional do sistema de memoria
│ ├── agent-catalog.md # Catalogo completo dos agentes BMAD
│ └── sprint-status.yaml # Status do sprint atual
│
├── scripts/ # Scripts utilitarios
│ ├── setup.mjs # Wizard de configuracao interativo (6 passos)
│ ├── extract-memories.mjs # Extracao em lote via LLM
│ └── import-conversations.mjs # Importacao de historico para o vault
│
├── aiteam.config.example.json # Exemplo de configuracao (referencia)
├── .cursor/ # Regras e skills do Cursor IDE
│ └── rules/bmad/ # Regras BMAD (.mdc): agentes e workflows
│
├── package.json
├── tsconfig.json
├── next.config.ts
└── .gitignore
| Documento | Nivel | Descricao |
|---|---|---|
| Guia de Instalacao | Iniciante | Instalacao passo a passo, wizard de setup, solucao de problemas |
| Arquitetura | Tecnico/Arquitetural | Diagramas, fluxos de dados, decisoes de design |
| Referencia da API | Tecnico | Endpoints, parametros, exemplos de request/response |
| Guia do Desenvolvedor | Desenvolvedor | Setup, convencoes, como contribuir |
| Guia do Usuario | Usuario Final | Como usar o painel, interagir com agentes, Memory Vault |
| Sistema de Memoria (tecnico) | Tecnico/Conceitual | Arquitetura em camadas do sistema de memoria |
| Guia de Memoria (funcional) | Usuario Final | Como usar o Memory Vault, estudos de caso, boas praticas |
| Catalogo de Agentes | Referencia | Todos os agentes, especialidades e como trabalhar com cada um |
O sistema descobre agentes automaticamente a partir do bmad/_cfg/agent-manifest.csv. A instalacao padrao inclui 14 agentes:
| Persona | Papel | Modulo |
|---|---|---|
| BMad Master | Orquestrador principal, custodio de conhecimento | core |
| BMad Builder | Criacao de modulos, agentes e workflows BMAD | core |
| Mary | Business Analyst — pesquisa e requisitos de negocio | bmm |
| John | Product Manager — PRD, epicos, gestao de produto | bmm |
| Winston | Architect — arquitetura de sistemas e tech spec | bmm |
| Sally | UX Designer — design de experiencia e interface | bmm |
| Bob | Scrum Master — sprint planning e revisao de codigo | bmm |
| Amelia | Developer — implementacao de stories e features | bmm |
| Murat | Test Architect — estrategia e design de testes | bmm |
| Paige | Tech Writer — documentacao tecnica e knowledge | bmm |
| Cloud Dragonborn | Game Architect — arquitetura e sistemas de jogo | bmgd |
| Samus Shepard | Game Designer — GDD, narrativa e design de jogo | bmgd |
| Link Freeman | Game Developer — implementacao de jogo | bmgd |
| Max | Game Scrum Master — gestao agil para game dev | bmgd |
Consulte o Catalogo de Agentes para detalhes sobre especialidades e comandos de cada agente.
O AITEAM-X usa um arquivo aiteam.config.json local (gitignored) gerado pelo npm run setup. Para configuracao avancada, crie um .env.local:
# Caminho alternativo para a instalacao BMAD
# Util para: BMAD em outro diretorio, CI/CD, multiplos projetos
AITEAM_BMAD_ROOT=/caminho/para/seu/projeto-bmad
# Sobrescreve o diretorio de memoria (util para testes)
MEMORY_DIR_OVERRIDE=/caminho/customizado/.memoryPrioridade de configuracao para bmadRoot:
AITEAM_BMAD_ROOT (env var) > aiteam.config.json > "./" (padrao)
Consulte o Guia de Instalacao para todos os cenarios de configuracao.
- Crie uma branch a partir de
develop - Faca suas alteracoes seguindo as convencoes do projeto
- Certifique-se de que
npm run lintenpm run buildpassam - Abra um Pull Request para
develop
Consulte o Guia do Desenvolvedor para detalhes.
Este projeto e distribuido sob a licenca MIT. Veja LICENSE para detalhes.
Mario Mayerle (MaMFLux) — INOSX
Construido com o BMAD Method — onde agentes de IA trabalham como um time.
