Saltar al contenido
ailu — Powered by JAEI Co.
ailu — Powered by JAEI Co.

Para los agent-teams nativos de Claude Code v2.1.32+

Coordina equipos de Claude Code sin perder el contexto

Lanza un team peer-to-peer, observa el buzón en tiempo real, mira el Kanban compartido y conversa con cualquier teammate desde una sola pantalla. Todo local, persistente en SQLite, sin tracking.

Instalar Ver el código

VSCode extension + app de escritorio (Electron) + MCP server, mismo backend.

¿Qué es?

Una capa sobre el CLI claude que materializa los primitivos experimentales de agent_teams (TeamCreate, Agent(team_name, name), SendMessage) en una UI auditable. El leader registra el team, spawnea teammates como procesos independientes y se comunican peer-to-peer. Tú ves el flujo completo — buzón, Kanban, agentes en vivo, negociaciones — y puedes responderle a cualquier agente sin perder el hilo del Claude que coordina.

Nada se sube a la nube. Toda la data (mensajes, eventos, tareas, agentes, plantillas, contexto) vive en ~/.ailu-claude-team-work/ y en una SQLite local con WAL.

Lo que la app hace por ti

Una capa fina sobre el CLI con todo lo que necesitas para no perderte un mensaje, una tarea o una decisión.

  • Agent-teams nativos peer-to-peer

    El leader llama TeamCreate + Agent(team_name, name) y los teammates se hablan entre sí con SendMessage. La app inyecta la receta exacta en el prompt para que no tengas que recordarla.

  • Buzón en vivo

    Stream NDJSON parseado en tiempo real. Filtros por agente, badges de no leídos, avatares coloreados por rol, atribución correcta de cada teammate (no “Tú → Leader” cuando es un peer).

  • Kanban compartido

    Los hooks TaskCreated/TaskCompleted nativos del CLI poblan tres columnas (Pendiente, En curso, Completadas) en vivo. Lo que el team coordina, lo ves.

  • Negociaciones auditables

    Si los teammates usan el protocolo POSTURA / ACUERDO / TERMINADO / APROBADO en sus mensajes, un panel colapsable muestra el debate por Q, los owners cerrados y las auditorías cruzadas.

  • Persistencia local

    SQLite con WAL para el historial completo de cada team. Reabres la app y todo está donde lo dejaste: mensajes, eventos, tareas, agentes, contexto.

  • MCP server incluido

    Tu Claude Code interactivo puede lanzar y consultar teams via 8 tools del MCP server (launch_team, list_messages, get_team…). Misma DB, mismo Buzón, otro frontend.

  • IPC validado con zod

    Cada canal entre renderer y main process pasa por schemas estrictos antes de tocar disco o procesos hijos. Sin telemetría, sin cookies, todo local. Tests unitarios verifican la regla en cada IPC handler.

  • Plantillas + Contexto reusable

    4 plantillas curadas (Blank, PR Review, Bug Hunt, Equipo Definitivo) listas para lanzar. CLAUDE.md, reglas y system-extra persisten entre teams: defínelos una vez y se inyectan automáticamente.

  • Dos hosts, mismo backend

    Misma capa de servicios (spawner, hook server, DB) en la app de escritorio Electron y en la VSCode extension. Eliges el host según tu flujo; el comportamiento es idéntico.

Flujo en 4 pasos

De equipo vacío a conversación auditable, sin tocar el JSON-RPC del CLI a mano.

  1. Define el equipo

    Eliges una plantilla o partes en blanco. Cada teammate tiene nombre, rol y responsabilidad. Modo agent_teams (peer-to-peer) o subagents (hub-and-spoke clásico).

  2. Lanza la sesión

    La app spawnea claude --print --output-format stream-json con la receta nativa de agent_teams ya inyectada. El leader registra el team y spawnea peers automáticamente.

  3. Observa en vivo

    Buzón, Live Agents, Kanban y Negociaciones se actualizan al instante. Cada teammate va y vuelve por el mismo canal — ningún mensaje se pierde aunque mates la app.

  4. Conversa cuando quieras

    Respondes al leader, filtras por agente, escalas mensajes. Reabres la app y todo el historial sigue intacto en SQLite.

