Saltar al contenido
JAJose Arias
Todos los proyectos

Agentes de IA · 2026

Oficina de Agentes

Observabilidad en vivo para agentes de IA

Repositorio en GitHub
Mi rol
Autor y desarrollador
Resultado clave
3agentes de IA integrados y una API abierta para otros
Stack
Node.jsJavaScriptSSESQLiteHooks de Claude CodePWAAndroid

01

Contexto

Cuando se trabaja con varios agentes de IA a la vez, no es evidente cuál está trabajando, cuál espera un permiso ni cuánto ha consumido cada uno. Este proyecto lo hace visible en tiempo real, en el navegador y en el celular. Es independiente y no está afiliado a Anthropic, GitHub, Microsoft ni Google.

02

Qué construí

  • Integré Claude Code mediante hooks (tareas, cada herramienta en vivo, esperas de permiso) y una línea de estado que informa tokens y porcentaje del plan.
  • Construí un vigilante para Copilot CLI que interpreta, en modo solo lectura, los registros de sesión que la herramienta deja en disco.
  • Conecté Gemini CLI y otros agentes con un conector que envuelve su ejecución, y definí una API genérica de eventos para cualquier otra fuente.
  • Desarrollé el servidor (API HTTP + SSE) con historial y consumo guardados en SQLite.
  • Diseñé la interfaz: una oficina en pixel-art responsive, instalable como PWA y como app de Android.

03

Arquitectura

  1. Claude Code

    Hooks + línea de estado

    Copilot CLI

    Registros de sesión (solo lectura)

    Gemini CLI

    Conector que envuelve la ejecución

    Otros agentes

    POST /api/event

  2. Servidor Node.js

    API HTTP + SSE · token local

  3. SQLite

    Historial y consumo

  4. Oficina en pixel-art

    Web · PWA · Android

De los agentes al panel: eventos en tiempo real.
  • Entrada
  • Proceso
  • Almacenamiento
  • Salida

04

Decisiones técnicas

Hooks que nunca estorban al agente
Los hooks de Claude Code no bloquean ni hacen fallar la sesión: si el servidor está apagado, simplemente no pasa nada.
Instalación reversible
El instalador edita la configuración de Claude Code dejando copia de seguridad y sin tocar otros hooks; un comando deshace todo.
Local y con token por defecto
El servidor escucha solo en 127.0.0.1 y toda la API exige un token aleatorio generado en el equipo. Sin nube, sin cuentas y sin telemetría.
Un contrato de eventos abierto
Un único endpoint de eventos (inicio de sesión, tarea, acción, espera, límite, consumo) permite integrar cualquier agente; los eventos de consumo llevan tokens, costo y límites del plan.
Lectura solo-lectura para Copilot CLI
El vigilante detecta cada sesión de Copilot y lee sus registros sin modificarlos, y puede desactivarse desde la configuración.
Dependencias mínimas
El proyecto instala una sola librería (para el código QR del celular); el resto es Node.js puro.

05

Resultado

  • Panel en vivo con tres agentes integrados (Claude Code, Copilot CLI y Gemini CLI) y una API abierta para cualquier otro.
  • Consumo de tokens por sesión, por día y por semana, y uso del plan con la hora de renovación.
  • Disponible en el navegador, como PWA y como app de Android.