Audience: xAI evaluators, new plugin users
Plugin: engram-geometric
Contract: 8-tool lean path only
git clone https://github.com/staticroostermedia-arch/engram.git
cd engram
./scripts/install-engram-plugin.shOpen a new Grok Build session on the Engram repo (or any project with the plugin trusted).
Ask the agent (or run tools):
/engram-wake
Then:
-
mcp_engram_remember- concept:
demo:marketplace_user_goal - text: "Ship engram-geometric as the best Grok Build memory plugin."
- concept:
-
mcp_engram_quick_trace- decision: "Use 8-tool lean contract for marketplace listing"
- why: "Proves continuity without ritual tax on 180k+ stores"
-
mcp_engram_session_end- summary: "Demo session 1: remembered demo goal, traced marketplace decision. Next wake should rehydrate handoff."
- prepare_compression: true
Expected: Structured handoff packet in response; helper:session_handoff_latest updated.
Open a new Grok chat (same machine, plugin still trusted).
/engram-wake
Expected without user paste:
- Agent states continuation from prior session
continuation_bundleincludes handoff previewmcp_engram_recall("marketplace demo", scope="anchors")surfacesdemo:marketplace_user_goal
Optional edit demo:
mcp_engram_context_for_edit(path="/absolute/path/to/README.md")
Expected: File-scoped spatial + related traces (no watch_workspace).
./scripts/engram-mcp-health.shWhile a Grok session is open: OK: Live engram MCP already running — not a failure.
Do not use grok mcp doctor during an active session (lock contention).
STABLE_BIN=target/debug/engram tools/test-harness/bin/engram-harness.sh --suite agent-memoryMust exit 0 with passed: true and helper:session_handoff_latest present.
Not flat markdown memory — geometric blocks with CRS trust, edit-scoped code context, and machine-readable session handoff.