Referência

Arquitetura

Dois servidores MCP, SQLite local, arquivos de estado em Markdown criptografados, um comando de instalação. Sem nuvem, sem daemon, sem servidor de configuração.

Visão geral

As ferramentas de programação com IA leem o protocolo de memória nos arquivos de instrução de cada ferramenta. Onde o MCP está registrado, as ferramentas se conectam por stdio ao egc-memory e ao egc-guardian. O egc-memory lê e grava o estado em Markdown criptografado por branch e um armazenamento local em SQLite de decisões e sessões. — As ferramentas usam o protocolo de memória instalado. Onde estão registradas, também se conectam aos dois servidores MCP locais por stdio. Abra o diagrama em tamanho real (nova aba) para ampliar.

Camadas

Camada das ferramentas de IA

Claude Code, Cursor, Codex, Antigravity CLI, OpenCode, Devin Desktop, Amp, VS Code Copilot, Zed, Kiro, Trae, CodeBuddy, Junie, Goose, OpenHands, Aider, Warp, Cline e Qwen Code: 19 destinos de instalação gerenciados. Cada ferramenta lê o estado no início da sessão e grava no fim: pelos servidores MCP onde eles estão registrados, e pelos arquivos de contexto propagados nos demais casos. O bootstrap cognitivo que o instalador injeta escreve esse protocolo no arquivo de instruções global de cada ferramenta.

Transporte MCP (stdio)

Os dois servidores se comunicam por stdio. A ferramenta os inicia como processos filhos. Sem portas, sem rede, sem daemon. Sobe em menos de 100 ms.

egc-memory

Cuida de todas as operações de memória. Lê e grava os arquivos de estado em Markdown separados por projeto e por branch do git. Guarda as decisões no SQLite com busca de texto completo BM25. Mantém o barramento de sessões, para que sessões paralelas anunciem presença, reservem caminhos e passem trabalho adiante sem colisões.

egc-guardian

Valida comandos e gravações de arquivo antes de executar, procura padrões de prompt injection em conteúdo não confiável (validate_content, só como aviso) e oferece utilitários de contexto (reduce_context, orchestrate_task, auto_learn). A aplicação também acontece no nível do harness: o roteamento de prompts e os hooks antes das ferramentas rodam em toda sessão, e o Token Crusher comprime a saída do terminal antes de ela chegar ao modelo, com a economia registrada num livro-caixa local (egc gain).

Armazenamento local (~/.egc/)

Os arquivos de estado são Markdown, um por branch do projeto, criptografados em repouso com AES-256-GCM e com integridade verificada por HMAC-SHA256. O SQLite guarda o histórico estruturado de decisões para consulta, e o livro-caixa do crusher registra cada economia de tokens. Tudo é local e nunca sai da sua máquina.

Painel (localhost:7890)

Central de controle em tempo real aberta logo após a instalação: chamadas de ferramenta ao vivo, uso de tokens, comparação de provedores, replay de sessões e exportação para CSV/JSON. Emissores de hooks das IDEs enviam eventos do Cursor, do Kiro, do OpenCode e do CodeBuddy.

Notas de projeto

Consolidação da arquitetura

Versões anteriores do EGC exploraram conceitos de runtime distribuído: FederationManager, ReplayEngine, camadas de orquestração cognitiva, despacho entre vários provedores. Esses experimentos foram explorações reais, não enganação. Ajudaram a definir o que o projeto realmente precisava ser.

O runtime atual reflete essa consolidação. Dois servidores MCP, SQLite local, arquivos de estado em Markdown criptografados, um comando de instalação. A branch legacy-runtime preserva a arquitetura histórica completa para quem quiser estudar a evolução.