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

herdr-codex-subagents — плагин для Claude Code: обзор и установка

Плагин herdr-codex-subagents открывает отдельные терминальные панели Herdr только для чтения под каждого субагента Codex и автоматически закрывает их после выполнения работы.

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

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

Что делает herdr-codex-subagents

Плагин организует обзор параллельных субагентов внутри терминала Herdr. Основная сессия остаётся в левой половине экрана, а панели субагентов раскладываются справа без перехвата фокуса ввода. Каждая такая панель транслирует компактный вывод локального процесса: вызовы шелла, правки файлов, обращения к MCP и статус выполнения.

Сам субагент остаётся в исходном процессе Codex — новая панель служит только средством просмотра и не порождает отдельный экземпляр программы. Для синхронизации состояний хуков используется файловая блокировка, а при повторном обращении к агенту плагин заново открывает нужный просмотрщик по связке agent_id и pane_id.

Инструмент работает исключительно внутри терминала Herdr при наличии переменной HERDR_ENV=1 на Linux или macOS. Для запуска требуются Python версии не ниже 3.10 и подтверждение пяти хуков плагина через команду /hooks.

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

  • следить за выводом параллельных субагентов без потери фокуса ввода
  • автоматически закрывать терминальные панели завершённых задач
  • отслеживать вызовы MCP и изменения файлов отдельными агентами
  • выявлять застрявшие или активные фоновые процессы в терминале

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

  • Запусти параллельную задачу через субагента для рефакторинга тестов
  • Раздели проверку типов и линтинг на двух отдельных субагентов
  • Проверь статус выполнения задач в открытых панелях Herdr

Как установить herdr-codex-subagents

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

/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install herdr-codex-subagents@awesome-codex-plugins

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

Вопросы о herdr-codex-subagents

Как установить herdr-codex-subagents в Claude Code?

Добавьте маркетплейс командой /plugin marketplace add hashgraph-online/awesome-codex-plugins, а затем установите плагин вызовом /plugin install herdr-codex-subagents@awesome-codex-plugins. После этого проверьте и подтвердите хуки в /hooks.

Что делает плагин herdr-codex-subagents?

Он открывает вспомогательные панели Herdr в правой части окна для каждого субагента Codex и закрывает их по завершении работы.

Какие системные требования нужны для работы плагина?

Необходимы терминал Herdr с поддержкой команд pane split, pane run и pane close, Python 3.10 или новее, а также операционная система Linux или macOS.

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

herdr-codex-subagents · MIT
<div align="center">
  <img src="docs/assets/logo.svg" width="96" alt="Herdr Codex Subagents logo">
  <h1>Herdr Codex Subagents</h1>
  <p>Open a read-only Herdr pane for every Codex subagent and close it when the work is done.</p>
</div>

<p align="center">
  <a href="https://github.com/arvkonstantin/herdr-codex-subagents/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/arvkonstantin/herdr-codex-subagents/actions/workflows/ci.yml/badge.svg"></a>
  <a href="https://codecov.io/gh/arvkonstantin/herdr-codex-subagents"><img alt="Coverage" src="https://codecov.io/gh/arvkonstantin/herdr-codex-subagents/graph/badge.svg"></a>
  <a href="https://github.com/arvkonstantin/herdr-codex-subagents/actions/workflows/codeql.yml"><img alt="CodeQL" src="https://github.com/arvkonstantin/herdr-codex-subagents/actions/workflows/codeql.yml/badge.svg"></a>
  <a href="https://github.com/arvkonstantin/herdr-codex-subagents/actions/workflows/dependency-review.yml"><img alt="Dependency review" src="https://github.com/arvkonstantin/herdr-codex-subagents/actions/workflows/dependency-review.yml/badge.svg"></a>
  <a href="https://hol.org/guard"><img alt="HOL Guard" src="https://img.shields.io/endpoint?url=https%3A%2F%2Fhol.org%2Fapi%2Fregistry%2Fbadges%2Fguard%2Farvkonstantin%2Fherdr-codex-subagents%3Fstyle%3Dflat-square"></a>
  <a href="https://scorecard.dev/viewer/?uri=github.com/arvkonstantin/herdr-codex-subagents"><img alt="OpenSSF Scorecard" src="https://api.scorecard.dev/projects/github.com/arvkonstantin/herdr-codex-subagents/badge"></a>
  <a href="https://github.com/arvkonstantin/herdr-codex-subagents/releases"><img alt="Release" src="https://img.shields.io/github/v/release/arvkonstantin/herdr-codex-subagents?display_name=tag&sort=semver"></a>
  <a href="LICENSE"><img alt="License" src="https://img.shields.io/github/license/arvkonstantin/herdr-codex-subagents"></a>
