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

openrig-herdr — скилл для Claude Code: что делает и как установить

Скилл openrig-herdr открывает флот агентов OpenRig как живые тайлы терминала через herdr: риг, под, миссия, срез или сохранённое представление становятся интерактивными панелями с вложенными tmux attach.

Apache-2.0 ★ 8 928 обновлён 2026-11-12

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add mvschwarz/openrig --skill openrig-herdr -a claude-code
Открыть на GitHub

Что делает openrig-herdr

Скилл учит агента работать с rig terminal open, rig terminal views и rig terminal status — командами, которые превращают группу агентов в стену терминальных тайлов. Каждый тайл — это вложенная сессия tmux attach к агенту, которым владеет демон; вы видите живую сессию, а не снимок. Скилл объясняет, что представление (<view>) — это имя рига, pod:<rig>/<podNamespace>, mission:<id>, slice:<id> или сохранённая группа, и как интерпретировать результат: opened (открытые агенты), absent (агенты из представления, которых сейчас нет), degraded (агенты, которые структурно не могут стать тайлом, с причиной — например, хост по HTTP без ssh-пути).

Представления mission: и slice: открываются как read-only по конструкции (tmux attach -r), потому что они режут через риги; риг и pod: — интерактивны. Дублирующиеся тайлы (один агент в двух открытых представлениях) работают, если панели одного размера — tmux зажимает множество клиентов до минимального, и это задокументированный лимит. Колесо мыши прокручивает историю панели, выделение мышью копирует в системный буфер без команд — это настройки демона по умолчанию.

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

  • открыть всех агентов рига или пода как живые терминальные тайлы
  • посмотреть агентов миссии или среза в режиме read-only, не вмешиваясь
  • прочитать результат открытия как партицию: opened, absent, degraded с именами и причинами
  • открыть представление по запросу агента («открой все мои риги плюс миссию как виды»)
  • проверить доступные представления через rig terminal views

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

  • открой риг acme-web как терминальную стену
  • покажи агентов миссии site-relaunch в herdr
  • выведи список доступных представлений OpenRig

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

1Через Skills CLI (Vercel)

npx skills add mvschwarz/openrig --skill openrig-herdr -a claude-code

2Вручную: положить файлы

~/.claude/skills/openrig-herdr/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/openrig-herdr/

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

Вопросы об openrig-herdr

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

Выполни npx skills add mvschwarz/openrig --skill openrig-herdr -a claude-code, потом прочитай ~/.claude/skills/openrig-herdr/SKILL.md.

Что делает openrig-herdr?

Учит агента открывать флот агентов OpenRig через rig terminal open: риг, под, миссия, срез или сохранённая группа становятся живыми тайлами терминала (вложенные tmux attach к агентским сессиям). Агент читает результат как партицию: opened, absent, degraded — и понимает, что миссии и срезы открываются read-only, а риги — интерактивно.

Чем отличается mission: от рига?

Представление mission:<id> собирается из агентов, которые работают на конкретной миссии, по живой топологии — состав динамический. Риг — это фиксированная инвентаризация. Миссия открывается как read-only по конструкции, риг — интерактивно.

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

SKILL.md · Apache-2.0
---
name: openrig-herdr
description: >
  Use when opening OpenRig fleet terminals as a herdr wall — turning a rig, pod, mission, slice, or
  saved view into live interactive agent tiles via `rig terminal`, watching another rig read-only,
  or driving herdr on an agent's request ("open all my rigs + a mission as views"). Covers the
  `rig terminal open|views|status` verbs, the honest-partial/degrade reading of the result, the
  read-only-by-construction rail for cross-rig views, scroll/copy out of the box, and the
  same-size-only duplicate-pane limit. herdr is the default, proof-gated provider.
metadata:
  openrig:
    stage: candidate
    sibling_skills:
      - openrig-cmux
      - openrig-user
---

# openrig-herdr

OpenRig decides **which** agents make up a view (a rig, a pod, a mission, a slice, or a saved
group); **herdr** renders the pixels. A view opens as live, interactive terminal tiles — each tile
is a nested `tmux attach` to a daemon-owned agent session, so you get the real session, not a
snapshot. OpenRig owns the semantics; herdr owns the surface. You drive it entirely through the
`rig terminal` CLI, which rides the installed herdr binary at arm's length — never link, embed, or
plugin it.

## The whole surface — three verbs

```bash
rig terminal open <view> [--provider herdr|cmux|rex] [--json]   # herdr is the default provider
rig terminal open <view> --provider herdr-app                    # in the herdr-app window this runs in; plain open inside herdr-app does the same when the window answers (--window always asks for a new desktop window; the open installs OpenRig's mods there)
rig terminal views [--json]                                     # list openable views (saved + derived)
rig terminal status [--provider] [--json]                       # provider liveness / health
```

Inside Rex, `rig terminal open <view> --window` opens the view as a new Rex session instead, on the same Rex
server as your terminal, and asks the Rex app to show it. `--provider rex` opens it there from anywhere.

