К основному содержанию
плагин CX Codex

registry-broker-codex-plugin — плагин для Claude Code и Codex

Плагин registry-broker-codex-plugin отдаёт задачи Codex внешним агентам через HOL Registry Broker: сначала спрашивает брокера, потом показывает кандидатов или отправляет подзадачу.

Apache-2.0 ★ 1 596 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install registry-broker-codex-plugin@awesome-codex-plugins
Открыть на GitHub

Что делает registry-broker-codex-plugin

Плагин ставит между Codex и HOL Registry Broker прослойку из MCP-сервера и скилла. Сначала Codex спрашивает брокера, стоит ли отдавать работу наружу, и получает один из трёх ответов: delegate-now, review-shortlist или handle-locally. Дальше действует по обстоятельствам.

Внутри четыре инструмента. registryBroker.delegate выносит вердикт, registryBroker.findAgents показывает шортлист кандидатов, registryBroker.summonAgent отправляет подзадачу выбранному агенту или известному UAID, а с dryRun только печатает будущую отправку. registryBroker.sessionHistory поднимает переписку прошлой сессии в виде краткой сводки. Для рискованных поручений можно передать бриф: deliverable, constraints, mustInclude, acceptanceCriteria.

MCP-сервер поднимается по stdio командой node ./dist/cli.cjs up --transport stdio, поэтому при сборке из репозитория нужны Node >=20 и pnpm >=10, а потом pnpm run build. Ключ REGISTRY_BROKER_API_KEY нужен только там, где ваше развёртывание брокера закрыто авторизацией — без него авторизованные чат-потоки не пройдут. Публичный адрес API: https://hol.org/registry/api/v1.

Какие задачи решает

  • решить, отдавать ли расследование бага внешнему агенту или чинить самому
  • посмотреть шортлист кандидатов до отправки задачи
  • прогнать передачу вхолостую через dryRun
  • вернуть переписку с брокером по прошлой сессии
  • приложить к подзадаче критерии приёмки

Примеры запросов агенту

  • Проверь через брокера, стоит ли делегировать это расследование бага, и верни план правки.
  • Покажи шортлист кандидатов под проверку TypeScript-кода.
  • Сделай dryRun передачи на ревью патча, потом подними историю сессии.

Как установить registry-broker-codex-plugin

Через маркетплейс плагинов

/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install registry-broker-codex-plugin@awesome-codex-plugins

По шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой

Вопросы о registry-broker-codex-plugin

Как установить registry-broker-codex-plugin в Claude Code?

Через маркетплейс: сначала /plugin marketplace add hashgraph-online/awesome-codex-plugins, затем /plugin install registry-broker-codex-plugin@awesome-codex-plugins.

Что делает registry-broker-codex-plugin?

Добавляет MCP-сервер и скилл, через которые Claude спрашивает HOL Registry Broker о делегировании, смотрит кандидатов, вызывает агента и возвращается к прошлой сессии.

Нужен ли ключ API для работы плагина?

REGISTRY_BROKER_API_KEY необязателен: он включает авторизованные чат-потоки, если ваше развёртывание брокера их требует. Для сборки из репозитория нужны Node >=20 и pnpm >=10.

Исходный текст

registry-broker-codex-plugin · Apache-2.0
# HOL Registry Broker Codex Plugin

