https://github.com/0xplaygrounds/ryzome-mcp-plugins
🫚 Integration plugins to leverage Ryzome's agentic context in Openclaw, Claude Code & via MCP
https://github.com/0xplaygrounds/ryzome-mcp-plugins
agents agentshub context-engineering context-management openclaw openclaw-alternative openclaw-extension openclaw-plugin ryzome
Last synced: 5 days ago
JSON representation
🫚 Integration plugins to leverage Ryzome's agentic context in Openclaw, Claude Code & via MCP
- Host: GitHub
- URL: https://github.com/0xplaygrounds/ryzome-mcp-plugins
- Owner: 0xPlaygrounds
- License: mit
- Created: 2026-03-06T20:19:25.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-15T22:41:18.000Z (12 days ago)
- Last Synced: 2026-04-15T23:32:36.705Z (12 days ago)
- Topics: agents, agentshub, context-engineering, context-management, openclaw, openclaw-alternative, openclaw-extension, openclaw-plugin, ryzome
- Language: TypeScript
- Homepage: https://ryzome.ai/claw
- Size: 320 KB
- Stars: 5
- Watchers: 0
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: AGENTs.md
Awesome Lists containing this project
README
# 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`](packages/ryzome-core) | Shared logic: API client, 11 tools, graph builder, layout | [](https://www.npmjs.com/package/@ryzome-ai/ryzome-core) |
| [`@ryzome-ai/ryzome-mcp`](packages/ryzome-mcp) | MCP server with tools + resources for Claude Code and other MCP clients | [](https://www.npmjs.com/package/@ryzome-ai/ryzome-mcp) |
| [`@ryzome-ai/openclaw-ryzome`](packages/openclaw-ryzome) | OpenClaw plugin adapter | [](https://www.npmjs.com/package/@ryzome-ai/openclaw-ryzome) |
| [`hermes-ryzome-plugin`](packages/hermes-ryzome) | Hermes Agent plugin (Python package, bundles a Node runner over `ryzome-core`) | [](https://pypi.org/project/hermes-ryzome-plugin/) |
| [`@ryzome-ai/ryzome-claude-plugin`](packages/ryzome-claude-plugin) | Claude Code plugin with skills, agents, and hooks | [](https://www.npmjs.com/package/@ryzome-ai/ryzome-claude-plugin) |
## 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`](packages/ryzome-claude-plugin) for one-command install
- **MCP client users**: See [`@ryzome-ai/ryzome-mcp`](packages/ryzome-mcp) for `npx` quick start
- **OpenClaw users**: See [`@ryzome-ai/openclaw-ryzome`](packages/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`](packages/ryzome-core) for the shared library
### Hermes Plugin
For a local rollout from this repository:
```bash
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
```bash
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
```bash
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](https://github.com/changesets/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