`<view>` resolves, in order, to one of:
- a **rig name** — every live agent in that rig, auto-laid-out;
- **`pod:<rig>/<podNamespace>`** — every live agent in one pod of a rig (the rig's inventory filtered by pod);
- **`mission:<id>`** — the agents working that mission (derived live from topology);
- **`slice:<id>`** — the agents working that slice (derived live);
- a **saved-view name** — a user-defined group (see Saved views).

## Compose a view from a sentence

An agent asked "open all my rigs plus a mission as views" runs one `open` per target:

```bash
rig terminal open acme-web                     # a whole rig, live agents as tiles
rig terminal open mission:site-relaunch        # exactly the agents working the mission
rig terminal open slice:search-filters      # the agents working one slice
```

No hand-listing of seats: the mission/slice membership is derived from live topology at open time.

## Read the result honestly — partial and degrade

The result is a partition — every seat lands in exactly one bucket, each **named**:

- **opened** — the live agents now showing as tiles.
- **absent** — seats in the view that aren't currently live: **named and skipped, never silently
  dropped.** A view that opens *some* of its seats is a success (the partial is disclosed) and exits
  **0**. Only a view where **no** pane opens exits **non-zero**.
- **degraded** — an agent that structurally cannot tile, named **with the reason**. The v1 case:
  an agent on a host registered over HTTP has no ssh path, so its tile can't be composed — it reads
  as **"host `<id>` is http-registered; tiles need ssh"** and is skipped, never dropped. (ssh-reachable
  hosts tile via an ssh-wrapped attach; full http-host tiling is deferred to the cross-host transport
  seam.)

Read `--json` to branch on the partition programmatically; the exit code alone tells you opened-something
(0) vs opened-nothing (non-zero).

## Read-only — who's interactive, who's watch-only

Read-only is composed into the pane at open time — a read-only tile is a `tmux attach -r`, the client
reports `readonly=1`, and it **physically cannot send input**. The current policy, by view kind:

- **A rig view or a `pod:` view is interactive** — you asked for that rig (or pod) directly, so you
  can drive its agents.
- **`mission:` and `slice:` views are read-only by construction** — these derived views cut across
  rigs; you watch and scroll, you don't keystroke into them.
- **A saved view is per-member** — each member carries its own `readOnly` (omit = interactive;
  `true` = `attach -r`).

So you don't have to remember to be careful: the view kind (and, for a saved view, the per-member
flag) sets it at open time.

## Safety rails (hard — the fleet-safety rail)

- A tile is a **view** (a nested `tmux attach`) of a daemon-owned session. **Never** move, join, kill,
  or re-parent a daemon-owned pane. Closing a tile detaches one tmux client — the daemon's session is
  untouched and its addressing (send/capture/nudge) is unaffected.
- Host-local read-only viewing mutates nothing. Anything that would change a **live** daemon session's
  shared state (e.g. flipping a tmux option on a running seat) is a config/design change — prove it in
  an isolated environment, never live-flip in production.

## Scroll + copy work out of the box

