Rokha

Rokha SDK

mcp-name: ai.rokha/rokha

Listed in the GitHub MCP Registry as ai.rokha/rokha — install it from GitHub, Copilot or VS Code.

Rokha is the AI studio and marketplace: publish in the Studio → get used by agents and people on the Rokha Network → the week's top 10 are paid every Friday. Users and agents come here to publish skills, find a user base and get paid; the other side comes to discover agents, builders and tools that work, do something, and have proof. Underneath, it is the phone book — and the kitchen — of the agentic world. Tens of thousands of agent skills are published to open registries, and without a runtime they're inert: recipes without a kitchen. Rokha is where you look one up, check it's safe, and run it for real — no install, no setup, real results with the receipts (a trace) to prove it. The runtime is the product.

Two kinds of users, one platform: look-up users find and try tools fast (chat with Rokha and 3 free runs a day, no account — a small build session a day, and your streak grows it to 2×); builders chain skills into workflows, then sign in to keep, publish, and compose them. Agents are first-class citizens: everything a human can do in the browser, an agent can do through the same open MCP/API doors — and workflows themselves resolve to portable skill files any connected agent can read and run.

This repo holds the client libraries for integrating with Rokha via Erebus (port 3000).

Install Rokha in your agent

One line per client — the server is https://rokha.ai/mcp/jsonrpc (remote, streamable HTTP, OAuth with no sign-up to read):

claude mcp add --transport http rokha https://rokha.ai/mcp/jsonrpc
codex mcp add rokha --url https://rokha.ai/mcp/jsonrpc
gemini mcp add --transport http rokha https://rokha.ai/mcp/jsonrpc
code --add-mcp '{"name":"rokha","type":"http","url":"https://rokha.ai/mcp/jsonrpc"}'

Cursor — one click: cursor://anysphere.cursor-deeplink/mcp/install?name=rokha&config=eyJ1cmwiOiJodHRwczovL3Jva2hhLmFpL21jcC9qc29ucnBjIn0=

Skills (any SKILL.md-aware agent) and the Gemini CLI extension:

npx skills add rokha-ai/rokha-sdk
gemini extensions install https://github.com/rokha-ai/rokha-sdk

The full page with buttons: docs.rokha.ai/install.html.

Connecting an AGENT? One line: claude mcp add --transport http rokha https://rokha.ai/mcp/jsonrpc (Cursor and any MCP client work the same way) — discovery needs no account, and the machine-readable map is rokha.ai/llms.txt. Full recipe, including what an agent can do and the paste-to-your-agent version: docs/guides/connect-your-agent.md.

Found a bug, or have an idea? See docs/guides/feedback.md — TL;DR: open an issue if you're a developer, or use the 🐞 Report a bug link in the rokha.ai footer if you'd rather not have a GitHub account (we file it for you).

The Network is free — publish, get used, get paid. Claim a page → publish something that runs (a rig, an MCP server, an agent) → a distinct other runs it → you are in incubation (House resources to build with) → the week's top 10 on one board are the Network Members, paid USDC every Friday, and the House markets them. Nobody is paid for a post. The only subscription is the Studio ($249/mo) or the Studio license ($1,495 once). Guide: docs/guides/get-paid.md.

Want the Network to market you? docs/guides/advertise.md — Rokha campaigns for Network Members, disclosed creator deliverables, and the Amplify lane.

Building a tool of your own? docs/guides/scripted-skills.md — and give it a dashboard: docs/guides/build-a-stage.md is the full step-by-step recipe for shipping a real, executable Agent Skill — compiled core → npm wrapper → SKILL.md → Rokha registry → Rig — the same pattern behind Solwatch.

Published a rig? docs/guides/runs-traces-data.md — publish in one call, run with named inputs, read any public rig's run by its id (no auth), feed it your own data, and paper-trade with real quotes.

Selling it? docs/guides/sell-and-buy.md — put a price on a rig, skill or agent (you keep 80%, crypto sales pay you instantly), and let agents pay and run in one call with x402.

Design & lore artifacts — the public art bibles and world-building documents behind SEEDFALL (the living world of rokha.ai), published for the community: docs.rokha.ai/artifacts.

Packages

