Ravenclaw - sistema open source para gerenciar o contexto de trabalho de agentes de programação com IA
(github.com/chainofdive)Visão geral
Ao usar agentes de programação com IA (Claude Code, Gemini CLI, Codex etc.) em vários projetos, enfrentei dois problemas.
1. Ao trocar de agente, o contexto se perde
Se você está trabalhando com o Claude Code e muda para o Gemini CLI, precisa explicar tudo de novo desde o início. Mesmo com o mesmo agente, acontece a mesma coisa quando a sessão termina. Você acaba vasculhando o histórico de conversas no terminal de cada projeto e repetindo "fizemos até aqui, e o próximo passo é este".
2. Quando vários projetos avançam em paralelo, a cabeça entra em colapso
Quando 3 ou 4 projetos andam ao mesmo tempo, entender em que ponto cada um está já vira trabalho por si só. Ficar alternando entre abas do terminal e rolando o histórico das conversas tem um limite.
Criei o Ravenclaw para resolver esse problema.
Ideia central
Gerenciar centralmente o contexto de trabalho dos agentes.
Não importa qual agente você use (Claude Code, Gemini CLI, Codex), o contexto de trabalho é acumulado no Ravenclaw. Mesmo que você troque de agente ou a sessão seja interrompida, é possível carregar exatamente o estado anterior em uma nova sessão com ferramentas MCP. Ele não fica preso a um agente específico.
Na interface web, é possível ver de relance a estrutura de épicos/issues por projeto, a visualização em grafo e o progresso, então dá para entender imediatamente "até onde este projeto chegou agora?" sem depender do histórico do terminal.
Um sistema para agentes, não para pessoas
Os tickets (issues/épicos) e a wiki do Ravenclaw podem parecer com Jira ou Linear, mas o principal usuário é outro.
- Quem cria issues, muda status e escreve a wiki são os agentes
- As pessoas usam a interface web para verificar a situação geral e, quando necessário, adicionar explicações ou orientar a direção por meio de comentários
- Quando o agente encontra uma situação que exige decisão, ele envia uma Human Input Request, e a resposta é dada pela web
Para que os agentes tenham acesso programático, ele oferece mais de 40 ferramentas via protocolo MCP, e todas as funcionalidades também podem ser usadas por CLI e REST API.
Principais recursos
- Chat web: instruções diretas ao agente no navegador, com resposta em streaming em tempo real
- Continuidade de conversa: uso de
claude --resume, com histórico de conversas salvo no banco de dados - Visualização de projetos: visão clara da estrutura de épicos/issues e do progresso no grafo
- Snapshots de contexto: o agente salva o andamento do trabalho para retomar na próxima sessão
- Controle de permissões: escolha entre auto-approve / bypass / accept-edits ao executar o agente
- Multiagente: escolha entre Claude Code, Gemini CLI e Codex para trabalhar no mesmo projeto
Stack técnica
Monorepo em TypeScript (pnpm workspaces)
- API: Hono + PostgreSQL (Drizzle ORM)
- Web: React + Tailwind + ReactFlow
- Integração com agentes: MCP Protocol (40+ ferramentas)
- CLI: Commander.js
- Testes: Playwright E2E (14 casos)
Instalação
git clone https://github.com/chainofdive/ravenclaw.git
cd ravenclaw && pnpm install && pnpm build
docker-compose up -d && pnpm db:push
É self-hosted; basta ter PostgreSQL. Licença Apache 2.0.
Na prática, estou usando esse sistema para gerenciar em paralelo vários side projects junto com agentes de IA. Feedback e perguntas são bem-vindos.
Ainda não há comentários.