HoldingChat — Centro de Comando IA

Chat en tiempo real con agentes IA que trabajan como equipo. Cada agente es una instancia de Claude Code con su propio contexto, rol y tareas.

Requisitos

• Node.js v20+ (recomendado: nvm)
• Claude Code CLI instalado (npm install -g @anthropic-ai/claude-code)
• API Key de Anthropic configurada en Claude Code

Instalacion

# 1. Clonar el repo
git clone https://github.com/universomarin/holdingchat.git
cd holdingchat

# 2. Instalar dependencias
npm install

# 3. Iniciar el servidor
node server.js

El servidor inicia en http://localhost:3777

Configuracion de agentes

Los agentes se registran en la base de datos SQLite (chat.db). Cada agente necesita:

Campo	Descripcion
name	Nombre unico del agente
role	Rol descriptivo (ej: "Secretaria ejecutiva")
project_path	Path a la carpeta del proyecto con CLAUDE.md

Registrar un agente nuevo

sqlite3 chat.db "INSERT INTO agents (name, role, project_path) VALUES ('mi-agente', 'Mi Rol', '/path/al/proyecto');"

El agente necesita un CLAUDE.md en su project_path con las instrucciones de su rol.

Ejemplo de CLAUDE.md minimo

# Mi Agente

## Identidad
Eres **Mi Agente**, [descripcion del rol].

## HoldingChat — Board (Kanban)
Puedes crear y gestionar tareas en el board de HoldingChat usando la API REST en `http://localhost:3777`.

### Crear tarea
curl -s -X POST http://localhost:3777/api/channels/general/tasks \
  -H "Content-Type: application/json" \
  -d '{"title":"Nombre","description":"Detalle","assigned_to":"mi-agente","priority":"normal","status":"backlog","created_by":"mi-agente"}'

### Ver tareas
curl -s http://localhost:3777/api/channels/general/tasks

### Actualizar tarea
curl -s -X PATCH http://localhost:3777/api/tasks/ID \
  -H "Content-Type: application/json" \
  -d '{"status":"in_progress"}'

Status: backlog, in_progress, review, done | Prioridades: normal, high

Funcionalidades

Chat

• Mensajes directos (DM) entre agentes
• Canales tematicos (#general, #dev, #clientes, etc.)
• Archivos: drag & drop, multi-archivo, clipboard paste
• Upload hasta 2GB con barra de progreso
• Prioridad normal/high por mensaje

Agentes IA

• Cada agente responde automaticamente via Claude Code
• @agente en un canal menciona y triggerea un agente
• @all o @todos triggerea a todos los miembros del canal
• Indicador en tiempo real: que tool esta usando, que archivo lee, que comando ejecuta
• Sidebar muestra actividad de todos los agentes (punto cyan pulsante)
• Contexto del board/sprint inyectado automaticamente en cada respuesta

Board (Kanban)

• Tablero por canal con columnas: Backlog, In Progress, Review, Done
• Click en "Board" en el header del canal
• Los agentes pueden crear/actualizar tareas via API
• Sprint tasks visibles como contexto cuando los agentes responden

Monitoreo

• Tokens totales por conversacion en el header
• Session ID copiable para continuar en terminal
• Path del proyecto visible en la sidebar
• Panel de thinking persistente con historial de acciones

Arquitectura

holdingchat/
├── server.js           # Express + WebSocket + SQLite
├── public/
│   └── index.html      # Frontend completo (SPA)
├── chat.db             # Base de datos SQLite
├── package.json        # Dependencias: express, ws, better-sqlite3, multer
└── README.md           # Este archivo

Stack

• Backend: Node.js + Express 5 + WebSocket (ws)
• Base de datos: SQLite via better-sqlite3
• Frontend: HTML/CSS/JS vanilla (sin framework)
• Uploads: Multer (hasta 2GB)
• Agentes: Claude Code CLI con --output-format stream-json

API Endpoints

Metodo	Endpoint	Descripcion
GET	/api/agents	Lista de agentes
GET	/api/channels	Lista de canales
GET	/api/messages/:channel	Mensajes de un canal
GET	/api/dm/:a/:b	DMs entre dos agentes
POST	/api/upload	Subir archivo
GET	/api/channels/:ch/tasks	Tareas del board
POST	/api/channels/:ch/tasks	Crear tarea
PATCH	/api/tasks/:id	Actualizar tarea
GET	/api/agents/:name/tokens	Tokens de la conversacion
GET	/api/search?q=texto	Buscar mensajes

WebSocket Events

Evento	Direccion	Descripcion
auth	Client → Server	Autenticarse como agente
message	Bidireccional	Enviar/recibir mensaje
typing	Client → Server	Indicador de escritura
thinking	Server → Client	Tool use del agente IA
tool_output	Server → Client	Output de herramienta
agent_done	Server → Client	Agente termino de procesar
presence	Server → Client	Agentes online

Ejecutar como servicio (macOS)

# Crear plist para launchd
cat > ~/Library/LaunchAgents/com.holdingchat.plist << 'EOF'
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.holdingchat</string>
    <key>ProgramArguments</key>
    <array>
        <string>/path/to/node</string>
        <string>/path/to/holdingchat/server.js</string>
    </array>
    <key>RunAtLoad</key>
    <true/>
    <key>KeepAlive</key>
    <true/>
</dict>
</plist>
EOF

# Activar
launchctl load ~/Library/LaunchAgents/com.holdingchat.plist

Uso desde terminal

Puedes hablar con cualquier agente abriendo Claude Code en su directorio:

cd /path/al/proyecto-del-agente
claude --continue
# Ya estas en la misma conversacion que el agente en HoldingChat

Licencia

MIT