docs: publish preview documentation
This commit is contained in:
kangal-bot
parent
d78e3d3b51
commit
e7c96206f7
|
|
@ -81,13 +81,13 @@ Pane input addresses the terminal regardless of its current occupant. Agent inpu
|
|||
|
||||
At the CLI, both `pane read` and `agent read` print terminal text directly. The default is UTF-8 text with ANSI escapes stripped; use `--format ansi` or `--ansi` to preserve terminal escapes where the source exposes them. The `detection` source is always plain text. For recent sources, `--lines N` selects the last N rendered terminal rows before optional unwrapping; without it, reads default to 80 rows. For `visible` and `detection`, omitting `--lines` returns the full snapshot, while specifying it keeps the last N newline-delimited lines. The socket API returns the text at `.result.read.text`.
|
||||
|
||||
## Known caveat: alternate-screen output
|
||||
## Alternate-screen history reads
|
||||
|
||||
Full-screen agents such as Claude Code and OpenCode may render in the terminal's alternate screen. Alternate-screen rows do not enter Herdr's host scrollback. `--lines` can only request more rows from the pane's available screen and host scrollback; it cannot create missing history. If increasing `--lines` returns no additional response text, the pane is probably using the alternate screen and those response rows are no longer retained. A larger font or smaller pane makes this more likely.
|
||||
Full-screen agents such as Claude Code and OpenCode render transcript history in the terminal's alternate screen instead of Herdr's host scrollback. For an idle, recognized agent at the bottom of its transcript, text reads from `recent` or `recent-unwrapped` automatically use the agent's mouse-scroll interface when `--lines` requests more than the visible screen. Herdr collects overlapping pages and returns the viewport to the bottom before completing the read. The same behavior applies to `pane read` when the pane contains that agent; it requires no additional option.
|
||||
|
||||
Ask the agent for concise responses, enlarge the pane or use a smaller font, or use the agent's own transcript and scrolling controls. After scrolling inside the agent, use `--source visible` to read the page it currently renders.
|
||||
Other reads remain passive. Herdr does not move the application viewport for `visible`, `detection`, or ANSI reads, output waits and subscriptions, a manually scrolled agent, a direct attachment, or an application that does not report mouse-wheel input. An explicit `agent read --lines N` that needs alternate-screen history returns `agent_not_idle` while the agent is working, blocked, or unknown; wait for idle and retry, or use `--source visible`. Other recent reads return the available screen and host scrollback as before.
|
||||
|
||||
After that failed read, ask the agent to write its complete response as Markdown in a temporary directory and reply only with the file path, then read the file directly. Use this only as a fallback; do not request file output in the initial prompt.
|
||||
If a full response is still unavailable, ask the agent to write it as Markdown in a temporary directory and reply only with the file path, then read the file directly.
|
||||
|
||||
Successful `agent start`, `agent prompt`, and `agent wait` commands return the current agent at `.result.agent`. `pane wait-output` returns `.result.pane_id`, `.result.matched_line`, and the matched snapshot at `.result.read`.
|
||||
|
||||
|
|
|
|||
|
|
@ -3,7 +3,7 @@ title: Agent skill file
|
|||
description: Install Herdr instructions for Claude Code or another coding agent.
|
||||
---
|
||||
|
||||
Herdr ships a reusable agent skill file at [`SKILL.md`](https://github.com/ogulcancelik/herdr/blob/master/SKILL.md).
|
||||
Herdr ships a reusable agent skill file at [`skills/herdr/SKILL.md`](https://github.com/herdrdev/herdr/blob/master/skills/herdr/SKILL.md).
|
||||
|
||||
Install that file into any coding agent that supports reusable skills or custom instructions. The skill teaches the agent how to control Herdr from inside a Herdr pane.
|
||||
|
||||
|
|
@ -21,22 +21,24 @@ With the skill installed, an agent can:
|
|||
- wait for servers, tests, or another agent to finish
|
||||
- start helper agents in sibling panes
|
||||
|
||||
The skill is not a separate app or service. It is a markdown instruction file for agents.
|
||||
The skill is not a separate app or service. It is a markdown instruction file for agents. If Herdr is already installed, run `herdr --skill` to print the release-matched copy bundled with that binary.
|
||||
|
||||
## Install it
|
||||
|
||||
Install the skill with `npx skills`:
|
||||
|
||||
```bash
|
||||
npx skills add ogulcancelik/herdr --skill herdr -g
|
||||
npx skills add herdrdev/herdr --skill herdr -g
|
||||
```
|
||||
|
||||
If you installed the skill while it lived at the repository root, rerun this add command once instead of using `skills update`. The add command replaces the oversized copy and records the new location.
|
||||
|
||||
The `-g` flag installs it globally for supported agents. Omit `-g` to install it into the current project.
|
||||
|
||||
Use the repository copy as the manual fallback and source of truth:
|
||||
|
||||
```text
|
||||
https://github.com/ogulcancelik/herdr/blob/master/SKILL.md
|
||||
https://github.com/herdrdev/herdr/blob/master/skills/herdr/SKILL.md
|
||||
```
|
||||
|
||||
For agents with a skill system, install that file as a skill named `herdr`. For agents without a skill system, paste the file into the agent's project or user instructions.
|
||||
|
|
@ -62,4 +64,4 @@ The full command guide lives in the skill file itself. It covers pane IDs, `pane
|
|||
|
||||
Read the source file here:
|
||||
|
||||
[Open `SKILL.md` on GitHub →](https://github.com/ogulcancelik/herdr/blob/master/SKILL.md)
|
||||
[Open `SKILL.md` on GitHub →](https://github.com/herdrdev/herdr/blob/master/skills/herdr/SKILL.md)
|
||||
|
|
|
|||
|
|
@ -14,11 +14,11 @@ Automatic detection works out of the box for common coding agents. The important
|
|||
| Agent | State authority | Integration role |
|
||||
| --- | --- | --- |
|
||||
| Pi | lifecycle hooks when installed; otherwise screen manifest | state and session |
|
||||
| OMP | lifecycle hooks when installed | state |
|
||||
| OMP | lifecycle hooks when installed | state and session |
|
||||
| GitHub Copilot CLI | screen manifest | session |
|
||||
| Devin CLI | screen manifest | session |
|
||||
| Kimi Code CLI | lifecycle hooks when installed; otherwise screen manifest | state and session |
|
||||
| Hermes Agent | lifecycle hooks when installed; otherwise screen manifest | state and session |
|
||||
| Hermes Agent | screen manifest | session |
|
||||
| Qoder CLI | screen manifest | session |
|
||||
| Droid | screen manifest | session |
|
||||
| OpenCode | lifecycle plugin when installed; otherwise screen manifest | state and session |
|
||||
|
|
@ -29,7 +29,7 @@ Automatic detection works out of the box for common coding agents. The important
|
|||
| Cursor Agent CLI | screen manifest | session |
|
||||
| Amp | screen manifest | none |
|
||||
| Grok CLI | screen manifest | session |
|
||||
| Antigravity CLI | screen manifest | none |
|
||||
| Antigravity CLI | screen manifest | session |
|
||||
| Kiro CLI | screen manifest | none |
|
||||
| Maki | screen manifest | none |
|
||||
|
||||
|
|
@ -45,12 +45,14 @@ For agents without complete lifecycle hooks, Herdr identifies the foreground pro
|
|||
|
||||
The screen snapshot comes from the recent bottom of the pane buffer, not the scrolled viewport. If you scroll back in Herdr, detection still follows the live agent UI at the bottom.
|
||||
|
||||
Claude Code, Codex, GitHub Copilot CLI, Droid, Qoder CLI, Cursor Agent CLI, and Grok CLI integrations are intentionally not lifecycle authorities. They provide native session identity for restore, but their hooks do not cover the whole lifecycle. They can miss permission approval results, escape interrupts, or other transitions. For those agents, Herdr still uses screen manifest detection.
|
||||
Integrations marked `session` in the table above are intentionally not lifecycle authorities. They provide native session identity for restore, but their hooks do not cover the whole lifecycle. They can miss permission approval results, escape interrupts, or other transitions. For those agents, Herdr still uses screen manifest detection.
|
||||
|
||||
## VMs and sandbox wrappers
|
||||
|
||||
On Linux and macOS, a host-visible wrapper can hide the real agent process from Herdr. Set `HERDR_AGENT=<agent>` on the wrapper command to tell Herdr which existing agent screen manifest to use. For example, run `HERDR_AGENT=claude fence -- claude` on Linux or `HERDR_AGENT=claude nono run --profile claude-code -- claude` on macOS. The hint is scoped to that foreground process; setting it only inside a VM or container is not visible to Herdr, and you should avoid exporting it globally unless every inherited foreground process should be treated as that agent.
|
||||
|
||||
Some restricted Linux runtimes do not expose a terminal foreground process group. Start the Herdr server with `HERDR_PROCESS_DETECTION=child-groups` to opt into direct child-process-group inference when native detection is unavailable. Native detection remains preferred, and the default `native` mode never performs this inference. The opt-in mode is best effort: a newer background job can be mistaken for the foreground job. The variable is read by the server and requires a restart; set it in the remote server environment rather than on an attaching client.
|
||||
|
||||
## Blocked state
|
||||
|
||||
Blocked detection is deliberately strict for screen-manifest agents. Herdr only marks `blocked` when the live bottom-buffer snapshot matches known visible approval, question, or permission UI. If no manifest rule matches for a known agent, Herdr falls back to `idle` and labels that fallback as `default_known_agent_idle_fallback` in explain output.
|
||||
|
|
|
|||
|
|
@ -135,10 +135,10 @@ A workspace is the top-level project or work context. Creating one also creates
|
|||
## Worktrees
|
||||
|
||||
```bash
|
||||
herdr worktree list [--workspace ID | --cwd PATH] [--json]
|
||||
herdr worktree create [--workspace ID | --cwd PATH] [--branch NAME] [--base REF] [--path PATH] [--label TEXT] [--focus] [--no-focus] [--json]
|
||||
herdr worktree open [--workspace ID | --cwd PATH] (--path PATH | --branch NAME) [--label TEXT] [--focus] [--no-focus] [--json]
|
||||
herdr worktree remove --workspace ID [--force] [--json]
|
||||
herdr worktree list [--workspace ID | --cwd PATH]
|
||||
herdr worktree create [--workspace ID | --cwd PATH] [--branch NAME] [--base REF] [--path PATH] [--label TEXT] [--focus] [--no-focus]
|
||||
herdr worktree open [--workspace ID | --cwd PATH] (--path PATH | --branch NAME) [--label TEXT] [--focus] [--no-focus]
|
||||
herdr worktree remove --workspace ID [--force]
|
||||
```
|
||||
|
||||
Worktrees are normal Herdr workspaces with Git checkout provenance. `worktree create` creates a Git worktree checkout, opens it as a workspace, and groups it with the parent repo workspace. If `--branch` names an existing local branch, Herdr checks it out; otherwise it creates the branch from `--base` or `HEAD`. Without `--path`, Herdr creates the checkout under `<worktrees.directory>/<repo>/<branch-slug>`.
|
||||
|
|
@ -479,6 +479,7 @@ These meanings apply to reads. For `pane wait-output` only, both `recent` and `r
|
|||
| `HERDR_CONFIG_PATH` | Override the config file path. |
|
||||
| `HERDR_SESSION` | Select a named session for CLI commands. |
|
||||
| `HERDR_SOCKET_PATH` | Low-level socket path override. |
|
||||
| `HERDR_PROCESS_DETECTION` | Linux process detection strategy: `native` (default) or opt-in `child-groups`. |
|
||||
| `HERDR_ENV` | Set to `1` inside Herdr-managed pane processes. |
|
||||
| `HERDR_PANE_ID` | Public pane id for the running pane process. |
|
||||
| `HERDR_TAB_ID` | Public tab id for the running pane process. |
|
||||
|
|
|
|||
|
|
@ -256,6 +256,8 @@ Color values accept hex, named colors, `rgb(r,g,b)`, or reset aliases like `rese
|
|||
|
||||
The sidebar is the main Herdr dashboard. Search `ui.` in the [Config reference](/docs/config-reference/) for sizing, collapsed mode, Agent panel ordering, mouse behavior, pane borders, and other presentation settings.
|
||||
|
||||
Set `tab_bar_position = "bottom"` under `[ui]` to place the desktop tab row below the terminal panes. Prefix, Navigate, Copy, and Resize mode bars temporarily replace the bottom tab row while active. The default is `"top"`.
|
||||
|
||||
### Sidebar row layouts
|
||||
|
||||
The expanded desktop sidebar renders each inner array in `rows` as one line. These are the complete default layouts:
|
||||
|
|
@ -452,6 +454,7 @@ On Windows, support is currently limited to the Korean IME. With an IME for any
|
|||
| `HERDR_CONFIG_PATH` | Override the config file path. |
|
||||
| `HERDR_SESSION` | Select a named session for CLI commands. |
|
||||
| `HERDR_SOCKET_PATH` | Low-level socket path override. |
|
||||
| `HERDR_PROCESS_DETECTION` | Linux process detection strategy: `native` (default) or opt-in `child-groups`. |
|
||||
| `HERDR_LOG` | Set log filtering, for example `HERDR_LOG=herdr=debug`. |
|
||||
| `HERDR_DISABLE_SOUND` | Disable sound playback even when `[ui.sound] enabled = true`. |
|
||||
|
||||
|
|
|
|||
|
|
@ -37,16 +37,16 @@ If you already use mise:
|
|||
mise use -g herdr
|
||||
```
|
||||
|
||||
If mise reports `herdr not found in mise tool registry`, update mise and retry. Older mise versions predate the Herdr registry entry; `mise use -g github:ogulcancelik/herdr` works as a temporary fallback.
|
||||
If mise reports `herdr not found in mise tool registry`, update mise and retry. Older mise versions predate the Herdr registry entry; `mise use -g github:herdrdev/herdr` works as a temporary fallback.
|
||||
|
||||
## Install with Nix
|
||||
|
||||
If you already use Nix, Herdr provides a flake that builds Herdr from source:
|
||||
|
||||
```bash
|
||||
nix run github:ogulcancelik/herdr/v0.x.y
|
||||
nix build github:ogulcancelik/herdr/v0.x.y
|
||||
nix profile install github:ogulcancelik/herdr/v0.x.y
|
||||
nix run github:herdrdev/herdr/v0.x.y
|
||||
nix build github:herdrdev/herdr/v0.x.y
|
||||
nix profile install github:herdrdev/herdr/v0.x.y
|
||||
```
|
||||
|
||||
Replace `v0.x.y` with the latest release tag. You can omit the tag to track `master`, but release tags are recommended for normal installs.
|
||||
|
|
@ -54,7 +54,7 @@ Replace `v0.x.y` with the latest release tag. You can omit the tag to track `mas
|
|||
The flake also exposes a development shell:
|
||||
|
||||
```bash
|
||||
nix develop github:ogulcancelik/herdr
|
||||
nix develop github:herdrdev/herdr
|
||||
```
|
||||
|
||||
Update through the same Nix workflow you used to install Herdr. For a profile install, list your profile entries and upgrade the Herdr entry:
|
||||
|
|
@ -72,7 +72,7 @@ nix flake update herdr
|
|||
|
||||
## Download manually
|
||||
|
||||
You can also download a binary from [GitHub releases](https://github.com/ogulcancelik/herdr/releases).
|
||||
You can also download a binary from [GitHub releases](https://github.com/herdrdev/herdr/releases).
|
||||
|
||||
Choose the asset that matches your system:
|
||||
|
||||
|
|
|
|||
|
|
@ -1,11 +1,11 @@
|
|||
---
|
||||
title: Integrations
|
||||
description: Install Herdr integrations for Pi, OMP, Claude Code, Codex, GitHub Copilot CLI, Devin CLI, Droid, Kimi Code CLI, OpenCode, Kilo Code CLI, Hermes Agent, Qoder CLI, Cursor Agent CLI, MastraCode, and Grok CLI.
|
||||
description: Install Herdr integrations for Pi, OMP, Claude Code, Codex, GitHub Copilot CLI, Devin CLI, Droid, Kimi Code CLI, OpenCode, Kilo Code CLI, Hermes Agent, Qoder CLI, Cursor Agent CLI, MastraCode, Antigravity CLI, and Grok CLI.
|
||||
---
|
||||
|
||||
Herdr detects supported agents automatically. Official integrations can add native session identity for restore, lifecycle state reports, or both.
|
||||
|
||||
Use integrations when you want native agent session restore from Claude Code/Codex/Copilot/Devin-style hooks, direct lifecycle reports from Pi/OMP/Kimi/OpenCode/Kilo/Hermes-style hooks or plugins, or both. See [Agents](/docs/agents/) for the full status authority model.
|
||||
Use integrations when you want native agent session restore, direct lifecycle reports, or both. See [Agents](/docs/agents/) for the full status authority model.
|
||||
|
||||
## Install integrations
|
||||
|
||||
|
|
@ -26,6 +26,7 @@ herdr integration install hermes
|
|||
herdr integration install qodercli
|
||||
herdr integration install cursor
|
||||
herdr integration install mastracode
|
||||
herdr integration install antigravity-cli
|
||||
herdr integration install grok
|
||||
```
|
||||
|
||||
|
|
@ -46,6 +47,7 @@ herdr integration uninstall hermes
|
|||
herdr integration uninstall qodercli
|
||||
herdr integration uninstall cursor
|
||||
herdr integration uninstall mastracode
|
||||
herdr integration uninstall antigravity-cli
|
||||
herdr integration uninstall grok
|
||||
```
|
||||
|
||||
|
|
@ -55,14 +57,14 @@ Herdr uses integrations in two different ways:
|
|||
|
||||
| Integration type | Agents | Effect |
|
||||
| --- | --- | --- |
|
||||
| Lifecycle authority | Pi, OMP, Kimi Code CLI, OpenCode, Kilo Code CLI, Hermes Agent, MastraCode | When installed and actively reporting for the pane, hook or plugin events author `idle`, `working`, and `blocked`. Herdr does not also use screen manifest fallback for that same lifecycle authority. |
|
||||
| Session identity | Claude Code, Codex, GitHub Copilot CLI, Devin CLI, Droid, Qoder CLI, Cursor Agent CLI, Grok CLI | The integration reports native session references for restore. State still comes from Herdr's screen manifest detection. |
|
||||
| Lifecycle authority | Pi, OMP, Kimi Code CLI, OpenCode, Kilo Code CLI, MastraCode | When installed and actively reporting for the pane, hook or plugin events author `idle`, `working`, and `blocked`. Herdr does not also use screen manifest fallback for that same lifecycle authority. |
|
||||
| Session identity | Claude Code, Codex, GitHub Copilot CLI, Devin CLI, Droid, Qoder CLI, Cursor Agent CLI, Hermes Agent, Antigravity CLI, Grok CLI | The integration reports native session references for restore. State still comes from Herdr's screen manifest detection. |
|
||||
|
||||
Custom socket integrations can also report state when they define state that is not visible in the native terminal UI.
|
||||
|
||||
Some integrations report native agent session references. Herdr uses official session references to resume Claude Code, Codex, Devin CLI, Droid, Kimi Code CLI, Qoder CLI, Cursor Agent CLI, Grok CLI, GitHub Copilot CLI, Pi, OMP, Hermes Agent, OpenCode, Kilo Code CLI, and MastraCode panes after a Herdr server restart unless `[session] resume_agents_on_restore = false` disables it.
|
||||
Some integrations report native agent session references. Herdr uses official session references to resume Claude Code, Codex, Devin CLI, Droid, Kimi Code CLI, Qoder CLI, Cursor Agent CLI, Grok CLI, GitHub Copilot CLI, Pi, OMP, Hermes Agent, OpenCode, Kilo Code CLI, MastraCode, and Antigravity CLI panes after a Herdr server restart unless `[session] resume_agents_on_restore = false` disables it.
|
||||
|
||||
Native session restore requires current Herdr integrations: Pi integration version `2`, OMP version `3`, Claude Code version `6`, Codex version `5`, GitHub Copilot CLI version `2`, Devin CLI version `2`, Droid version `2`, Kimi Code CLI version `3`, Qoder CLI version `2`, Cursor Agent CLI version `1`, Grok CLI version `1`, OpenCode version `5`, Kilo Code CLI version `1`, Hermes Agent version `2`, or MastraCode version `1`. Check installed versions with `herdr integration status`.
|
||||
Native session restore requires current Herdr integrations: Pi integration version `2`, OMP version `3`, Claude Code version `6`, Codex version `5`, GitHub Copilot CLI version `2`, Devin CLI version `2`, Droid version `2`, Kimi Code CLI version `3`, Qoder CLI version `2`, Cursor Agent CLI version `1`, Grok CLI version `1`, OpenCode version `5`, Kilo Code CLI version `1`, Hermes Agent version `2`, MastraCode version `1`, or Antigravity CLI version `1`. Check installed versions with `herdr integration status`.
|
||||
|
||||
## Pi
|
||||
|
||||
|
|
@ -212,7 +214,7 @@ herdr integration install hermes
|
|||
|
||||
Herdr writes `~/.hermes/plugins/herdr-agent-state/` and enables `herdr-agent-state` in `~/.hermes/config.yaml`. The Hermes config directory must already exist. Restart Hermes after installing so the plugin loads. Uninstall removes the plugin directory and removes `herdr-agent-state` from `plugins.enabled`.
|
||||
|
||||
The plugin reports lifecycle, tool, approval state, and session id while Hermes runs inside a Herdr pane. Herdr can use the reported session id to resume the pane with `hermes --resume <id>`. Native screen manifest detection remains available when the plugin is not installed.
|
||||
The plugin reports the resumable session id while Hermes runs inside a Herdr pane. Herdr uses screen manifest detection for `working`, `idle`, and `blocked`, and can use the reported session id to resume the pane with `hermes --resume <id>`.
|
||||
|
||||
## Qoder CLI
|
||||
|
||||
|
|
@ -258,6 +260,20 @@ Herdr uses `~/.mastracode`. Install writes `hooks/herdr-agent-state.sh` and adds
|
|||
|
||||
Herdr resumes stored MastraCode threads with `mastracode --thread <id>`.
|
||||
|
||||
## Antigravity CLI
|
||||
|
||||
Install the Antigravity CLI hook:
|
||||
|
||||
```bash
|
||||
herdr integration install antigravity-cli
|
||||
```
|
||||
|
||||
Herdr uses `~/.gemini/config/` by default, or `ANTIGRAVITY_CLI_CONFIG_DIR` when set. This is the directory Antigravity CLI reads global customizations from, and it must already exist. Install writes `hooks/herdr-agent-state.sh` (or `herdr-agent-state.ps1` on Windows) and adds a Herdr-owned `herdr` block to `hooks.json`. Antigravity CLI keys `hooks.json` by hook name, so install rewrites only that block and leaves other named hooks untouched. Uninstall removes the `herdr` block and deletes the hook script.
|
||||
|
||||
This integration is session-only. It reports the conversation the pane is running and does not report agent state, so Herdr keeps deriving working, idle, and blocked from what Antigravity CLI draws on screen.
|
||||
|
||||
The hook runs on `PreInvocation`, so Herdr learns the conversation once the first prompt is sent. From then on Herdr can resume the pane with `agy --conversation <id>` after a Herdr server restart.
|
||||
|
||||
## Grok CLI
|
||||
|
||||
Install the Grok CLI hook:
|
||||
|
|
|
|||
|
|
@ -81,13 +81,13 @@ herdr agent rename w1:p2 reviewer
|
|||
|
||||
CLI では、`pane read` と `agent read` のどちらもターミナルテキストを直接出力します。デフォルトは ANSI エスケープを除去した UTF-8 テキストです。ソースに装飾が含まれる場合、`--format ansi` または `--ansi` でエスケープを残します。`detection` ソースは常にプレーンテキストです。recent 系ソースでは、`--lines N` は折り返し解除の前に末尾の N 描画行を選び、省略時は 80 行です。`visible` と `detection` では、省略時にスナップショット全体を返し、指定時は改行で区切られた末尾 N 行を返します。socket API ではテキストを `.result.read.text` に返します。
|
||||
|
||||
## 既知の注意点: 代替画面の出力
|
||||
## 代替画面の履歴読み取り
|
||||
|
||||
Claude Code や OpenCode などの全画面エージェントは、ターミナルの代替画面に描画することがあります。代替画面の行は Herdr のホスト側スクロールバックには入りません。`--lines` で取得できるのは、ペインの現在の画面とホスト側スクロールバックに存在する行だけであり、失われた履歴を作り出すことはできません。`--lines` を増やしても応答テキストが増えない場合、そのペインは代替画面を使っている可能性が高く、応答の行はすでに保持されていません。フォントが大きい場合やペインが小さい場合は、より起こりやすくなります。
|
||||
Claude Code や OpenCode などの全画面エージェントは、トランスクリプト履歴を Herdr のホスト側スクロールバックではなく、ターミナルの代替画面に描画します。認識済みのエージェントが idle でトランスクリプトの末尾にあり、`--lines` が表示画面より多い行を要求した場合、`recent` または `recent-unwrapped` のテキスト読み取りはエージェントのマウススクロール操作を自動的に使います。Herdr は重なり合うページを収集し、読み取りが完了する前にビューポートを末尾へ戻します。そのペインに対象エージェントがいる場合、`pane read` にも同じ動作が追加オプションなしで適用されます。
|
||||
|
||||
エージェントに簡潔な応答を求めるか、ペインを広げる、フォントを小さくする、またはエージェント自身のトランスクリプトやスクロール操作を使ってください。エージェント内でスクロールした後、`--source visible` を使うと、現在描画されているページを読み取れます。
|
||||
その他の読み取りは受動的なままです。`visible`、`detection`、ANSI 読み取り、出力待機と購読、手動でスクロールされたエージェント、直接アタッチ中のペイン、マウスホイール入力を報告しないアプリケーションでは、Herdr はアプリケーションのビューポートを動かしません。明示的な `agent read --lines N` が代替画面の履歴を必要とする場合、エージェントが working、blocked、または unknown の間は `agent_not_idle` を返します。idle になるまで待って再試行するか、`--source visible` を使ってください。その他の recent 読み取りは従来どおり、利用可能な画面とホスト側スクロールバックを返します。
|
||||
|
||||
その読み取りに失敗した後、エージェントに完全な応答を一時ディレクトリ内へ Markdown 形式で書き込み、ファイルパスだけを返すよう依頼してから、そのファイルを直接読み取ってください。これはフォールバックとしてのみ使い、最初のプロンプトではファイル出力を求めないでください。
|
||||
完全な応答を取得できない場合は、一時ディレクトリの Markdown ファイルに応答を書き込み、ファイルパスだけを返すようエージェントに依頼して、そのファイルを直接読み取ってください。
|
||||
|
||||
成功した `agent start`、`agent prompt`、`agent wait` は現在のエージェントを `.result.agent` に返します。`pane wait-output` は `.result.pane_id`、`.result.matched_line`、一致したスナップショット `.result.read` を返します。
|
||||
|
||||
|
|
|
|||
|
|
@ -3,7 +3,7 @@ title: エージェントスキルファイル
|
|||
description: Claude Code などのコーディングエージェントに Herdr の使い方をインストールします。
|
||||
---
|
||||
|
||||
Herdr は再利用可能なエージェントスキルファイルを [`SKILL.md`](https://github.com/ogulcancelik/herdr/blob/master/SKILL.md) として提供しています。
|
||||
Herdr は再利用可能なエージェントスキルファイルを [`skills/herdr/SKILL.md`](https://github.com/herdrdev/herdr/blob/master/skills/herdr/SKILL.md) として提供しています。
|
||||
|
||||
このファイルを、再利用可能なスキルやカスタム指示に対応した任意のコーディングエージェントにインストールしてください。このスキルは、Herdr のペイン内から Herdr を制御する方法をエージェントに教えます。
|
||||
|
||||
|
|
@ -21,22 +21,24 @@ Herdr は別の用途向けに [`herdr.dev/agent-guide.md`](https://herdr.dev/ag
|
|||
- サーバー、テスト、別のエージェントの完了を待つ
|
||||
- 隣のペインでヘルパーエージェントを起動する
|
||||
|
||||
このスキルは独立したアプリやサービスではありません。エージェント向けの markdown 指示ファイルです。
|
||||
このスキルは独立したアプリやサービスではありません。エージェント向けの markdown 指示ファイルです。Herdr がすでにインストールされている場合は、`herdr --skill` を実行すると、そのバイナリのリリースと一致する同梱コピーを表示できます。
|
||||
|
||||
## インストールする
|
||||
|
||||
`npx skills` でスキルをインストールします:
|
||||
|
||||
```bash
|
||||
npx skills add ogulcancelik/herdr --skill herdr -g
|
||||
npx skills add herdrdev/herdr --skill herdr -g
|
||||
```
|
||||
|
||||
スキルがリポジトリのルートにあったときにインストールした場合は、`skills update` ではなく、この add コマンドを一度再実行してください。大きすぎる既存のコピーが置き換えられ、新しい場所が記録されます。
|
||||
|
||||
`-g` フラグは、対応エージェントにグローバルインストールします。現在のプロジェクトにインストールする場合は `-g` を省略してください。
|
||||
|
||||
手動でのフォールバックおよび信頼できるソースとしては、リポジトリのコピーを使ってください:
|
||||
|
||||
```text
|
||||
https://github.com/ogulcancelik/herdr/blob/master/SKILL.md
|
||||
https://github.com/herdrdev/herdr/blob/master/skills/herdr/SKILL.md
|
||||
```
|
||||
|
||||
スキルシステムを持つエージェントには、このファイルを `herdr` という名前のスキルとしてインストールしてください。スキルシステムを持たないエージェントには、ファイルの内容をプロジェクト指示またはユーザー指示に貼り付けてください。
|
||||
|
|
@ -62,4 +64,4 @@ claude
|
|||
|
||||
ソースファイルはこちら:
|
||||
|
||||
[GitHub で `SKILL.md` を開く →](https://github.com/ogulcancelik/herdr/blob/master/SKILL.md)
|
||||
[GitHub で `SKILL.md` を開く →](https://github.com/herdrdev/herdr/blob/master/skills/herdr/SKILL.md)
|
||||
|
|
|
|||
|
|
@ -14,11 +14,11 @@ Herdr は複数のコーディングエージェントを同時に動かすた
|
|||
| エージェント | 状態の権威 | インテグレーションの役割 |
|
||||
| --- | --- | --- |
|
||||
| Pi | インストール時はライフサイクルフック。それ以外はスクリーンマニフェスト | 状態とセッション |
|
||||
| OMP | インストール時はライフサイクルフック | 状態 |
|
||||
| OMP | インストール時はライフサイクルフック | 状態とセッション |
|
||||
| GitHub Copilot CLI | スクリーンマニフェスト | セッション |
|
||||
| Devin CLI | スクリーンマニフェスト | セッション |
|
||||
| Kimi Code CLI | インストール時はライフサイクルフック。それ以外はスクリーンマニフェスト | 状態とセッション |
|
||||
| Hermes Agent | インストール時はライフサイクルフック。それ以外はスクリーンマニフェスト | 状態とセッション |
|
||||
| Hermes Agent | スクリーンマニフェスト | セッション |
|
||||
| Qoder CLI | スクリーンマニフェスト | セッション |
|
||||
| Droid | スクリーンマニフェスト | セッション |
|
||||
| OpenCode | インストール時はライフサイクルプラグイン。それ以外はスクリーンマニフェスト | 状態とセッション |
|
||||
|
|
@ -28,8 +28,8 @@ Herdr は複数のコーディングエージェントを同時に動かすた
|
|||
| Codex | スクリーンマニフェスト | セッション |
|
||||
| Cursor Agent CLI | スクリーンマニフェスト | セッション |
|
||||
| Amp | スクリーンマニフェスト | なし |
|
||||
| Grok CLI | スクリーンマニフェスト | なし |
|
||||
| Antigravity CLI | スクリーンマニフェスト | なし |
|
||||
| Grok CLI | スクリーンマニフェスト | セッション |
|
||||
| Antigravity CLI | スクリーンマニフェスト | セッション |
|
||||
| Kiro CLI | スクリーンマニフェスト | なし |
|
||||
| Maki | スクリーンマニフェスト | なし |
|
||||
|
||||
|
|
@ -45,12 +45,14 @@ Herdr はまず各ペインのフォアグラウンドプロセスを検出し
|
|||
|
||||
スクリーンスナップショットは、スクロールされたビューポートではなく、ペインバッファの直近の下部から取得されます。Herdr でスクロールバックしても、検出は下部のライブなエージェント UI を追い続けます。
|
||||
|
||||
Claude Code、Codex、GitHub Copilot CLI、Droid、Qoder CLI、Cursor Agent CLI のインテグレーションは、意図的にライフサイクル権威にしていません。これらは復元のためのネイティブセッション識別を提供しますが、フックがライフサイクル全体をカバーしていません。許可承認の結果、Esc による中断、その他の遷移を見逃すことがあります。これらのエージェントでは、Herdr は引き続きスクリーンマニフェスト検出を使います。
|
||||
上の表で「セッション」と記載されたインテグレーションは、意図的にライフサイクル権威にしていません。これらは復元のためのネイティブセッション識別を提供しますが、フックがライフサイクル全体をカバーしていません。許可承認の結果、Esc による中断、その他の遷移を見逃すことがあります。これらのエージェントでは、Herdr は引き続きスクリーンマニフェスト検出を使います。
|
||||
|
||||
## VM とサンドボックスラッパー
|
||||
|
||||
Linux と macOS では、ホストから見えるラッパーが実際のエージェントプロセスを Herdr から隠すことがあります。ラッパーのコマンドに `HERDR_AGENT=<agent>` を設定して、どの既存エージェントのスクリーンマニフェストを使うべきか Herdr に伝えてください。たとえば、Linux では `HERDR_AGENT=claude fence -- claude`、macOS では `HERDR_AGENT=claude nono run --profile claude-code -- claude` を実行します。このヒントはそのフォアグラウンドプロセスにスコープされます。VM やコンテナの内部だけで設定しても Herdr からは見えません。また、継承されるすべてのフォアグラウンドプロセスをそのエージェントとして扱いたいのでない限り、グローバルな export は避けてください。
|
||||
|
||||
一部の制限された Linux ランタイムでは、ターミナルのフォアグラウンドプロセスグループが公開されません。ネイティブ検出が利用できない場合に直接の子プロセスグループ推論を有効にするには、Herdr サーバーを `HERDR_PROCESS_DETECTION=child-groups` 付きで起動します。ネイティブ検出が引き続き優先され、デフォルトの `native` モードではこの推論を行いません。このオプトインモードはベストエフォートで、新しいバックグラウンドジョブをフォアグラウンドと誤認する可能性があります。この変数はサーバーが読み取るため再起動が必要です。アタッチするクライアントではなく、リモートサーバーの環境に設定してください。
|
||||
|
||||
## blocked 状態
|
||||
|
||||
スクリーンマニフェスト方式のエージェントでは、blocked の検出は意図的に厳格です。Herdr が `blocked` と判定するのは、ライブの下部バッファスナップショットが既知の承認・質問・許可 UI にマッチしたときだけです。既知のエージェントでどのマニフェストルールにもマッチしない場合、Herdr は `idle` にフォールバックし、explain の出力ではそのフォールバックに `default_known_agent_idle_fallback` というラベルを付けます。
|
||||
|
|
|
|||
|
|
@ -131,10 +131,10 @@ herdr workspace create --cwd ~/project --label api --no-focus
|
|||
## Worktree
|
||||
|
||||
```bash
|
||||
herdr worktree list [--workspace ID | --cwd PATH] [--json]
|
||||
herdr worktree create [--workspace ID | --cwd PATH] [--branch NAME] [--base REF] [--path PATH] [--label TEXT] [--focus] [--no-focus] [--json]
|
||||
herdr worktree open [--workspace ID | --cwd PATH] (--path PATH | --branch NAME) [--label TEXT] [--focus] [--no-focus] [--json]
|
||||
herdr worktree remove --workspace ID [--force] [--json]
|
||||
herdr worktree list [--workspace ID | --cwd PATH]
|
||||
herdr worktree create [--workspace ID | --cwd PATH] [--branch NAME] [--base REF] [--path PATH] [--label TEXT] [--focus] [--no-focus]
|
||||
herdr worktree open [--workspace ID | --cwd PATH] (--path PATH | --branch NAME) [--label TEXT] [--focus] [--no-focus]
|
||||
herdr worktree remove --workspace ID [--force]
|
||||
```
|
||||
|
||||
worktree は、Git チェックアウトの出自情報を持つ通常の Herdr ワークスペースです。`worktree create` は Git worktree のチェックアウトを作成し、ワークスペースとして開き、親リポジトリのワークスペースとグループ化します。`--branch` が既存のローカルブランチを指す場合はそれをチェックアウトし、そうでなければ `--base` または `HEAD` からブランチを作成します。`--path` がない場合、チェックアウトは `<worktrees.directory>/<repo>/<branch-slug>` の下に作成されます。
|
||||
|
|
|
|||
|
|
@ -37,16 +37,16 @@ brew install herdr
|
|||
mise use -g herdr
|
||||
```
|
||||
|
||||
mise が `herdr not found in mise tool registry` と報告する場合は、mise をアップデートして再試行してください。古い mise は Herdr のレジストリ登録より前のバージョンです。一時的な回避策として `mise use -g github:ogulcancelik/herdr` も使えます。
|
||||
mise が `herdr not found in mise tool registry` と報告する場合は、mise をアップデートして再試行してください。古い mise は Herdr のレジストリ登録より前のバージョンです。一時的な回避策として `mise use -g github:herdrdev/herdr` も使えます。
|
||||
|
||||
## Nix でインストール
|
||||
|
||||
すでに Nix を使っている場合、Herdr はソースからビルドする flake を提供しています:
|
||||
|
||||
```bash
|
||||
nix run github:ogulcancelik/herdr/v0.x.y
|
||||
nix build github:ogulcancelik/herdr/v0.x.y
|
||||
nix profile install github:ogulcancelik/herdr/v0.x.y
|
||||
nix run github:herdrdev/herdr/v0.x.y
|
||||
nix build github:herdrdev/herdr/v0.x.y
|
||||
nix profile install github:herdrdev/herdr/v0.x.y
|
||||
```
|
||||
|
||||
`v0.x.y` は最新のリリースタグに置き換えてください。タグを省略すると `master` を追跡できますが、通常のインストールにはリリースタグを推奨します。
|
||||
|
|
@ -54,7 +54,7 @@ nix profile install github:ogulcancelik/herdr/v0.x.y
|
|||
flake は開発用シェルも公開しています:
|
||||
|
||||
```bash
|
||||
nix develop github:ogulcancelik/herdr
|
||||
nix develop github:herdrdev/herdr
|
||||
```
|
||||
|
||||
アップデートは、Herdr のインストールに使ったのと同じ Nix ワークフローで行います。プロファイルインストールの場合は、プロファイルのエントリを一覧して Herdr のエントリをアップグレードします:
|
||||
|
|
@ -72,7 +72,7 @@ nix flake update herdr
|
|||
|
||||
## 手動でダウンロード
|
||||
|
||||
[GitHub releases](https://github.com/ogulcancelik/herdr/releases) からバイナリをダウンロードすることもできます。
|
||||
[GitHub releases](https://github.com/herdrdev/herdr/releases) からバイナリをダウンロードすることもできます。
|
||||
|
||||
システムに合ったアセットを選んでください:
|
||||
|
||||
|
|
|
|||
|
|
@ -1,11 +1,11 @@
|
|||
---
|
||||
title: インテグレーション
|
||||
description: Pi、OMP、Claude Code、Codex、GitHub Copilot CLI、Devin CLI、Droid、Kimi Code CLI、OpenCode、Kilo Code CLI、Hermes Agent、Qoder CLI、Cursor Agent CLI、MastraCode 向けの Herdr インテグレーションをインストールします。
|
||||
description: Pi、OMP、Claude Code、Codex、GitHub Copilot CLI、Devin CLI、Droid、Kimi Code CLI、OpenCode、Kilo Code CLI、Hermes Agent、Qoder CLI、Cursor Agent CLI、MastraCode、Antigravity CLI、Grok CLI 向けの Herdr インテグレーションをインストールします。
|
||||
---
|
||||
|
||||
Herdr は対応エージェントを自動的に検出します。公式インテグレーションは、復元のためのネイティブセッション識別、ライフサイクル状態の報告、またはその両方を追加できます。
|
||||
|
||||
Claude Code/Codex/Copilot/Devin 系のフックによるエージェントネイティブのセッション復元、Pi/OMP/Kimi/OpenCode/Kilo/Hermes/MastraCode 系のフックまたはプラグインによる直接のライフサイクル報告、あるいはその両方が欲しいときにインテグレーションを使ってください。状態権威モデルの全体像は[エージェント](/ja/docs/agents/)を参照してください。
|
||||
エージェントネイティブのセッション復元、直接のライフサイクル報告、またはその両方が欲しいときにインテグレーションを使ってください。状態権威モデルの全体像は[エージェント](/ja/docs/agents/)を参照してください。
|
||||
|
||||
## インテグレーションをインストールする
|
||||
|
||||
|
|
@ -26,6 +26,8 @@ herdr integration install hermes
|
|||
herdr integration install mastracode
|
||||
herdr integration install qodercli
|
||||
herdr integration install cursor
|
||||
herdr integration install antigravity-cli
|
||||
herdr integration install grok
|
||||
```
|
||||
|
||||
## インテグレーションをアンインストールする
|
||||
|
|
@ -45,6 +47,8 @@ herdr integration uninstall hermes
|
|||
herdr integration uninstall mastracode
|
||||
herdr integration uninstall qodercli
|
||||
herdr integration uninstall cursor
|
||||
herdr integration uninstall antigravity-cli
|
||||
herdr integration uninstall grok
|
||||
```
|
||||
|
||||
## Herdr がインテグレーションをどう使うか
|
||||
|
|
@ -53,14 +57,14 @@ Herdr はインテグレーションを 2 つの異なる方法で使います:
|
|||
|
||||
| インテグレーションの種類 | エージェント | 効果 |
|
||||
| --- | --- | --- |
|
||||
| ライフサイクル権威 | Pi、OMP、Kimi Code CLI、OpenCode、Kilo Code CLI、Hermes Agent、MastraCode | インストールされ、そのペインについて能動的に報告している間は、フックまたはプラグインのイベントが `idle`、`working`、`blocked` を決定します。同じライフサイクル権威に対して、Herdr はスクリーンマニフェストのフォールバックを併用しません。 |
|
||||
| セッション識別 | Claude Code、Codex、GitHub Copilot CLI、Devin CLI、Droid、Qoder CLI、Cursor Agent CLI | インテグレーションは復元用のネイティブセッション参照を報告します。状態は引き続き Herdr のスクリーンマニフェスト検出から得られます。 |
|
||||
| ライフサイクル権威 | Pi、OMP、Kimi Code CLI、OpenCode、Kilo Code CLI、MastraCode | インストールされ、そのペインについて能動的に報告している間は、フックまたはプラグインのイベントが `idle`、`working`、`blocked` を決定します。同じライフサイクル権威に対して、Herdr はスクリーンマニフェストのフォールバックを併用しません。 |
|
||||
| セッション識別 | Claude Code、Codex、GitHub Copilot CLI、Devin CLI、Droid、Qoder CLI、Cursor Agent CLI、Hermes Agent、Antigravity CLI、Grok CLI | インテグレーションは復元用のネイティブセッション参照を報告します。状態は引き続き Herdr のスクリーンマニフェスト検出から得られます。 |
|
||||
|
||||
カスタムソケットインテグレーションも、ネイティブのターミナル UI では見えない状態を定義する場合に状態を報告できます。
|
||||
|
||||
一部のインテグレーションは、エージェントのネイティブセッション参照を報告します。Herdr は公式のセッション参照を使って、`[session] resume_agents_on_restore = false` で無効化されていない限り、Herdr サーバーの再起動後に Claude Code、Codex、Devin CLI、Droid、Kimi Code CLI、Qoder CLI、Cursor Agent CLI、GitHub Copilot CLI、Pi、OMP、Hermes Agent、OpenCode、Kilo Code CLI、MastraCode のペインを resume します。
|
||||
一部のインテグレーションは、エージェントのネイティブセッション参照を報告します。Herdr は公式のセッション参照を使って、`[session] resume_agents_on_restore = false` で無効化されていない限り、Herdr サーバーの再起動後に Claude Code、Codex、Devin CLI、Droid、Kimi Code CLI、Qoder CLI、Cursor Agent CLI、Grok CLI、GitHub Copilot CLI、Pi、OMP、Hermes Agent、OpenCode、Kilo Code CLI、MastraCode、Antigravity CLI のペインを resume します。
|
||||
|
||||
エージェントネイティブのセッション復元には最新の Herdr インテグレーションが必要です: Pi インテグレーションはバージョン `2`、OMP は `3`、Claude Code は `6`、Codex は `5`、GitHub Copilot CLI は `2`、Devin CLI は `2`、Droid は `2`、Kimi Code CLI は `3`、Qoder CLI は `2`、Cursor Agent CLI は `1`、OpenCode は `5`、Kilo Code CLI は `1`、Hermes Agent は `2`、MastraCode は `1` です。インストール済みバージョンは `herdr integration status` で確認してください。
|
||||
エージェントネイティブのセッション復元には最新の Herdr インテグレーションが必要です: Pi インテグレーションはバージョン `2`、OMP は `3`、Claude Code は `6`、Codex は `5`、GitHub Copilot CLI は `2`、Devin CLI は `2`、Droid は `2`、Kimi Code CLI は `3`、Qoder CLI は `2`、Cursor Agent CLI は `1`、Grok CLI は `1`、OpenCode は `5`、Kilo Code CLI は `1`、Hermes Agent は `2`、MastraCode は `1`、Antigravity CLI は `1` です。インストール済みバージョンは `herdr integration status` で確認してください。
|
||||
|
||||
## Pi
|
||||
|
||||
|
|
@ -210,7 +214,7 @@ herdr integration install hermes
|
|||
|
||||
Herdr は `~/.hermes/plugins/herdr-agent-state/` を書き込み、`~/.hermes/config.yaml` で `herdr-agent-state` を有効にします。Hermes の設定ディレクトリはあらかじめ存在している必要があります。プラグインを読み込ませるため、インストール後に Hermes を再起動してください。アンインストールはプラグインディレクトリを削除し、`plugins.enabled` から `herdr-agent-state` を削除します。
|
||||
|
||||
このプラグインは、Hermes が Herdr のペイン内で動いている間、ライフサイクル、ツール、承認状態、セッション id を報告します。Herdr は報告されたセッション id を使って `hermes --resume <id>` でペインを resume できます。プラグインがインストールされていないときは、スクリーンマニフェスト検出が引き続き利用できます。
|
||||
このプラグインは、Hermes が Herdr のペイン内で動いている間、resume 可能なセッション id を報告します。Herdr は `working`、`idle`、`blocked` にスクリーンマニフェスト検出を使い、報告されたセッション id で `hermes --resume <id>` としてペインを resume できます。
|
||||
|
||||
## Qoder CLI
|
||||
|
||||
|
|
@ -256,6 +260,34 @@ Herdr は `~/.mastracode` を使います。インストールは `hooks/herdr-a
|
|||
|
||||
Herdr は保存された MastraCode スレッドを `mastracode --thread <id>` で resume します。
|
||||
|
||||
## Antigravity CLI
|
||||
|
||||
Antigravity CLI フックをインストールします:
|
||||
|
||||
```bash
|
||||
herdr integration install antigravity-cli
|
||||
```
|
||||
|
||||
Herdr はデフォルトで `~/.gemini/config/` を使い、`ANTIGRAVITY_CLI_CONFIG_DIR` が設定されていればそちらを使います。これは Antigravity CLI がグローバルカスタマイズを読み込むディレクトリで、あらかじめ存在している必要があります。インストールは `hooks/herdr-agent-state.sh`（Windows では `herdr-agent-state.ps1`）を書き込み、`hooks.json` に Herdr 所有の `herdr` ブロックを追加します。Antigravity CLI は `hooks.json` をフック名で管理するため、インストールはそのブロックだけを書き換え、ほかの名前付きフックには触れません。アンインストールは `herdr` ブロックとフックスクリプトを削除します。
|
||||
|
||||
このインテグレーションはセッション専用です。ペインで実行中の会話を報告しますが、エージェント状態は報告しません。そのため、Herdr は Antigravity CLI の画面表示から `working`、`idle`、`blocked` を引き続き判定します。
|
||||
|
||||
フックは `PreInvocation` で実行されるため、最初のプロンプト送信後に Herdr が会話を認識します。それ以降、Herdr サーバーの再起動後に `agy --conversation <id>` でペインを resume できます。
|
||||
|
||||
## Grok CLI
|
||||
|
||||
Grok CLI フックをインストールします:
|
||||
|
||||
```bash
|
||||
herdr integration install grok
|
||||
```
|
||||
|
||||
このフックは、Grok CLI が Herdr のペイン内で動いている間、Grok の `SessionStart` フックを通じてセッション識別を報告します。Grok の状態は Herdr のスクリーンマニフェスト検出から得られます。
|
||||
|
||||
Herdr はデフォルトで `~/.grok` を使い、`GROK_HOME` が設定されていればそちらを使います。Grok の設定ディレクトリはあらかじめ存在している必要があります。Grok はそのディレクトリ内のすべての `hooks/*.json` ファイルを統合するため、インストールは Herdr の `SessionStart` エントリだけを含む `hooks/herdr.json` と `hooks/herdr-agent-state.sh` を書き込み、ほかのフックファイルには触れません。アンインストールは Herdr 所有のこの 2 ファイルだけを削除します。
|
||||
|
||||
Grok がセッション開始イベントを発行した後、Herdr は報告されたセッション id を使って `grok --resume <id>` でペインを resume できます。
|
||||
|
||||
## カスタムステータスラベル
|
||||
|
||||
インテグレーションは、ライフサイクル状態を意味的な状態としてのみ報告します。たとえば、ライフサイクル報告に表示フィールドを加えず、エージェントを `working` として報告します。
|
||||
|
|
|
|||
|
|
@ -38,7 +38,7 @@ Herdr サーバーが停止して再起動すると、元のペインのプロ
|
|||
|
||||
ペイン画面履歴は、サーバーの完全な再起動後に直近のターミナル内容を復元します。復元されるのは Herdr が表示できるものであって、元のプロセスではありません。
|
||||
|
||||
ペイン出力にはシークレット、トークン、プロンプト、コマンド出力が含まれうるため、これはデフォルトで無効です。Settings > Experiments > pane screen history から、または次の設定で有効にします:
|
||||
ペイン出力にはシークレット、トークン、プロンプト、コマンド出力が含まれうるため、これはデフォルトで無効です。設定ファイルで有効にします:
|
||||
|
||||
```toml
|
||||
[experimental]
|
||||
|
|
|
|||
|
|
@ -37,7 +37,7 @@ host_cursor = "native"
|
|||
| foot | 1.20.0 |
|
||||
| Alacritty | 0.15.0 |
|
||||
|
||||
長期サポート版 Linux ディストリビューションの古いターミナルパッケージで特に発生します。確認済みの境界キャプチャと上流参照は [Herdr issue #1116](https://github.com/ogulcancelik/herdr/issues/1116) を参照してください。現在のターミナルでも発生する場合は、正確なバージョンと Herdr の外でも発生するかを報告してください。
|
||||
長期サポート版 Linux ディストリビューションの古いターミナルパッケージで特に発生します。確認済みの境界キャプチャと上流参照は [Herdr issue #1116](https://github.com/herdrdev/herdr/issues/1116) を参照してください。現在のターミナルでも発生する場合は、正確なバージョンと Herdr の外でも発生するかを報告してください。
|
||||
|
||||
## Option+Left または Option+Right を押すと `;3D` または `;3C` が入力される
|
||||
|
||||
|
|
@ -57,7 +57,7 @@ map alt+left send_text all \x1bb
|
|||
map alt+right send_text all \x1bf
|
||||
```
|
||||
|
||||
ターミナルアプリケーションが Alt+Left と Alt+Right を直接使用する場合があるため、Herdr は修飾付き矢印を意図的に書き換えません。調査の詳細は [Herdr issue #1370](https://github.com/ogulcancelik/herdr/issues/1370) を参照してください。
|
||||
ターミナルアプリケーションが Alt+Left と Alt+Right を直接使用する場合があるため、Herdr は修飾付き矢印を意図的に書き換えません。調査の詳細は [Herdr issue #1370](https://github.com/herdrdev/herdr/issues/1370) を参照してください。
|
||||
|
||||
## Herdr を更新したのに実行中のセッションが古い
|
||||
|
||||
|
|
|
|||
|
|
@ -38,7 +38,7 @@ Snapshot restore does not preserve running shells, servers, tests, or arbitrary
|
|||
|
||||
Pane screen history restores recent terminal contents after a full server restart. It restores what Herdr can show, not the old process.
|
||||
|
||||
This is off by default because pane output can include secrets, tokens, prompts, and command output. Enable it from Settings > Experiments > pane screen history or with:
|
||||
This is off by default because pane output can include secrets, tokens, prompts, and command output. Enable it in the config file:
|
||||
|
||||
```toml
|
||||
[experimental]
|
||||
|
|
@ -67,6 +67,7 @@ Native session restore requires these Herdr integration versions or newer:
|
|||
| Agent | Minimum Herdr integration version | Resume command |
|
||||
| --- | --- | --- |
|
||||
| Pi | `2` | `pi --session <path-or-id>` |
|
||||
| Antigravity CLI | `1` | `agy --conversation <id>` |
|
||||
| OMP | `3` | `omp --resume=<path-or-id>` |
|
||||
| Claude Code | `6` | `claude --resume <id>` |
|
||||
| Codex | `5` | `codex resume <id>` |
|
||||
|
|
|
|||
|
|
@ -37,7 +37,7 @@ Update the outer terminal to a version containing its upstream fix:
|
|||
| foot | 1.20.0 |
|
||||
| Alacritty | 0.15.0 |
|
||||
|
||||
This is especially common with older terminal packages from long-term-support Linux distributions. See [Herdr issue #1116](https://github.com/ogulcancelik/herdr/issues/1116) for the confirmed boundary captures and upstream references. If the problem remains on a current terminal version, report the exact terminal version and whether it also happens outside Herdr.
|
||||
This is especially common with older terminal packages from long-term-support Linux distributions. See [Herdr issue #1116](https://github.com/herdrdev/herdr/issues/1116) for the confirmed boundary captures and upstream references. If the problem remains on a current terminal version, report the exact terminal version and whether it also happens outside Herdr.
|
||||
|
||||
## Option+Left or Option+Right inserts `;3D` or `;3C`
|
||||
|
||||
|
|
@ -57,7 +57,7 @@ map alt+left send_text all \x1bb
|
|||
map alt+right send_text all \x1bf
|
||||
```
|
||||
|
||||
Herdr deliberately does not rewrite modified arrows because terminal applications may use Alt+Left and Alt+Right directly. See [Herdr issue #1370](https://github.com/ogulcancelik/herdr/issues/1370) for the investigation.
|
||||
Herdr deliberately does not rewrite modified arrows because terminal applications may use Alt+Left and Alt+Right directly. See [Herdr issue #1370](https://github.com/herdrdev/herdr/issues/1370) for the investigation.
|
||||
|
||||
## Herdr updated, but the running session is still old
|
||||
|
||||
|
|
|
|||
|
|
@ -81,13 +81,13 @@ herdr agent rename w1:p2 reviewer
|
|||
|
||||
在 CLI 中,`pane read` 和 `agent read` 都直接打印终端文本。默认输出去除 ANSI 转义的 UTF-8 文本;来源包含样式时,使用 `--format ansi` 或 `--ansi` 保留终端转义。`detection` 来源始终是纯文本。对 recent 类来源,`--lines N` 会在可选的取消折行之前选择最后 N 个已渲染终端行;省略时默认读取 80 行。对 `visible` 和 `detection`,省略 `--lines` 会返回完整快照,指定时保留按换行分隔的最后 N 行。socket API 在 `.result.read.text` 返回文本。
|
||||
|
||||
## 已知注意事项:备用屏幕输出
|
||||
## 备用屏幕历史读取
|
||||
|
||||
Claude Code 和 OpenCode 等全屏智能体可能会在终端的备用屏幕中绘制。备用屏幕中的行不会进入 Herdr 的主机回滚缓冲区。`--lines` 只能请求窗格当前屏幕和主机回滚缓冲区中现有的更多行,不能生成缺失的历史。如果增大 `--lines` 后仍没有返回更多回复文本,该窗格很可能正在使用备用屏幕,且那些回复行已不再保留。字体较大或窗格较小时更容易遇到此限制。
|
||||
Claude Code 和 OpenCode 等全屏智能体会把对话历史绘制在终端的备用屏幕中,而不是写入 Herdr 的主机回滚缓冲区。当已识别的智能体处于 idle、对话位于底部,且 `--lines` 请求的行数超过可见屏幕时,`recent` 或 `recent-unwrapped` 文本读取会自动使用智能体的鼠标滚动界面。Herdr 会收集相互重叠的页面,并在完成读取前把视口恢复到底部。当窗格中包含该智能体时,`pane read` 也会自动采用相同行为,无需额外选项。
|
||||
|
||||
可以要求智能体简洁回复、扩大窗格或使用较小字体,也可以使用智能体自身的记录和滚动控件。在智能体内部滚动后,使用 `--source visible` 读取它当前绘制的页面。
|
||||
其他读取仍保持被动。对于 `visible`、`detection` 或 ANSI 读取、输出等待和订阅、已被手动滚动的智能体、直接附加的窗格,以及不报告鼠标滚轮输入的应用,Herdr 不会移动应用视口。当显式的 `agent read --lines N` 需要备用屏幕历史时,如果智能体处于 working、blocked 或 unknown,命令会返回 `agent_not_idle`;请等待 idle 后重试,或使用 `--source visible`。其他 recent 读取仍像以前一样返回可用的屏幕和主机回滚内容。
|
||||
|
||||
在这次读取失败后,可以让智能体把完整回复以 Markdown 格式写入临时目录,只回复文件路径,然后直接读取该文件。仅将此方法用作后备方案;不要在初始提示中要求文件输出。
|
||||
如果仍无法取得完整回复,可以让智能体把回复以 Markdown 格式写入临时目录,只回复文件路径,然后直接读取该文件。
|
||||
|
||||
成功的 `agent start`、`agent prompt` 和 `agent wait` 会在 `.result.agent` 返回当前智能体。`pane wait-output` 返回 `.result.pane_id`、`.result.matched_line` 以及位于 `.result.read` 的匹配快照。
|
||||
|
||||
|
|
|
|||
|
|
@ -3,7 +3,7 @@ title: 智能体技能文件
|
|||
description: 为 Claude Code 或其他编程智能体安装 Herdr 使用说明。
|
||||
---
|
||||
|
||||
Herdr 提供了一个可复用的智能体技能文件: [`SKILL.md`](https://github.com/ogulcancelik/herdr/blob/master/SKILL.md)。
|
||||
Herdr 提供了一个可复用的智能体技能文件: [`skills/herdr/SKILL.md`](https://github.com/herdrdev/herdr/blob/master/skills/herdr/SKILL.md)。
|
||||
|
||||
把这个文件安装到任何支持可复用技能或自定义指令的编程智能体中。这份技能教智能体如何在 Herdr 窗格内部控制 Herdr。
|
||||
|
||||
|
|
@ -21,22 +21,24 @@ Herdr 还提供了另一份用途不同的指南: [`herdr.dev/agent-guide.md`](h
|
|||
- 等待服务器、测试或另一个智能体完成
|
||||
- 在相邻窗格中启动辅助智能体
|
||||
|
||||
这份技能不是独立的应用或服务,它只是一份给智能体看的 markdown 指令文件。
|
||||
这份技能不是独立的应用或服务,它只是一份给智能体看的 markdown 指令文件。如果已经安装 Herdr,运行 `herdr --skill` 即可输出与该二进制版本匹配的内置副本。
|
||||
|
||||
## 安装
|
||||
|
||||
用 `npx skills` 安装技能:
|
||||
|
||||
```bash
|
||||
npx skills add ogulcancelik/herdr --skill herdr -g
|
||||
npx skills add herdrdev/herdr --skill herdr -g
|
||||
```
|
||||
|
||||
如果你是在该技能仍位于仓库根目录时安装的，请重新运行一次此 add 命令，而不要使用 `skills update`。add 命令会替换原先过大的副本并记录新位置。
|
||||
|
||||
`-g` 参数为受支持的智能体全局安装。省略 `-g` 则安装到当前项目。
|
||||
|
||||
以仓库中的副本作为手动兜底和事实来源:
|
||||
|
||||
```text
|
||||
https://github.com/ogulcancelik/herdr/blob/master/SKILL.md
|
||||
https://github.com/herdrdev/herdr/blob/master/skills/herdr/SKILL.md
|
||||
```
|
||||
|
||||
对于有技能系统的智能体,把这个文件安装为名为 `herdr` 的技能。对于没有技能系统的智能体,把文件内容粘贴到智能体的项目指令或用户指令中。
|
||||
|
|
@ -62,4 +64,4 @@ claude
|
|||
|
||||
在这里阅读源文件:
|
||||
|
||||
[在 GitHub 上打开 `SKILL.md` →](https://github.com/ogulcancelik/herdr/blob/master/SKILL.md)
|
||||
[在 GitHub 上打开 `SKILL.md` →](https://github.com/herdrdev/herdr/blob/master/skills/herdr/SKILL.md)
|
||||
|
|
|
|||
|
|
@ -14,11 +14,11 @@ Herdr 为同时运行多个编程智能体而生。每个智能体都待在一
|
|||
| 智能体 | 状态权威 | 集成角色 |
|
||||
| --- | --- | --- |
|
||||
| Pi | 安装后为生命周期钩子;否则为屏幕清单 | 状态与会话 |
|
||||
| OMP | 安装后为生命周期钩子 | 状态 |
|
||||
| OMP | 安装后为生命周期钩子 | 状态与会话 |
|
||||
| GitHub Copilot CLI | 屏幕清单 | 会话 |
|
||||
| Devin CLI | 屏幕清单 | 会话 |
|
||||
| Kimi Code CLI | 安装后为生命周期钩子;否则为屏幕清单 | 状态与会话 |
|
||||
| Hermes Agent | 安装后为生命周期钩子;否则为屏幕清单 | 状态与会话 |
|
||||
| Hermes Agent | 屏幕清单 | 会话 |
|
||||
| Qoder CLI | 屏幕清单 | 会话 |
|
||||
| Droid | 屏幕清单 | 会话 |
|
||||
| OpenCode | 安装后为生命周期插件;否则为屏幕清单 | 状态与会话 |
|
||||
|
|
@ -28,8 +28,8 @@ Herdr 为同时运行多个编程智能体而生。每个智能体都待在一
|
|||
| Codex | 屏幕清单 | 会话 |
|
||||
| Cursor Agent CLI | 屏幕清单 | 会话 |
|
||||
| Amp | 屏幕清单 | 无 |
|
||||
| Grok CLI | 屏幕清单 | 无 |
|
||||
| Antigravity CLI | 屏幕清单 | 无 |
|
||||
| Grok CLI | 屏幕清单 | 会话 |
|
||||
| Antigravity CLI | 屏幕清单 | 会话 |
|
||||
| Kiro CLI | 屏幕清单 | 无 |
|
||||
| Maki | 屏幕清单 | 无 |
|
||||
|
||||
|
|
@ -45,12 +45,14 @@ Herdr 首先检测每个窗格的前台进程。之后,每个窗格有且只有
|
|||
|
||||
屏幕快照来自窗格缓冲区最近的底部,而不是滚动后的视口。即使你在 Herdr 里向上翻页,检测仍然跟随底部的实时智能体 UI。
|
||||
|
||||
Claude Code、Codex、GitHub Copilot CLI、Droid、Qoder CLI 和 Cursor Agent CLI 的集成有意不作为生命周期权威。它们为恢复提供原生会话身份,但它们的钩子并不覆盖整个生命周期,可能漏掉权限审批结果、Esc 中断或其他状态转换。对这些智能体,Herdr 仍然使用屏幕清单检测。
|
||||
上表中标为“会话”的集成有意不作为生命周期权威。它们为恢复提供原生会话身份,但它们的钩子并不覆盖整个生命周期,可能漏掉权限审批结果、Esc 中断或其他状态转换。对这些智能体,Herdr 仍然使用屏幕清单检测。
|
||||
|
||||
## 虚拟机与沙箱包装器
|
||||
|
||||
在 Linux 和 macOS 上,宿主可见的包装器可能会向 Herdr 隐藏真实的智能体进程。在包装器命令上设置 `HERDR_AGENT=<agent>`,告诉 Herdr 应使用哪个已有智能体的屏幕清单。例如,在 Linux 上运行 `HERDR_AGENT=claude fence -- claude`,或在 macOS 上运行 `HERDR_AGENT=claude nono run --profile claude-code -- claude`。这个提示的作用范围只限于该前台进程;仅在 VM 或容器内部设置时 Herdr 无法看到它,而且除非所有继承的前台进程都应被视为该智能体,否则不要全局 export。
|
||||
|
||||
某些受限的 Linux 运行环境不会公开终端前台进程组。原生检测不可用时,以 `HERDR_PROCESS_DETECTION=child-groups` 启动 Herdr 服务器,即可选择启用直接子进程组推断。原生检测仍然优先,默认的 `native` 模式不会执行此推断。这个选择加入模式属于尽力而为,较新的后台任务可能会被误判为前台任务。该变量由服务器读取且需要重启;请在远程服务器环境中设置,而不是在连接客户端上设置。
|
||||
|
||||
## blocked 状态
|
||||
|
||||
对屏幕清单类智能体,blocked 检测刻意从严。只有当实时底部缓冲区快照匹配已知可见的审批、提问或权限 UI 时,Herdr 才标记 `blocked`。对已知智能体,如果没有任何清单规则匹配,Herdr 会回退到 `idle`,并在 explain 输出中把该回退标记为 `default_known_agent_idle_fallback`。
|
||||
|
|
|
|||
|
|
@ -131,10 +131,10 @@ herdr workspace create --cwd ~/project --label api --no-focus
|
|||
## Worktree
|
||||
|
||||
```bash
|
||||
herdr worktree list [--workspace ID | --cwd PATH] [--json]
|
||||
herdr worktree create [--workspace ID | --cwd PATH] [--branch NAME] [--base REF] [--path PATH] [--label TEXT] [--focus] [--no-focus] [--json]
|
||||
herdr worktree open [--workspace ID | --cwd PATH] (--path PATH | --branch NAME) [--label TEXT] [--focus] [--no-focus] [--json]
|
||||
herdr worktree remove --workspace ID [--force] [--json]
|
||||
herdr worktree list [--workspace ID | --cwd PATH]
|
||||
herdr worktree create [--workspace ID | --cwd PATH] [--branch NAME] [--base REF] [--path PATH] [--label TEXT] [--focus] [--no-focus]
|
||||
herdr worktree open [--workspace ID | --cwd PATH] (--path PATH | --branch NAME) [--label TEXT] [--focus] [--no-focus]
|
||||
herdr worktree remove --workspace ID [--force]
|
||||
```
|
||||
|
||||
worktree 是带有 Git 检出来源信息的普通 Herdr 工作区。`worktree create` 创建一个 Git worktree 检出,作为工作区打开,并与父仓库工作区分到一组。如果 `--branch` 指向已有的本地分支,Herdr 检出它;否则从 `--base` 或 `HEAD` 创建分支。没有 `--path` 时,Herdr 在 `<worktrees.directory>/<repo>/<branch-slug>` 下创建检出。
|
||||
|
|
|
|||
|
|
@ -37,16 +37,16 @@ brew install herdr
|
|||
mise use -g herdr
|
||||
```
|
||||
|
||||
如果 mise 报 `herdr not found in mise tool registry`,请更新 mise 后重试。旧版 mise 早于 Herdr 的注册表条目;`mise use -g github:ogulcancelik/herdr` 可以作为临时兜底。
|
||||
如果 mise 报 `herdr not found in mise tool registry`,请更新 mise 后重试。旧版 mise 早于 Herdr 的注册表条目;`mise use -g github:herdrdev/herdr` 可以作为临时兜底。
|
||||
|
||||
## 用 Nix 安装
|
||||
|
||||
如果你已经在用 Nix,Herdr 提供了一个从源码构建的 flake:
|
||||
|
||||
```bash
|
||||
nix run github:ogulcancelik/herdr/v0.x.y
|
||||
nix build github:ogulcancelik/herdr/v0.x.y
|
||||
nix profile install github:ogulcancelik/herdr/v0.x.y
|
||||
nix run github:herdrdev/herdr/v0.x.y
|
||||
nix build github:herdrdev/herdr/v0.x.y
|
||||
nix profile install github:herdrdev/herdr/v0.x.y
|
||||
```
|
||||
|
||||
把 `v0.x.y` 替换为最新的发布标签。省略标签可以跟踪 `master`,但常规安装建议使用发布标签。
|
||||
|
|
@ -54,7 +54,7 @@ nix profile install github:ogulcancelik/herdr/v0.x.y
|
|||
flake 还提供一个开发 shell:
|
||||
|
||||
```bash
|
||||
nix develop github:ogulcancelik/herdr
|
||||
nix develop github:herdrdev/herdr
|
||||
```
|
||||
|
||||
更新时使用你安装 Herdr 的同一套 Nix 工作流。对于 profile 安装,列出 profile 条目并升级 Herdr 条目:
|
||||
|
|
@ -72,7 +72,7 @@ nix flake update herdr
|
|||
|
||||
## 手动下载
|
||||
|
||||
也可以从 [GitHub releases](https://github.com/ogulcancelik/herdr/releases) 下载二进制文件。
|
||||
也可以从 [GitHub releases](https://github.com/herdrdev/herdr/releases) 下载二进制文件。
|
||||
|
||||
选择匹配你系统的产物:
|
||||
|
||||
|
|
|
|||
|
|
@ -1,11 +1,11 @@
|
|||
---
|
||||
title: 集成
|
||||
description: 为 Pi、OMP、Claude Code、Codex、GitHub Copilot CLI、Devin CLI、Droid、Kimi Code CLI、OpenCode、Kilo Code CLI、Hermes Agent、Qoder CLI、Cursor Agent CLI 和 MastraCode 安装 Herdr 集成。
|
||||
description: 为 Pi、OMP、Claude Code、Codex、GitHub Copilot CLI、Devin CLI、Droid、Kimi Code CLI、OpenCode、Kilo Code CLI、Hermes Agent、Qoder CLI、Cursor Agent CLI、MastraCode、Antigravity CLI 和 Grok CLI 安装 Herdr 集成。
|
||||
---
|
||||
|
||||
Herdr 自动检测受支持的智能体。官方集成可以额外提供用于恢复的原生会话身份、生命周期状态上报,或两者兼有。
|
||||
|
||||
当你想要 Claude Code/Codex/Copilot/Devin 式钩子的智能体原生会话恢复、Pi/OMP/Kimi/OpenCode/Kilo/Hermes/MastraCode 式钩子或插件的直接生命周期上报,或两者都要时,使用集成。完整的状态权威模型见[智能体](/zh-cn/docs/agents/)。
|
||||
当你想要智能体原生会话恢复、直接生命周期上报,或两者都要时,使用集成。完整的状态权威模型见[智能体](/zh-cn/docs/agents/)。
|
||||
|
||||
## 安装集成
|
||||
|
||||
|
|
@ -26,6 +26,8 @@ herdr integration install hermes
|
|||
herdr integration install mastracode
|
||||
herdr integration install qodercli
|
||||
herdr integration install cursor
|
||||
herdr integration install antigravity-cli
|
||||
herdr integration install grok
|
||||
```
|
||||
|
||||
## 卸载集成
|
||||
|
|
@ -45,6 +47,8 @@ herdr integration uninstall hermes
|
|||
herdr integration uninstall mastracode
|
||||
herdr integration uninstall qodercli
|
||||
herdr integration uninstall cursor
|
||||
herdr integration uninstall antigravity-cli
|
||||
herdr integration uninstall grok
|
||||
```
|
||||
|
||||
## Herdr 如何使用集成
|
||||
|
|
@ -53,14 +57,14 @@ Herdr 以两种不同方式使用集成:
|
|||
|
||||
| 集成类型 | 智能体 | 效果 |
|
||||
| --- | --- | --- |
|
||||
| 生命周期权威 | Pi、OMP、Kimi Code CLI、OpenCode、Kilo Code CLI、Hermes Agent、MastraCode | 已安装且在为该窗格主动上报时,由钩子或插件事件决定 `idle`、`working` 和 `blocked`。对同一个生命周期权威,Herdr 不再使用屏幕清单兜底。 |
|
||||
| 会话身份 | Claude Code、Codex、GitHub Copilot CLI、Devin CLI、Droid、Qoder CLI、Cursor Agent CLI | 集成上报用于恢复的原生会话引用。状态仍来自 Herdr 的屏幕清单检测。 |
|
||||
| 生命周期权威 | Pi、OMP、Kimi Code CLI、OpenCode、Kilo Code CLI、MastraCode | 已安装且在为该窗格主动上报时,由钩子或插件事件决定 `idle`、`working` 和 `blocked`。对同一个生命周期权威,Herdr 不再使用屏幕清单兜底。 |
|
||||
| 会话身份 | Claude Code、Codex、GitHub Copilot CLI、Devin CLI、Droid、Qoder CLI、Cursor Agent CLI、Hermes Agent、Antigravity CLI、Grok CLI | 集成上报用于恢复的原生会话引用。状态仍来自 Herdr 的屏幕清单检测。 |
|
||||
|
||||
自定义 socket 集成在定义了原生终端 UI 中不可见的状态时,也可以上报状态。
|
||||
|
||||
一些集成会上报智能体的原生会话引用。除非被 `[session] resume_agents_on_restore = false` 禁用,Herdr 会在服务器重启后使用官方会话引用恢复 Claude Code、Codex、Devin CLI、Droid、Kimi Code CLI、Qoder CLI、Cursor Agent CLI、GitHub Copilot CLI、Pi、OMP、Hermes Agent、OpenCode、Kilo Code CLI 和 MastraCode 的窗格。
|
||||
一些集成会上报智能体的原生会话引用。除非被 `[session] resume_agents_on_restore = false` 禁用,Herdr 会在服务器重启后使用官方会话引用恢复 Claude Code、Codex、Devin CLI、Droid、Kimi Code CLI、Qoder CLI、Cursor Agent CLI、Grok CLI、GitHub Copilot CLI、Pi、OMP、Hermes Agent、OpenCode、Kilo Code CLI、MastraCode 和 Antigravity CLI 的窗格。
|
||||
|
||||
原生会话恢复需要最新的 Herdr 集成: Pi 集成版本 `2`、OMP 版本 `3`、Claude Code 版本 `6`、Codex 版本 `5`、GitHub Copilot CLI 版本 `2`、Devin CLI 版本 `2`、Droid 版本 `2`、Kimi Code CLI 版本 `3`、Qoder CLI 版本 `2`、Cursor Agent CLI 版本 `1`、OpenCode 版本 `5`、Kilo Code CLI 版本 `1`、Hermes Agent 版本 `2`、MastraCode 版本 `1`。用 `herdr integration status` 查看已安装版本。
|
||||
原生会话恢复需要最新的 Herdr 集成: Pi 集成版本 `2`、OMP 版本 `3`、Claude Code 版本 `6`、Codex 版本 `5`、GitHub Copilot CLI 版本 `2`、Devin CLI 版本 `2`、Droid 版本 `2`、Kimi Code CLI 版本 `3`、Qoder CLI 版本 `2`、Cursor Agent CLI 版本 `1`、Grok CLI 版本 `1`、OpenCode 版本 `5`、Kilo Code CLI 版本 `1`、Hermes Agent 版本 `2`、MastraCode 版本 `1`、Antigravity CLI 版本 `1`。用 `herdr integration status` 查看已安装版本。
|
||||
|
||||
## Pi
|
||||
|
||||
|
|
@ -210,7 +214,7 @@ herdr integration install hermes
|
|||
|
||||
Herdr 写入 `~/.hermes/plugins/herdr-agent-state/`,并在 `~/.hermes/config.yaml` 中启用 `herdr-agent-state`。Hermes 配置目录必须已经存在。安装后请重启 Hermes 以加载插件。卸载会删除插件目录,并从 `plugins.enabled` 中移除 `herdr-agent-state`。
|
||||
|
||||
该插件在 Hermes 运行于 Herdr 窗格内时上报生命周期、工具、审批状态和会话 id。Herdr 可以用上报的会话 id 通过 `hermes --resume <id>` 恢复该窗格。插件未安装时,屏幕清单检测仍然可用。
|
||||
该插件在 Hermes 运行于 Herdr 窗格内时上报可恢复的会话 id。Herdr 使用屏幕清单检测 `working`、`idle` 和 `blocked`,并可用上报的会话 id 通过 `hermes --resume <id>` 恢复该窗格。
|
||||
|
||||
## Qoder CLI
|
||||
|
||||
|
|
@ -256,6 +260,34 @@ Herdr 使用 `~/.mastracode`。安装会写入 `hooks/herdr-agent-state.sh`,并
|
|||
|
||||
Herdr 用 `mastracode --thread <id>` 恢复保存的 MastraCode 线程。
|
||||
|
||||
## Antigravity CLI
|
||||
|
||||
安装 Antigravity CLI 钩子:
|
||||
|
||||
```bash
|
||||
herdr integration install antigravity-cli
|
||||
```
|
||||
|
||||
Herdr 默认使用 `~/.gemini/config/`,设置了 `ANTIGRAVITY_CLI_CONFIG_DIR` 时使用后者。这是 Antigravity CLI 读取全局自定义配置的目录,并且必须已经存在。安装会写入 `hooks/herdr-agent-state.sh`（Windows 上为 `herdr-agent-state.ps1`）,并向 `hooks.json` 添加由 Herdr 管理的 `herdr` 块。Antigravity CLI 按钩子名称管理 `hooks.json`,因此安装只会重写该块,不会改动其他命名钩子。卸载会移除 `herdr` 块并删除钩子脚本。
|
||||
|
||||
该集成仅上报会话。它会上报窗格当前运行的对话,但不上报智能体状态,因此 Herdr 仍根据 Antigravity CLI 在屏幕上绘制的内容判断 `working`、`idle` 和 `blocked`。
|
||||
|
||||
钩子在 `PreInvocation` 时运行,所以 Herdr 会在发送第一个提示词后获知对话。此后,Herdr 服务器重启时可以用 `agy --conversation <id>` 恢复窗格。
|
||||
|
||||
## Grok CLI
|
||||
|
||||
安装 Grok CLI 钩子:
|
||||
|
||||
```bash
|
||||
herdr integration install grok
|
||||
```
|
||||
|
||||
该钩子在 Grok CLI 运行于 Herdr 窗格内时,通过 Grok 的 `SessionStart` 钩子上报会话身份。Grok 的状态来自 Herdr 的屏幕清单检测。
|
||||
|
||||
Herdr 默认使用 `~/.grok`,设置了 `GROK_HOME` 时使用后者。Grok 配置目录必须已经存在。Grok 会合并该目录中的所有 `hooks/*.json` 文件,因此安装会写入独立的 `hooks/herdr.json`,其中包含 Herdr 的 `SessionStart` 条目,并同时写入 `hooks/herdr-agent-state.sh`;它不会修改其他钩子文件。卸载只会删除这两个由 Herdr 管理的文件。
|
||||
|
||||
Grok 发出会话启动事件后,Herdr 可以用上报的会话 id 通过 `grok --resume <id>` 恢复窗格。
|
||||
|
||||
## 自定义状态标签
|
||||
|
||||
集成只把生命周期状态作为语义状态上报。例如,上报智能体为 `working` 时,不在生命周期报告中添加展示字段。
|
||||
|
|
|
|||
|
|
@ -38,7 +38,7 @@ herdr
|
|||
|
||||
窗格屏幕历史在服务器完全重启后恢复最近的终端内容。它恢复的是 Herdr 能展示的内容,而不是原来的进程。
|
||||
|
||||
它默认关闭,因为窗格输出可能包含密钥、令牌、提示词和命令输出。可以在 Settings > Experiments > pane screen history 中开启,或者:
|
||||
它默认关闭,因为窗格输出可能包含密钥、令牌、提示词和命令输出。可以在配置文件中开启:
|
||||
|
||||
```toml
|
||||
[experimental]
|
||||
|
|
|
|||
|
|
@ -37,7 +37,7 @@ host_cursor = "native"
|
|||
| foot | 1.20.0 |
|
||||
| Alacritty | 0.15.0 |
|
||||
|
||||
长期支持版 Linux 发行版中的旧终端软件包尤其容易出现此问题。已确认的边界捕获和上游链接见 [Herdr issue #1116](https://github.com/ogulcancelik/herdr/issues/1116)。如果当前版本仍有问题，请报告准确的终端版本，以及该问题是否也会在 Herdr 外出现。
|
||||
长期支持版 Linux 发行版中的旧终端软件包尤其容易出现此问题。已确认的边界捕获和上游链接见 [Herdr issue #1116](https://github.com/herdrdev/herdr/issues/1116)。如果当前版本仍有问题，请报告准确的终端版本，以及该问题是否也会在 Herdr 外出现。
|
||||
|
||||
## 按 Option+Left 或 Option+Right 时输入 `;3D` 或 `;3C`
|
||||
|
||||
|
|
@ -57,7 +57,7 @@ map alt+left send_text all \x1bb
|
|||
map alt+right send_text all \x1bf
|
||||
```
|
||||
|
||||
终端应用可能会直接使用 Alt+Left 和 Alt+Right，因此 Herdr 不会改写带修饰键的方向键。调查详情见 [Herdr issue #1370](https://github.com/ogulcancelik/herdr/issues/1370)。
|
||||
终端应用可能会直接使用 Alt+Left 和 Alt+Right，因此 Herdr 不会改写带修饰键的方向键。调查详情见 [Herdr issue #1370](https://github.com/herdrdev/herdr/issues/1370)。
|
||||
|
||||
## Herdr 已更新，但运行中的会话仍是旧版本
|
||||
|
||||
|
|
|
|||
|
|
@ -652,6 +652,12 @@
|
|||
"default": "true",
|
||||
"description": "Draw borders around split panes."
|
||||
},
|
||||
{
|
||||
"key": "ui.pane_scrollbars",
|
||||
"type": "boolean",
|
||||
"default": "true",
|
||||
"description": "Draw interactive scrollbars beside terminal panes. Disable to reclaim the scrollbar column and keep it out of terminal-native selections."
|
||||
},
|
||||
{
|
||||
"key": "ui.pane_gaps",
|
||||
"type": "boolean",
|
||||
|
|
@ -670,6 +676,16 @@
|
|||
"default": "false",
|
||||
"description": "Hide the tab row when the workspace has one tab."
|
||||
},
|
||||
{
|
||||
"key": "ui.tab_bar_position",
|
||||
"type": "enum",
|
||||
"default": "\"top\"",
|
||||
"description": "Place the desktop tab row above or below the terminal panes.",
|
||||
"values": [
|
||||
"top",
|
||||
"bottom"
|
||||
]
|
||||
},
|
||||
{
|
||||
"key": "ui.agent_panel_sort",
|
||||
"type": "enum",
|
||||
|
|
@ -702,7 +718,7 @@
|
|||
"key": "ui.sidebar.spaces.row_gap",
|
||||
"type": "integer",
|
||||
"default": "0",
|
||||
"description": "Blank terminal rows between expanded Space sidebar entries. Set to 1 to restore the previous spacing. Consecutive indented worktree children remain packed as one group."
|
||||
"description": "Blank terminal rows between worktree groups and unrelated top-level Spaces. Worktree parents and their indented children remain packed."
|
||||
},
|
||||
{
|
||||
"key": "ui.sidebar.spaces.rows",
|
||||
|
|
|
|||
|
|
@ -1,36 +1,66 @@
|
|||
{
|
||||
"schema_version": 1,
|
||||
"channel": "preview",
|
||||
"base_version": "0.7.5",
|
||||
"build_id": "2026-07-29-44b3adb12552",
|
||||
"commit": "44b3adb125524ea9a55739eee3776f922f2115ad",
|
||||
"built_at": "2026-07-29T13:32:08Z",
|
||||
"protocol": 18,
|
||||
"notes": "Preview build 2026-07-29-44b3adb12552\n\nBuilt from `44b3adb12552` on `master`.\nBase stable: v0.7.5\nCompare: https://github.com/herdrdev/herdr/compare/0f10e1453a7f9fda357352bb65ce17fa26fda447...44b3adb125524ea9a55739eee3776f922f2115ad\n\n### Added\n- Print bundled agent skill and hint next cli steps\n- Switch IME to ASCII in prefix mode on Windows (Korean IME) (#1823)\n- Filter keybind help (#1832)\n- Add grok cli integration for native session restore (#1807)\n- Publish versioned release documentation\n\n### Fixed\n- Preserve parent agent ownership\n- Preserve windows path variables during install\n- Restore system notifications and sound playback (#2019)\n- Preserve navigate mode after pane focus (#1993)\n- Restore python3 commit hook\n- Select windows python command in commit hook (#1994)\n- Count ptmx master fds under devpts layouts (#1984)\n- Preserve linked worktree workspace labels\n- Ignore nested codex session reports (#1927)\n- Resolve relative plugin commands from plugin root\n- Keep focus on the current workspace when another self-closes (#1912)\n- Make native windows checks reliable (#1925)\n- Close workspace when api closes its last tab (#1899)\n- Preserve shift-enter in windows panes (#1909)\n- Delay agent prompt submission\n- Ignore empty clipboard writes\n- Restrict unapproved pull requests to bug fixes\n- Include SKILL.md in the package fileset (#1890)\n- Repaint after transient terminal resizes\n- Preserve prefix mode for modifier events\n- Preserve focus when closing a non-focused workspace (#1877)\n- Support non-us shifted keybindings (#1876)\n- Improve sidebar worktree hierarchy and reordering (#1873)\n- Avoid renders for passive mouse motion (#1872)\n- Add rust-analyzer to development shell\n- Copy retained mouse selections with keyboard shortcuts\n- Run pi worktree ext on background\n- Bundle modern ConPTY on Windows (#1828)\n- Harden hermes lifecycle detection\n- Report truncated pane reads\n- Make known-agent exit process-owned\n- Answer XTWINOPS size queries in panes\n- Prefer branded homepage search image\n- Consume handled url click gestures\n- Preserve kitty graphics during host repaints\n- Inherit host palette in pane queries (#1759)\n- Preserve kitty printable key releases\n- Preserve physical escape on windows\n- Respect OMP config directory override\n- Keep reading while pty input is blocked\n- Fall back to sh for remote path discovery\n\n### Performance\n- Skip rendering hidden pty updates\n- Replace agent spinners with static status marks\n- Avoid full pane renders for spinner animation (#1868)\n- Eliminate repeated workspace git discovery (#1842)\n\n### Maintenance\n- Remove flaky sound timing assertion\n- Remove approved contributor bypass\n- Add simplified chinese readme (#1990)\n- Update sponsor acknowledgements\n- Harden pull request workflow execution\n- Gate pull request review by scope\n- Consolidate project skills\n- Define maintainer and agent contribution workflows\n- Relicense herdr under apache-2.0\n- Centralize new terminal cwd selection\n- Name darwin nix toolchain inputs\n- Simplify macos input source ownership\n- Clarify opencode event state mapping\n- Simplify cursor session reporting\n- Simplify kimi lifecycle reporting\n- Simplify qoder session reporting\n- Replace pane mouse and clipboard internals\n- Add alternate-screen output fallback",
|
||||
"base_version": "0.8.0",
|
||||
"build_id": "2026-08-04-d78e3d3b5126",
|
||||
"commit": "d78e3d3b51266a1ff80ae6858b894e782aac3e9f",
|
||||
"built_at": "2026-08-03T21:56:43Z",
|
||||
"protocol": 19,
|
||||
"notes": "Preview build 2026-08-04-d78e3d3b5126\n\nBuilt from `d78e3d3b5126` on `master`.\nBase stable: v0.8.0\nCompare: https://github.com/herdrdev/herdr/compare/v0.8.0...d78e3d3b51266a1ff80ae6858b894e782aac3e9f\n\n### Fixed\n- Keep collapsed workspace status visible (#2239)\n\n### Maintenance\n- Refine cpu optimization blog post",
|
||||
"assets": {
|
||||
"linux-x86_64": {
|
||||
"url": "https://github.com/herdrdev/herdr/releases/download/preview-2026-07-29-44b3adb12552/herdr-linux-x86_64",
|
||||
"sha256": "2d50d64ab849c3d0f5d0d53e0bebd00fa94d5ed120797532c8fcfd1a679ebc19"
|
||||
"url": "https://github.com/herdrdev/herdr/releases/download/preview-2026-08-04-d78e3d3b5126/herdr-linux-x86_64",
|
||||
"sha256": "338afbfe03f0eb32efc52e30a5effc6c5ee772846bdb5e059f73d04b89b467d6"
|
||||
},
|
||||
"linux-aarch64": {
|
||||
"url": "https://github.com/herdrdev/herdr/releases/download/preview-2026-07-29-44b3adb12552/herdr-linux-aarch64",
|
||||
"sha256": "2167fb9127d0a67c1dad368d54e6468fd7c2a3858b832922c7f0c264d012be13"
|
||||
"url": "https://github.com/herdrdev/herdr/releases/download/preview-2026-08-04-d78e3d3b5126/herdr-linux-aarch64",
|
||||
"sha256": "f79f3ad5b24dd1b6ba49ebee1b26d69ab5dcbeaf15be4fd7f3357ab0d17f6096"
|
||||
},
|
||||
"macos-x86_64": {
|
||||
"url": "https://github.com/herdrdev/herdr/releases/download/preview-2026-07-29-44b3adb12552/herdr-macos-x86_64",
|
||||
"sha256": "b9316cdff4802f325f6b77b83ea36cd33deb8da4ef9efa8454423b0ce8de77fc"
|
||||
"url": "https://github.com/herdrdev/herdr/releases/download/preview-2026-08-04-d78e3d3b5126/herdr-macos-x86_64",
|
||||
"sha256": "384ee2f2a805260d24f3d398ba8169aa68b502452ab1457c5da40a8e4d9c975f"
|
||||
},
|
||||
"macos-aarch64": {
|
||||
"url": "https://github.com/herdrdev/herdr/releases/download/preview-2026-07-29-44b3adb12552/herdr-macos-aarch64",
|
||||
"sha256": "99941b4a40e852c8f21694c7ec1e96f85abd4f764d9f667757c65fae6e4b065b"
|
||||
"url": "https://github.com/herdrdev/herdr/releases/download/preview-2026-08-04-d78e3d3b5126/herdr-macos-aarch64",
|
||||
"sha256": "d02190962293ccf19186e0ea8a162d7f670ef49e61dfc10051bffd7da08a7ee4"
|
||||
},
|
||||
"windows-x86_64": {
|
||||
"url": "https://github.com/herdrdev/herdr/releases/download/preview-2026-07-29-44b3adb12552/herdr-windows-x86_64.zip",
|
||||
"sha256": "ead450c21d31ea559289d45e4c60d14bb0a7ff0937668a309e74c6a3f9f6cca1",
|
||||
"url": "https://github.com/herdrdev/herdr/releases/download/preview-2026-08-04-d78e3d3b5126/herdr-windows-x86_64.zip",
|
||||
"sha256": "b1d288118848ecd3ef33532a34506edc53a38a416057aee5b7fe1de4188a16fc",
|
||||
"format": "zip"
|
||||
}
|
||||
},
|
||||
"builds": {
|
||||
"2026-08-04-d78e3d3b5126": {
|
||||
"base_version": "0.8.0",
|
||||
"commit": "d78e3d3b51266a1ff80ae6858b894e782aac3e9f",
|
||||
"built_at": "2026-08-03T21:56:43Z",
|
||||
"protocol": 19,
|
||||
"tag": "preview-2026-08-04-d78e3d3b5126",
|
||||
"assets": {
|
||||
"linux-x86_64": {
|
||||
"url": "https://github.com/herdrdev/herdr/releases/download/preview-2026-08-04-d78e3d3b5126/herdr-linux-x86_64",
|
||||
"sha256": "338afbfe03f0eb32efc52e30a5effc6c5ee772846bdb5e059f73d04b89b467d6"
|
||||
},
|
||||
"linux-aarch64": {
|
||||
"url": "https://github.com/herdrdev/herdr/releases/download/preview-2026-08-04-d78e3d3b5126/herdr-linux-aarch64",
|
||||
"sha256": "f79f3ad5b24dd1b6ba49ebee1b26d69ab5dcbeaf15be4fd7f3357ab0d17f6096"
|
||||
},
|
||||
"macos-x86_64": {
|
||||
"url": "https://github.com/herdrdev/herdr/releases/download/preview-2026-08-04-d78e3d3b5126/herdr-macos-x86_64",
|
||||
"sha256": "384ee2f2a805260d24f3d398ba8169aa68b502452ab1457c5da40a8e4d9c975f"
|
||||
},
|
||||
"macos-aarch64": {
|
||||
"url": "https://github.com/herdrdev/herdr/releases/download/preview-2026-08-04-d78e3d3b5126/herdr-macos-aarch64",
|
||||
"sha256": "d02190962293ccf19186e0ea8a162d7f670ef49e61dfc10051bffd7da08a7ee4"
|
||||
},
|
||||
"windows-x86_64": {
|
||||
"url": "https://github.com/herdrdev/herdr/releases/download/preview-2026-08-04-d78e3d3b5126/herdr-windows-x86_64.zip",
|
||||
"sha256": "b1d288118848ecd3ef33532a34506edc53a38a416057aee5b7fe1de4188a16fc",
|
||||
"format": "zip"
|
||||
}
|
||||
}
|
||||
},
|
||||
"2026-07-29-44b3adb12552": {
|
||||
"base_version": "0.7.5",
|
||||
"commit": "44b3adb125524ea9a55739eee3776f922f2115ad",
|
||||
|
|
|
|||
Loading…
Reference in New Issue