</p>

<p align="center">
  <a href="https://github.com/arvkonstantin/herdr-codex-subagents/stargazers"><img alt="Stars" src="https://img.shields.io/github/stars/arvkonstantin/herdr-codex-subagents?style=social"></a>
  <a href="https://github.com/arvkonstantin/herdr-codex-subagents/forks"><img alt="Forks" src="https://img.shields.io/github/forks/arvkonstantin/herdr-codex-subagents?style=social"></a>
  <a href="https://github.com/arvkonstantin/herdr-codex-subagents/issues"><img alt="Issues" src="https://img.shields.io/github/issues/arvkonstantin/herdr-codex-subagents"></a>
  <a href="https://github.com/arvkonstantin/herdr-codex-subagents/pulls"><img alt="Pull requests" src="https://img.shields.io/github/issues-pr/arvkonstantin/herdr-codex-subagents"></a>
  <a href="https://github.com/arvkonstantin/herdr-codex-subagents/graphs/contributors"><img alt="Contributors" src="https://img.shields.io/github/contributors/arvkonstantin/herdr-codex-subagents"></a>
  <img alt="Last commit" src="https://img.shields.io/github/last-commit/arvkonstantin/herdr-codex-subagents">
  <img alt="Commit activity" src="https://img.shields.io/github/commit-activity/m/arvkonstantin/herdr-codex-subagents">
  <img alt="Repository size" src="https://img.shields.io/github/repo-size/arvkonstantin/herdr-codex-subagents">
  <img alt="Primary language" src="https://img.shields.io/github/languages/top/arvkonstantin/herdr-codex-subagents">
  <img alt="Languages" src="https://img.shields.io/github/languages/count/arvkonstantin/herdr-codex-subagents">
</p>

<p align="center">
  <img src="docs/assets/herdr-subagents-demo.png" alt="Herdr showing three Codex subagents working in parallel">
</p>

## Installation

Add this repository as a Codex plugin marketplace, then install the plugin:

```bash
codex plugin marketplace add arvkonstantin/herdr-codex-subagents
codex plugin add herdr-codex-subagents@herdr-codex-subagents
```

Start a new Codex session inside Herdr. Open `/hooks`, review the five plugin hooks, and trust them.

For a local checkout, replace the GitHub repository in the first command with its absolute path.

## Upgrade

Refresh the Git marketplace and install the newest plugin version:

```bash
codex plugin marketplace upgrade herdr-codex-subagents
codex plugin add herdr-codex-subagents@herdr-codex-subagents
```

Start a new Codex session to load the update. If `/hooks` asks you to review updated hooks,
trust them before using subagent panes.

## What it does

- Keeps the parent in the left half and tiles subagent viewers in the right half without moving focus.
- Streams a compact view of each subagent's local Codex rollout.
- Reopens the matching viewer when Codex interacts with an existing subagent.
- Tracks the exact `agent_id` to `pane_id` relationship and closes the matching pane on completion.
- Does nothing outside a Herdr-managed pane.

The subagent remains owned by the original Codex process. The new pane only runs a viewer; it does
not start another Codex instance.

## How it works

```text
1 viewer    parent | A

2 viewers   parent | A
                   | B

4 viewers   parent | A | C
                   | B | D
```

The viewer renders assistant updates, shell commands, file changes, MCP calls, and terminal status.
The first viewer takes the right half. Further viewers split that half breadth-first, alternating
down and right at each level. Concurrent hook processes serialize state changes with a file lock.
`PostToolUse` resolves successful `send_message` and `followup_task` calls from the parent rollout,
so reused agents get a fresh viewer without keeping idle panes open. When a resumed session passes
an old pane ID, the hook uses the focused Codex pane in the current project. Session hooks clean up
tracked viewers after a session ends or before a parent pane is reused.

## Requirements

