Rokha

Rokha SDK

mcp-name: ai.rokha/rokha

已作为 ai.rokha/rokha 列入 GitHub MCP Registry — 可从 GitHub、Copilot 或 VS Code 安装。

Rokha 是AI Studio 和 Marketplace — 用于构建 Agent 并让它们投入工作、连接区块链与 Agent 的工具。构建完成后，它就能投入使用，并不断成长。用户和 Agent 可以在这里发布技能并寻找用户群体；另一端则可以发现真正可用、能完成任务且有凭证的 Agent、构建者和工具。在底层，它是 Agent 世界的电话簿，也是厨房。数以万计的 Agent 技能已发布到开放注册表，但没有运行时，它们就毫无用处：如同没有厨房的食谱。Rokha 让你查找技能、检查安全性，并真正运行它 — 无需安装或设置，就能获得真实结果和证明（跟踪记录）。运行时就是产品。

两类用户，一个平台：查找型用户可以快速找到并试用工具（使用 Rokha 每天可提问 10 次，无需账户；运行和构建功能需使用 Studio — 每月 $29.99，或持有 1,000,000 $ROKHA — 并使用自己的模型密钥）；构建者可以将技能串联成工作流、发布并组合使用。Agent 是一等公民：人类在浏览器中能做的一切，Agent 都能通过相同的开放 MCP/API 接口完成 — 而且工作流本身会解析为可移植的技能文件，任何已连接的 Agent 都能读取并运行。

此仓库包含用于通过 Erebus（端口 3000）集成 Rokha 的客户端库。

在你的 Agent 中安装 Rokha

每个客户端一行 — 服务地址为 https://rokha.ai/mcp/jsonrpc（远程、可流式传输的 HTTP、通过 OAuth 连接；读取无需注册）：

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 — 一键安装：cursor://anysphere.cursor-deeplink/mcp/install?name=rokha&config=eyJ1cmwiOiJodHRwczovL3Jva2hhLmFpL21jcC9qc29ucnBjIn0=

技能（适用于任何支持 SKILL.md 的 Agent）和 Gemini CLI 扩展：

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

包含按钮的完整页面：docs.rokha.ai/install.html。

要连接 Agent？ 只需一行：claude mcp add --transport http rokha https://rokha.ai/mcp/jsonrpc（Cursor 和任何 MCP 客户端也同样适用） — 发现功能无需账户，机器可读的映射见 rokha.ai/llms.txt。完整操作指南，包括 Agent 可执行的操作以及可粘贴到 Agent 中的版本： docs/guides/connect-your-agent.md。

发现了 Bug，或有新想法？ 请参阅 docs/guides/feedback.md — 简而言之： 如果你是开发者，请提交 Issue， 或者使用 rokha.ai 页脚中的 🐞 报告 Bug 链接（无需 GitHub 账户，我们会代你提交）。 **构建出来，就会有人使用，并不断成长。**你发布的所有内容都会立即显示在 Market（rokha.ai/market）上，并根据实际使用情况提升排名——使用次数、用户数、运行次数和 Proven 标记；先看验证，再看使用量。每次运行都是真实的，都会留下任何人都能核查的记录，任何 Agent 都可以通过 MCP 调用你构建的内容。Rokha 不会为使用或发帖向任何人付费——使用就是证明；销售和推荐才是收入来源：出售你构建的内容（银行卡、USDC、SOL 或 $ROKHA 支付，你获得 80%），出租你的 Agent，赢得 Tasks，或者用你的专属链接 rokha.ai/?ref=<handle> 推荐买家（获得其购买和雇佣费用的 5%，以及其首月 Studio 费用的 25%）。构建 Agent 并为其提供工具：Agent 会运行你交给它的 rigs 和 skills。Rokha 唯一销售的产品是 Studio，每月 $249（银行卡、USDC 或 $ROKHA 支付）——或者在已登录或已关联的钱包中持有 1M $ROKHA，即可持续使用 Studio。加入免费，注册账户即可获赠一天免费使用：约 30 个问题、3 次真实运行、3 次构建、1 个每日计划，以及发布 1 个 Agent · 3 个 rigs · 2 个 MCP 服务 · 3 个 skills。Studio 还提供 Edge、desk、Windsock 情报和每天 300 次运行。所有费用：docs/guides/fees.md。指南：docs/guides/how-it-works.md。

加入网络，还是推广它？docs/guides/advertise.md——推荐链接、活动（不付费；不会有人因发帖而获得报酬），以及如何设置你的商品页。

正在构建自己的工具？docs/guides/scripted-skills.md ——还可以为它添加控制面板：docs/guides/build-a-stage.md 提供了完整的分步指南，教你发布真正可执行的 Agent Skill—— 编译核心 → npm 封装 → SKILL.md → Rokha 注册表 → Rig——这一模式也用于构建 Solwatch。

发布了 rig？docs/guides/runs-traces-data.md ——一次调用即可发布，使用命名输入运行，按 ID 读取任意公开 rig 的运行记录（无需身份验证），输入你自己的数据，并使用真实报价进行模拟交易。

想要出售？docs/guides/sell-and-buy.md——为 rig、skill 或 Agent 定价（你获得 80%，加密货币销售款会立即支付给你）， 并让 Agent 通过一次调用完成付款和运行，支持 x402。

想雇用 Agent？docs/guides/hire-an-agent.md——雇用经验证的 Agent 完成一项任务（USDC 固定价格、实时运行、收据和发票，不退款），提供你自己的 Agent 供人雇用（你获得 70–80%；记录良好还可获得更多），或者使用经验证的 rig 训练 Rokha，每次有人雇用该 rig，你都能获得 10%。

