EGC — Contexto que nunca zera · memória persistente para ferramentas de IA

01 O problema

Por que começar do zero toda vez?

Feche a janela e o contexto vai embora: a stack que você prefere, as decisões de arquitetura da semana passada, a abordagem que falhou depois de três tentativas. Troque do Cursor para o Claude Code e começa tudo de novo.

você ›~~Usamos PostgreSQL com row-level security…~~
você ›~~Prefiro componentes funcionais, sem classes…~~
você ›~~Saímos do Prisma para o Drizzle porque…~~

Sem EGC

Repetir o contexto em toda sessão
Perder decisões importantes
Reexplicar a estrutura do projeto

Com EGC

Contexto restaurado em cada nova sessão
Decisões guardadas junto com o projeto
Troque de ferramenta e siga em frente

02 Demonstração

Uma decisão, duas ferramentas.

Veja o caminho de uma decisão: registrada no Cursor, guardada pelo EGC e restaurada no Claude Code, sem você repetir nada.

Demonstração ilustrativaSimulação da interface para explicar o fluxo. Não é uma gravação real.

Etapa 1 de 5

A sessão registra uma decisão

No Cursor, você decide trocar o ORM. A IA salva a decisão com store_decision.

Etapa 2 de 5

A sessão é encerrada

Você fecha a janela. A decisão fica criptografada em ~/.egc, na sua máquina.

Etapa 3 de 5

Outra ferramenta é aberta

Dias depois, você abre o Claude Code no mesmo projeto e só diz “vamos continuar”.

Etapa 4 de 5

O EGC restaura a decisão

O EGC carrega o estado do projeto e devolve a decisão para a nova sessão.

Etapa 5 de 5

O trabalho continua

A IA segue de onde parou, já sabendo o que foi decidido.

Veja a gravação real

A simulação acima explica o fluxo. Para ver o EGC de verdade, assista à demonstração gravada.

Ao reproduzir, o vídeo é carregado do YouTube.

03 Como funciona

Um cérebro, quatro funções.

Um único motor local, ativo desde a primeira instalação em todas as ferramentas compatíveis. Cada círculo da marca é uma das partes que trabalham juntas por você.

#01 Memória

O que um agente aprende, todos sabem.

Decisões e lições ficam guardadas e voltam em qualquer ferramenta.

Detalhes técnicos

Decisões, contexto da sessão, memória de trabalho e lições aprendidas são guardados enquanto você trabalha e ficam disponíveis em qualquer terminal, IDE ou agente. Você fala naturalmente, em qualquer idioma: “salve esta sessão”, “o que decidimos sobre autenticação?”. Não há comando para decorar.

get_state · update_state · store_decision · search_history · lesson_save — por projeto e por branch

Como a memória funciona

#02 Session Mesh

Suas sessões abertas se enxergam.

Sessões paralelas avisam no que estão trabalhando e cooperam em vez de colidir.

Detalhes técnicos

Duas abas do Cursor, um terminal do Claude Code e uma sessão do Antigravity compartilham um barramento ao vivo. Elas anunciam no que estão trabalhando, reservam os arquivos que editam e passam tarefas umas para as outras.

session_announce · claim_path · session_send · session_wait — eventos entregues uma única vez

Ver os servidores MCP

#03 Guardian

Segurança antes de cada comando.

Comandos e escritas arriscadas são validados antes de rodar, em segundo plano.

Detalhes técnicos

O Guardian valida comandos antes de rodarem, barra escritas arriscadas e impede que o contexto transborde, sem você chamar nada.

Ressalva: a cobertura depende do suporte a hooks de cada ferramenta. As exceções estão na avaliação de segurança do projeto.

validate_command bloqueia injeção de shell · validate_write protege caminhos como ~/.ssh e /etc · validate_content sinaliza prompt injection (apenas alerta)

Conhecer o Guardian

#04 Token Crusher

O ruído não chega ao modelo.

Saídas longas do terminal são comprimidas em até 90%, mantendo erros e avisos.

Detalhes técnicos

Antes que a saída do terminal chegue ao modelo, o Token Crusher comprime logs do git, testes verbosos, ruído de instalação e JSONs gigantes, mantendo todos os erros e avisos. Pergunte “quanto eu economizei?” e a resposta vem do seu registro local.

Um git log de 637 KB virou 31 KB em uma única compressão · egc gain mostra a sua economia

Ler sobre otimização de tokens

04 Integrações

Funciona com as ferramentas que você já usa.

O egc install detecta o que está instalado e configura cada ferramenta com o que ela consegue ler.

Ferramentas de desenvolvimento28

Selecione uma ferramenta para conhecer sua integração.

Ver todas as integrações

Provedores de modelos10

Traga o seu modelo. Funciona nativamente com estes provedores, além do OpenRouter como intermediário.

Claudenativo
ChatGPTnativo
Gemininativo
DeepSeeknativo
Mistral AInativo
Ollamanativo
Groqnativo
Vertex AInativo
Coherenativo
OpenRouterintermediário

05 Eficiência

Estimativas do projeto EGC

87%menos tokens para reconstruir o contexto a cada sessão.

Contexto carregado por sessão
sem EGC~1.500 tokens
com EGC~200 tokens
Tempo reexplicando o projeto
sem EGC10 min/sessão
com EGC0
Custo de 20 sessões por mês
sem EGCUS$ 0,08–0,09
com EGCUS$ 0,011–0,012
Saída do terminal enviada ao modelo
sem EGCcompleta
com EGCaté 90% menor

