Retrieve and summarize Ryzome canvases and documents as structured AI context, enabling agents to externalize working memory by searching for relevant content via title, tags, or description and returning markdown with metadata and URLs.
This plugin requires configuration values that are prompted when the plugin is enabled. Sensitive values are stored in your system keychain.
api_keyYour Ryzome API key. Get one at https://ryzome.ai/workspace#settings/api-keys
${user_config.api_key}Ryzome lets AI agents externalize their working context (plans, research, reasoning) as interactive canvases. Users can inspect the agent's state, correct it, and hand the corrected graph back for the agent to continue from.
This monorepo provides Ryzome canvas tools for AI agents across multiple integration surfaces.
| Package | Description | Registry |
|---|---|---|
@ryzome-ai/ryzome-core | Shared logic: API client, 11 tools, graph builder, layout | |
@ryzome-ai/ryzome-mcp | MCP server with tools + resources for Claude Code and other MCP clients | |
@ryzome-ai/openclaw-ryzome | OpenClaw plugin adapter | |
hermes-ryzome-plugin | Hermes Agent plugin (Python package, bundles a Node runner over ryzome-core) | |
@ryzome-ai/ryzome-claude-plugin | Claude Code plugin with skills, agents, and hooks |
ryzome-claude-plugin (Claude Code plugin)
└── ryzome-mcp (MCP server)
└── ryzome-core (shared logic)
openclaw-ryzome (OpenClaw plugin)
└── ryzome-core (shared logic)
hermes-ryzome (Hermes plugin)
├── Python Hermes plugin surface
└── ryzome-core (shared logic via Node runner)
ryzome-core contains the API client, 11 tools, graph builder, layout engine, and markdown formatter. The MCP server, OpenClaw plugin, and Hermes plugin all reuse that shared tool implementation.
@ryzome-ai/ryzome-claude-plugin for one-command install@ryzome-ai/ryzome-mcp for npx quick start@ryzome-ai/openclaw-ryzome for plugin installpackages/hermes-ryzome into ~/.hermes/plugins/ryzome, then run hermes ryzome setup --key rz_...@ryzome-ai/ryzome-core for the shared libraryFor a local rollout from this repository:
pnpm build
ln -s "$PWD/packages/hermes-ryzome" ~/.hermes/plugins/ryzome
hermes ryzome setup --key rz_...
The Python wheel bundles the Node runner (_runner.js) alongside the plugin, so public installs only need Node.js on PATH. To override the runner command, set RYZOME_HERMES_RUNNER.
pnpm install # Install all dependencies
pnpm build # Build all packages
pnpm test # Run unit tests across all packages
pnpm typecheck # tsc --noEmit in each package
pnpm lint # Biome lint + typecheck
pnpm format # Biome format --write
pnpm --filter @ryzome-ai/ryzome-core test
pnpm --filter @ryzome-ai/ryzome-mcp test
pnpm --filter @ryzome-ai/ryzome-core test -- --testPathPattern=layout
This repo uses Changesets for versioning and publishing. Each package is versioned independently.
pnpm changeset to describe what changed and which packages are affectedDev snapshots are published on every push to main under the dev tag.
The Hermes plugin is a Python package published to PyPI as hermes-ryzome-plugin via the manual Publish Hermes Python Plugin workflow. The wheel bundles the compiled Node runner produced by pnpm --filter @ryzome-ai/hermes-ryzome build, so it is not published to npm. Changesets still version-bumps it so the package.json / pyproject.toml / plugin.yaml versions stay in sync.
MIT
Requires secrets
Needs API keys or credentials to function
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
npx claudepluginhub 0xplaygrounds/ryzome-mcp-plugins --plugin claude-ryzomeUltra-compressed communication mode. Cuts ~75% of tokens while keeping full technical accuracy by speaking like a caveman.
Memory compression system for Claude Code - persist context across sessions
Multi-model consensus engine integrating OpenAI Codex CLI, Gemini CLI, and Claude CLI for collaborative code review and problem-solving.
Curate auto-memory, promote learnings to CLAUDE.md and rules, extract proven patterns into reusable skills.