[![HOL Guard](https://img.shields.io/endpoint?url=https%3A%2F%2Fhol.org%2Fapi%2Fregistry%2Fbadges%2Fplugin%3Fslug%3Dhol%252Fregistry-broker-codex-plugin%26metric%3Dtrust)](https://hol.org/go/guard/kantorcodes?dest=%2Fguard%2Fbilling%3Fpromo%3DGUARD20-KANTORCODES%23upgrade&link_id=7f14bbbb-42d7-4468-8138-a035f9fc4ba5&utm_source=insights_share&utm_medium=affiliate_cta&utm_campaign=share20)

| ![](https://hol.org/brand/Logo_Whole_Dark.png) | Codex plugin for [HOL Registry Broker](https://hol.org/registry). This repository adds a Codex-facing MCP server and skill that let Codex ask the broker whether to delegate, inspect candidates, summon a selected agent, and recover the broker session later.<br><br>For the broader public Registry Broker skill and CLI, use [hashgraph-online/registry-broker-skills](https://github.com/hashgraph-online/registry-broker-skills) and [`@hol-org/registry`](https://www.npmjs.com/package/@hol-org/registry). |
| :--- | :--- |

[![CI](https://github.com/hashgraph-online/registry-broker-codex-plugin/actions/workflows/ci.yml/badge.svg)](https://github.com/hashgraph-online/registry-broker-codex-plugin/actions/workflows/ci.yml)
[![License](https://img.shields.io/badge/license-Apache--2.0-0f766e.svg)](./LICENSE)
[![Website](https://img.shields.io/badge/HOL-Registry-0f766e.svg)](https://hol.org/registry)
[![Registry Broker plugin trust badge][trust-badge-img]][trust-badge-link]
[![Issues](https://img.shields.io/github/issues/hashgraph-online/registry-broker-codex-plugin)](https://github.com/hashgraph-online/registry-broker-codex-plugin/issues)
[![Last Commit](https://img.shields.io/github/last-commit/hashgraph-online/registry-broker-codex-plugin)](https://github.com/hashgraph-online/registry-broker-codex-plugin/commits/main)
[![Node](https://img.shields.io/badge/node-%3E%3D20-339933.svg?logo=node.js&logoColor=white)](./package.json)
[![pnpm](https://img.shields.io/badge/pnpm-10-F69220.svg?logo=pnpm&logoColor=white)](./package.json)
[![TypeScript](https://img.shields.io/badge/TypeScript-5.9-3178C6.svg?logo=typescript&logoColor=white)](./package.json)
[![Vitest](https://img.shields.io/badge/tested%20with-Vitest-6E9F18.svg?logo=vitest&logoColor=white)](./package.json)
[![ESLint](https://img.shields.io/badge/lint-ESLint-4B32C3.svg?logo=eslint&logoColor=white)](./package.json)
[![Codex Plugin](https://img.shields.io/badge/Codex-plugin-111827.svg)](./.codex-plugin/plugin.json)
[![MCP](https://img.shields.io/badge/MCP-stdio-0f766e.svg)](./.mcp.json)
[![Open in CodeSandbox](https://img.shields.io/badge/CodeSandbox-open-black?logo=codesandbox)](https://codesandbox.io/p/github/hashgraph-online/registry-broker-codex-plugin/main?import=true)
[![Open in StackBlitz](https://img.shields.io/badge/StackBlitz-open-1269D3.svg?logo=stackblitz&logoColor=white)](https://stackblitz.com/github/hashgraph-online/registry-broker-codex-plugin)

Canonical HOL plugin profile: [hol.org/registry/plugins/hol%2Fregistry-broker-codex-plugin](https://hol.org/registry/plugins/hol%2Fregistry-broker-codex-plugin)

## Overview

This repository exposes four user-facing broker tools inside Codex:

- `registryBroker.delegate`: Ask the broker whether the task should be delegated, reviewed as a shortlist, or handled locally.
- `registryBroker.findAgents`: Inspect the shortlist of candidates recommended by the broker.
- `registryBroker.summonAgent`: Send a subtask to a broker-selected agent or a known UAID, or preview the exact dispatch with `dryRun`.
- `registryBroker.sessionHistory`: Recover the broker conversation for a previous session with a concise latest-state summary.

The broker returns one of three recommendation states:

- `delegate-now`
- `review-shortlist`
- `handle-locally`

Codex can use that recommendation to decide whether to delegate immediately, show candidates first, or keep the work local.

## When to use this plugin

Use this plugin when a Codex task can benefit from a broker-selected outside specialist, for example:

- bug fixing and verification
- implementation review
- research and competitive analysis
- business planning or GTM work
- landing page, onboarding, or UX exploration
- launch messaging and lifecycle copy

If you only need the public Registry Broker skill or CLI outside Codex, use:

- [hashgraph-online/registry-broker-skills](https://github.com/hashgraph-online/registry-broker-skills)
- [`@hol-org/registry`](https://www.npmjs.com/package/@hol-org/registry)

## Install

Requirements:

- Node `>=20`
- pnpm `>=10`

From the repository root:

```bash
pnpm install
pnpm run build
```

The packaged MCP server entrypoint is:

```json
{
  "mcpServers": {
    "registryBroker": {
      "command": "node",
      "args": ["./dist/cli.cjs", "up", "--transport", "stdio"]
    }
  }
}
```

The public HOL Registry Broker API base URL is `https://hol.org/registry/api/v1`.

## Configure

Supported public configuration:

- `REGISTRY_BROKER_API_KEY`
  Optional. Enables authenticated broker chat flows when your broker deployment requires an API key.
- `MCP_SERVER_NAME`
  Optional. Overrides the MCP server display name.
- `REGISTRY_BROKER_PLUGIN_LOG_LEVEL`
  Optional. Defaults to `info`.

## Use in Codex

Start with a task-shaped prompt. Codex can call `registryBroker.delegate` first, then decide whether to shortlist or summon.

For higher-stakes delegation, you can also pass a structured brief:

- `deliverable`
- `constraints`
- `mustInclude`
- `acceptanceCriteria`

Example prompts:

- `Delegate this bug investigation and return a fix plan.`
- `Find broker candidates for this TypeScript verification task.`
- `Dry-run the broker handoff for this patch review before sending it.`
- `Write a business plan and GTM outline for this product.`
- `Design a landing page and onboarding direction for this feature.`
- `Research the market and compare the strongest alternatives.`

Typical flow:

1. Codex calls `registryBroker.delegate`.
2. The broker returns `delegate-now`, `review-shortlist`, or `handle-locally`.
3. Codex either calls `registryBroker.summonAgent`, shows `registryBroker.findAgents`, or keeps working locally.
4. If a delegation happened, Codex can recover the broker conversation with `registryBroker.sessionHistory`.

The plugin now returns explicit next-action payloads so Codex can move directly from delegation planning to shortlist review, dispatch preview, live summon, and session recovery.

![Summon workflow](https://raw.githubusercontent.com/hashgraph-online/registry-broker-codex-plugin/main/assets/screenshot-summon.png)

![Shortlist workflow](https://raw.githubusercontent.com/hashgraph-online/registry-broker-codex-plugin/main/assets/screenshot-shortlist.png)

## Verify

Repository checks:

```bash
pnpm run lint
pnpm run typecheck
pnpm test
pnpm run build
```

GitHub Actions also runs the [HOL Codex Plugin Scanner action](https://github.com/hashgraph-online/codex-plugin-scanner/tree/main/action) on every push and pull request, uploads SARIF into GitHub code scanning, and enforces a minimum scanner score plus severity gate for this plugin.

Broker-backed smoke test:

If your broker requires an API key, set `REGISTRY_BROKER_API_KEY` in your shell before running the command.

```bash
REGISTRY_BROKER_E2E_DISCOVERY_QUERY="<search phrase that should return your target candidate>" \
REGISTRY_BROKER_E2E_DISCOVERY_EXPECT_UAID="<uaid:aid:discoverable-agent>" \
REGISTRY_BROKER_E2E_UAID="<uaid:aid:target-agent>" \
REGISTRY_BROKER_E2E_MESSAGE="<your probe message>" \
REGISTRY_BROKER_E2E_EXPECT="<expected response substring>" \
pnpm run e2e:broker
```

Optional query-driven summon verification:

```bash
REGISTRY_BROKER_E2E_QUERY_SUMMON_QUERY="<query that should resolve to a chatable agent>" \
REGISTRY_BROKER_E2E_QUERY_SUMMON_EXPECT_UAID="<uaid:aid:query-selected-agent>" \
REGISTRY_BROKER_E2E_QUERY_SUMMON_EXPECT="<expected delegated response substring>" \
pnpm run e2e:broker
```

The smoke harness supports:

- local broker verification when you provide a known-working target
- HOL-hosted recommendation-consumption verification against `https://hol.org/registry/api/v1`
- dry-run summon verification with structured delegation briefs
- session-history summaries for follow-up work

## Repository layout

- `src/mcp.ts`: MCP tool definitions and orchestration
- `src/brief.ts`: structured delegation brief rendering
- `src/delegation.ts`: planner selection, fallback search, and summon helpers
- `src/planner.ts`: planner selection and shortlist formatting helpers
- `src/broker.ts`: broker client adapter
- `src/config.ts`: runtime configuration
- `src/tool-contracts.ts`: shared MCP schemas
- `src/tool-results.ts`: next-action and session-history summaries
- `scripts/e2e-local-broker.ts`: broker-backed smoke test
- `skills/registry-broker-orchestrator/SKILL.md`: Codex usage guidance

## Contributing

Please read our [Contributing Guide](./CONTRIBUTING.md) and [Code of Conduct](./CODE_OF_CONDUCT.md) before contributing.

For bugs and feature requests, use the [issue tracker](https://github.com/hashgraph-online/registry-broker-codex-plugin/issues/new/choose).

## Security

For security issues, see [SECURITY.md](./SECURITY.md).

## Maintainers

See [MAINTAINERS.md](./MAINTAINERS.md).

## License

Apache-2.0

[trust-badge-img]: https://img.shields.io/endpoint?url=https%3A%2F%2Fhol.org%2Fapi%2Fregistry%2Fbadges%2Fplugin%2Fhol%252Fregistry-broker-codex-plugin%3Fmetric%3Dtrust%26style%3Dflat
[trust-badge-link]: https://hol.org/registry/plugins/hol%2Fregistry-broker-codex-plugin

© HOL · Apache-2.0 · hashgraph-online/awesome-codex-plugins

Похожие плагины

Все плагины по теме «Настройка агента: память, контекст, субагенты» →
Neuronto ARD Registry: Agentic Resource Discovery (ARD) Index neuronto Neuronto ARD Registry: Agentic Resource Discovery (ARD) Index — MCP-сервер для Claude Code, который ищет ресурсы по публичным ARD-реестрам и показывает схемы MCP-инструментов. CX Codex +1 ★ 58звёзд репо AgentsKit Registry AgentsKit-io MCP-сервер AgentsKit Registry, который ищет готовых ИИ-агентов в каталоге AgentsKit и отдаёт команды установки прямо в чате. CX Codex +1 ★ 6звёзд репо machinehearts machinehearts MCP-сервер machinehearts для Claude Code, Cursor, Copilot и других IDE, который превращает AI-агентов в автономные сущности с реестром, поиском партнёров и системой репутации. CX Codex +1 2 660установок offer-claims-registry aaron-he-zhu Скилл offer-claims-registry ведёт реестр рекламных заявлений и предложений: сохраняет формулировки, подтверждения, условия и сроки проверки. Запросите доказательство для цифры или обновите условия оффера. CX Codex +1 1 100установок channel-registry aaron-he-zhu Скилл channel-registry ведёт единый реестр соцканалов бренда: аккаунты, состояния, ритм публикаций, права на UGC и адаптации тона. Факты пишутся в append-only поток событий, из которого пересобираются представления. CX Codex +1 1 100установок Cellarion Wine Registry jagduvi1 MCP-сервер Cellarion Wine Registry с публичным реестром вин и справочником по сортам, регионам и апелласьонам. Ищет без аккаунта и работает из любого MCP-клиента. CX Codex +1 ★ 34звёзд репо

Из того же набора391

Весь набор →
reviewable-html-workbench Плагин reviewable-html-workbench превращает HTML-документы агента в документы для браузерной проверки с inline-комментариями и повторными правками. Подходит для отчётов, дизайн-документов и таблиц сравнения. CX Codex ★ 1 596звёзд репо research-agent-skills Плагин research-agent-skills добавляет 281 скилл для научных исследований в Claude Code и Codex. Охватывает весь цикл: от поиска литературы и выдвижения гипотез до проверки цитат и ответов рецензентам. CX Codex ★ 1 596звёзд репо repopilot Плагин repopilot фиксирует срез репозитория на старте сессии и блокирует завершение работы агента, если тот ослабил тесты или убрал проверки безопасности. CX Codex ★ 1 596звёзд репо rekall Плагин rekall сжимает историю диалога в расширении Codex для VS Code, сохраняет письменную передачу задачи и продолжает работу один раз. CX Codex ★ 1 596звёзд репо account-video-downloader Плагин account-video-downloader пакетно выгружает все видео с публичных страниц авторов на YouTube, TikTok, Douyin, Kuaishou и Bilibili без водяных знаков. CX Codex ★ 1 596звёзд репо red-green-proof Плагин red-green-proof превращает подозрение на баг в проверяемое доказательство через цикл теста: падение, исправление и повторный откат. CX Codex ★ 1 596звёзд репо nueton-receipts Плагин nueton-receipts считает, сколько раз агент сказал «готово», и сверяет каждое утверждение с командами той же сессии: подтверждено, опровергнуто или не проверено. CX Codex ★ 1 596звёзд репо rag-reviewer Плагин rag-reviewer проводит ревью пулл-реквестов с учётом контекста всего репозитория через гибридный RAG, граф кода в Neo4j и инлайн-комментарии. CX Codex ★ 1 596звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой