GrayMatter

Durable memory and shared graph state for Codex and OpenClaw agents, with live ValkyrAI schema awareness.

valkyr-labs-inc/graymatter · v0.3.3+codex.20260909171430 · Development & Workflow

Valkyr Labs Inc.safe

Install Source Claim this plugin

Trust Score

78

Security

95

Surfaces

10

What is GrayMatter?

GrayMatter is a published development & workflow plugin for AI coding agents in the codex ecosystem, developed by Valkyr Labs Inc. and distributed through the HOL AI plugin registry. Durable memory and shared graph state for Codex and OpenClaw agents, with live ValkyrAI schema awareness.

Canonical slug: valkyr-labs-inc/graymatter
Version: v0.3.3+codex.20260909171430 · updated Oct 8, 2026
Open data: entity.json (JSON-LD)

Trust & Reputation

HOL Trust Score

78

Factor Analysis

Per-metric points (0–100 each) combined via a weighted average into the overall score.

Installability

100pts

Maintenance

55pts

MCP Posture

100pts

Plugin Security

95pts

Provenance

70pts

Publisher Quality

75pts

Registry Snapshot

Repository: https://github.com/ValkyrLabs/GrayMatter
Homepage: https://github.com/ValkyrLabs/GrayMatter
Canonical profile: https://hol.org/registry/plugins/valkyr-labs-inc%2Fgraymatter
Publisher verification: No
Marketplace source: Unknown
Scanner: Broker fallback
Safety label: safe
Digest verified: Yes

9 bundled skills — copy or download SKILL.mdOpen skills

Trust & reputation

Trust & Reputation

HOL Trust Score

78

Factor Analysis

Per-metric points (0–100 each) combined via a weighted average into the overall score.

Installability

100pts

Maintenance

55pts

MCP Posture

100pts

Plugin Security

95pts

Provenance

70pts

Publisher Quality

75pts

Provenance

Plugin root: .
Source repo: https://github.com/ValkyrLabs/GrayMatter
Source commit: b49761d14628…
Publisher verified: No
Owner verified: Not owner verified

Continuous scanner CI not detected

This plugin remains listed. Its overall trust score is reduced by 10% because security checks are not maintained in the source repository's CI.

Optional: maintain the scanner in the source repository's CI to receive the full trust score. Listing does not require that change.

Verified badge not detected

Add the HOL verified badge to the repository README to score +2% trust. Plugin owners can open that pull request from Guard Plugins.

Security Posture

safe

Safety label

95

Security score

0

High findings

Provider: registry-broker-fallback
Grade: A · safe
Version: Unknown

cisco-skill-scanner: unknown

Findings

lowoperational-securitysupply-chain.lockfile-missing

Repository snapshot does not include a lockfile.

infoskill-securityskill-scan.unavailable

Script permission declarations are required for scripts/: scripts/gm-auth.mjs, scripts/gm-install.mjs, scripts/gm-connection.mjs, scripts/graymatter_api.sh, scripts/package_graymatter.sh, scripts/gm-macos-signin.js, scripts/graymatter-prod-acceptance.sh, scripts/smoke-test-public-mcp.sh, scripts/gm-mcp-launcher.mjs

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

GrayMatter — Frequently asked questions

What is GrayMatter?: GrayMatter is an AI plugin in the HOL registry. Durable memory and shared graph state for Codex and OpenClaw agents, with live ValkyrAI schema awareness.
How do I install GrayMatter?: Install GrayMatter in your harness: Codex — codex plugin marketplace add ValkyrLabs/GrayMatter; Any agent — npx skills add ValkyrLabs/GrayMatter. Full step-by-step guidance is on the HOL plugin page.
How do I install GrayMatter in Codex?: To install GrayMatter in Codex, start with codex plugin marketplace add ValkyrLabs/GrayMatter. The complete step-by-step install guide for Codex is on the HOL plugin page.
Is GrayMatter free?: Pricing for GrayMatter is published on its HOL plugin page when the maker schedules a launch.
Who publishes GrayMatter?: GrayMatter is published by Valkyr Labs Inc. and listed on HOL.
Is GrayMatter available now?: GrayMatter availability is listed on its HOL plugin page.

