Ravenclaw - Sistema open source para gestionar el contexto de trabajo de agentes de codificación con IA
(github.com/chainofdive)Descripción general
Al usar agentes de codificación con IA (Claude Code, Gemini CLI, Codex, etc.) en varios proyectos, me encontré con dos problemas.
1. Si cambias de agente, se pierde el contexto
Si estás trabajando con Claude Code y luego cambias a Gemini CLI, tienes que volver a explicar desde cero qué habías hecho antes. Incluso con el mismo agente pasa lo mismo cuando termina la sesión. Terminas revisando los registros de conversación del terminal por proyecto y repitiendo una y otra vez: "hasta aquí llegamos, y lo siguiente es esto".
2. Si llevas varios proyectos en paralelo, la cabeza explota
Cuando trabajas en 3 o 4 proyectos al mismo tiempo, solo entender hasta dónde avanzó cada uno ya se vuelve una tarea en sí misma. Ir cambiando entre pestañas del terminal y hacer scroll en el historial de conversaciones tiene un límite.
Ravenclaw fue creado para resolver este problema.
Idea principal
Gestiona de forma centralizada el contexto de trabajo del agente.
No importa qué agente uses (Claude Code, Gemini CLI, Codex), el contexto de trabajo se va acumulando en Ravenclaw. Aunque cambies de agente o se corte la sesión, en una nueva sesión puedes cargar exactamente el estado anterior mediante herramientas MCP. No depende de un agente específico.
En la interfaz web puedes ver de un vistazo la estructura de épicas/issues por proyecto, la vista de grafo y el progreso, así que puedes entender de inmediato "¿en qué punto va este proyecto ahora mismo?" sin revisar el historial del terminal.
Un sistema para agentes, no para personas
Los tickets (issues/épicas) y la wiki de Ravenclaw se parecen a Jira o Linear, pero el usuario principal es distinto.
- Quien crea issues, cambia estados y redacta la wiki es el agente
- La persona revisa la situación general en la interfaz web y, cuando hace falta, agrega explicaciones o guía la dirección mediante comentarios
- Cuando el agente se encuentra con una situación que requiere criterio, envía una Human Input Request y se responde desde la web
Para que los agentes puedan acceder de forma programática, ofrece más de 40 herramientas a través del protocolo MCP, y todas las funciones también están disponibles desde CLI y REST API.
Funciones principales
- Chat web: instrucciones directas al agente desde el navegador, con respuestas en streaming en tiempo real
- Continuidad de conversación: uso de
claude --resume, con historial de conversación guardado en la base de datos - Visualización de proyectos: en la vista de grafo puedes ver de un vistazo la estructura de épicas/issues y el progreso
- Snapshots de contexto: el agente guarda el estado del trabajo para retomarlo en la siguiente sesión
- Control de permisos: al ejecutar el agente, puedes elegir entre auto-approve / bypass / accept-edits
- Multiagente: puedes elegir entre Claude Code, Gemini CLI y Codex para trabajar en el mismo proyecto
Stack tecnológico
Monorepo en TypeScript (pnpm workspaces)
- API: Hono + PostgreSQL (Drizzle ORM)
- Web: React + Tailwind + ReactFlow
- Integración con agentes: MCP Protocol (más de 40 herramientas)
- CLI: Commander.js
- Pruebas: Playwright E2E (14)
Instalación
git clone https://github.com/chainofdive/ravenclaw.git
cd ravenclaw && pnpm install && pnpm build
docker-compose up -d && pnpm db:push
Es self-hosted, solo necesitas PostgreSQL. Licencia Apache 2.0.
De hecho, ya estoy gestionando en paralelo varios side projects con agentes de IA usando este sistema. Se agradecen comentarios o preguntas.
Aún no hay comentarios.