[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6MD4VP622NWD7XTJXP1YD10":3,"skill-same:01M6MD4VP622NWD7XTJXP1YD10":67},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":39,"linkOnly":40,"markdownContent":41,"markdownBody":42,"frontMatter":43,"refName":44,"commitSha":45,"skillDirectory":46,"forksCount":47,"repositoryHtmlUrl":48,"repositoryHomepageUrl":49,"ownerHtmlUrl":50,"ownerBlogUrl":49,"ownerDescription":51,"updatedAt":52,"install":53,"resources":66},"01M6MD4VP622NWD7XTJXP1YD10","herdr",null,"Control Herdr, a terminal multiplexer for coding agents. Use only when the user explicitly mentions Herdr or asks to use Herdr to inspect or control panes, tabs, workspaces, commands, or another agent. Do not use merely because a task could benefit from a background terminal, delegation, or parallel work. Requires HERDR_ENV=1.","compozy\u002Fcompozy","compozy","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F205107042?v=4","01M6JWVTXX4DX38AWZ7SPFEKEV","CompozyOS","01M6JWVV2P34GM1PDATVB2EV05",2871,"MIT","https:\u002F\u002Fgithub.com\u002Fcompozy\u002Fcompozy\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fherdr\u002FSKILL.md",[],[5,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38],"only","when","for","inspect","multiplexer","env","control","commands","task","do","workspaces","terminal","use","user","work","parallel","coding","panes","delegation","coding agents","2026-11-10 10:12:30",false,"---\nname: herdr\ndescription: \"Control Herdr, a terminal multiplexer for coding agents. Use only when the user explicitly mentions Herdr or asks to use Herdr to inspect or control panes, tabs, workspaces, commands, or another agent. Do not use merely because a task could benefit from a background terminal, delegation, or parallel work. Requires HERDR_ENV=1.\"\n---\n\n# Herdr\n\nHerdr organizes terminals into workspaces, tabs, and panes, recognizes coding agents running inside panes, and exposes the current session through the `herdr` CLI.\n\nBefore issuing any control command, verify that this agent is running inside a Herdr-managed pane:\n\n```bash\ntest \"${HERDR_ENV:-}\" = 1\n```\n\nIf the check fails, say that you are not running inside Herdr and stop. Do not inspect or control the focused Herdr session from outside Herdr.\n\nWhen the check passes, the `herdr` binary in `PATH` talks to the current session. Use it to inspect neighboring work, create terminal layout, start agents and commands, read output, and wait for state changes.\n\n## Learn the current CLI\n\nThe installed binary is the authority for command syntax. Start with:\n\n```bash\nherdr --help\n```\n\nThen print the relevant command group by running the group without a subcommand:\n\n```bash\nherdr agent\nherdr pane\nherdr workspace\nherdr tab\nherdr worktree\nherdr terminal\nherdr notification\nherdr integration\nherdr session\nherdr machine\n```\n\nDo not run bare `herdr` for discovery; it launches or attaches the TUI. Do not probe a mutating nested command by omitting arguments. Commands such as `herdr workspace create` are valid with defaults and will execute.\n\nMost control commands return JSON. Read identifiers and state from those responses instead of predicting them.\n\n## Understand layout, panes, and agents\n\nChoose the primitive that matches the job:\n\n- Workspace, tab, and pane topology organize terminal locations.\n- Pane commands control raw terminals, shells, tests, servers, input, and output.\n- Agent commands control the recognized coding agent currently occupying a pane.\n\nA pane exists whether or not it contains an agent. `agent start` requires an existing available shell pane and never creates, splits, or moves layout. Use pane commands for ordinary processes. Use agent commands when Herdr must validate agent identity or interpret `idle`, `working`, `blocked`, `done`, and `unknown` lifecycle states.\n\nAgent commands accept either a unique live agent name or the pane ID currently hosting that agent. They do not accept terminal IDs or bare agent-kind labels. Names must match `[a-z][a-z0-9_-]{0,31}` and be unique among live agents. A name follows the current pane occupant and is cleared when that agent exits, is released, or is replaced.\n\n`idle` and `done` both mean the agent is ready for input. The CLI\u002FAPI uses the server's seen state to distinguish them; explicit focus commands mark the target seen, while reads do not. Each TUI client tracks viewed completions independently, so its Done badge can differ from the CLI or another client's badge. `blocked` means Herdr recognized an approval or question UI. `unknown` means an agent is present but Herdr cannot classify it confidently; it does not prove completion.\n\n## Use IDs and caller context\n\nPublic IDs are opaque stable handles:\n\n- workspace: `w1`\n- tab: `w1:t1`\n- pane: `w1:p1`\n\nClosed tab and pane IDs are not reused. A pane moved into another workspace receives a new workspace-qualified pane ID. After `pane move`, continue with `.result.move_result.pane.pane_id` or the live agent name. The old value is reported as `.result.move_result.previous_pane_id`; only the moved process's inherited caller context keeps resolving that old ID, so do not use it as a general agent target.\n\nHerdr injects the caller's context into each managed pane:\n\n```bash\nprintf '%s\\n' \"$HERDR_WORKSPACE_ID\" \"$HERDR_TAB_ID\" \"$HERDR_PANE_ID\"\n```\n\nPrefer `--current` when a pane command should target the calling pane. An omitted `pane split` target uses the calling pane when `HERDR_PANE_ID` is available, otherwise the focused pane. Other commands may use the UI-focused pane, which can belong to the user or another client.\n\nDiscover live state with:\n\n```bash\nherdr workspace list\nherdr tab list --workspace \"$HERDR_WORKSPACE_ID\"\nherdr pane current --current\nherdr pane list --workspace \"$HERDR_WORKSPACE_ID\"\nherdr agent list\n```\n\nCreation responses expose the IDs to use next. `workspace create` returns `.result.workspace`, `.result.tab`, and `.result.root_pane`. `tab create` returns `.result.tab` and `.result.root_pane`. `pane split` returns the new pane as `.result.pane`.\n\nIDs and live agent names are scoped to one server. Two saved SSH machines can both have `w1:p1` or an agent named `reviewer`. Selecting a machine in the TUI does not retarget commands running in your pane: without `--machine`, they still use the inherited session and socket context.\n\nTo control a saved SSH machine, use the same global prefix for discovery and every later command:\n\n```bash\nherdr --machine \u003Clabel-or-id> agent list\nherdr --machine \u003Clabel-or-id> pane list\nherdr --machine \u003Clabel-or-id> agent prompt \u003Cremote-agent-name> \"Reply with your current status.\" --wait --timeout 120000\n```\n\nThe selector must be an enabled saved profile ID or a unique, case-sensitive label, not an arbitrary SSH hostname. Commands use that profile's remote session without an open TUI. Do not combine `--machine` with `--session` or `--remote`. Discover IDs on that machine; inherited local IDs and `--current` do not identify remote panes.\n\nBoth installations must support machine API forwarding, and the remote server must already be running and API-compatible. Forwarding never installs, starts, or restarts a server and never falls back to Local. Local configuration, session management, installation commands, and interactive attachment are not forwarded. Remote worktree paths must be absolute, `~`, or start with `~\u002F`; plugin link paths must be absolute. A connection failure does not prove a mutation was not applied: inspect remote state before retrying.\n\n`herdr machine list` lists saved connection profiles, not a cross-machine pane inventory; add `--json` for scripts. Only add, remove, enable, or disable profiles when the user asks. Removing a profile disconnects the client but does not stop remote sessions. Adding a machine uses the remote default session unless `--remote-session` is explicitly supplied. Setup asks before stopping an incompatible server and defaults to No; do not approve replacement without the user's consent. Experimental handoff is not part of `machine add`.\n\n## Start and coordinate an agent\n\nDefault to a sibling pane in the current tab and the current working directory. Do not create a workspace, tab, worktree, or different cwd unless the user explicitly requests that topology or location.\n\nHonor a direction requested by the user. Otherwise inspect the caller pane:\n\n```bash\nherdr pane layout --pane \"$HERDR_PANE_ID\"\n```\n\nSplit a wide pane to the right and a narrow or tall pane down. Avoid repeated same-direction splits that create unusably narrow columns or short rows. Keep the user's focus in the calling pane and explicitly preserve the caller's working directory:\n\n```bash\nherdr pane split --current --direction right --cwd \"$PWD\" --no-focus\n```\n\nReplace `right` with `down` when appropriate. Read the new pane ID from `.result.pane.pane_id`.\n\nAn available shell pane must be at its interactive prompt, with the shell itself in the foreground and no foreground command, editor, or agent running. Start a supported agent in that pane with a useful unique name:\n\n```bash\nherdr agent start reviewer --kind codex --pane \u003Creturned-pane-id>\n```\n\nUse the kind requested by the user. Run `herdr agent` to inspect the installed kind list and options. Pass native agent arguments only after `--`:\n\n```bash\nherdr agent start reviewer --kind codex --pane \u003Creturned-pane-id> -- \u003Cagent-args...>\n```\n\nA successful `agent start` returns only after Herdr detects the expected agent in the same pane and considers it ready for interactive input. If the agent is blocked during startup, the command returns `agent_not_ready` immediately but keeps the name available for `agent read` and `agent send-keys`. Wait until the agent becomes idle before prompting it. Startup defaults to a 30-second timeout.\n\nSubmit work through the agent surface:\n\n```bash\nherdr agent prompt reviewer \"Review the current diff and report only actionable findings.\" --wait --timeout 120000\n```\n\n`agent prompt` honors the pane's live bracketed-paste mode and sends text followed by encoded Enter as one ordered submission. It reports successful submission only after both have been written; that alone does not prove the agent started a turn. For Codex on Windows, Herdr sends a paste boundary before Enter so submission does not depend on prompt size. It rejects an agent already waiting at an approval or question dialog with `agent_blocked` before sending any input. Inspect the blocked UI and ask the user before answering it. For normal agent work, `--wait` is enough: it waits for the first settled `idle`, `done`, or `blocked` state. Do not repeat those defaults with `--until`.\n\nWith `--wait`, a prompt sent from a non-working state must produce observed `working` or `blocked` activity. After submission, Herdr waits up to five seconds for that activity; unrelated `idle`, `done`, or session changes do not satisfy this gate. It returns `agent_prompt_stalled` if no activity is observed, or `timeout` if the caller's timeout expires first. The caller timeout includes submission time. Without a timeout, the settled-state wait is indefinite after activity is observed. This wait tracks lifecycle state, not an individual turn; if the agent is already working, completion of the active turn may satisfy it.\n\nUse `--until` only for a state-specific workflow, such as waiting for an already-running agent to request input:\n\n```bash\nherdr agent wait reviewer --until blocked --timeout 120000\n```\n\nWithout `--until`, standalone `agent wait` uses the same settled-state defaults as `agent prompt --wait`.\n\nUse logical keys for interactive agent UI controls:\n\n```bash\nherdr agent send-keys reviewer esc\nherdr agent send-keys reviewer ctrl+c\n```\n\nHerdr validates all keys before writing any bytes. Read the result through the resolved agent:\n\n```bash\nherdr agent get reviewer\nherdr agent read reviewer --source recent-unwrapped --lines 120\n```\n\nIf a wait fails or returns `blocked`, inspect `agent get` and `agent read` before deciding what input to send. A timeout or stalled response does not prove the prompt was never delivered; do not blindly submit it again. Use the pane surface only when raw terminal control is intentional.\n\n## Run an ordinary command in another pane\n\nCreate a sibling pane with the same geometry rule, preserve the caller's working directory, and keep user focus unchanged:\n\n```bash\nherdr pane split --current --direction right --cwd \"$PWD\" --no-focus\n```\n\nRead the new pane ID from `.result.pane.pane_id`, then run and inspect the command:\n\n```bash\nherdr pane run \u003Creturned-pane-id> \"just test\"\nherdr pane wait-output \u003Creturned-pane-id> --match \"test result\" --timeout 120000\nherdr pane read \u003Creturned-pane-id> --source recent-unwrapped --lines 120\n```\n\n`pane run` atomically sends command text and Enter. `pane wait-output` searches the selected snapshot immediately, so output that already exists can match. Use `--match \u003Ctext>` for a literal substring or `--regex \u003Cpattern>` for a Rust regular expression. Omitting `--timeout` allows an indefinite wait.\n\nUse the read source that matches the task:\n\n- `visible`: the currently rendered viewport.\n- `recent`: recent rendered output, including soft wraps.\n- `recent-unwrapped`: recent output with soft wraps joined; prefer it for logs and transcripts.\n- `detection`: the plain-text bottom-buffer snapshot used for agent detection.\n\nUse `--format ansi` when colors and terminal styling are evidence. Otherwise use text.\n\n`--lines` asks Herdr for more rows from the pane's available screen and host scrollback. Alternate-screen rows do not enter ordinary host scrollback. For supported idle agents, Herdr can collect application-owned history and restore the viewport afterward, but not every application or response can be recovered this way.\n\nIf a larger recent read still does not reveal the completed response, ask the agent to write it as Markdown in a temporary directory and reply only with the file path, then read that file on the same machine. Use this only as a fallback; do not request file output in the initial prompt.\n\n## Safety and coordination rules\n\n- Use `--no-focus` for background work unless the user asked to switch context.\n- Use `--current`, an explicit pane ID, or a unique agent name. Do not rely on another client's focused pane.\n- Parse IDs from JSON responses. Do not derive them from sidebar order or examples.\n- Do not close workspaces, tabs, panes, or sessions you did not create unless the user explicitly asked. `workspace close --group` closes the primary workspace and its linked worktree workspaces; never add it merely to bypass `workspace_group_close_required`.\n- Use `--trust-repository` only after the user has verified the repository. It grants per-request Git trust; it is not a routine retry for a failed worktree command.\n- Client and server versions can differ after an update. Check `herdr status` before relying on new server features. A missing method is not permission to stop or upgrade a server.\n- Never run `herdr server stop` from an active session unless the user explicitly intends to stop the server and its pane processes.\n- Never kill the main Herdr process. Use named test sessions for experiments that need an isolated server.\n- CLI server errors are JSON on stderr with exit status 1. CLI syntax errors exit with status 2.\n","# Herdr\n\nHerdr organizes terminals into workspaces, tabs, and panes, recognizes coding agents running inside panes, and exposes the current session through the `herdr` CLI.\n\nBefore issuing any control command, verify that this agent is running inside a Herdr-managed pane:\n\n```bash\ntest \"${HERDR_ENV:-}\" = 1\n```\n\nIf the check fails, say that you are not running inside Herdr and stop. Do not inspect or control the focused Herdr session from outside Herdr.\n\nWhen the check passes, the `herdr` binary in `PATH` talks to the current session. Use it to inspect neighboring work, create terminal layout, start agents and commands, read output, and wait for state changes.\n\n## Learn the current CLI\n\nThe installed binary is the authority for command syntax. Start with:\n\n```bash\nherdr --help\n```\n\nThen print the relevant command group by running the group without a subcommand:\n\n```bash\nherdr agent\nherdr pane\nherdr workspace\nherdr tab\nherdr worktree\nherdr terminal\nherdr notification\nherdr integration\nherdr session\nherdr machine\n```\n\nDo not run bare `herdr` for discovery; it launches or attaches the TUI. Do not probe a mutating nested command by omitting arguments. Commands such as `herdr workspace create` are valid with defaults and will execute.\n\nMost control commands return JSON. Read identifiers and state from those responses instead of predicting them.\n\n## Understand layout, panes, and agents\n\nChoose the primitive that matches the job:\n\n- Workspace, tab, and pane topology organize terminal locations.\n- Pane commands control raw terminals, shells, tests, servers, input, and output.\n- Agent commands control the recognized coding agent currently occupying a pane.\n\nA pane exists whether or not it contains an agent. `agent start` requires an existing available shell pane and never creates, splits, or moves layout. Use pane commands for ordinary processes. Use agent commands when Herdr must validate agent identity or interpret `idle`, `working`, `blocked`, `done`, and `unknown` lifecycle states.\n\nAgent commands accept either a unique live agent name or the pane ID currently hosting that agent. They do not accept terminal IDs or bare agent-kind labels. Names must match `[a-z][a-z0-9_-]{0,31}` and be unique among live agents. A name follows the current pane occupant and is cleared when that agent exits, is released, or is replaced.\n\n`idle` and `done` both mean the agent is ready for input. The CLI\u002FAPI uses the server's seen state to distinguish them; explicit focus commands mark the target seen, while reads do not. Each TUI client tracks viewed completions independently, so its Done badge can differ from the CLI or another client's badge. `blocked` means Herdr recognized an approval or question UI. `unknown` means an agent is present but Herdr cannot classify it confidently; it does not prove completion.\n\n## Use IDs and caller context\n\nPublic IDs are opaque stable handles:\n\n- workspace: `w1`\n- tab: `w1:t1`\n- pane: `w1:p1`\n\nClosed tab and pane IDs are not reused. A pane moved into another workspace receives a new workspace-qualified pane ID. After `pane move`, continue with `.result.move_result.pane.pane_id` or the live agent name. The old value is reported as `.result.move_result.previous_pane_id`; only the moved process's inherited caller context keeps resolving that old ID, so do not use it as a general agent target.\n\nHerdr injects the caller's context into each managed pane:\n\n```bash\nprintf '%s\\n' \"$HERDR_WORKSPACE_ID\" \"$HERDR_TAB_ID\" \"$HERDR_PANE_ID\"\n```\n\nPrefer `--current` when a pane command should target the calling pane. An omitted `pane split` target uses the calling pane when `HERDR_PANE_ID` is available, otherwise the focused pane. Other commands may use the UI-focused pane, which can belong to the user or another client.\n\nDiscover live state with:\n\n```bash\nherdr workspace list\nherdr tab list --workspace \"$HERDR_WORKSPACE_ID\"\nherdr pane current --current\nherdr pane list --workspace \"$HERDR_WORKSPACE_ID\"\nherdr agent list\n```\n\nCreation responses expose the IDs to use next. `workspace create` returns `.result.workspace`, `.result.tab`, and `.result.root_pane`. `tab create` returns `.result.tab` and `.result.root_pane`. `pane split` returns the new pane as `.result.pane`.\n\nIDs and live agent names are scoped to one server. Two saved SSH machines can both have `w1:p1` or an agent named `reviewer`. Selecting a machine in the TUI does not retarget commands running in your pane: without `--machine`, they still use the inherited session and socket context.\n\nTo control a saved SSH machine, use the same global prefix for discovery and every later command:\n\n```bash\nherdr --machine \u003Clabel-or-id> agent list\nherdr --machine \u003Clabel-or-id> pane list\nherdr --machine \u003Clabel-or-id> agent prompt \u003Cremote-agent-name> \"Reply with your current status.\" --wait --timeout 120000\n```\n\nThe selector must be an enabled saved profile ID or a unique, case-sensitive label, not an arbitrary SSH hostname. Commands use that profile's remote session without an open TUI. Do not combine `--machine` with `--session` or `--remote`. Discover IDs on that machine; inherited local IDs and `--current` do not identify remote panes.\n\nBoth installations must support machine API forwarding, and the remote server must already be running and API-compatible. Forwarding never installs, starts, or restarts a server and never falls back to Local. Local configuration, session management, installation commands, and interactive attachment are not forwarded. Remote worktree paths must be absolute, `~`, or start with `~\u002F`; plugin link paths must be absolute. A connection failure does not prove a mutation was not applied: inspect remote state before retrying.\n\n`herdr machine list` lists saved connection profiles, not a cross-machine pane inventory; add `--json` for scripts. Only add, remove, enable, or disable profiles when the user asks. Removing a profile disconnects the client but does not stop remote sessions. Adding a machine uses the remote default session unless `--remote-session` is explicitly supplied. Setup asks before stopping an incompatible server and defaults to No; do not approve replacement without the user's consent. Experimental handoff is not part of `machine add`.\n\n## Start and coordinate an agent\n\nDefault to a sibling pane in the current tab and the current working directory. Do not create a workspace, tab, worktree, or different cwd unless the user explicitly requests that topology or location.\n\nHonor a direction requested by the user. Otherwise inspect the caller pane:\n\n```bash\nherdr pane layout --pane \"$HERDR_PANE_ID\"\n```\n\nSplit a wide pane to the right and a narrow or tall pane down. Avoid repeated same-direction splits that create unusably narrow columns or short rows. Keep the user's focus in the calling pane and explicitly preserve the caller's working directory:\n\n```bash\nherdr pane split --current --direction right --cwd \"$PWD\" --no-focus\n```\n\nReplace `right` with `down` when appropriate. Read the new pane ID from `.result.pane.pane_id`.\n\nAn available shell pane must be at its interactive prompt, with the shell itself in the foreground and no foreground command, editor, or agent running. Start a supported agent in that pane with a useful unique name:\n\n```bash\nherdr agent start reviewer --kind codex --pane \u003Creturned-pane-id>\n```\n\nUse the kind requested by the user. Run `herdr agent` to inspect the installed kind list and options. Pass native agent arguments only after `--`:\n\n```bash\nherdr agent start reviewer --kind codex --pane \u003Creturned-pane-id> -- \u003Cagent-args...>\n```\n\nA successful `agent start` returns only after Herdr detects the expected agent in the same pane and considers it ready for interactive input. If the agent is blocked during startup, the command returns `agent_not_ready` immediately but keeps the name available for `agent read` and `agent send-keys`. Wait until the agent becomes idle before prompting it. Startup defaults to a 30-second timeout.\n\nSubmit work through the agent surface:\n\n```bash\nherdr agent prompt reviewer \"Review the current diff and report only actionable findings.\" --wait --timeout 120000\n```\n\n`agent prompt` honors the pane's live bracketed-paste mode and sends text followed by encoded Enter as one ordered submission. It reports successful submission only after both have been written; that alone does not prove the agent started a turn. For Codex on Windows, Herdr sends a paste boundary before Enter so submission does not depend on prompt size. It rejects an agent already waiting at an approval or question dialog with `agent_blocked` before sending any input. Inspect the blocked UI and ask the user before answering it. For normal agent work, `--wait` is enough: it waits for the first settled `idle`, `done`, or `blocked` state. Do not repeat those defaults with `--until`.\n\nWith `--wait`, a prompt sent from a non-working state must produce observed `working` or `blocked` activity. After submission, Herdr waits up to five seconds for that activity; unrelated `idle`, `done`, or session changes do not satisfy this gate. It returns `agent_prompt_stalled` if no activity is observed, or `timeout` if the caller's timeout expires first. The caller timeout includes submission time. Without a timeout, the settled-state wait is indefinite after activity is observed. This wait tracks lifecycle state, not an individual turn; if the agent is already working, completion of the active turn may satisfy it.\n\nUse `--until` only for a state-specific workflow, such as waiting for an already-running agent to request input:\n\n```bash\nherdr agent wait reviewer --until blocked --timeout 120000\n```\n\nWithout `--until`, standalone `agent wait` uses the same settled-state defaults as `agent prompt --wait`.\n\nUse logical keys for interactive agent UI controls:\n\n```bash\nherdr agent send-keys reviewer esc\nherdr agent send-keys reviewer ctrl+c\n```\n\nHerdr validates all keys before writing any bytes. Read the result through the resolved agent:\n\n```bash\nherdr agent get reviewer\nherdr agent read reviewer --source recent-unwrapped --lines 120\n```\n\nIf a wait fails or returns `blocked`, inspect `agent get` and `agent read` before deciding what input to send. A timeout or stalled response does not prove the prompt was never delivered; do not blindly submit it again. Use the pane surface only when raw terminal control is intentional.\n\n## Run an ordinary command in another pane\n\nCreate a sibling pane with the same geometry rule, preserve the caller's working directory, and keep user focus unchanged:\n\n```bash\nherdr pane split --current --direction right --cwd \"$PWD\" --no-focus\n```\n\nRead the new pane ID from `.result.pane.pane_id`, then run and inspect the command:\n\n```bash\nherdr pane run \u003Creturned-pane-id> \"just test\"\nherdr pane wait-output \u003Creturned-pane-id> --match \"test result\" --timeout 120000\nherdr pane read \u003Creturned-pane-id> --source recent-unwrapped --lines 120\n```\n\n`pane run` atomically sends command text and Enter. `pane wait-output` searches the selected snapshot immediately, so output that already exists can match. Use `--match \u003Ctext>` for a literal substring or `--regex \u003Cpattern>` for a Rust regular expression. Omitting `--timeout` allows an indefinite wait.\n\nUse the read source that matches the task:\n\n- `visible`: the currently rendered viewport.\n- `recent`: recent rendered output, including soft wraps.\n- `recent-unwrapped`: recent output with soft wraps joined; prefer it for logs and transcripts.\n- `detection`: the plain-text bottom-buffer snapshot used for agent detection.\n\nUse `--format ansi` when colors and terminal styling are evidence. Otherwise use text.\n\n`--lines` asks Herdr for more rows from the pane's available screen and host scrollback. Alternate-screen rows do not enter ordinary host scrollback. For supported idle agents, Herdr can collect application-owned history and restore the viewport afterward, but not every application or response can be recovered this way.\n\nIf a larger recent read still does not reveal the completed response, ask the agent to write it as Markdown in a temporary directory and reply only with the file path, then read that file on the same machine. Use this only as a fallback; do not request file output in the initial prompt.\n\n## Safety and coordination rules\n\n- Use `--no-focus` for background work unless the user asked to switch context.\n- Use `--current`, an explicit pane ID, or a unique agent name. Do not rely on another client's focused pane.\n- Parse IDs from JSON responses. Do not derive them from sidebar order or examples.\n- Do not close workspaces, tabs, panes, or sessions you did not create unless the user explicitly asked. `workspace close --group` closes the primary workspace and its linked worktree workspaces; never add it merely to bypass `workspace_group_close_required`.\n- Use `--trust-repository` only after the user has verified the repository. It grants per-request Git trust; it is not a routine retry for a failed worktree command.\n- Client and server versions can differ after an update. Check `herdr status` before relying on new server features. A missing method is not permission to stop or upgrade a server.\n- Never run `herdr server stop` from an active session unless the user explicitly intends to stop the server and its pane processes.\n- Never kill the main Herdr process. Use named test sessions for experiments that need an isolated server.\n- CLI server errors are JSON on stderr with exit status 1. CLI syntax errors exit with status 2.\n",{"name":5,"description":7},"main","65613632bb94072e27fc5015d17387e28a870111",".agents\u002Fskills\u002Fherdr",187,"https:\u002F\u002Fgithub.com\u002Fcompozy\u002Fcompozy","https:\u002F\u002Fcompozy.com","https:\u002F\u002Fgithub.com\u002Fcompozy","An OS for AI agents","2026-11-15 03:55:11",{"source":8,"skillName":5,"commands":54,"prompt":64,"zipAvailable":65},[55,58,61],{"tool":56,"command":57},"npx","npx skills add compozy\u002Fcompozy --skill herdr",{"tool":59,"command":60},"bunx","bunx skills add compozy\u002Fcompozy --skill herdr",{"tool":62,"command":63},"pnpm","pnpm dlx skills add compozy\u002Fcompozy --skill herdr","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fcompozy\u002Fcompozy\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fherdr\u002FSKILL.md",true,[],[68,100,125,147,158,170],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":72,"licenseFileUrl":73,"sourceHtmlUrl":74,"categories":75,"keywords":81,"publishedAt":39},"01M6MD7W312X49RNEJRKKVKTTD","security-review","Security code review for vulnerabilities. Use when asked to \"security review\", \"find vulnerabilities\", \"check for security issues\", \"audit security\", \"OWASP review\", or review code for injection, XSS, authentication, authorization, cryptography issues. Provides systematic review with confidence-based reporting.","CC-BY-SA-4.0","https:\u002F\u002Fgithub.com\u002Fcompozy\u002Fcompozy\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fsecurity-review\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fcompozy\u002Fcompozy\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fsecurity-review\u002FSKILL.md",[76],{"categoryNo":77,"categoryName":78,"taxonomyType":79,"taxonomyTypeDesc":80},"01JBSEEDCAT000000000000007","代码审查","SCENARIO","使用场景",[82,83,84,85,86,87,88,89,90,91,92,93,94,95,96,97,98,21,31,27,20,99],"security","security review","review","injection","authentication","code review","issues","Bash","code","xss","audit","systematic","read","reporting","cryptography","owasp","systematic review","audit security",{"skillNo":101,"name":102,"nameZh":6,"description":103,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":104,"categories":105,"keywords":111,"publishedAt":39},"01M6MD5K93G1GP8VA56V2FEPZV","lesson-learned","Extract evidence-backed engineering lessons from recent changes or incidents. Use for requested reflection, lesson updates, or retiring an obsolete workflow rule.","https:\u002F\u002Fgithub.com\u002Fcompozy\u002Fcompozy\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Flesson-learned\u002FSKILL.md",[106],{"categoryNo":107,"categoryName":108,"taxonomyType":109,"taxonomyTypeDesc":110},"01JBSEEDCAT000000000000039","教师与教育","PROFESSION","适用职业",[112,113,114,21,115,116,117,118,119,120,121,122,31,123,124],"learned","lesson learned","lesson","changes","evidence","incidents","workflow","engineering","updates","extract","rule","lessons","reflection",{"skillNo":126,"name":9,"nameZh":6,"description":127,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":128,"categories":129,"keywords":130,"publishedAt":39},"01M6MDPNH3J60VRCGTPHVTHZR8","Operate CompozyOS. Use when working with CompozyOS sessions, agents, native tools, skills, tasks, Loops, Goals, Terminal, desktops and windows, automation, extensions, or configuration. Don't use for unrelated projects.","https:\u002F\u002Fgithub.com\u002Fcompozy\u002Fcompozy\u002Fblob\u002Fmain\u002Fskills\u002Fcompozy\u002FSKILL.md",[],[9,131,132,133,134,21,135,136,31,137,138,139,140,141,142,143,144,30,145,146,20],"sessions","windows","projects","operate","runtime","true","automation","tasks","extensions","with","loops","unrelated","goals","native","configuration","Tools",{"skillNo":148,"name":149,"nameZh":6,"description":150,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":151,"categories":152,"keywords":153,"publishedAt":39},"01M6MDPHKNPQHJ1TF21E1HSFNF","remotion-upgrade","Upgrade Remotion, and related packages","https:\u002F\u002Fgithub.com\u002Fcompozy\u002Fcompozy\u002Fblob\u002Fmain\u002Fpackages\u002Flaunch-video\u002F.agents\u002Fskills\u002Fremotion-upgrade\u002FSKILL.md",[],[154,155,156,157],"remotion upgrade","upgrade","Remotion","packages",{"skillNo":159,"name":160,"nameZh":6,"description":161,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":162,"categories":163,"keywords":164,"publishedAt":39},"01M6MDPFT91ZWC7Z09MRNZPAJG","remotion-studio","Preview a Remotion video","https:\u002F\u002Fgithub.com\u002Fcompozy\u002Fcompozy\u002Fblob\u002Fmain\u002Fpackages\u002Flaunch-video\u002F.agents\u002Fskills\u002Fremotion-studio\u002FSKILL.md",[],[165,166,156,167,168,169],"studio","remotion studio","Video","preview","remotion video",{"skillNo":171,"name":172,"nameZh":6,"description":173,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":174,"categories":175,"keywords":176,"publishedAt":39},"01M6MDPD5XDZPYB5NAZGKMPXWC","remotion-saas","Build an app with Remotion","https:\u002F\u002Fgithub.com\u002Fcompozy\u002Fcompozy\u002Fblob\u002Fmain\u002Fpackages\u002Flaunch-video\u002F.agents\u002Fskills\u002Fremotion-saas\u002FSKILL.md",[],[177,178,156,140,179,180],"saas","remotion saas","app","build"]