Rho MD for Codex and Claude Code

Two things for your AI tool:

• Search Rho Cloud — the documents people publish on rho.md — and read them in full with a link to the source (an MCP server at https://rho.md/api/mcp; nothing to install).
• Use Rho MD, the Markdown reader and notebook on your computer: open a Markdown file — or a report it just wrote — so you can read it rendered, read and edit the document you have open, search, tag, move and index the notes in your Rho MD library, and export to PDF or Word.

Requirements

Searching Rho Cloud needs nothing installed. Using the app needs:

• Rho MD 1.4.15 or later, installed and running on the same computer (download). Rho MD 1.4.15 is available for Windows and Linux; the Mac version follows.
• Settings › AI tools › "Allow AI tools to use Rho MD" switched on (the default).

The app part does not work in cloud sandboxes, where the app is not available.

Install

Codex

codex plugin marketplace add scos-lab/rho-md-agent
codex plugin add rho-md@rho-md

Claude Code

/plugin marketplace add scos-lab/rho-md-agent
/plugin install rho-md@rho-md

Then ask, for example: "Open the report you just wrote in Rho MD".

What it can do, and what it asks first

The plugin's skill runs Rho MD commands through a small client script (node, with bash and PowerShell fallbacks) that reads Rho MD's agent-connect.json (the local port and a key that changes every time the app starts) and talks to the app over a local connection on 127.0.0.1; nothing from your library goes over the internet. Rho Cloud search is read-only, reaches published documents only, and sends the search words to rho.md (privacy policy §5d). Asked to start Rho MD, it opens the rho:// link. The plugin's own README lists everything it runs, reads and connects to.

• Reading and editing run directly.
• Deleting, publishing, sending and uploading always ask you in Rho MD first.
• Account and sign-in actions are not available to AI tools.
• The first AI tool that connects is allowed; any other one asks you first. Rho MD lists every tool under Settings › AI tools, where you can remove one or switch the whole thing off.

Layout

.agents/plugins/marketplace.json     Codex marketplace
.claude-plugin/marketplace.json      Claude Code marketplace
plugins/rho-md/
  plugin.json                        portable manifest (+ OpenAI listing and review details)
  mcp.json                           the Rho Cloud MCP server (portable / Codex / ChatGPT)
  .claude-plugin/plugin.json         Claude Code manifest (declares the same MCP server)
  skills/rho-md/SKILL.md             the skill
  skills/rho-md/scripts/             rho.mjs · rho.sh · rho.ps1
  skills/rho-md/references/          command reference
tools/pack_openai.py                 builds and checks the ZIP for the OpenAI plugin directory

Support

[email protected]

License

MIT