claude-ryzome

Ryzome MCP Plugins

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.

Packages

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

Architecture

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.

Getting Started

• Claude Code users: See @ryzome-ai/ryzome-claude-plugin for one-command install
• MCP client users: See @ryzome-ai/ryzome-mcp for npx quick start
• OpenClaw users: See @ryzome-ai/openclaw-ryzome for plugin install
• Hermes users: Build this repo, link packages/hermes-ryzome into ~/.hermes/plugins/ryzome, then run hermes ryzome setup --key rz_...
• Building integrations: See @ryzome-ai/ryzome-core for the shared library

Hermes Plugin

For 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.

Development

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

Per-package commands

pnpm --filter @ryzome-ai/ryzome-core test
pnpm --filter @ryzome-ai/ryzome-mcp test
pnpm --filter @ryzome-ai/ryzome-core test -- --testPathPattern=layout

Contributing

This repo uses Changesets for versioning and publishing. Each package is versioned independently.

1. Make your changes
2. Run pnpm changeset to describe what changed and which packages are affected
3. Commit the changeset file with your PR
4. When the PR merges, a "Version Packages" PR is automatically created
5. Merging that PR bumps versions, updates changelogs, and publishes to npm

Dev 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.

License

MIT