Install Guidance

Install in Codex

Install through the Codex CLI plugin marketplace.

Codex plugin docs

1
Register the marketplace
Run in any terminal. Codex reads the marketplace entry from .agents/plugins/marketplace.json (or the legacy .claude-plugin path) in the repository. If the repository ships none, add the generated entry from the Advanced section below first.
shell
2
Install from the Plugins browser
Open Codex, open the Plugins browser, choose the GrayMatter marketplace, and install graymatter.
3
Verify the marketplace registration
shell

Plugin Manifest

{
  "name": "graymatter",
  "version": "0.3.3+codex.20260909171430",
  "description": "Persistent, secure memory and shared context for AI agents.",
  "author": {
    "name": "Valkyr Labs Inc.",
    "email": "[email protected]",
    "url": "https://valkyrlabs.com/"
  },
  "homepage": "https://github.com/ValkyrLabs/GrayMatter",
  "repository": "https://github.com/ValkyrLabs/GrayMatter",
  "license": "Proprietary",
  "keywords": [
    "graymatter",
    "secure-memory",
    "durable-memory",
    "shared-context",
    "mcp",
    "retrieval-receipts",
    "context-pages",
    "agent-memory",
    "graymatter-light",
    "valoride",
    "openclaw",
    "codex",
    "chatgpt"
  ],
  "skills": "./",
  "mcpServers": "./.registry/mcp.json",
  "apps": "./.app.json",
  "interface": {
    "displayName": "GrayMatter",
    "developerName": "Valkyr Labs Inc.",
    "shortDescription": "Persistent, secure memory and shared context for AI agents",
    "longDescription": "GrayMatter gives ChatGPT, Codex, ValorIDE, OpenClaw, and other MCP-compatible agents secure durable memory, bounded task-specific context, reusable procedures, retrieval receipts, a bundled mcp-server, and optional GrayMatter Light local mode while preserving api-0 authentication, RBAC, ACL, and tenant isolation.",
    "category": "Productivity",
    "capabilities": [
      "Interactive",
      "Read",
      "Write"
    ],
    "websiteURL": "https://valkyrlabs.com/",
    "privacyPolicyURL": "https://valkyrlabs.com/privacy-policy",
    "termsOfServiceURL": "https://valkyrlabs.com/terms",
    "composerIcon": "./assets/graymatter-logo.png",
    "logo": "./assets/graymatter-logo.png",
    "defaultPrompt": [
      "Search GrayMatter before asking me to repeat context.",
      "Compile task-specific context from GrayMatter.",
      "Save this durable decision in GrayMatter."
    ],
    "brandColor": "#245B4A"
  },
  "holManifestOrigin": "repository",
  "registryIndexVersion": 5
}

Marketplace Source

Repo URL: https://github.com/ValkyrLabs/GrayMatter
Marketplace path: Unknown
Source path: plugins/ValkyrLabs/GrayMatter
Install policy: AVAILABLE

Skills

9 SKILL.md files ship with this plugin. Preview, copy, or download each one, then install them with the Skills CLI.

skills-cli

