What it looks like in practice
You open Claude Code on a project you have not touched in two weeks. Without typing anything:
State loaded from egc-memory via ~/.egc/state/Projects--MyApp.md
Context and preferences acknowledged.
Ready to pick up:
- Test full install on a clean machine
- Add GEMINI.md with session memory protocol
- Publish v1.0.1 fix after clean install test passes
The AI already knows what you were building, what decisions you made, what failed, and exactly where you stopped. You did not type anything. You just started working.
How it works
EGC ships two MCP servers that run locally during every session.
egc-memory: 14 tools for persistent memory
| Tool | What it does |
|---|---|
get_state | Loads project memory at session start |
update_state | Saves decisions, preferences, and next steps |
store_decision | Persists a single decision to SQLite |
query_history | Returns past decisions by timestamp |
search_history | Full-text search with BM25 ranking |
working_memory_set | Stores transient context with a TTL |
lesson_save | Records cross-session knowledge with confidence decay |
lesson_recall | Retrieves active lessons above a threshold |
detect_patterns | Surfaces repeated commands and recurring errors |
compress_observations | Compresses hook events to save token budget |
State files live at ~/.egc/state/<project-slug>.md. One file per project. Plain Markdown. Human-readable.
egc-guardian: 5 tools for context and safety
| Tool | What it does |
|---|---|
validate_command | Checks shell commands before execution |
validate_write | Validates file paths to prevent unsafe writes |
reduce_context | Compresses file payloads to save token budget |
orchestrate_task | Routes prompts with agent/skill context |
auto_learn | Mines session failures and writes lessons to CLAUDE.md |
Every tool. One memory.
EGC installs into whichever tools you already use:
- Claude Code
- Cursor
- Gemini CLI / Antigravity
- Windsurf
- GitHub Copilot
- Trae
- Zed
- Aider
- OpenCode
- Kiro
- Amp
All of them read from and write to the same ~/.egc/state/ directory. What Claude knows, Gemini knows. No copy-paste, no re-explanation.
Install
npm install -g @egchq/egc && egc install
Or without installing globally:
npx @egchq/egc install
EGC detects which tools you have installed and sets them up automatically.
Prompt library included
EGC ships 479 components as a bonus: 63 agents, 229 skills, and 76 commands written from real engineering sessions. Skip them entirely and EGC still gives you persistent memory. Or use them to extend any AI tool you already have.
npx skills add Fmarzochi/EGC
Open source
EGC is MIT licensed, built by one developer, maintained in the open.
- Website:
- npm:
@egchq/egc
- Discord: https://discord.gg/AtazrtxJ
If EGC changed how you work, a star goes a long way.
SOCIAL SHARE CARD GENERATOR