graymatter — Claude Code plugin: what it does, how to install
graymatter supplies persistent memory and shared graph context for Claude Code and Codex agents over MCP.
LicenseRef-Proprietary ★ 1,596 updated 2026-10-29
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install graymatter@awesome-codex-pluginsWhat graymatter does
The plugin bridges coding agents with GrayMatter memory backends, supporting both hosted ValkyrAI infrastructure and a self-hosted GrayMatter Lite deployment backed by embedded H2 storage. It handles durable memory entries, hybrid search, retrieval receipts, and citation tracking.
Running Lite locally exposes an HTTP MCP server on port 3333 and an embedded dashboard on port 8787. Building from source with ./vaix setup expects Java 17+, Maven, and Node 20+, though Docker Compose configuration is also provided. Context collections can be packaged and shared as signed .gmkp files.
Blended multi-profile retrieval operates strictly in read-only mode, so data mutations fail by design until an explicit target profile is picked.
What it helps with
- retain project context across separate coding sessions
- serve indexed knowledge to agents via local MCP endpoints
- prevent data leaks by keeping memory inside a local H2 store
- share curated context bundles using portable
.gmkppackages
Example prompts for the agent
- Search GrayMatter memory for the release checklist agreed on earlier
- Store this database migration convention into persistent memory
- Export the current workspace memory into a
.gmkppack
How to install graymatter
Plugin marketplace
/plugin marketplace add hashgraph-online/awesome-codex-plugins/plugin install graymatter@awesome-codex-pluginsStep by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own
Questions about graymatter
How to install graymatter in Claude Code?
Register the marketplace repository with /plugin marketplace add hashgraph-online/awesome-codex-plugins, then run /plugin install graymatter@awesome-codex-plugins.
What does graymatter do?
It gives AI agents persistent memory, structured retrieval receipts, and knowledge-pack management through standard MCP endpoints.
Can graymatter run completely offline?
Yes, GrayMatter Lite runs locally using an embedded H2 database, which can be booted via ./vaix setup or using the provided Docker Compose file without registering an external account.