# graymatter

graymatter supplies persistent memory and shared graph context for Claude Code and Codex agents over MCP.

- plugin · `type=plugin` · Claude Code, Codex · ★ 1596 repo stars
- Author: Valkyr Labs Inc.
- License: LicenseRef-Proprietary · policy=link-only · description only; the file stays with the author
- Source: https://github.com/hashgraph-online/awesome-codex-plugins/tree/HEAD/plugins/ValkyrLabs/GrayMatter
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text and 3 script files) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/plugins/graymatter

## What it 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.

## Install

### Claude Code (native platform)

**Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add hashgraph-online/awesome-codex-plugins
```
In the agent chat (not a shell):
```text
/plugin install graymatter@awesome-codex-plugins
```

## When to use it
- 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
- 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

## Similar
- [compile-knowledge](https://affpapa.org/en/nevibecode/skills/compile-knowledge.md) — skill · 3300 installs
- [hermes-history-ingest](https://affpapa.org/en/nevibecode/skills/hermes-history-ingest.md) — skill · 2500 installs
- [openclaw-history-ingest](https://affpapa.org/en/nevibecode/skills/openclaw-history-ingest.md) — skill · 2200 installs
- [distill-memory](https://affpapa.org/en/nevibecode/skills/distill-memory.md) — skill · 743 installs
- [wiki](https://affpapa.org/en/nevibecode/skills/yeachan-heo-wiki.md) — skill · 685 installs
- [story-memory](https://affpapa.org/en/nevibecode/skills/story-memory.md) — skill · 606 installs

From the same set: [hashgraph-online/awesome-codex-plugins](https://affpapa.org/en/nevibecode/by/hashgraph-online/awesome-codex-plugins.md) — 391 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
