io.github.NickCirv/engram
Ranked local code-graph context for AI coding agents. Intercepts reads + greps. Apache-2.0.
io.github.NickCirv/engram · Repository · version 4.5.0 · 139 stars · listed from registry
Install
The sweep installs into a clean prefix, but this is the command a user would run:
npx engramx
Results by platform
Linux
MCP handshake failed2026-08-16 · probed over npm1 recorded run, oldest first.
handshake failed: MCP error -32000: Connection closed --- stderr (tail) --- … graph path [options] <source> <target> Find shortest path between two concepts gods [options] Show most connected entities (god nodes) callers [options] <symbol> List files that call a symbol (over the reference graph) callees [options] <symbol> List definitions that a symbol's file calls impact [options] <symbol> Show files transitively affected if you change a symbol stats [options] Show knowledge graph statistics and context reduction learn [options] <text> Teach engram a decision, pattern, or lesson mistakes [options] List known mistakes extracted from past sessions measure [options] Honest structural context-token reduction on YOUR repo (auto-discovers top symbols) bench [options] Run token reduction benchmark upgrade [options] Smooth upgrade path for v3.x users — runs schema migrations and shows what's new mesh Federation (v4.0): identity, peers, audit cost [options] Show token-savings telemetry from engram hook logs hooks Manage git hooks gen [options] Generate CLAUDE.md + AGENTS.md (default) or a single file via --target gen-mdc [options] Generate .cursor/rules/engram-context.mdc from knowledge graph gen-ccs [options] Export knowledge graph as .context/index.md (CCS format) gen-aider [options] Generate .aider-context.md from knowledge graph gen-windsurfrules [options] Generate .windsurfrules from knowledge graph (Windsurf IDE) intercept Hook entry point. Reads JSON from stdin, writes response JSON to stdout. Called by Claude Code. cursor-intercept Cursor beforeReadFile hook entry point (experimental). Reads JSON from stdin, writes Cursor-shaped response JSON to stdout. install-hook [options] Install engram hook entries into Claude Code settings uninstall-hook|repair-hooks [options] Remove engram hook entries from Claude Code settings (also: 'repair-hooks' — same thing, named for users who ended up with orphaned hooks after npm uninstall) hook-stats [options] Summarize hook-log.jsonl for a project hook-preview [options] <file> Show what the Read handler would do for a file (dry-run) hook-disable [options] Disable engram hooks via kill switch (does not uninstall) hook-enable [options] Re-enable engram hooks (remove kill switch flag) memory-sync [options] Write engram's structural facts into MEMORY.md (complementary to Anthropic Auto-Dream) stress-test [options] Run stress tests: memory, concurrency, large-graph, hook-log replay server [options] Start engram HTTP REST server (binds to 127.0.0.1 only) ui [options] Open the web dashboard (auto-starts HTTP server if needed) context-server Start Zed-compatible context server (JSON-RPC over stdio) tune [options] Analyze hook-log and propose provider config changes db Database management plugin Manage context provider plugins cache Inspect and manage the context cache update [options] Check for and install the latest engram release doctor [options] Component health report with remediation hints setup [options] Zero-friction first-run wizard (init + install-hook + doctor) help [command] display help for command
macOS
MCP handshake failed2026-08-16 · probed over npm1 recorded run, oldest first.
handshake failed: MCP error -32000: Connection closed --- stderr (tail) --- … graph path [options] <source> <target> Find shortest path between two concepts gods [options] Show most connected entities (god nodes) callers [options] <symbol> List files that call a symbol (over the reference graph) callees [options] <symbol> List definitions that a symbol's file calls impact [options] <symbol> Show files transitively affected if you change a symbol stats [options] Show knowledge graph statistics and context reduction learn [options] <text> Teach engram a decision, pattern, or lesson mistakes [options] List known mistakes extracted from past sessions measure [options] Honest structural context-token reduction on YOUR repo (auto-discovers top symbols) bench [options] Run token reduction benchmark upgrade [options] Smooth upgrade path for v3.x users — runs schema migrations and shows what's new mesh Federation (v4.0): identity, peers, audit cost [options] Show token-savings telemetry from engram hook logs hooks Manage git hooks gen [options] Generate CLAUDE.md + AGENTS.md (default) or a single file via --target gen-mdc [options] Generate .cursor/rules/engram-context.mdc from knowledge graph gen-ccs [options] Export knowledge graph as .context/index.md (CCS format) gen-aider [options] Generate .aider-context.md from knowledge graph gen-windsurfrules [options] Generate .windsurfrules from knowledge graph (Windsurf IDE) intercept Hook entry point. Reads JSON from stdin, writes response JSON to stdout. Called by Claude Code. cursor-intercept Cursor beforeReadFile hook entry point (experimental). Reads JSON from stdin, writes Cursor-shaped response JSON to stdout. install-hook [options] Install engram hook entries into Claude Code settings uninstall-hook|repair-hooks [options] Remove engram hook entries from Claude Code settings (also: 'repair-hooks' — same thing, named for users who ended up with orphaned hooks after npm uninstall) hook-stats [options] Summarize hook-log.jsonl for a project hook-preview [options] <file> Show what the Read handler would do for a file (dry-run) hook-disable [options] Disable engram hooks via kill switch (does not uninstall) hook-enable [options] Re-enable engram hooks (remove kill switch flag) memory-sync [options] Write engram's structural facts into MEMORY.md (complementary to Anthropic Auto-Dream) stress-test [options] Run stress tests: memory, concurrency, large-graph, hook-log replay server [options] Start engram HTTP REST server (binds to 127.0.0.1 only) ui [options] Open the web dashboard (auto-starts HTTP server if needed) context-server Start Zed-compatible context server (JSON-RPC over stdio) tune [options] Analyze hook-log and propose provider config changes db Database management plugin Manage context provider plugins cache Inspect and manage the context cache update [options] Check for and install the latest engram release doctor [options] Component health report with remediation hints setup [options] Zero-friction first-run wizard (init + install-hook + doctor) help [command] display help for command
Windows
MCP handshake failed2026-08-16 · probed over npm1 recorded run, oldest first.
handshake failed: MCP error -32000: Connection closed --- stderr (tail) --- … graph path [options] <source> <target> Find shortest path between two concepts gods [options] Show most connected entities (god nodes) callers [options] <symbol> List files that call a symbol (over the reference graph) callees [options] <symbol> List definitions that a symbol's file calls impact [options] <symbol> Show files transitively affected if you change a symbol stats [options] Show knowledge graph statistics and context reduction learn [options] <text> Teach engram a decision, pattern, or lesson mistakes [options] List known mistakes extracted from past sessions measure [options] Honest structural context-token reduction on YOUR repo (auto-discovers top symbols) bench [options] Run token reduction benchmark upgrade [options] Smooth upgrade path for v3.x users — runs schema migrations and shows what's new mesh Federation (v4.0): identity, peers, audit cost [options] Show token-savings telemetry from engram hook logs hooks Manage git hooks gen [options] Generate CLAUDE.md + AGENTS.md (default) or a single file via --target gen-mdc [options] Generate .cursor/rules/engram-context.mdc from knowledge graph gen-ccs [options] Export knowledge graph as .context/index.md (CCS format) gen-aider [options] Generate .aider-context.md from knowledge graph gen-windsurfrules [options] Generate .windsurfrules from knowledge graph (Windsurf IDE) intercept Hook entry point. Reads JSON from stdin, writes response JSON to stdout. Called by Claude Code. cursor-intercept Cursor beforeReadFile hook entry point (experimental). Reads JSON from stdin, writes Cursor-shaped response JSON to stdout. install-hook [options] Install engram hook entries into Claude Code settings uninstall-hook|repair-hooks [options] Remove engram hook entries from Claude Code settings (also: 'repair-hooks' — same thing, named for users who ended up with orphaned hooks after npm uninstall) hook-stats [options] Summarize hook-log.jsonl for a project hook-preview [options] <file> Show what the Read handler would do for a file (dry-run) hook-disable [options] Disable engram hooks via kill switch (does not uninstall) hook-enable [options] Re-enable engram hooks (remove kill switch flag) memory-sync [options] Write engram's structural facts into MEMORY.md (complementary to Anthropic Auto-Dream) stress-test [options] Run stress tests: memory, concurrency, large-graph, hook-log replay server [options] Start engram HTTP REST server (binds to 127.0.0.1 only) ui [options] Open the web dashboard (auto-starts HTTP server if needed) context-server Start Zed-compatible context server (JSON-RPC over stdio) tune [options] Analyze hook-log and propose provider config changes db Database management plugin Manage context provider plugins cache Inspect and manage the context cache update [options] Check for and install the latest engram release doctor [options] Component health report with remediation hints setup [options] Zero-friction first-run wizard (init + install-hook + doctor) help [command] display help for command
Badge
Paste this into the project README to show the current result:
[](https://doesitinstall.com/s/io.github.nickcirv__engram.html)