- [Herdr](https://herdr.dev) with the `pane split`, `pane run`, and `pane close` commands.
- Codex CLI with lifecycle hooks and native subagents. Tested with Codex CLI `0.160.1`
  and Herdr `0.9.3`.
- Python `3.10` or newer.
- Linux or macOS.

## Safety and privacy

The plugin activates only when `HERDR_ENV=1` and the parent pane can be resolved. Splits use
`--no-focus`, and cleanup refuses to close a pane whose ID matches the parent. Rollout files are read
locally and are never modified or transmitted.

## Configuration

The plugin works without configuration. To change how long a viewer remains visible after a terminal
rollout event, set `HERDR_SUBAGENT_CLOSE_GRACE` to a duration in seconds. The default is `0.35`.

Codex supplies `PLUGIN_ROOT` and `PLUGIN_DATA`. `CODEX_HOME` is respected when set and otherwise
defaults to `~/.codex`.

## Troubleshooting

- No pane appears: start Codex inside Herdr and trust the plugin hooks through `/hooks`.
- After upgrading, restart Codex and trust any newly added plugin hook through `/hooks`.
- A viewer is waiting: the child rollout is created asynchronously and will be attached when it appears.
- A stale viewer remains after a crash: start a new Codex session in the same parent pane to clean it up.
- Diagnostics are written to `plugin.log` in the Codex-provided `PLUGIN_DATA` directory.

When reporting a bug, include any relevant version information. Do not attach rollout files or
credentials.

## Development

The runtime has no third-party dependencies. Development uses [uv](https://docs.astral.sh/uv/):

```bash
uv sync --extra dev
uv run ruff check .
uv run pytest --cov --cov-report=term-missing
```

Tests use a fake Herdr client and never touch the developer's active session. Coverage must remain at
or above 90%.

Herdr Codex Subagents is an independent community project and is not affiliated with OpenAI or
Herdr. See [Contributing](CONTRIBUTING.md), [Security](SECURITY.md), the
[Code of Conduct](CODE_OF_CONDUCT.md), and the [MIT License](LICENSE).

© Konstantin Aristov · MIT · hashgraph-online/awesome-codex-plugins

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

Все плагины по теме «Настройка агента: память, контекст, субагенты» →
openrig-herdr mvschwarz Скилл openrig-herdr открывает флот агентов OpenRig как живые тайлы терминала через herdr: риг, под, миссия, срез или сохранённое представление становятся интерактивными панелями с вложенными tmux attach. CX Codex +1 ★ 8 928звёзд репо herdr-core herdrdev Скилл herdr-core для Claude Code, который управляет субагентами, фоновыми задачами и терминалами через CLI hc. Запускается для координации агентов, работы на удалённых машинах или настройки интерфейса Herdr. CX Codex +1 827установок herdr-orchestration Pedro Nauck Скилл herdr-orchestration инструктирует главного агента запускать воркеры Claude и Codex в отдельных вкладках herdr через socket CLI и следить за их статусом. CX Codex +1 210установок herdr-fleet larcane97 Скилл herdr-fleet для Claude Code, который запускает несколько кодинг-агентов параллельно в панелях herdr, каждый под своим профилем clausona. Раздаёт задачи по разным аккаунтам или API-моделям вроде GLM и DeepSeek. CX Codex +1 ★ 62звёзд репо herdr herdrdev Скилл даёт агенту доступ к Herdr — терминальному мультиплексору для кодинг-агентов: панели, вкладки, воркспейсы и запуск команд. CX Codex +1 87 100установок implement-with-subagents chrisbanes Скилл implement-with-subagents координирует выполнение графа задач соло-агентом или пулом субагентов с изолированными коммитами и обязательным независимым ревью. CX Codex +1 807установок

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

Весь набор →
hotl Плагин hotl ведёт задачу через восемь фаз: брейншторм, письменный план, исполнение, ревью и проверка тестами. Для фич, рефакторингов и правок, которые страшно пускать наугад. CX Codex ★ 1 596звёзд репо codex-honcho Плагин codex-honcho сохраняет контекст и решения между перезапусками сессий с помощью сервиса памяти Honcho, избавляя от повторения инструкций. CX Codex ★ 1 596звёзд репо homie Плагин homie помогает создавать multiplayer-игры, музыку и видео, а затем публиковать их через студию на своём Cloudflare. CX Codex ★ 1 596звёзд репо hol-guard-plugin Проверяет вызовы инструментов перед выполнением и блокирует подозрительные операции. Встраивается в локальный слой безопасности, требует предварительно установленный hol-guard CLI. CX Codex ★ 1 596звёзд репо hera-unity Плагин hera-unity учит агента работать с запущенным Unity Editor через CLI hera-agent-unity: смотреть сцену, менять ассеты, гонять тесты и Play Mode. CX Codex ★ 1 596звёзд репо hera-godot Плагин hera-godot подключает агента к запущенному редактору Godot 4.x через Hera CLI: правки сцен и узлов, сигналы, запуск игры и проверки в рантайме с коротким JSON в ответе. CX Codex ★ 1 596звёзд репо graymatter Плагин graymatter подключает долговременную память и общее контекстное хранилище для агентов Claude Code и Codex через протокол MCP. CX Codex ★ 1 596звёзд репо codex-goal-progress Плагин codex-goal-progress показывает прогресс по цели Codex и расход токенов. Для каждой новой цели его нужно включать отдельно. CX Codex ★ 1 596звёзд репо

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

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