GrayMatter v0.21.0
Persistent memory for AI agents. Local storage, CLI and MCP server.
Quick install
go install github.com/angelnicolasc/graymatter/cmd/graymatter@v0.21.0Prebuilt binaries for Linux, macOS and Windows are in the assets below,
with checksums.txt (sha256). Per-platform download commands are in the
README.
Agents can now keep a decision with its source and exact quote, then replace it
when the decision changes. Existing MCP clients start with the same seven tools.
See the three-session memory study for the comparison with an organized notes folder.
Added
- Citations and current values by subject. Start
graymatter mcp serve --tools coreto enable evidence-backed writes. Reusing a subject replaces its current fact in one transaction. Core search reads project and shared memory together and can retrieve an omitted citation by fact ID. The defaultfullprofile keeps the legacy write contract, so a successful text write in that profile can ignore citation and subject fields. MCP profile guide - Explicit review.
graymatter review analyzesends a bounded set of facts to the selected provider and records proposals in a separate journal. Inspect a proposal and usereview applyto approve a change. The store checks that the sources still match before recording a delayed response. - Maintenance reports.
graymatter consolidate <agent-id> --jsonreports committed decay and pruning counts and the outcome of graph maintenance. If the daemon loses its reply after dispatch, both text and JSON report an unknown outcome. Inspect the store before retrying. - Configurable provider endpoints. Set base URLs for Anthropic Messages, OpenAI embeddings and Voyage embeddings through Go configuration or environment variables. Explicit review and configured graph extraction follow the store owner's endpoint, including in daemon mode.
Changed
- Consolidation runs maintenance only. Decay, pruning and configured graph extraction continue. If you used automatic model-generated summaries, switch to explicit review. Existing summaries remain subject to the ordinary retention rules. Anthropic and Ollama summarizer settings remain accepted. Status distinguishes the current maintenance mode from historical summary counts.
- Checkpoint recovery and recall. The
fullprofile preserves the previous latest-checkpoint selection. The optionalcoreprofile skips markers that contain only hook metadata. Ordinary recall and prompt context use live facts, while eligible aliases support query expansion.
Fixed
- Atomic revisions. CLI, MCP and TUI revisions store the replacement and retire the selected sources in one transaction. A conflict leaves the revision unapplied, and daemon clients verify support before sending the write.
- Retention and maintenance. Pruning rechecks a fact's age and stored weight inside the transaction. Decay updates skip unchanged index entries, reducing contention with session-end checkpoints.
Security
- Release binaries use Go 1.26.11, which includes standard-library fixes for GO-2026-6809 and GO-2026-6859.
Upgrading from 0.20.1
- If you run an earlier version, upgrade to 0.20.1 first. Close clients using the store, run
graymatter daemon stopfor the relevant data directory, and copy its closedgray.dbto a separate location. Keep that copy for rollback. - Install 0.21.0, restart the MCP server and reconnect its clients. Existing launch commands use
full. Add--tools coreexplicitly for citations and subject-based writes. Restart a daemon that asks for an update before using new operations. - To roll back, stop the new clients and daemon. Remove any explicit
--toolsflag from the MCP launch command. Restore the pre-upgrade copy to a separate data directory and point 0.20.1 at it. Keep the upgraded store if you need to recover writes made after the backup.