Plantillas curadas

Cuatro arquetipos cubren los casos reales. Editables, duplicables, persistentes en disco.

Blank

En blanco

Sin presets. Tú defines roles, prompt y modo desde cero. Útil para experimentos rápidos o cuando el caso no encaja en los otros tres.

Audit

PR Review (3 revisores)

Tres lentes adversarias paralelas — security (OWASP top-10), perf (N+1, allocations) y tests (cobertura, suite). El leader consolida un veredicto APROBAR / CAMBIOS / RECHAZAR. Para PR ajeno o post-merge audit.

Investigate

Bug Hunt (5 hipótesis adversarias)

Cinco teammates investigan en paralelo hipótesis distintas de causa raíz (race, validación, dependencia externa, estado persistido, type drift). Debaten entre sí y consolidan en findings.md. Para encontrar el bug, no para arreglarlo.

Build + Test

Equipo Definitivo (5 roles)

Pipeline completo con gates: architect diseña → frontend-engineer + backend-engineer construyen → tests-engineer verifica con tests/plan.md + Playwright headed → security-engineer endurece (OWASP) → auditoría cruzada con devils-advocate on-demand. El protocolo POSTURA/ACUERDO/TERMINADO/APROBADO se ilumina en Negociaciones.

Instalar

Requiere claude CLI v2.1.32+ en tu PATH y la variable CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 (la app la fija al spawnear).

Recomendado

VSCode extension

Sidebar nativo dentro de VSCode + acceso a tus workspace folders.

code --install-extension \
  ailu-claude-team-work-vscode-0.1.0.vsix

Después: Ctrl+Shift+P → Developer: Reload Window. El ícono aparece en la activity bar.

Standalone

App de escritorio

Electron empaquetado, sin requerir VSCode.

npm install
npm run dev      # desarrollo
npm run build    # empacar instalador

Para Linux también hay .deb con maintainer y postinst hint.

Programático

MCP server (lanzar teams desde tu Claude Code interactivo)

Agrega el server a tu ~/.claude.json para que tu CLI claude tenga 8 tools nuevas: launch_team, list_messages, get_team, set_context…

{
  "mcpServers": {
    "ailu-claude-team-work": {
      "command": "node",
      "args": [
        "<path-to-extension>/dist/mcp/server.cjs"
      ]
    }
  }
}

La extensión se autoinstala en tu config; copia el command desde Manage MCP servers si lo necesitas a mano. Misma SQLite que la UI — los teams aparecen en ambos lados.

Arquitectura por debajo

Money-flow simplificado desde un click en el lanzador hasta el render del Buzón. 

TeamLauncher (renderer)
   └─ ipc.launchTeam(payload)
        └─ zod.parse(payload)
             └─ ClaudeSpawner.launch(input)
                  └─ spawn(claude, --print --verbose --output-format stream-json …)
                       └─ stdout NDJSON
                            └─ stream-parser.parseStream
                                 └─ ClaudeSpawner.persistEvent
                                      ├─ events-repo.appendBatch (BEGIN…COMMIT)
                                      └─ webContents.send('teams:event', …)
                                           └─ agents-store.patch
                                                └─ LiveAgents + Buzón re-render
  • Stack Electron 33, React 18, Tailwind 3, Zustand, node-sqlite3-wasm con WAL, pino, chokidar, Playwright.
  • Validación zod en cada IPC handler antes de tocar disco o procesos. Tests unitarios fuerzan el contrato.
  • Privacidad Sin telemetría, sin analytics, sin cookies, sin nube. Data en ~/.ailu-claude-team-work/.

Listo para coordinar tu primer equipo

Instálalo en tu máquina. Todos los datos quedan locales y son auditables.

Instrucciones de instalación GitHub