aboutsummaryrefslogtreecommitdiff
path: root/website/src/content/docs/cli-reference.mdx
diff options
context:
space:
mode:
authorOgulcan Celik <ogulcancelik@gmail.com>2026-05-18 20:17:00 +0300
committerOgulcan Celik <ogulcancelik@gmail.com>2026-05-18 20:17:43 +0300
commit57e907977c86c5d2005286d5ed5ca982549a1a8e (patch)
tree696f95ee2f01990b55762fff153482d1b60e4aad /website/src/content/docs/cli-reference.mdx
parenta2e381dfa57928cc5721c370bb53029d780823d6 (diff)
docs: clarify live docs agent cli
Diffstat (limited to 'website/src/content/docs/cli-reference.mdx')
-rw-r--r--website/src/content/docs/cli-reference.mdx6
1 files changed, 5 insertions, 1 deletions
diff --git a/website/src/content/docs/cli-reference.mdx b/website/src/content/docs/cli-reference.mdx
index 7e42ebf9..78487b6a 100644
--- a/website/src/content/docs/cli-reference.mdx
+++ b/website/src/content/docs/cli-reference.mdx
@@ -128,7 +128,11 @@ herdr agent attach <target> [--takeover]
herdr agent start <name> [--cwd PATH] [--workspace ID] [--tab ID] [--split right|down] [--focus|--no-focus] -- <argv...>
```
-Targets accept terminal IDs, unique agent names, and legacy pane IDs.
+Agent targets can be terminal IDs, unique agent names, detected or reported agent labels, or legacy pane IDs. Names and labels are agent identities. Terminal IDs and legacy pane IDs are low-level escape hatches.
+
+`agent read` reads the resolved terminal stream. `agent send` writes literal text to that stream. `agent get`, `agent focus`, `agent wait`, and `agent attach` require the resolved terminal to have agent identity. `agent rename` can assign that identity.
+
+Use `pane send-text`, `pane send-keys`, `pane run`, and `terminal attach` for ordinary terminals, servers, tests, shells, or low-level terminal control. Use `pane run` when you want to submit a command with Enter.
## Direct terminal attach