herdr
/herdr
Steruje Herdr przez jeden skrypt: odczytuje terminale innych agentów, tworzy przestrzenie, uruchamia i przenosi agentów.
- Autor
- langri-sha ↗
- Repozytorium
- skills ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 13.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 19
- Skrypty
- 16
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 13.11.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
- 16 skryptów w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.
Skrypty: scripts/herdr.py, tests/support.py, tests/test_close.py, tests/test_deliver.py, tests/test_dialog.py, tests/test_launch.py, tests/test_launch_placement.py, tests/test_move.py, tests/test_prompt.py, tests/test_read.py, tests/test_relaunch.py, tests/test_roster.py, tests/test_seat.py, tests/test_space.py, tests/test_watch.py, tests/test_whois.py
Co robi i kiedy
Steruje Herdr przez jeden skrypt: odczytuje terminale innych agentów, tworzy przestrzenie, uruchamia i przenosi agentów.
Oryginalny opis (EN)
Drives Herdr, the workspace for coding agents, through one script that works in both the Herdr app (hc and herdr-app) and the Herdr TUI (herdr): finds the terminal this agent runs in, identifies and reads other agents' terminals, lists the roster, makes spaces, launches, briefs, relaunches and moves agents. Use when the user mentions Herdr, the Herdr app, hc, herdr-app, panes, terminals or spaces, or wants to start, read, brief, restart or close an agent in Herdr. Not for tmux, or for starting a new worktree session (create-session).
Jak działa
- Contract
- Task to verb
- Exit codes
Podgląd SKILL.md
---
name: herdr
description: >-
Drives Herdr, the workspace for coding agents, through one script that works
in both the Herdr app (hc and herdr-app) and the Herdr TUI (herdr): finds the
terminal this agent runs in, identifies and reads other agents' terminals,
lists the roster, makes spaces, launches, briefs, relaunches and moves agents.
Use when the user mentions Herdr, the Herdr app, hc, herdr-app, panes,
terminals or spaces, or wants to start, read, brief, restart or close an agent
in Herdr. Not for tmux, or for starting a new worktree session
(create-session).
metadata:
author: langri-sha
version: '1.0.0'
---
# Herdr
Two Herdrs can run side by side: the app (`herdr-app` with `hc`; spaces, tabs
and terminals addressed `t7`) and the TUI (`herdr`; workspaces, tabs and panes
addressed `w1:p2`). `scripts/herdr.py` hides the difference. Every verb prints
one JSON line, `{ok, verb, ...}`, and exits with a code from the table below.
```
python3 <skill-dir>/scripts/herdr.py <verb> [options]
```
## Contract
1. **Run `seat` first.** It walks up from this process to the controlling tty
and reports which tmux pane, app terminal or TUI pane owns it. Environment
variables (`HC_TERMINAL_ID`, `HERDR_*`, `TMUX_PANE`) only nominate
candidates, because nested sessions and background jobs inherit them; the tty
decides. Pass its `target` to the other verbs. If `backend` is `tmux`, or
`seat` exits 4 (`no_seat`), this is not a Herdr seat: say so and stop.
2. **`session_match: false`** means the terminal belongs to another session: a
background job holding an inherited address, or a continued session. Ask
which terminal is the user's before placing anything beside it.
`session_match: null` means the machine records no session for terminals;
`session_reason` says why. See [references/app.md](references/app.md).
3. **From the app, never run `herdr` with `--current` or without a target.** The
TUI CLI still works there and acts on whichever TUI pane the user focuses.
4. **Never guess state from screen text.** `status` and `dialog` come from the
verbs; a `blocked` terminal needs the user, so show its dialog and ask.
`dialog --answer` acts only on the folder-trust dialog and exits 9 on any
other; never answer a permission dialog yourself.
5. **Never sleep to wait.** Use `hc wait`, `herdr agent wait` or `hc events`.
6. **Launch through `launch`, one agent at a time.** It types into an
interactive shell so the user's shell functions run; `hc run claude` or the
binary itself would skip them. A function may ask the user to approve each
launch (a password manager, say), and a burst times out: tell the user before
each launch, and on a launcher failure stop and report it. It never retries.
7. **Choose a permission mode on every launch.** By default `launch` passes a
flag, so the mode is the flag's. `--no-permission-flag` leaves the configured
default in effect. The agent counts as started once it reports any status,
`working` included, within 15 seconds (`--timeout`); a dialog or the shell
prompt coming back ends the wait at once.
8. **A shell is idle by its process tree**, never by `status` alone, which goes
stale. `launch` refuses a shell that runs a program.
9. **Exit an agent with `relaunch`**, which presses ctrl+c twice. `/exit` sent
as text arrives tagged and may never run, and a raw `kill` of the shell skips
the checks that keep the terminal at its address.
10. **Clean up only terminals you started.** `close` refuses any terminal whose
parent is not the caller, and `launch` makes the caller the parent.
Syntax for everything the verbs do not cover is in the CLIs' own manuals, which
track the installed versions: `hc --skill`, `herdr-app --skill`, and
`herdr --help` with each group's help (`herdr agent`, `herdr pane`, ...).
`launch` accepts repeated `--arg=VALUE` options and `--prompt-file PATH` for
agent options and a startup prompt. The file is read verbatim as one argument;
when the prompt starts work immediately, a working status counts as a successful
start. A blocked or failed launch is reported without resending the prompt.
`--no-permission-flag` leaves the agent's configured permission mode in effect;
the launcher cannot verify which mode it selected. It cannot be combined with
`--permission-flag`.
## Task to verb
| Task | Verb |
| ------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------- |
| Where am I, and in which Herdr? | `seat` |
| Who runs in terminal T, and how do I resume it? | `whois T` |
| What is on terminal T's screen? | `read T`, with `--tail N` or `--footer` |
| Who is running, blocked, or missing bypass? | `roster`, with `--label k=v` (app only) |
| Make a space for a mission | `space NAME`, with `--folder`, `--tab`, `--keep-focus` |
| Start an agent in an idle shell | `launch --in T --agent claude --model M` |
| Start an agent in a new terminal, placed by space and tab; it is the caller's child unless `--no-parent` | `launch --space S --tab T --name N` or `--worker-of T` (app only) |
| Brief an agent | `deliver T "text"` or `deliver T --file path` |
| What dialog is a blocked terminal showing, and can the folder-trust dialog be answered? | `dialog T`, with `--answer OPTION` for the folder-trust dialog only |
| Swap, resume or restart the agent in a terminal; every failure says whether the agent exited (`exited_agent`) and carries `previous` | `relaunch T`, with `--resume`, `--agent`, `--model`, `--handoff PATH` |
| Finish with a worker you started | `close T`, with `--brief PATH` to file its brief under `closed/` (app only) |
| Follow the status of a group of terminals | `watch --label k=v`, then run the printed command as a monitor (app only) |
| Move a placed terminal to another space and tab | `move T --space S --tab T` |
Failures, with what to tell the user:
[references/failures.md](references/failures.md).
For a saved session, `relaunch T --agent claude --resume-session ID` uses that
exact ID, even in an idle shell with stale labels. A running agent must match
the requested kind and session. `--arg=VALUE` adds an agent argument; pass a
separate option for each literal argument. `--resume` and `--resume-session` are
mutually exclusive.
## Exit codes
| Code | Meaning |
| ---- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| 0 | Done |
| 1 | A Herdr command failed; `reason` carries its message |
| 2 | Usage error |
| 3 | `not_found`: no such terminal, pane or agent |
| 4 | `no_seat`: this process is not in a Herdr app or TUI terminal |
| 5 | `space_exists`: a space of that name is open; ask the user |
| 6 | `launcher_failed`: the launch line failed, or the shell prompt came back |
| 7 | `timeout`: not ready in time; `status` and `footer` show where it stopped |
| 8 | The terminal is not in the state the verb needs, such as a shell running a program |
| 9 | `blocked`: a dialog is open; `dialog` has its `kind`, `msg` and `options`. Ask the user |
| 10 | `unconfirmed`: sent, but the agent did not start working; it may have arrived, so read before sending again |
| 11 | `finished`: the terminal ended |
| 12 | `not_owned`: the terminal's parent is not the caller, so it is not yours to close |
| 13 | `held_focus` or `held_input`: the terminal has the user's focus, or text is typed at its prompt, so its shell is left alone. Ask the user |
Pliki w paczce (19)
- SKILL.md 10 KB
- references/app.md 2 KB
- references/failures.md 22 KB
- scripts/herdr.py 78 KB
- tests/support.py 3 KB
- tests/test_close.py 5 KB
- tests/test_deliver.py 6 KB
- tests/test_dialog.py 7 KB
- tests/test_launch.py 16 KB
- tests/test_launch_placement.py 9 KB
- tests/test_move.py 9 KB
- tests/test_prompt.py 2 KB
- tests/test_read.py 7 KB
- tests/test_relaunch.py 31 KB
- tests/test_roster.py 9 KB
- tests/test_seat.py 8 KB
- tests/test_space.py 5 KB
- tests/test_watch.py 2 KB
- tests/test_whois.py 10 KB
Wersje
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · langri-sha/skills | 100 | MIT |
| vanducng/skills | 100 | MIT |
| herdrdev/herdr | 100 | Apache-2.0 |
| sammcj/agentic-coding | 100 | Apache-2.0 |
| dkarter/dotfiles | 100 | MIT |
| edmundmiller/dotfiles | 100 | MIT |
| yassimba/loom | 100 | Apache-2.0 |
| Mineru98/skills-store | 100 | MIT |
| davidondrej/skills | 100 | MIT |
Migawka bazy z 13.11.2026 · wersja paczki 78ae5ed9d5ca (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100herdr-helper
Kieruje pracą w Herdr do właściwego produktu i wbudowanej instrukcji, gdy trzeba ustawić agentów, terminale, układy lub motywy. - 100hc-agent
Zarządza flotą agentów AI w aplikacji Herdr przez hc: dzieli pracowników, wysyła polecenia, czyta wyniki i sprząta po zakończeniu. - 96move
Przenosi przestrzenie robocze lub karty herdr między sesjami i wznawia agentów Claude lub Codex w sesji docelowej. - 100herdr-agent
Zarządza flotami agentów AI w Herdr: korzeń i podagenci w jednej karcie, start, prompt, oczekiwanie, odczyt i monitorowanie przez CLI herdr agent oraz sterowanie dowolnym panelem. - 90herdr-guide
Pokazuje, jak sterować agentami i panelami w Herdr: uruchamiać je, wysyłać prompty, czytać status i przenosić. - 90herdr-orchestra
Koordynuje pracę kilku agentów-pracowników w Herdr: dzieli zadania, porównuje wyniki i zbiera rezultaty.