@egchq/egc

Language: English | Español | Português (Brasil)

Language / Idioma

English | Español | Português (Brasil)

EGC - Extended Global Context

Your AI agents never start from zero again.

EGC is a local runtime that gives every AI coding tool you use a persistent memory. At the end of each session, the AI saves what it learned about your project: the decisions you made, what failed, your preferences, what comes next. At the start of the next session, it loads that state back. One install covers Claude Code, Cursor, Gemini CLI, Windsurf, and more.

This is what EGC looks like in practice

You open Claude Code on a project you haven't touched in two weeks. Without typing anything:

State loaded from egc-memory via ~/.egc/state/Projects--MyApp.md

Context and preferences acknowledged (terse responses).

Ready to pick up the next items:
• Test full install on a clean machine
• Add GEMINI.md with session memory protocol
• Publish v1.0.1 fix to npm after clean install test passes
• Add mcp_server_count to audit.js

The AI already knows what you were building, what decisions you made, what failed, and exactly where you stopped. It knows because EGC saved that state at the end of your last session and loaded it back when this one started. You didn't type anything. You just started working.

Install

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

Or run without installing globally:

npx @egchq/egc install

Full installation guide

What the MCP server gives your AI

EGC ships egc-memory, an MCP server that exposes 14 tools your AI can call during a session:

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
working_memory_get	Reads a transient key
working_memory_list	Lists all live transient entries for the current project
lesson_save	Records cross-session knowledge with confidence decay
lesson_recall	Retrieves active lessons above a confidence threshold
lesson_reinforce	Boosts confidence on a lesson when the same pattern repeats
detect_patterns	Surfaces repeated commands and recurring errors from hook events
compress_observations	Compresses raw hook observations into typed summaries to reduce token usage
get_project_state	Returns server health metadata and storage engine status

State files live at ~/.egc/state/<project-slug>.md. One file per project, plain Markdown, human-readable.

Prompt library

479 components: optional. Install to get access to 63 agents, 229 skills, and 76 commands written from real experience. Skip them and EGC still gives you persistent memory.

Component	Total	Claude Code	Gemini CLI	Claude Code native
Agents	63	Shared (AGENTS.md)	Shared (AGENTS.md)	12
Commands	76	Shared	Instruction-based	31
Skills	229	Shared	10 (native format)	37
Rules	111	:	:	:

Support EGC

EGC is built by one developer, maintained in the open, and free.

• Join the Discord: ask questions, share feedback
• Sponsor on GitHub: any amount
• Donate via PayPal: no GitHub account needed
• Star the repository: helps other developers find it
• Contribute: agents, skills, commands, bug fixes, docs
• Share: if EGC changed how you work, tell someone

Sponsors

Support from the community keeps this project alive and independent.

Backers

Monthly sponsors · be the first