Quick start

GrayMatter is a single ~10 MB static binary. Install it, run init, restart your editor — done.

Install

Homebrew (macOS / Linux)

brew install angelnicolasc/tap/graymatter

Scoop (Windows)

scoop bucket add angelnicolasc https://github.com/angelnicolasc/scoop-bucket
scoop install graymatter

Go

go install github.com/angelnicolasc/graymatter/cmd/graymatter@latest

Binary

Pre-built binaries for Linux, macOS, and Windows are on the releases page.

# Linux (x86_64)
curl -sSL https://github.com/angelnicolasc/graymatter/releases/download/v0.13.1/graymatter_0.13.1_linux_amd64.tar.gz | tar -xz && sudo mv graymatter /usr/local/bin/

Wire and verify

1. Wire every supported MCP client at once:

   graymatter init

   This creates .graymatter/, writes the MCP config for each detected client, and adds a memory block to CLAUDE.md / AGENTS.md. Existing MCP entries from other servers are merged, never overwritten.

2. Verify:

   graymatter doctor

3. Restart your editor. Five memory tools are live: memory_search, memory_add, checkpoint_save, checkpoint_resume, and memory_reflect.

Optional: knowledge graph from day one

graymatter init --kg

Persists knowledge-graph activation so every future daemon builds the graph automatically. See Knowledge graph.

Next steps

• MCP clients — per-client config files and manual wiring
• Agent guide — how agents should use the five tools
• Benchmarks — where the 90% number comes from