Rokha SDK

Указан в реестре MCP GitHub как ai.rokha/rokha — установите его через GitHub, Copilot или VS Code.

Rokha — это студия ИИ и торговая площадка: публикуйте материалы в Studio → получайте пользователей среди агентов и людей в Rokha Network → каждую пятницу получайте оплату за использование. Пользователи и агенты приходят сюда, чтобы публиковать навыки, находить свою аудиторию и зарабатывать. Другие — чтобы находить полезных агентов, разработчиков и инструменты, проверять, что они работают и приносят результат. В основе Rokha — телефонный справочник и кухня агентного мира. В открытых реестрах опубликованы десятки тысяч навыков для агентов, но без среды выполнения они бесполезны: это рецепты без кухни. В Rokha можно найти нужный навык, проверить его безопасность и запустить по-настоящему — без установки и настройки, с реальным результатом и подтверждающим его журналом выполнения (trace). Среда выполнения — это сам продукт.

На одной платформе работают два типа пользователей: те, кто ищет инструменты, могут быстро находить и пробовать их — общаться с Rokha и выполнять до трёх бесплатных запусков в день без учётной записи; это небольшая ежедневная сессия сборки, а серия дней использования увеличивает лимит вдвое. Разработчики объединяют навыки в рабочие процессы, а затем входят в систему, чтобы сохранять, публиковать и комбинировать их. Агенты — полноценные участники платформы: всё, что человек может сделать в браузере, агент может сделать через те же открытые интерфейсы MCP/API. Рабочие процессы также представлены переносимыми файлами навыков, которые может прочитать и запустить любой подключённый агент.

В этом репозитории находятся клиентские библиотеки для интеграции с Rokha через Erebus (порт 3000).

Подключаете агента? Достаточно одной команды: claude mcp add --transport http rokha https://rokha.ai/mcp/jsonrpc (так же работают Cursor и любой MCP-клиент).

Для просмотра данных учётная запись не нужна; карта в машиночитаемом формате доступна по адресу

rokha.ai/llms.txt. Полная инструкция, в том числе описание возможностей агента и вариант текста для вставки в агент:

docs/guides/connect-your-agent.md.

Нашли ошибку или хотите предложить идею? Смотрите

docs/guides/feedback.md. Кратко:

если вы разработчик, создайте issue. Если вы не хотите заводить учётную запись GitHub, воспользуйтесь ссылкой 🐞 Сообщить об ошибке внизу страницы rokha.ai — мы создадим issue за вас.

Участие в Network бесплатное: публикуйте, получайте пользователей и зарабатывайте. Заявите права на страницу → опубликуйте работающий материал (rig, MCP-сервер или агента) → кто-то другой запустит его → вы попадёте в программу Incubation → доска Incubation будет выплачивать USDC каждую пятницу за использование, а House будет продвигать лучших участников (Network Members). За публикации не платят. Единственные платные варианты — подписка Studio ($249 в месяц) и лицензия Studio ($1,495 единоразово). Инструкция: docs/guides/get-paid.md.

Хотите, чтобы Network продвигала вас? docs/guides/advertise.md — кампании Rokha для участников Network, раскрытие информации о материалах, создаваемых авторами, и направление Amplify.

Создаёте собственный инструмент? Начните с docs/guides/scripted-skills.md

и добавьте к нему панель управления: docs/guides/build-a-stage.md

— это полная пошаговая инструкция по созданию и выпуску настоящего исполняемого навыка для агента:

скомпилированное ядро → обёртка npm → SKILL.md → реестр Rokha → Rig. По такому же принципу создан Solwatch.

Опубликовали rig? docs/guides/runs-traces-data.md

— публикуйте одной командой, запускайте с именованными входными данными, просматривайте запуски любого публичного rig по его идентификатору (без авторизации), передавайте собственные данные и торгуйте на бумаге, используя реальные котировки.

Хотите продавать свой продукт? docs/guides/sell-and-buy.md — назначьте цену на rig, навык или агента (вы получаете 80%, а криптовалютные платежи поступают мгновенно) и позвольте агентам оплачивать запуск и выполнять его одной командой с помощью x402.

Артефакты дизайна и мифологии — общедоступные библии художественного мира и документы по его созданию, связанные с SEEDFALL (живым миром rokha.ai), опубликованные для сообщества:

rokha-ai.github.io/rokha-sdk/artifacts.

Пакеты

Пакет	Язык	Путь	Описание
`@rokha_ai/sdk`	TypeScript	`sdk/typescript/`	Типизированный HTTP-клиент
`rokha-sdk`	Python	`sdk/python/`	Типизированный HTTP-клиент
`ro`	Rust (CLI)	`svc/rokha-cli/`	Локальный агент для работы в терминале

Статус распространения (доступно с 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 (rokha-sdk в PyPI): пока он не опубликован, устанавливайте его из исходного кода в этом репозитории.

Локальный агент для работы в терминале (`ro`)

ro — это лёгкий локальный интерфейс Rokha: тонкий клиент на вашем

компьютере, который сам не выполняет сложную работу — поиск, запуск и работа агента

происходят на платформе. Всё, что человек делает в браузере, ro выполняет

из терминала через те же открытые интерфейсы API/MCP.

 # search the live Rokha Registry (206k+ listings)

ro chat "" # one-shot chat with the Rokha agent ro run # 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 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 (206k+ 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 — основная идея продукта в терминале: навык запускается в одноразовой изолированной облачной песочнице (ничего не устанавливается локально, секреты никуда не передаются), ход выполнения отображается в реальном времени, а trace служит подтверждением запуска. Анонимные запуски учитываются в бесплатном дневном лимите; после входа в систему запуски расходуют квоту вашего плана — за запуск всегда платит пользователь.

ro mcp serve — ключевая возможность: это прозрачный мост MCP между stdio и платформой. Подключите к нему Claude Desktop, Claude Code или любой MCP-клиент — и получите доступ к реальным инструментам платформы: поиску по реестру, получению навыков, чату, rigs и запускам, выполняемым в Rokha. Мост работает напрямую, поэтому новые инструменты платформы становятся доступны сразу после их выпуска сервером — обновлять CLI не нужно. После входа в систему (ro login) JWT открывает доступ к набору инструментов с авторизацией; без входа доступны общедоступные инструменты.

Поверхность API

Все запросы проходят через Erebus — единую точку входа. Для работы с платформой укажите SDK адрес https://api.rokha.ai, а для локальной среды разработки — http://localhost:3000. Подключаться напрямую к сервисам не нужно.

Путь	Сервис	Описание
`/api/agents/*`	Agents	Чат, задачи, модели
`/api/harnesses/*`	Harnesses	CRUD для памяти и контекста
`/api/marketplace/registry`	Rokha Registry	Объявления, поиск, обнаружение
`/api/runtime/*`	Runtime	Настоящий запуск навыка (бесплатная проба и запуск за счёт квоты тарифа)
`/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	JSON-RPC MCP 2025-11-25 (общедоступные инструменты и инструменты с авторизацией)
`/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 (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(),
});

Быстрый старт (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")

Навыки (переносимость между агентами)

Rokha публикует навыки, соответствующие требованиям agentskills.io: их можно использовать в любом совместимом агенте без инфраструктуры Rokha.

Навыки доступны вместе с этим SDK в каталоге skills/, а также в режиме реального времени по адресу GET /api/skills на каждом экземпляре Erebus.

Просмотр доступных навыков

# 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 клиента

действует тот же принцип установки: достаточно скопировать навык в каталог навыков клиента.

Доступные навыки

Навык	Назначение
`rokha-audit`	Проверка MCP-инструментов на соответствие требованиям безопасности и нормативным требованиям. Три этапа: эвристический анализ → необязательная проверка в изолированной среде → сохранение результатов в harness.

Кратко об уровнях

Уровень	Что это	Как использовать
Распространение	Каталоги SKILL.md (этот раздел)	Загрузите по HTTP с GitHub raw или из `/api/skills/*`
Возможности	MCP-инструменты — `rokha_audit`, `create_harness`, …	Любой клиент MCP: сервис агентов, конечная точка `mcp/jsonrpc` или навык, который умеет вызывать эти инструменты
Пользователь	Ваш агент (Claude Code, Cursor, Rokha, CLI `nb`, …)	Просто установите навык: файл SKILL.md объяснит агенту, что делать

OpenClaw не требуется. Фронтенд Rokha тоже не нужен. npm не нужен.

Навык — это не пакет. Скопируйте каталог, и агент выполнит нужный сценарий.