Primeiros passos

Instalação

Instale o EGC uma vez e ele funciona em todas as ferramentas de IA para programação que você já usa.

Requisitos

Role a tabela para o lado para ver todas as colunas.

Requisito	Versão	Como conferir
Node.js	`20+`	node --version
Git	`qualquer`	git --version
Sistema	Linux, macOS, Windows

Escolha o método

Use o npm em qualquer sistema compatível, ou escolha o seu sistema operacional para instalar a partir do código-fonte.

03 /Rode a instalação

Mais rápido

Funciona em Linux, macOS e Windows. Não precisa de git clone.

Usa mise, nvm, asdf ou fnm? Instale o EGC na sua versão padrão do Node, a que fica ativa fora de qualquer pasta de projeto, para evitar conflito de versões.

terminal

$ npm install -g @egchq/egc
$ egc install

Permissões: se o npm install -g falhar com EACCES (Node instalado pelo gerenciador de pacotes da sua distro, ou qualquer prefixo global do root), rode só o passo npm install -g com sudo e todo o resto como o seu usuário normal. Um gerenciador de versões do Node, como nvm, mise ou fnm, nunca precisa de sudo.

Depois, acorde o cérebro: a instalação sozinha só prepara o runtime. Dentro de um projeto de verdade, rode egc init uma vez para que as suas ferramentas de IA restaurem a memória dele já no primeiro prompt. O egc doctor deve terminar com errors=0.

Você precisa do Node.js 20+. Não tem certeza? Rode node --version.

bash

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

Você precisa do Node.js 20+. Não tem certeza? Rode node --version.

zsh

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

Você precisa do Node.js 20+ e do PowerShell. Rode como Administrador se for pedido.

powershell

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

Para atualizar depois com npm install -g @egchq/egc@latest: feche antes as ferramentas de IA e os terminais que rodam o EGC. O npm renomeia a pasta do pacote durante a atualização, e o Windows recusa enquanto algum processo estiver com um arquivo dela aberto (basta uma ferramenta de IA rodando os servidores MCP do EGC). O erro aparece como EBUSY: resource busy or locked; fechar as ferramentas resolve, e reiniciar também.

O que o instalador faz

Prepara os servidores MCP

O pacote do npm já traz o egc-guardian e o egc-memory compilados; um clone do código-fonte compila os dois a partir do TypeScript.

Inicializa o armazenamento

Cria o banco SQLite local em ~/.egc/ para decisões, lições e o barramento de sessões. Os documentos de estado ficam em ~/.egc/state/, um por branch do projeto, criptografados em repouso.

Bootstrap cognitivo

Escreve o protocolo de memória nos arquivos globais de instruções de cada ferramenta detectada (CLAUDE.md, GEMINI.md, cursor.rules etc.).

Registra os servidores MCP e os hooks

Grava os dois servidores na configuração MCP das dez ferramentas que aceitam (Antigravity, Claude Code, Cursor, Kiro, Codex CLI, OpenCode, Zed, Kimi Code CLI, Crush, Auggie) e liga os hooks nativos em toda ferramenta que os tem. No Claude Code, instala também um hook SessionStart (carrega o estado automaticamente) e um hook Stop (salva o estado automaticamente no fim da sessão). Roda uma vez por ferramenta e é idempotente.

Biblioteca de prompts (opcional)

Pergunta se deve instalar 232 skills, 77 comandos e 61 agentes; o padrão é não. A partir da v1.1.22, egc install --prompt-library responde sim sem perguntar e --no-prompt-library pula a pergunta. No CI, ela é pulada automaticamente.

Shim binário do Token Crusher

Instala, como etapa de melhor esforço, um shim no PATH (git, npm, gh e outros) em ~/.egc/bin. Cobre uma lacuna conhecida: no Claude Code, o hook automático nunca dispara para os comandos que o próprio assistente de IA executa.

Saída esperada

terminal

EGC install
  node v22.0.0
  building egc-guardian...
  building egc-memory...
  initializing database...
  bootstrapping cognitive protocol...
  ✓ ~/.claude/CLAUDE.md updated
  ✓ ~/.gemini/GEMINI.md updated
  registering MCP servers...
  ✓ registered in Antigravity CLI
  ✓ registered in Claude Code (global)
  ✓ registered in Cursor
  ✓ registered in Codex CLI
  ✓ registered in OpenCode
  ✓ registered in Zed

Install prompt library? (61 agents, 232 skills, 77 commands) [y/N]:

  Installing Token Crusher binary shim...
  ✓ Installed: git, npm, gh, ...

Installation complete.
Run 'egc doctor' to verify.

Confira a instalação

$ egc doctor

egc-guardian  running
egc-memory    running
database      ok
claude code   registered
cursor        registered

Se uma ferramenta aparecer como not found, ela não está instalada ou não foi detectada. Depois de instalar a ferramenta, rode egc install de novo (ou egc init dentro de um projeto).

Próximos passos

egc-memory

Entenda como funcionam o get_state e o update_state.

egc-guardian

Conheça a camada de validação e segurança.

Funções

Visão completa das funções e detalhes da biblioteca de prompts.

Referência da CLI

Todos os comandos do egc explicados.