Skip to main content

Activation Fastlane

The GrayMatter activation fastlane is the default first-run path for reviewers, operators, and customer setup flows. It runs hosted readiness checks, demonstrates the core memory path, and writes a machine-readable result artifact.

Agentic Install Path​

For Codex, OpenClaw, ValorIDE, Claude adapters, and other agent hosts, the expected setup is:

git clone https://github.com/ValkyrLabs/GrayMatter.git
cd GrayMatter
test -x scripts/gm-activate || ./graymatter-bootstrap
scripts/gm-activate
scripts/gm-doctor --quick

What should happen:

  1. The install restores bundled runtime files if a sparse/plugin install is missing scripts.
  2. gm-activate checks for updates, authenticates through api-0, stores the reusable session in the OS keychain when available, registers the agent, syncs OpenAPI, and validates memory.
  3. gm-doctor --quick confirms auth, memory, graph, strategic, KPI, OpenAPI, MCP, and deferred replay readiness without running the credit-consuming smoke query.

Use the full doctor when you want live write/query proof:

scripts/gm-doctor

From a ValkyrAI workspace that has GrayMatter installed beside it or in the Codex plugin cache, use:

scripts/graymatter-doctor.sh --quick

Run It​

scripts/graymatter-activation-fastlane.sh

The fastlane checks:

  • hosted service health
  • authentication readiness
  • descriptor availability
  • schema visibility
  • reviewer-safe demo behavior

It writes results to:

artifacts/graymatter-activation-fastlane/result.json

Use This For​

  • customer onboarding validation
  • internal release review
  • hosted environment smoke tests
  • demo readiness checks

Break-Glass Mode​

Raw bearer token handling is supported only for debug or break-glass usage. Normal first-run setup should use the standard login/session flow so users do not pass tokens around manually.

CI Check​

scripts/test-graymatter-activation-fastlane.sh

Related: