@egchq/egc

🌐 English · العربية · Español · हिन्दी · 日本語 · 한국어 · Português (Brasil) · Русский

EGC - Extended Global Context

Your AI agents never start from zero again.

Zero setup. Zero commands. You work, EGC remembers.

EGC is a local runtime that gives every AI coding tool you use a persistent memory. At the end of each session, your AI saves what it learned: decisions made, what failed, your preferences, what to pick up next. At the start of the next session, it loads that state back on its own, no prompting required. Say "let's continue" or "where did we stop?" in any language and your AI already knows what to do. One install covers Claude Code, Cursor, Gemini CLI, Windsurf, Zed, Warp, JetBrains Junie, VS Code with GitHub Copilot, and more (20 tools total). Works natively with Claude, GPT-4o, Gemini, DeepSeek, Mistral, Groq, Cohere, and Vertex AI, plus OpenRouter for Qwen3, Llama 4, and more.

Your AI already knows

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/MyApp/main.md

Context and preferences acknowledged.

Ready to pick up:
• Fix the rate limiter edge case on concurrent requests
• Add integration tests for the new auth module
• Review open PR from @contributor before merging

=== EGC Stack Briefing ===
Stack: typescript, node
Skills: tdd-workflow, coding-standards
Agents: code-reviewer
Guardian: active, every command checked before it runs
===

This isn't a cache of your last chat. EGC remembers the decisions, the dead ends, and your preferences, and it stands guard the whole session, blocking the commands that would burn your codebase down before they run. You didn't ask for any of it. You just started working.

Install

Same install command on Windows, macOS, and Linux:

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

Windows has a few of its own caveats (PowerShell version, Antigravity CLI, Gemini CLI's discontinued free tier): see the Windows notes if you hit anything unexpected.

Or run without installing globally:

npx @egchq/egc install

One brain, many tools. With the GitHub Copilot Chat extension installed, Copilot finds the skills on its own, and the same memory you already have in Claude Code or Cursor shows up there too:

npm install -g @egchq/egc
egc install --target copilot

Full installation guide

What EGC gives your AI

EGC always runs two things together, every session: a memory that keeps what matters, and a safety layer that blocks dangerous commands before they run. It all comes ready, no configuration needed.

Memory: what your AI remembers on its own

You'll never memorize a single command. Say it in any language: "continue from yesterday", "remember this decision", "what broke last time", and your AI knows exactly what to do. The work is yours, the remembering is EGC's.

egc-memory

Tool	What it does
get_state	Loads everything your AI already knew about the project the moment the session opens, plus your user-wide global memory
update_state	Saves what got decided today so nobody loses the thread tomorrow; scope: "global" shares it across every project
session_announce / session_peers	Parallel sessions see each other and split territory instead of colliding
claim_path / release_path	Cooperative locks so two sessions never fight over the same files
store_decision	Writes down one important decision, for good
query_history	Shows past decisions in the order they happened
search_history	Finds anything that was ever decided, even if you don't remember the date
working_memory_set / _get / _list	Quick notes that expire on their own once they stop being useful
lesson_save	Records something learned, which fades over time if nobody confirms it again
lesson_recall	Brings back the lessons that are still worth acting on
lesson_reinforce	Reinforces a lesson when it gets confirmed again
detect_patterns	Notices when the same error or command keeps repeating
compress_observations	Summarizes the raw history so you don't burn tokens for nothing
get_project_state	Checks that memory is working the way it should

Every branch of your project keeps its own memory, encrypted on your machine: nobody else has access, not even the cloud. Privacy by default, nothing to configure.

Context and safety: what stands guard while you work

egc-guardian

These tools run automatically in the background. Every shell command and every file write is checked before it executes. You never invoke them directly.

Tool	What it does
validate_command	Checks every command before it runs: blocks the ones that could cause damage
validate_write	Stops the AI from writing to sensitive files by accident
reduce_context	Shrinks large files so you don't burn your token budget for nothing
orchestrate_task	Picks the right tools for each request, without you needing to know which ones exist
auto_learn	Learns from the session's mistakes and writes it down so it doesn't repeat

Token Crusher: stop burning tokens on shell noise

A 200-commit git log, a 400-line npm install, a test run with 300 passing cases: your model reads all of it, and you pay for all of it. The Token Crusher compresses that output before it reaches the model: up to 90% smaller, with errors, warnings and failures always preserved.

egc run git log        # same command, crushed output
egc run --raw git log  # escape hatch: full output
egc saved              # accumulated savings, computed locally at zero token cost

Conservative by design: small outputs pass through untouched, failures always survive, and the savings ledger never touches your context window.

Enforced, not requested

Security that doesn't depend on the AI being in a good mood: every command passes through EGC before it runs, always. Full details on harness enforcement, session-intent detection, and the memory miner →

One memory. Every tool you use.

Run egc watch once and forget it exists. Change context in Cursor, it shows up on its own in Gemini CLI, Copilot, Windsurf, Zed: everywhere you work. No manual steps, no stale state anywhere.

egc watch              # watch current project
egc watch /path/proj   # watch a specific project
egc watch --quiet      # suppress output

Dashboard: watch your agents work

See every tool call, token, and cost your agents generate, live in your browser. Starts automatically after egc init. Full guide

Prompt library

As a bonus, EGC gives you access to 63 agents, 230 skills, and 77 commands, plus 111 rules: specialists that review your code on their own, best-practice guides for every language and situation, shortcuts that run a whole sequence of tasks for you, and style rules that keep your code consistent. All written from real engineering sessions, not theory. Don't want to use any of it? Fine: EGC's persistent memory works exactly the same.

🌐 English · العربية · Español · हिन्दी · 日本語 · 한국어 · Português (Brasil) · Русский

Support EGC

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

• Website: full docs, feature overview, and live demo
• 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.

Tool Partners

AI coding tools that integrate natively with EGC. Partners get logo placement across all READMEs and EGCSite.

Annual Sponsors · Be the first annual sponsor.

Backers

Monthly sponsors · be the first