Skip to content

ryzome-claude-plugin

Directory actions

More options

Directory actions

More options

Latest commit

 

History

History

ryzome-claude-plugin

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
.claude-plugin
.claude-plugin
 
 
agents
agents
 
 
hooks
hooks
 
 
skills
skills
 
 
.mcp.json
.mcp.json
 
 
CHANGELOG.md
CHANGELOG.md
 
 
README.md
README.md
 
 
package.json
package.json
 
 

README.md

@ryzome-ai/ryzome-claude-plugin

Ryzome plugin for Claude Code. Adds canvas and document tools, library resources, skills, and a context retrieval agent.

Install

In Claude Code:

/plugin marketplace add 0xPlaygrounds/ryzome-mcp-plugins
/plugin install claude-ryzome

The first command registers this repo as a plugin marketplace; the second installs the plugin from it. You'll then be prompted for your Ryzome API key (stored securely in your system keychain). Get one at ryzome.ai/workspace#settings/api-keys.

What's Included

MCP Tools (11)

Tool Description
create_ryzome_document Create a standalone document in the Ryzome library
create_ryzome_canvas Create a canvas with explicitly defined nodes and edges
get_ryzome_document Retrieve a document by ID with metadata and content details
create_ryzome_plan Create a canvas from sequential steps (auto-chained)
create_ryzome_research Create a canvas with research findings branching from a topic
get_ryzome_canvas Retrieve a canvas by ID with all nodes and edges
list_ryzome_documents List accessible documents, optionally filtered by tag, favorite state, or content type
list_ryzome_canvases List all accessible canvases
update_ryzome_document Update document metadata or content, including appending text
save_ryzome_node_to_library Promote a canvas node's backing document into the library
upload_ryzome_image Upload an image from a URL to an existing canvas

MCP Resources

URI Description
ryzome://canvases JSON list of all canvas summaries
ryzome://canvas/{id} Single canvas rendered as structured markdown
ryzome://documents JSON list of library-visible document summaries
ryzome://document/{id} Single document rendered as structured markdown

Skills

Skill Args Description
/plan goal (required) Break a goal into steps and create a plan canvas
/research topic (required) Organize findings on a topic into a research canvas
/ryzome-status — Check API connection and list recent canvases

Agent

ryzome-context — A lightweight (Haiku-powered) context retrieval agent that finds and summarizes canvas or document content. It has access to list_ryzome_canvases, get_ryzome_canvas, list_ryzome_documents, and get_ryzome_document.

Hooks

SessionStart — Displays a status message confirming the Ryzome plugin is active and listing available skills.

Configuration

The plugin uses Claude Code's userConfig system:

  1. On install (or via /plugin), you're prompted for api_key (marked as sensitive, stored in keychain)
  2. .mcp.json injects the value via ${user_config.api_key} substitution into RYZOME_API_KEY
  3. The bundled MCP server (@ryzome-ai/ryzome-mcp) reads RYZOME_API_KEY
userConfig.api_key → ${user_config.api_key} → RYZOME_API_KEY → ryzome-mcp server

Architecture

This package ships no code. It is a static configuration bundle:

.claude-plugin/plugin.json   # Plugin manifest (name, scopes, userConfig)
.mcp.json                    # Bundled MCP server config (npx @ryzome-ai/ryzome-mcp)
skills/                      # /plan, /research, /ryzome-status
agents/                      # ryzome-context retrieval agent for canvases and documents
hooks/                       # SessionStart greeting

The actual tool logic lives in @ryzome-ai/ryzome-mcp, which is run via npx when Claude Code starts the MCP server.

License

MIT