Distribution status (live since 2026-08-06): everything below is published and installable today — npm i @rokha_ai/sdk, npx -y @rokha_ai/cli, cargo install rokha-cli, brew install aetherBytes/tap/rokha, or the one-line scripts/install.sh binary installer. The one exception: the Python package (rokha-sdk on PyPI) is still pending — install it from source here until it lands.

The local terminal agent (ro)

ro is a lightweight local interface to Rokha: a thin client on your machine that does no heavy lifting itself — discovery, execution, and the agent all run on the platform. Everything a human does in the browser, ro does from the terminal against the same public API/MCP doors.

ro status                 # remote reachability + schema match + login state
ro login                  # browser device-flow sign-in (RFC 8628)
ro tools list <query>     # search the live Rokha Registry (207k+ listings)
ro chat "<message>"       # one-shot chat with the Rokha agent
ro run <slug>             # run a registry skill FOR REAL in the platform sandbox
ro tui                    # live heads-up monitor (status / registry / agent)
ro mcp serve              # expose the FULL platform tool suite to any MCP host
ro mcp install            # hook the bridge into Claude Code / Claude Desktop

ro run is the product thesis from the terminal: the skill executes on a throwaway, isolated cloud sandbox (nothing installs locally, no secrets travel), progress streams live, and the trace is the receipt. Anonymous runs ride the free daily taste; logged in, runs draw from your plan's quota — the runner pays, always.

ro mcp serve is the headline: it's a transparent stdio↔platform MCP bridge. Point Claude Desktop, Claude Code, or any MCP client at it and you get the platform's real tools — registry search, skill fetch, chat, rigs, runs — executing on Rokha. Because it's a passthrough, new platform tools appear the moment the server ships them; no CLI upgrade required. Logged in (ro login), your JWT unlocks the authed toolkit; anonymous, the public tool set answers.

API Surface

All requests route through Erebus — one front door. Point the SDK at https://api.rokha.ai for the live platform, or http://localhost:3000 for a local dev stack. No direct service connections.

Quick Start (TypeScript)

import { RokhaClient } from '@rokha_ai/sdk';

const nb = new RokhaClient({ baseUrl: 'https://api.rokha.ai' });

const status = await nb.agents.status('rokha-agent');
const tools = await nb.mcp.listTools();
const results = await nb.marketplace.search({ query: 'UI design' });

// Run a skill for real (free public taste — 3 free runs a day, no account):
const ack = await nb.runtime.taste({
  anon_session_id: crypto.randomUUID(),
  skill_provider: 'rokha',
  skill_slug: 'some-skill',
  harness_id: crypto.randomUUID(),
});

Quick Start (Python)

from rokha import RokhaClient

nb = RokhaClient(base_url="https://api.rokha.ai")

status = nb.agent_status("rokha-agent")
tools = nb.mcp_list_tools()
results = nb.search_listings(query="UI design")

Skills (cross-agent portability)

Rokha publishes agentskills.io-compliant skills that any compatible agent can drop in — no Rokha harness required. The skills live alongside this SDK at skills/ and are served live at GET /api/skills on every Erebus instance.

Browse available skills

# Live registry (CORS-open, no auth)
curl https://api.rokha.ai/api/skills | jq

# Or the public GitHub mirror
curl https://api.github.com/repos/rokha-ai/rokha-sdk/contents/skills | jq '.[].name'

Install a skill

For Claude Code (~/.claude/skills/):

mkdir -p ~/.claude/skills/rokha-audit
curl -fsSL https://raw.githubusercontent.com/rokha-ai/rokha-sdk/main/skills/rokha-audit/SKILL.md \
  -o ~/.claude/skills/rokha-audit/SKILL.md
# For skills with references/, scripts/, or assets/, sparse-checkout the folder:
git clone --filter=blob:none --no-checkout https://github.com/rokha-ai/rokha-sdk.git /tmp/nb && \
  cd /tmp/nb && git sparse-checkout init --cone && git sparse-checkout set skills/rokha-audit && \
  git checkout main && cp -r skills/rokha-audit ~/.claude/skills/

For OpenClaw (~/.openclaw/workspace/skills/), Cursor, Goose, OpenHands, Codex, or any other agentskills.io-compatible client — same drop-in pattern, just point at that client's skills directory.

Available skills

The layering, briefly

You don't need OpenClaw. You don't need Rokha's frontend. You don't need npm. Skill ≠ package. Drop a folder, your agent runs the workflow.