graymatter-analytics
plugins/graymatter/skills/graymatter-analytics/SKILL.md
Use when GrayMatter should support analytics work by retrieving durable context, checking retrieval receipts, loading the live api-docs schema, and helping create user/workspace-specific semantic layers without assuming tenant business objects exist.
Raw SKILL.md
graymatter-context
plugins/graymatter/skills/graymatter-context/SKILL.md
Compile bounded, task-specific GrayMatter context and inspect authorized procedures or retrieval receipts. Use when a task needs grounded prior context, a reusable method, or an explanation of why particular memory was selected.
Raw SKILL.md
graymatter-memory
plugins/graymatter/skills/graymatter-memory/SKILL.md
Search, retrieve, save, revise, and forget secure durable GrayMatter memory. Use when a task may depend on prior decisions, preferences, todos, artifacts, or long-lived context, or when the user asks to remember, update, or forget information.
Raw SKILL.md
graymatter
plugins/graymatter/skills/graymatter/SKILL.md
Install and use GrayMatter as an OpenClaw skill that provides primary durable memory, shared object-graph state, and authenticated access to the live api-docs schema via api-0. Use when the agent should persist durable memory, inspect organizational data models, and operate inside the business domain through RBAC-scoped API access.
Raw SKILL.md
graymatter
SKILL.md
Install and use GrayMatter as an OpenClaw skill that provides primary durable memory, shared object-graph state, and authenticated access to the live api-docs schema via api-0. Use when the agent should persist durable memory, inspect organizational data models, and operate inside the business domain through RBAC-scoped API access.
Raw SKILL.md
graymatter-analytics
skills/graymatter-analytics/SKILL.md
Use when GrayMatter should support analytics work by retrieving durable context, checking retrieval receipts, loading the live api-docs schema, and helping create user/workspace-specific semantic layers without assuming tenant business objects exist.
Raw SKILL.md
graymatter-context
skills/graymatter-context/SKILL.md
Compile bounded, task-specific GrayMatter context and inspect authorized procedures or retrieval receipts. Use when a task needs grounded prior context, a reusable method, or an explanation of why particular memory was selected.
Raw SKILL.md
graymatter-memory
skills/graymatter-memory/SKILL.md
Search, retrieve, save, revise, and forget secure durable GrayMatter memory. Use when a task may depend on prior decisions, preferences, todos, artifacts, or long-lived context, or when the user asks to remember, update, or forget information.
Raw SKILL.md
graymatter
skills/graymatter/SKILL.md
Install and use GrayMatter as an OpenClaw skill that provides primary durable memory, shared object-graph state, and authenticated access to the live api-docs schema via api-0. Use when the agent should persist durable memory, inspect organizational data models, and operate inside the business domain through RBAC-scoped API access.
Raw SKILL.md

File Inventory

.agents/plugins/marketplace.json

file

370 bytes

d47fc35db4716a6c…

.app.json

file

102 bytes

08302f1c9916685a…

.codex-plugin/plugin.json

plugin-manifest

1,680 bytes

3dded7edba7be10e…

.github/ISSUE_TEMPLATE/bug.yml

file

953 bytes

249e7c0aa213f019…

.github/ISSUE_TEMPLATE/config.yml

file

349 bytes

53fa6c85cc044e62…

.github/workflows/graymatter-ci.yml

file

4,133 bytes

0e144f007767130b…

.github/workflows/publish-mcp-registry.yml

file

6,240 bytes

0b6478403a888690…

.github/workflows/signed-release.yml

file

3,306 bytes

01940a1ff8bad74b…

.mcp.json

file

134 bytes

0e57b2c6f92e7ee1…

.registry/mcp.json

mcp-config

97 bytes

a0d25542fa8bde6b…

.run-graymatter-local-server/graymatter-local-server/application-bundle/components/graymatter-dashboard.yaml

file

370 bytes

dfac0e1d29274a75…

.run-graymatter-local-server/graymatter-local-server/application-bundle/components/live-telemetry.yaml

file

334 bytes

5d069578ff55b288…

.run-graymatter-local-server/graymatter-local-server/application-bundle/components/memory-workbench.yaml

file

253 bytes

a3d883498eaace73…

.run-graymatter-local-server/graymatter-local-server/application-bundle/components/mothership-sync.yaml

file

392 bytes

216f46695bc327db…

.run-graymatter-local-server/graymatter-local-server/application-bundle/components/swarm-protocol.yaml

file

400 bytes

722420327b6f3fa1…

.run-graymatter-local-server/graymatter-local-server/application-bundle/openapi.json

file

13,224 bytes

f2151eff9b4c4ab5…

.run-graymatter-local-server/graymatter-local-server/application-bundle/template.json

file

1,153 bytes

4842c90d66a3af64…

.run-graymatter-local-server/graymatter-local-server/application-bundle/thorapi/graymatter-local.bundle.yaml

file

535 bytes

09dffe070d2694d6…

.run-graymatter-local-server/graymatter-local-server/application-bundle/valkyr-components/data-workbooks.yaml

file

169 bytes

