graymatter — Claude Code skill: what it does, how to install
graymatter connects durable memory and live api-0 schemas with RBAC boundaries. Keeps agent sessions aligned with persistent organizational constraints.
AGPL-3.0 ★ 1,596 updated 2026-10-29
npx skills add hashgraph-online/awesome-codex-plugins --skill graymatter -a claude-codeWhat graymatter does
GrayMatter turns api-0 into the single durable memory layer for the coding agent. Instead of keeping scattered notes across local workspace files, the tool commits decisions, preferences, and tasks to an authenticated graph. Local storage serves strictly as a temporary scratchpad. Once the connection returns, records replay upstream and local duplicates clear out.
A mandatory preflight routine runs before touching any codebase. The agent executes scripts/gm-invariant-preflight to cross-check planned edits against stored architectural rules. If a task violates a recorded rule, execution halts. External tool outputs and web fetches cannot override these core policies.
Authentication relies on the operating system credential store. On Linux, missing Secret Service forces a fallback to masked terminal prompts.
What it helps with
- persist project decisions and tasks into durable
api-0storage - enforce architectural rules before applying code edits
- replay deferred local queue entries once connection restores
- inspect live business schemas directly from
/v1/api-docs
Example prompts for the agent
- Run invariant checks for the project using
scripts/gm-startup-preflight --workspace-key backend - Store the new authorization rule in
api-0with an invariant tag - Check available operational entities against
/v1/api-docs
How to install graymatter
1Skills CLI (Vercel)
npx skills add hashgraph-online/awesome-codex-plugins --skill graymatter -a claude-code2Manually: put the files in place
~/.claude/skills/GrayMatter/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/GrayMatter/
1Skills CLI (Vercel)
npx skills add hashgraph-online/awesome-codex-plugins --skill graymatter -a codex2Manually: put the files in place
.agents/skills/GrayMatter/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add hashgraph-online/awesome-codex-plugins --skill graymatter -a cursor2Manually: put the files in place
.cursor/skills/GrayMatter/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install hashgraph-online/awesome-codex-plugins plugins/ValkyrLabs/GrayMatter2Manually: put the files in place
.github/skills/GrayMatter/SKILL.md1Skills CLI (Vercel)
npx skills add hashgraph-online/awesome-codex-plugins --skill graymatter -a gemini-cli2Platform CLI
gemini skills install https://github.com/hashgraph-online/awesome-codex-plugins --path plugins/ValkyrLabs/GrayMatterManually: put the files in place
.devin/skills/GrayMatter/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about graymatter
How to install graymatter in Claude Code?
Run npx skills add hashgraph-online/awesome-codex-plugins --skill GrayMatter -a claude-code in your terminal. The configuration is written to ~/.claude/skills/GrayMatter/SKILL.md.
What is the main purpose of graymatter?
It provides long-lived memory and live schema access over api-0. Agents read architectural constraints directly from the graph instead of relearning project rules every session.
How does graymatter handle network outages?
It queues changes locally in degraded mode. When connectivity or authorization returns, records sync upstream to api-0 and the local files are deleted.