Skip to main content
plugin CX Codex

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

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install graymatter@awesome-codex-plugins
Open on GitHub

What 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 .gmkp packages

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 .gmkp pack

How to install graymatter

Plugin marketplace

/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install graymatter@awesome-codex-plugins

Step 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.

Similar plugins

All plugins for Agent setup: memory, context, orchestration →

From the same set391

The whole set →

Project sponsors

Companies that keep this analytics open