EngramMCP Server

A coding agent forgets everything when the session ends. Engram is a memory store built to survive that boundary, and it is deliberately unglamorous about how: one Go binary, one SQLite file at ~/.engram/engram.db, full-text search through FTS5. No Node.js, no Python, no Docker, no server to keep running for the usual stdio setup.

A curated memory, not a transcript sink

The distinctive part is the operating contract the project asks agents to follow, which is what separates a useful memory from a log nobody can search. Orient first (mem_current_project, mem_context) to recover relevant history. Search before repeating a decision or bug you may already have solved. Retrieve progressively — mem_search for candidates, mem_timeline when surrounding context matters, mem_get_observation before relying on a full record. Save deliberately: completed fixes, decisions, discoveries, configuration changes and durable user constraints, never raw tool output or every conversational turn.

Evolving topics get a stable topic_key such as architecture/auth-model, so revisiting a subject updates one memory instead of accumulating competing ones — with mem_suggest_topic_key to pick a key when it is unclear. Sessions close with a mem_session_summary handoff, which doubles as the recovery path after context compaction.

Four interfaces, one store

MCP over stdio is the agent-facing path, and the same database is reachable through an HTTP API, a CLI and an interactive TUI — useful for reviewing what an agent has actually been remembering. mem_review, mem_judge and mem_compare exist for auditing stale knowledge and relationships between memories.

Local first, portable when needed

The local SQLite database is authoritative. Git Sync exports portable compressed chunks for moving memory between machines; Engram Cloud is an optional, project-scoped replication layer with browser visibility and shared access. Project-aware reads resolve to a canonical current project (explicit flag, then ENGRAM_PROJECT, then cwd detection), with --all reserved for an intentional global read.

engram setup <agent> writes the configuration for Claude Code, Pi, OpenCode, Gemini CLI, Codex, Antigravity CLI, Windsurf, Qwen Code, Kiro, Cursor, VS Code Copilot and Kilo Code. MIT licensed; installable via Homebrew.