Colony: Uma Camada de Coordenação Local-Primeiro que Reduz Tokens de Transferência Multiagente de 30K para 400
Colony é uma camada de coordenação local-first para configurações de codificação multiagente. Ela fica entre seus runtimes de agente (Claude Code, Codex, Cursor, Gemini CLI, OpenCode) e um armazenamento SQLite local, reduzindo a sobrecarga de handoff de ~30.000 tokens para ~400 tokens por final de sessão.
Principais Recursos
- Reivindicações antes de edições — Agentes reivindicam um arquivo antes de tocá-lo; outros agentes veem a reivindicação ativa e se abstêm, evitando condições de corrida e PRs duplicados.
- Handoffs compactos — Ao final da sessão, Colony escreve um recibo estruturado (link do PR, SHA do merge, arquivos alterados, resultados de verificação, status de limpeza). O próximo agente lê ~400 tokens em vez de reproduzir ~30.000.
- Diagnósticos de saúde —
colony healthdetecta falhas silenciosas de coordenação: reivindicações obsoletas, incompatibilidades de ponte de ciclo de vida, lacunas de adoção de plano-reivindicação. - Memória persistente — Comprimida em repouso (~70% de compressão de prosa, perfeita para caminhos/código/comandos). Pesquisável via FTS5.
O Que Não É
- Não é um plano de controle hospedado — local-first por padrão, os dados nunca saem do disco.
- Não é um executor de agente — Codex, Claude, Cursor ainda executam o trabalho.
- Não é orquestração — estigmergia: agentes deixam rastros, os úteis são reforçados, os obsoletos evaporam.
Formato do Recibo de Handoff
Quando uma sessão termina, os agentes retornam uma resposta estruturada com link do PR, SHA do merge, arquivos alterados, resultados de verificação e status de limpeza da árvore de trabalho. Colony captura isso como uma observação; o próximo agente lê em vez de rederivar o contexto. mcp_metrics registra o custo.
Instalação
npm install -g /colony-cli
colony install --ide codex
colony healthRequer Node 20+. Licenciado sob MIT. Todos os dados armazenados em ~/.colony/data.db.
Melhorias Futuras
O autor está trabalhando em resolver automaticamente conflitos de reivindicação do mesmo arquivo e um comando colony heal --apply que executa o plano de correção em vez de apenas imprimi-lo.
📖 Leia a fonte completa: r/ClaudeAI
👀 See Also
Feiticeiro Livre Migra Histórico do ChatGPT para Projetos Claude — Lições Principais sobre Limites de Token e RAG
Uma ferramenta gratuita e sem código transforma exportações do ChatGPT em Projetos Claude, revelando que arquivos JSON de 26MB atingem limites de tokens e que a divisão por tópico é a solução. O RAG do Claude lê apenas partes de arquivos grandes, por isso consultas específicas funcionam melhor.
Feynman: Agente de Pesquisa de Código Aberto com Ferramenta de Auditoria de Base de Código de Artigos
Feynman é um agente de pesquisa CLI de código aberto que despacha quatro subagentes em paralelo para responder perguntas de pesquisa e inclui uma ferramenta de auditoria única que compara afirmações de artigos com bases de código reais. Possui instalação com um comando, licença MIT e executa em pi para tempo de execução do agente com alphaxiv para busca de artigos.
depct: Servidor MCP Fornece Análise e Documentação em Tempo Real para Claude
depct é um servidor MCP que instrumenta aplicações Node.js para capturar dados de runtime, gerando documentação estruturada com níveis de confiança que o Claude pode acessar antes de codificar. A ferramenta atualiza a documentação automaticamente após o Claude fazer alterações.
cc-lens: Painel Local para Análise de Sessões de Código Claude
Um desenvolvedor criou o cc-lens, um painel local que lê arquivos de sessão do Claude Code de ~/.claude/ e fornece análises de uso, rastreamento de custos e reprodução de sessões. Ele roda completamente na sua máquina sem sincronização na nuvem, cadastros ou telemetria.