Pular para o conteúdo

Referência

Perguntas frequentes

As dúvidas mais comuns sobre o EGC.

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

Não. Todo o estado fica guardado localmente em ~/.egc/. Nada é enviado a servidores externos. Os servidores MCP se comunicam por stdio só com a sua ferramenta de IA local.

Quais ferramentas são suportadas?

28 ferramentas: Claude Code, Cursor, Codex CLI, Antigravity CLI, 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 sozinho quais estão instaladas. Gemini CLI, Continue.dev e Roo Code foram aposentadas depois que os fabricantes as descontinuaram, e o Amazon Q Developer CLI seguiu o mesmo caminho em 2026-09-30 (cadastros fechados, suporte até 2027-04-30, a CLI virou a Kiro CLI).

A IA precisa chamar get_state manualmente?

Não. O bootstrap cognitivo que o instalador injeta (egc install e depois egc init em cada projeto) escreve o protocolo no arquivo de instruções global de cada ferramenta. A IA é instruída a chamar get_state no início de cada sessão automaticamente. Nas ferramentas em que o arquivo de instruções da IA não é lido automaticamente (depende da versão da ferramenta), pode ser preciso adicionar o CLAUDE.md do projeto, ou equivalente, ao contexto da sessão manualmente.

Posso usar o EGC com vários projetos?

Sim. O estado é guardado por projeto e por branch do git: o identificador do projeto vem do caminho absoluto da pasta, e cada branch ganha seu próprio documento de estado. Abra projetos diferentes em sessões diferentes e cada um terá a sua memória.

O que acontece se o arquivo de estado corromper?

Rode egc repair para restaurar os arquivos gerenciados. Os arquivos de estado são Markdown criptografado em repouso; o servidor de memória lê e grava esses arquivos por você, e a autenticação GCM dele detecta corrupção na leitura. Use egc export para ler o que está guardado. Você pode apagar um arquivo de estado manualmente para zerar um projeto. O banco SQLite é separado dos arquivos de estado.

A biblioteca de prompts é obrigatória?

Não. Ela é opcional e vem desligada: o instalador pergunta, e a partir da v1.1.22 egc install --prompt-library adiciona a biblioteca sem a pergunta. Os servidores MCP (memória e guardian) funcionam independentemente da biblioteca de prompts.

Qual a diferença entre o estado e um arquivo CLAUDE.md ou .cursorrules?

Esses arquivos são estáticos e ficam commitados no repositório. O estado do EGC é dinâmico e local do projeto: a IA escreve nele a cada sessão, acumulando decisões e preferências com o tempo. Um complementa o outro: regras estáticas para as convenções do repositório, estado do EGC para a continuidade entre sessões.

O EGC é gratuito?

Sim. O motor é Apache-2.0 e continua gratuito. Se um dia o EGC oferecer algo pago, será uma camada para equipes por cima do motor, nunca a memória na sua máquina. A direção está escrita em docs/VISION.md.

O que significam suporte principal e suporte da comunidade?

Toda ferramenta recebe o mesmo caminho de instalação e o mesmo protocolo de memória. As ferramentas com suporte principal (core-supported: Claude Code, Antigravity, Cursor, Codex CLI, OpenCode) são usadas todo dia pelo mantenedor ou por um responsável, e uma regressão causada por mudança do fabricante é corrigida antes da próxima release. As com suporte da comunidade (community-supported) são instaladas e testadas no CI como as demais, mas uma mudança do fabricante espera um relato ou um pull request. A lista e os critérios estão em docs/governance/support-levels.md, e cada ferramenta tem sua própria página em Integrações.

Posso contribuir?

Sim. Leia o CONTRIBUTING.md no GitHub. PRs são bem-vindos para correções de bugs, novas integrações de ferramentas e acréscimos à biblioteca de prompts.

Ainda tem dúvidas?

Abra uma issue no GitHub ou confira o código. Tudo é aberto.

Abrir uma issue