From 57e907977c86c5d2005286d5ed5ca982549a1a8e Mon Sep 17 00:00:00 2001 From: Ogulcan Celik Date: Mon, 18 May 2026 20:17:00 +0300 Subject: docs: clarify live docs agent cli --- website/src/content/docs/cli-reference.mdx | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) (limited to 'website/src/content/docs/cli-reference.mdx') 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 [--takeover] herdr agent start [--cwd PATH] [--workspace ID] [--tab ID] [--split right|down] [--focus|--no-focus] -- ``` -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 -- cgit v1.2.3