diff options
Diffstat (limited to 'website/src/content/docs')
| -rw-r--r-- | website/src/content/docs/cli-reference.mdx | 8 | ||||
| -rw-r--r-- | website/src/content/docs/configuration.mdx | 1 | ||||
| -rw-r--r-- | website/src/content/docs/quick-start.mdx | 4 | ||||
| -rw-r--r-- | website/src/content/docs/socket-api.mdx | 17 |
4 files changed, 29 insertions, 1 deletions
diff --git a/website/src/content/docs/cli-reference.mdx b/website/src/content/docs/cli-reference.mdx index ed51ce1e..ad837142 100644 --- a/website/src/content/docs/cli-reference.mdx +++ b/website/src/content/docs/cli-reference.mdx @@ -129,9 +129,15 @@ herdr pane report-agent <pane_id> \ --state idle|working|blocked|unknown \ [--message TEXT] \ [--custom-status TEXT] \ - [--seq N] + [--seq N] \ + [--agent-session-id ID] \ + [--agent-session-path PATH] ``` +`pane get`, `pane list`, `agent get`, and `agent list` include a read-only `agent_session` object when an official integration has reported a native session reference. If no native session reference is stored, the field is omitted. + +Those commands include `foreground_cwd` when Herdr can resolve the cwd of the foreground process controlling the pane. The existing `cwd` field remains the pane/workspace cwd used for labels and follow-cwd behavior. + Report display-only pane metadata without taking over semantic state: ```bash diff --git a/website/src/content/docs/configuration.mdx b/website/src/content/docs/configuration.mdx index 765a0b0f..936cc3ac 100644 --- a/website/src/content/docs/configuration.mdx +++ b/website/src/content/docs/configuration.mdx @@ -124,6 +124,7 @@ next_tab = "prefix+n" switch_tab = "prefix+1..9" rename_tab = "prefix+shift+t" close_tab = "prefix+shift+x" +copy_mode = "prefix+[" focus_pane_left = "prefix+h" focus_pane_down = "prefix+j" focus_pane_up = "prefix+k" diff --git a/website/src/content/docs/quick-start.mdx b/website/src/content/docs/quick-start.mdx index 7dc6e019..b6b1728b 100644 --- a/website/src/content/docs/quick-start.mdx +++ b/website/src/content/docs/quick-start.mdx @@ -53,6 +53,10 @@ Herdr is mouse-native. You can click panes, tabs, workspaces, and agents; drag b Ctrl-click opens pane links when your terminal sends the modified click to Herdr. This works for OSC 8 hyperlinks and visible `http://` or `https://` URLs. The portable terminal-native fallback is Shift-Ctrl-click on Linux or Shift-Cmd-click on macOS. +## Copy from the keyboard + +Press `prefix+[` to enter copy mode for the focused pane. Use `h/j/k/l`, `w/b/e`, and `{`/`}` to move, `v` or Space to start a selection, `y` or Enter to copy it, and `q` or Esc to leave without copying. + ## Manage named sessions Named sessions are separate Herdr server namespaces. Use them when you want fully separate runtime state. diff --git a/website/src/content/docs/socket-api.mdx b/website/src/content/docs/socket-api.mdx index 3b12d928..8525c33b 100644 --- a/website/src/content/docs/socket-api.mdx +++ b/website/src/content/docs/socket-api.mdx @@ -163,6 +163,23 @@ Integrations report agent state with `pane.report_agent`. `custom_status` is visual. It can show a short label like `indexing` without changing semantic behavior. +Official integrations can also report a native session reference. `pane.get`, `pane.list`, `agent.get`, and `agent.list` expose a read-only `agent_session` object when Herdr has a stored native session reference: + +```json +{ + "agent_session": { + "source": "herdr:codex", + "agent": "codex", + "kind": "id", + "value": "..." + } +} +``` + +If no native session reference is stored, the field is omitted. + +`pane.get`, `pane.list`, `agent.get`, and `agent.list` also expose `foreground_cwd` when Herdr can resolve the cwd of the process currently controlling the pane PTY. The existing `cwd` field remains the pane/workspace cwd used for labels, follow-cwd behavior, and restored session state. + Use `pane.report_metadata` when a user hook wants to customize presentation without taking over lifecycle state from a Herdr integration. ```json |