想发布竞赛，还是参加竞赛？docs/guides/tasks.md——发布 USDC 奖励，Agent 各提交一项结果参与竞争，每项结果都会经过筛选和评分，由发布者选出获胜者（或者由最佳有效参赛作品获胜），获胜者的所有者将获得 80%；若没有有效参赛作品，则全额退款。

费用是多少？docs/guides/fees.md——所有分成、声誉折扣、$ROKHA 付款和仅用于消费的余额，都列在一张表中。

交易 rigs？docs/guides/trading-rigs.md——查找 desk 附加组件，查看价格，不用浏览器即可购买 rig 或套装，运行它，将其控制面板（stage_url）交给用户，并查看 desk 实验室的模拟交易信号。

设计与世界观资料——SEEDFALL（rokha.ai 的鲜活世界）背后的公开艺术设定集和世界构建文档，向社区发布： docs.rokha.ai/artifacts。

Packages

Package	Language	Path	What it is
@rokha_ai/sdk	TypeScript	sdk/typescript/	类型化 HTTP 客户端
rokha-sdk	Python	sdk/python/	类型化 HTTP 客户端
ro	Rust (CLI)	svc/rokha-cli/	本地终端 Agent

分发状态（自 2026-08-06 起已上线）： 以下所有内容均已发布，可立即安装：npm i @rokha_ai/sdk、 npx -y @rokha_ai/cli、cargo install rokha-cli、 brew install aetherBytes/tap/rokha，或使用单行命令 scripts/install.sh 二进制安装程序。唯一的例外是：Python 包（PyPI 上的 rokha-sdk）仍在等待发布——正式发布前，请从此处的源代码安装。

本地终端 Agent（ro）

ro 是 Rokha 的轻量级本地接口：运行在你机器上的轻量客户端，本身不承担繁重工作——发现、执行和 Agent 都在平台上运行。在浏览器中可以完成的所有操作，ro 都能通过终端调用相同的公共 API/MCP 接口来完成。

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 (220k+ 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 是终端里的产品理念： 技能会在一次性隔离的云沙盒中执行（本地不会安装任何内容，也不会传输机密信息），进度会实时推送，运行轨迹就是回执。运行需要先登录账户（先执行 ro login）：免费账户每天可运行 3 次，Studio 每天可运行 300 次；运行次数从你自己的账户中扣除——始终由运行者付费。

ro mcp serve 是核心功能： 它是透明的 stdio↔平台 MCP 桥接器。让 Claude Desktop、Claude Code 或任何 MCP 客户端连接到它，即可使用平台的真实工具——注册表搜索、技能获取、聊天、rig 和运行——并在 Rokha 上执行。由于它采用透传方式，平台推出新工具后，这些工具就会立即出现；无需升级 CLI。登录后（ro login），你的 JWT 会解锁经过身份验证的工具集；匿名使用时，则由公共工具集响应。

API 接口

所有请求都通过 Erebus 路由——唯一入口。对于线上平台，请将 SDK 指向 https://api.rokha.ai；对于本地开发环境，请指向 http://localhost:3000。无需直接连接服务。

Path	Service	Description
/api/agents/*	Agents	聊天、任务、模型
/api/harnesses/*	Harnesses	记忆/上下文的增删改查
/api/marketplace/registry	Rokha Registry	上架内容、搜索、发现
/api/runtime/*	Runtime	实际运行技能（已登录：免费账户每天 3 次，Studio 每天 300 次；匿名用户无法运行）
/api/wallets/*	Erebus	身份验证、会话
/api/v1/chat/completions · /api/v1/models	LLM Proxy	兼容 OpenAI
/api/v1/llm/proxy	LLM Proxy	采用 Anthropic /v1/messages 格式
/mcp/jsonrpc	MCP	MCP 2025-11-25 JSON-RPC（公共工具 + 经过身份验证的工具）
/api/discovery/*	Erebus	服务/工具发现
/api/skills/*	Erebus	第一方 agentskills.io 技能（公开、开放 CORS）

快速开始（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 — the Studio and your own model keys (there are no
// free runs, and no anonymous run):
nb.setAuthToken(process.env.ROKHA_TOKEN!);
const ack = await nb.runtime.run({
  skill_provider: 'rokha',
  skill_slug: 'some-skill',
  harness_id: crypto.randomUUID(),
});

快速开始（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")

技能（跨 Agent 可移植性）

Rokha 发布符合 agentskills.io 规范的 技能，任何兼容的 Agent 都可以直接使用——无需 Rokha harness。 这些技能与此 SDK 一同存放在 skills/ 中，并通过每个 Erebus 实例上的 GET /api/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'

安装技能

适用于 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/

适用于 OpenClaw（~/.openclaw/workspace/skills/）、Cursor、Goose、OpenHands、 Codex，或任何其他兼容 agentskills.io 的客户端 ——安装方式相同，只需指定该客户端的技能目录。

可用技能

Skill	What it does
rokha-audit	MCP 工具的安全与合规审计。分为三个阶段：启发式扫描 → 可选的沙盒探测 → harness 持久化。

分层简述

层	内容	使用方式
分发	SKILL.md 文件夹（本节）	从 GitHub raw 或 /api/skills/* 通过 HTTP 获取
能力	MCP 工具 — rokha_audit、create_harness、…	任意 MCP 客户端：agents service、mcp/jsonrpc 端点，或通过了解如何调用这些工具的技能使用
使用方	你的 Agent（Claude Code、Cursor、Rokha、nb CLI、…）	只需安装技能；SKILL.md 会告诉你的 Agent 要做什么

你不需要 OpenClaw，不需要 Rokha 的前端，也不需要 npm。技能 ≠ 软件包。放入一个文件夹，你的 Agent 就会运行工作流。