# graymatter

graymatter connects durable memory and live api-0 schemas with RBAC boundaries. Keeps agent sessions aligned with persistent organizational constraints.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 1596 repo stars
- Author: Valkyr Labs Inc.
- License: AGPL-3.0 · 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/SKILL.md
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/graymatter

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

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add hashgraph-online/awesome-codex-plugins --skill graymatter -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/GrayMatter/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/GrayMatter/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add hashgraph-online/awesome-codex-plugins --skill graymatter -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/GrayMatter/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add hashgraph-online/awesome-codex-plugins --skill graymatter -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/GrayMatter/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install hashgraph-online/awesome-codex-plugins plugins/ValkyrLabs/GrayMatter
```

2. **Manually: put the files in place**
- File: `.github/skills/GrayMatter/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add hashgraph-online/awesome-codex-plugins --skill graymatter -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/hashgraph-online/awesome-codex-plugins --path plugins/ValkyrLabs/GrayMatter
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/GrayMatter/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/hashgraph-online/awesome-codex-plugins/tree/HEAD/plugins/ValkyrLabs/GrayMatter/SKILL.md

## When to use it
- persist project decisions and tasks into durable `api-0` storage
- 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
- Run invariant checks for the project using `scripts/gm-startup-preflight --workspace-key backend`
- Store the new authorization rule in `api-0` with an invariant tag
- Check available operational entities against `/v1/api-docs`

## Similar
- [neo4j-security-skill](https://affpapa.org/en/nevibecode/skills/neo4j-security-skill.md) — skill · 874 installs
- [Qdrant RBAC](https://affpapa.org/en/nevibecode/mcp/qdrant-rbac.md) — MCP server
- [vtex-io-rbac](https://affpapa.org/en/nevibecode/skills/vtex-io-rbac.md) — skill · 816 installs
- [access-control-rbac](https://affpapa.org/en/nevibecode/skills/access-control-rbac.md) — skill · 769 installs
- [MCP Gateway](https://affpapa.org/en/nevibecode/mcp/panossalt-mcp-gateway.md) — MCP server · ★ 6 repo stars
- [clerk-orgs](https://affpapa.org/en/nevibecode/skills/clerk-orgs.md) — skill · 53900 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