Barras proporcionais aos valores publicados pelo projeto (faixas pelo ponto médio). Rode egc gain para ver a economia registrada na sua máquina.

06 Privacidade e segurança

Sua memória mora na sua máquina.

Local-firstNada sai do seu computador.Os servidores MCP falam por stdio apenas com a ferramenta de IA local.
CriptografiaAES-256-GCM em repouso.A autenticação GCM detecta corrupção na leitura.
EscopoPor projeto e por branch.Trocar de branch restaura o contexto daquela branch.
RepositórioNunca vai para o git.A memória fica fora do seu código-fonte.
LicençaOpen source, Apache-2.0.O motor continua gratuito.

07 Instalação

Dois comandos. Sem passo três.

Instale o pacote
Requer Node.js 20 ou superior. Funciona em Windows, macOS e Linux.
Rode egc install
Detecta suas ferramentas, registra os servidores MCP locais e escreve o protocolo de memória. Só pergunta se você quer a biblioteca de prompts opcional.
Converse normalmente
Abra sua ferramenta e diga “vamos continuar”. A memória carrega sozinha.

Linux, macOS e Windows. Não precisa clonar o repositório.

$ npm install -g @egchq/egc
$ egc install
# conferir
$ egc doctor
egc-guardian running
egc-memory   running

Requer Node.js 20+ e git.

$ git clone https://github.com/Fmarzochi/EGC.git
$ cd EGC && sh scripts/install.sh

Requer Node.js 20+ e git.

$ git clone https://github.com/Fmarzochi/EGC.git
$ cd EGC && sh scripts/install.sh

Requer Node.js 20+ e PowerShell.

PS> git clone https://github.com/Fmarzochi/EGC.git
PS> cd EGC; .\scripts\install.ps1

Guia completo de instalação

O EGC envia os dados do meu projeto para algum lugar?

Não. Todo o estado fica salvo localmente em ~/.egc. Nada é enviado para servidores externos: os servidores MCP se comunicam por stdio apenas com a ferramenta de IA da sua máquina.

Quais ferramentas são compatíveis?

28 ferramentas: Claude Code, Cursor, Codex CLI, Antigravity, OpenCode, Devin Desktop, Amp, VS Code Copilot, Zed, Kiro, Trae, CodeBuddy, JetBrains Junie, Goose, OpenHands, Aider, Warp, Cline, Qwen Code, Kimi Code CLI, Crush, Auggie, Mistral Vibe, Grok Build, Kilo Code CLI, MiMo Code, Pi e Droid. O instalador detecta automaticamente quais estão na sua máquina.

Preciso pedir para a IA carregar o contexto?

Não. O egc install escreve o protocolo de memória no arquivo de instruções global de cada ferramenta, e a IA é orientada a carregar o estado no início de cada sessão. Em versões de ferramentas que não leem esse arquivo automaticamente, pode ser preciso adicioná-lo ao contexto manualmente.

Qual a diferença para um CLAUDE.md ou .cursorrules?

Esses arquivos são estáticos e versionados no repositório. O estado do EGC é dinâmico e local: a IA escreve nele a cada sessão, acumulando decisões e preferências. Os dois se complementam.

Funciona com vários projetos?

Sim. O estado é guardado por projeto e por branch do git. Cada projeto tem sua própria memória.

O EGC é gratuito?

Sim. O motor é Apache-2.0 e continua gratuito. Se um dia houver algo pago, será uma camada para equipes por cima do motor, nunca a memória na sua máquina.

A biblioteca de prompts é obrigatória?

Não. Ela é opcional e vem desligada por padrão: o instalador pergunta, e o motor (memória e Guardian) funciona do mesmo jeito sem ela.

Contexto que nunca zera.

Por que começar do zero toda vez?

Sem EGC

Com EGC

Uma decisão, duas ferramentas.

A sessão registra uma decisão

A sessão é encerrada

Outra ferramenta é aberta

O EGC restaura a decisão

O trabalho continua

Um cérebro, quatro funções.

O que um agente aprende, todos sabem.

Suas sessões abertas se enxergam.

Segurança antes de cada comando.

O ruído não chega ao modelo.

Funciona com as ferramentas que você já usa.

Ferramentas de desenvolvimento28

Provedores de modelos10

87%menos tokens para reconstruir o contexto a cada sessão.

Sua memória mora na sua máquina.

Dois comandos. Sem passo três.

Instale o pacote

Rode `egc install`

Converse normalmente

Perguntas frequentes.

Mesmo projeto. Nova sessão.

Contexto que nunca zera.

Por que começar do zero toda vez?

Sem EGC

Com EGC

Uma decisão, duas ferramentas.

A sessão registra uma decisão

A sessão é encerrada

Outra ferramenta é aberta

O EGC restaura a decisão

O trabalho continua

Um cérebro, quatro funções.

O que um agente aprende, todos sabem.

Suas sessões abertas se enxergam.

Segurança antes de cada comando.

O ruído não chega ao modelo.

Funciona com as ferramentas que você já usa.

Ferramentas de desenvolvimento28

Provedores de modelos10

87%menos tokens para reconstruir o contexto a cada sessão.

Sua memória mora na sua máquina.

Dois comandos. Sem passo três.

Instale o pacote

Rode egc install

Converse normalmente

Perguntas frequentes.

Mesmo projeto. Nova sessão.

Rode `egc install`