On a freshly-launched agent tile the mouse wheel scrolls the pane's history and a drag-select copies
to your **system** clipboard — with no tmux commands typed. This rides the daemon's terminal defaults
(a per-session scroll option set at launch, plus the daemon tmux server's clipboard defaults). Honest
timing: agents that were already running before this shipped pick up wheel-scroll at their **next
natural relaunch** (the scroll default is per-session and running seats are never retro-flipped);
system-clipboard copy works immediately (it's server-wide).

## Limits — state them, don't paper over them

- **Tile chrome v1 = a plain label** (agent + slice). Rich per-tile status is roadmap.
- **Duplicate / multi-view membership** (the same agent live in two views at once) works — put the
  duplicates in **same-size panes**. Different-sized duplicate panes have an inherent tmux
  multi-client resize mismatch (tmux clamps to the smallest client); it is **documented, not fixed** —
  don't expect a setting to remove it.
- **Inner tmux status bar** is hidden by default (herdr provides the chrome); one config key
  (`terminal.status_bar`) flips it back on for raw-tmux / no-provider surfaces, and the flip applies
  to **future launches only**.
- **Coming back to a view:** each `rig terminal open <view> --provider herdr` adds a new workspace,
  numbered when the name is taken (`<view> (2)`). To come back, focus the view's open space in Herdr.
  From inside Herdr, `rig terminal open <view> --window` focuses a matching space with live tiles
  instead of adding one.
- **After a Herdr server restart or update** (without `--handoff`), Herdr restores the layout and
  labels. A tile reattaches when Herdr took its restart command at open (Herdr 0.9.2 or later). The
  open result names a tile whose command Herdr didn't take; a tile over SSH, or for a runtime Herdr
  doesn't recognise, has none. Those come back as empty shells while the seats keep running: reopen
  the view, then close the old space.
- **Herdr's status for a tile is Herdr's own reading** of its screen. It can show a seat as idle or
  unknown while OpenRig shows it waiting (`needs-input`). Two cases are known: a narrow tile that
  wraps Claude's footer, and a tile that shows the inner tmux status line. That line shows when
  `terminal.status_bar` is on, or for a seat session OpenRig adopted rather than created, which keeps
  its own tmux `status`. To find waiting seats, use OpenRig's own view (`rig ps --nodes` or the TUI)
  or the Feed.

## Saved views — the library (`terminal-views.yaml`)

In v1 you **create** a saved view by **hand-authoring** `terminal-views.yaml` — there is no save/write
verb (`open` / `views` / `status` are the whole surface; a `rig terminal save <id>` verb is a named
stretch/follow-up). You **reopen** it like any other view: `rig terminal open <id>`.

The file lives at the OpenRig home root (resolved via `getDefaultOpenRigPath()`), is written
atomically (tmp + rename), and is byte-stable. **Only hand-authored saved views live here — derived
views (a rig, `pod:<rig>/<pod>`, `mission:<id>`, `slice:<id>`) are computed live and never written to
this file.**

Schema — use these field names **exactly**, in this order; **omit** optional fields when absent
(never write `null`):

```yaml
version: 1
views:
  - id: my-view-id             # required — the id `rig terminal open <id>` takes
    name: Human Name           # required
    members:
      - seat: pod-member@rig    # required — the canonical session name
        label: agent . slice    # optional — pane label
        host: some-host-id      # optional — STRUCTURED host id (NEVER a `member@rig@host` string);
                                #            omit for local. ssh-registered hosts tile;
                                #            http-registered hosts honest-degrade (named + skipped, with reason)
        tmuxSession: sessname   # optional — defaults to `seat`
        readOnly: true          # optional — omit = interactive; true = `tmux attach -r`
```

An agent composing a saved view on request **writes this YAML** and then opens the id:
`rig terminal open my-view-id` (add `--provider cmux` for cmux). The library is provider-agnostic —
the same saved view opens in herdr or cmux.

## AGPL / clean-room

Driving herdr through the `rig terminal` CLI (which talks to the installed herdr binary over its
CLI/socket) is arm's-length and fine. Do **not** link herdr's source, embed it in-process, or ship a
herdr plugin — a plugin needs legal review. This skill and its docs are clean-room: patterns only,
never herdr source text.

© mvschwarz · Apache-2.0 · mvschwarz/openrig

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
herdr-codex-subagents Konstantin Aristov Плагин herdr-codex-subagents открывает отдельные терминальные панели Herdr только для чтения под каждого субагента Codex и автоматически закрывает их после выполнения работы. CX Codex ★ 1 596звёзд репо 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установок smux ShawnPana Скилл smux связывает агентов в сессиях tmux и управляет панелями терминала через утилиту tmux-bridge. Пригодится при параллельной работе нескольких процессов. CX Codex +1 2 900установок

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

Весь набор →
rig-bundles-and-shareable-artifacts Скилл rig-bundles-and-shareable-artifacts для Claude Code помогает создавать, проверять и устанавливать бандлы OpenRig. Включается при авторинге и аудите переносимости бандла. CX Codex +1 ★ 8 928звёзд репо openrig-upgrade Скилл openrig-upgrade для Claude Code ведёт агента через обновление OpenRig CLI и демона. Он проверяет изменения по шагам и сохраняет работающие места и локальные файлы плагинов. CX Codex +1 ★ 8 928звёзд репо openrig-software-factory Скилл openrig-software-factory организует работу команды агентов OpenRig в репозитории проекта. Помогает распределять роли между Claude Code и Codex для написания и проверки кода. CX Codex +1 ★ 8 928звёзд репо openrig-skills Скилл помогает агенту в OpenRig выбрать нужный контекст для передачи работы, отладки или восстановления места. Он также объясняет, как найти и загрузить другие скиллы через rig. CX Codex +1 ★ 8 928звёзд репо openrig-cmux Скилл openrig-cmux для Claude Code открывает терминалы агентов OpenRig в тайлах cmux командой rig terminal --provider cmux. Позволяет мониторить риги и миссии. CX Codex +1 ★ 8 928звёзд репо openrig-architect Скилл openrig-architect помогает спроектировать команду агентов для OpenRig, подготовить спецификации и разобраться, почему запущенные агенты работают не так, как задумано. CX Codex +1 ★ 8 928звёзд репо messaging-the-human Скилл messaging-the-human для агента: найти нужного человека в проекте, проверить канал и отправить короткий бриф с решением или апдейтом через CLI rig. CX Codex +1 ★ 8 928звёзд репо human-in-the-loop Скилл human-in-the-loop превращает человека в надёжный узел очереди задач вместо чат-собеседника. Он классифицирует завершение этапа и привлекает разработчика только ради реальных решений. CX Codex +1 ★ 8 928звёзд репо

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

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