{"id":47994211,"url":"https://github.com/0xplaygrounds/ryzome-mcp-plugins","last_synced_at":"2026-08-27T16:10:39.354Z","repository":{"id":343271534,"uuid":"1174765538","full_name":"0xPlaygrounds/ryzome-mcp-plugins","owner":"0xPlaygrounds","description":"🫚 Integration plugins to leverage Ryzome's agentic context in Openclaw, Claude Code \u0026 via MCP","archived":false,"fork":false,"pushed_at":"2026-07-20T15:31:49.000Z","size":522,"stargazers_count":6,"open_issues_count":1,"forks_count":4,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-08-07T19:38:33.050Z","etag":null,"topics":["agents","agentshub","context-engineering","context-management","openclaw","openclaw-alternative","openclaw-extension","openclaw-plugin","ryzome"],"latest_commit_sha":null,"homepage":"https://ryzome.ai/claw","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/0xPlaygrounds.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTs.md","dco":null,"cla":null}},"created_at":"2026-03-06T20:19:25.000Z","updated_at":"2026-05-22T18:18:06.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/0xPlaygrounds/ryzome-mcp-plugins","commit_stats":null,"previous_names":["0xplaygrounds/openclaw-ryzome","0xplaygrounds/ryzome-mcp-plugins"],"tags_count":20,"template":false,"template_full_name":null,"purl":"pkg:github/0xPlaygrounds/ryzome-mcp-plugins","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xPlaygrounds%2Fryzome-mcp-plugins","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xPlaygrounds%2Fryzome-mcp-plugins/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xPlaygrounds%2Fryzome-mcp-plugins/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xPlaygrounds%2Fryzome-mcp-plugins/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/0xPlaygrounds","download_url":"https://codeload.github.com/0xPlaygrounds/ryzome-mcp-plugins/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xPlaygrounds%2Fryzome-mcp-plugins/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":36944077,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-08-22T15:14:58.755Z","status":"online","status_checked_at":"2026-08-27T02:00:07.166Z","response_time":96,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agents","agentshub","context-engineering","context-management","openclaw","openclaw-alternative","openclaw-extension","openclaw-plugin","ryzome"],"created_at":"2026-04-04T11:51:58.864Z","updated_at":"2026-08-27T16:10:39.349Z","avatar_url":"https://github.com/0xPlaygrounds.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"![claw-ryzome](https://github.com/user-attachments/assets/822727dc-dcd6-4af1-bc81-856a4e9a521f)\n\n# Ryzome MCP Plugins\n\nRyzome 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.\n\nThis monorepo provides Ryzome canvas tools for AI agents across multiple integration surfaces.\n\n## Packages\n\n| Package | Description | Registry |\n|---------|-------------|----------|\n| [`@ryzome-ai/ryzome-core`](packages/ryzome-core) | Shared logic: API client, 11 tools, graph builder, layout | [![npm](https://img.shields.io/npm/v/@ryzome-ai/ryzome-core)](https://www.npmjs.com/package/@ryzome-ai/ryzome-core) |\n| [`@ryzome-ai/ryzome-mcp`](packages/ryzome-mcp) | MCP server with tools + resources for Claude Code and other MCP clients | [![npm](https://img.shields.io/npm/v/@ryzome-ai/ryzome-mcp)](https://www.npmjs.com/package/@ryzome-ai/ryzome-mcp) |\n| [`@ryzome-ai/openclaw-ryzome`](packages/openclaw-ryzome) | OpenClaw plugin adapter | [![npm](https://img.shields.io/npm/v/@ryzome-ai/openclaw-ryzome)](https://www.npmjs.com/package/@ryzome-ai/openclaw-ryzome) |\n| [`hermes-ryzome-plugin`](packages/hermes-ryzome) | Hermes Agent plugin source package. Standard Hermes install repo: [`0xPlaygrounds/hermes-ryzome-plugin`](https://github.com/0xPlaygrounds/hermes-ryzome-plugin) | [![PyPI](https://img.shields.io/pypi/v/hermes-ryzome-plugin)](https://pypi.org/project/hermes-ryzome-plugin/) |\n| [`@ryzome-ai/ryzome-claude-plugin`](packages/ryzome-claude-plugin) | Claude Code plugin with skills, agents, and hooks | [![npm](https://img.shields.io/npm/v/@ryzome-ai/ryzome-claude-plugin)](https://www.npmjs.com/package/@ryzome-ai/ryzome-claude-plugin) |\n\n## Architecture\n\n```\nryzome-claude-plugin (Claude Code plugin)\n  └── ryzome-mcp (MCP server)\n        └── ryzome-core (shared logic)\n\nopenclaw-ryzome (OpenClaw plugin)\n  └── ryzome-core (shared logic)\n\nhermes-ryzome (Hermes plugin)\n  ├── Python Hermes plugin surface\n  └── ryzome-core (shared logic via Node runner)\n```\n\n`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.\n\n## Getting Started\n\n- **Claude Code users**: See [`@ryzome-ai/ryzome-claude-plugin`](packages/ryzome-claude-plugin) for one-command install\n- **MCP client users**: See [`@ryzome-ai/ryzome-mcp`](packages/ryzome-mcp) for `npx` quick start\n- **OpenClaw users**: See [`@ryzome-ai/openclaw-ryzome`](packages/openclaw-ryzome) for plugin install\n- **Hermes users**: Install the standalone repo with `hermes plugins install 0xPlaygrounds/hermes-ryzome-plugin --enable`. Hermes prompts for `RYZOME_API_KEY` during install and saves it to `~/.hermes/.env`.\n- **Building integrations**: See [`@ryzome-ai/ryzome-core`](packages/ryzome-core) for the shared library\n\n### Hermes Plugin\n\nStandard Hermes install path:\n\n```bash\nhermes plugins install 0xPlaygrounds/hermes-ryzome-plugin --enable\n```\n\nHermes prompts for `RYZOME_API_KEY` during install because the plugin declares it in `plugin.yaml` via `requires_env`. The value is saved to `~/.hermes/.env`.\n\nInside a Hermes session, the plugin exposes `/ryzome-status` for diagnostics.\n\nThe standalone install repo exists because Hermes git installs expect `plugin.yaml` and `__init__.py` at the repository root. The broader shared development surface remains in this monorepo under [`packages/hermes-ryzome`](packages/hermes-ryzome).\n\nFor local development from this monorepo:\n\n```bash\npnpm build\nln -s \"$PWD/packages/hermes-ryzome\" ~/.hermes/plugins/ryzome\nexport RYZOME_API_KEY=rz_...\n```\n\nThe 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`.\n\n## Development\n\n```bash\npnpm install                        # Install all dependencies\npnpm build                          # Build all packages\npnpm test                           # Run unit tests across all packages\npnpm typecheck                      # tsc --noEmit in each package\npnpm lint                           # Biome lint + typecheck\npnpm format                         # Biome format --write\n```\n\n### Per-package commands\n\n```bash\npnpm --filter @ryzome-ai/ryzome-core test\npnpm --filter @ryzome-ai/ryzome-mcp test\npnpm --filter @ryzome-ai/ryzome-core test -- --testPathPattern=layout\n```\n\n## Contributing\n\nThis repo uses [Changesets](https://github.com/changesets/changesets) for versioning and publishing. Each package is versioned independently.\n\n1. Make your changes\n2. Run `pnpm changeset` to describe what changed and which packages are affected\n3. Commit the changeset file with your PR\n4. When the PR merges, a \"Version Packages\" PR is automatically created\n5. Merging that PR bumps versions, updates changelogs, and publishes to npm\n\nDev snapshots are published on every push to `main` under the `dev` tag.\n\nThe 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.\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0xplaygrounds%2Fryzome-mcp-plugins","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F0xplaygrounds%2Fryzome-mcp-plugins","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0xplaygrounds%2Fryzome-mcp-plugins/lists"}