024aa4b73cb046eb…

.run-graymatter-local-server/graymatter-local-server/application-bundle/valkyr-components/rbac-core.yaml

file

182 bytes

16db3c17ea698e83…

.run-graymatter-local-server/graymatter-local-server/application-bundle/workflows/graymatter-local-bootstrap.workflow.json

file

1,088 bytes

39b77a5d2bc544eb…

.run-graymatter-local-server/graymatter-local-server/manifest.json

file

787 bytes

2930f65d8567abc8…

.run-graymatter-local-server/graymatter-local-server/README.md

file

1,820 bytes

d8c40d7e1b1d7c8b…

.run-graymatter-local-server/graymatter-local-server/source/manifest.json

file

787 bytes

2930f65d8567abc8…

.run-graymatter-local-server/graymatter-local-server/source/README.md

file

1,820 bytes

d8c40d7e1b1d7c8b…

.run-graymatter-local-server/graymatter-local-server/source/src/main/resources/static/index.html

file

25,589 bytes

af215df9fac34c4e…

AGENTS.md

file

1,049 bytes

e12b21f2f7d90d89…

assets/composer-icon.svg

asset

343 bytes

1ac8633296be4c62…

assets/graymatter-logo.png

asset

1,860 bytes

6be9a9699daa8708…

assets/logo.svg

asset

685 bytes

94c9a3066510cb07…

assets/screenshot.svg

asset

2,298 bytes

92aa65378c1a0027…

benchmarks/fixtures/valkyr-workflow-kyc.json

file

4,185 bytes

b9cd0fdeb9a1dee0…

benchmarks/README.md

file

1,585 bytes

ad5804a4788cfa17…

benchmarks/run-memory-benchmarks.mjs

file

22,765 bytes

27fe00a65c4c0c57…

clawhub.json

file

1,092 bytes

a1ee7c5458f073c1…

CODE_OF_CONDUCT.md

file

541 bytes

5d901499aaf960ee…

CONTRIBUTING.md

file

1,291 bytes

b9531e3d1451d0b9…

deploy/docker-compose.lite.yml

file

1,289 bytes

0c056b6cd0e1ed14…

docs/agent-discovery.md

file

5,656 bytes

2f3e1900fd136b40…

docs/agent-memory-reliability-contract.md

file

2,020 bytes

1d67451032629482…

docs/architecture.md

file

4,803 bytes

b55607b6bb21c1b2…

docs/awesome-codex-plugins.md

file

154 bytes

4fc81ff9d61a9c0b…

docs/blended-profile-security.md

file

11,180 bytes

86972b250ee16987…

docs/contribution-evidence.md

file

5,470 bytes

3f517b80e3555663…

docs/graymatter-light.md

file

497 bytes

0c34d4c7ca2823bb…

docs/graymatter-lite.md

file

10,076 bytes

336c71a26b9fd0ed…

docs/knowledge-packs.md

file

9,260 bytes

0b9ef1373c10fd7b…

docs/local-models.md

file

4,651 bytes

0e1ac5f2c6d33bc5…

docs/mcp-registry.md

file

3,703 bytes

ab82726cd22e1b5d…

docs/omegarag-prd-inventory.md

file

1,737 bytes

4cb4806a857c2e39…

docs/omegarag-release-evidence.md

file

12,150 bytes

fe4f2bec2f8c8e73…

docs/openai-app-directory-submission.md

file

3,054 bytes

1696756b5aa7ca6e…

docs/phased-rollout-plan.md

file

4,503 bytes

c85c5996cc706b5b…

docs/prd-context-compaction-reset.md

file

11,083 bytes

0444981bb2d4f6e1…

docs/prd-graymatter-omegarag.md

file

91,425 bytes

15b1f70f4bf6b7d0…

docs/prd-graymatter-suite-hardening.md

file

23,753 bytes

e9ba491416ef317e…

docs/privacy-policy.md

file

3,780 bytes

3deb57e58492aa40…

docs/private-procedure-execution-plan.md

file

9,462 bytes

ff02081ce0d46f2f…

docs/private-procedure-execution.md

file

8,872 bytes

63d4123570b9f3a1…

docs/reviewer-test-credentials.md

file

7,653 bytes

ae7037391c000c2f…

docs/schema-regeneration.md

file

7,056 bytes

a4e32f2e6b935cd0…

docs/server-capabilities.md

file

7,355 bytes

c15024786728f618…

docs/thorapi-integration.md

file

3,179 bytes

39300af05ea54030…

examples/graymatter-light-memoryentry.yaml

file

1,399 bytes

0ab8c74d4c05bca7…

examples/graymatter-light-thorapi-bundle.yaml

file

2,192 bytes

9f78fc56bebee0fa…

examples/memoryentry-artifact.json

file

159 bytes

98bcf42f2fa67d0f…

examples/memoryentry-basic.json

file

135 bytes

bad3898efa1b379d…

examples/memoryentry-decision.json

file

161 bytes

35045f7978748475…

examples/memoryentry-todo.json

file

161 bytes

32f48d60b54283bd…

examples/swarm-workflow-execution-receipt.v1.json

file

2,133 bytes

d072260c78614377…

install.sh

file

420 bytes

1df1cf76e57d55e0…

mcp-server/index.js

file

233,507 bytes

088f16760c5f3e67…

mcp-server/lib/contribution-report.cjs

file

5,595 bytes

ffa096ec85539a31…

mcp-server/lib/memory-scan.cjs

file

6,637 bytes

8f0320853c407cc6…

mcp-server/lib/procedure-discovery.cjs

file

6,561 bytes

a7621af5e64fc149…

mcp-server/lib/procedure-execution.cjs

file

9,502 bytes

21dc21becca4e46d…

mcp-server/lib/procedure-inspection.cjs

file

4,095 bytes

d1695a990b363fb9…

mcp-server/package.json

file

408 bytes

fa7c6eacebde79d6…

mcp-server/README.md

file

22,486 bytes

2c7bbd303beae5bf…

mcp-server/scripts/verify-public-no-call-guidance.cjs

file

5,648 bytes

085eb4f991c49e4d…

mcp-server/test/auth-installer.test.js

file

12,069 bytes

3f182b34a8c21b3a…

mcp-server/test/composition-boundaries.test.js

file

5,095 bytes

468661ebed6e9156…

mcp-server/test/contribution-report.test.js

file

2,611 bytes

9e6263f519ab6d18…

mcp-server/test/local-onboarding.test.js

file

20,879 bytes

6c0c5342ab77ff65…

mcp-server/test/memory-scan.test.js

file

6,063 bytes

5819577eba95ee2b…

mcp-server/test/procedure-discovery.test.js

file

10,519 bytes

917f57fd3ba8b2a8…

mcp-server/test/procedure-execution.test.js

file

13,728 bytes

9714c2c08c4f91a7…

mcp-server/test/procedure-inspection.test.js

file

9,031 bytes

db3d2b619dea036d…

mcp-server/test/procedure-run-continuity.test.js

file

3,123 bytes

0d9f1c8b0195706a…

mcp-server/test/public-app.test.js

file

23,888 bytes

3456a765bd38fde8…

mcp-server/test/public-smoke-script.test.js

file

4,610 bytes

f9a67747fdbb0237…

mcp-server/test/receipt-inspection.test.js

file

3,940 bytes

5f7d0d37e2c1b18c…

mcp-server/test/recovery.test.js

file

22,587 bytes

ac25f5c620996c2e…

mcp-server/test/server.test.js

file

101,188 bytes

633c93b5fbd97e27…

mcp-server/test/submitted-reviewer-cases.test.js

file

17,540 bytes

c4324df18264bcdf…

openai-app/submission-manifest.json

file

1,236 bytes

5ac36b316413e67c…

openapi/bundles/00-graymatter-core.yaml

file

33,434 bytes

6146e920662a256a…

openapi/extensions/customer-support.yaml

file

1,442 bytes

7ab7b2fb4ff3deba…

openapi/generator/spring.yaml

file

731 bytes

f2c95cc008763280…

plugins/graymatter/.app.json

file

102 bytes

08302f1c9916685a…

Browse all 322 files