aboutsummaryrefslogtreecommitdiff
path: root/docs/next/README.md
diff options
context:
space:
mode:
authorOgulcan Celik <ogulcancelik@gmail.com>2026-05-17 03:34:08 +0300
committerOgulcan Celik <ogulcancelik@gmail.com>2026-05-17 03:34:08 +0300
commitc115dbd0510200371dc033c208c0c3c09131c797 (patch)
treebaf745f658ec7740e89769556a8ccd3d2369ca38 /docs/next/README.md
parentf7fe0f203e0f349df33819aab239c0aade016f79 (diff)
docs: document terminal core in next docs
Diffstat (limited to 'docs/next/README.md')
-rw-r--r--docs/next/README.md8
1 files changed, 7 insertions, 1 deletions
diff --git a/docs/next/README.md b/docs/next/README.md
index 1b5ed7fa..f5faf558 100644
--- a/docs/next/README.md
+++ b/docs/next/README.md
@@ -108,6 +108,12 @@ Host workbox
same session, same agents, same state.
+### direct agent attach
+
+`herdr` and `herdr --remote` attach to the full Herdr session UI. `herdr agent attach <target>` attaches your current terminal directly to one server-owned terminal, like a single-pane terminal attach. `herdr terminal attach <terminal_id>` does the same by terminal id.
+
+Direct attach streams the current rendered terminal state first, then live ANSI frames. Your input goes straight to that terminal. Detach with `ctrl+b q`; send a literal `ctrl+b` with `ctrl+b ctrl+b`. One writable client owns input and resize for a terminal. A second attach fails unless you pass `--takeover`.
+
## agent awareness
the sidebar shows which agents are blocked, working, or done. workspaces roll up to their most urgent state so you can scan the full list at a glance.
@@ -147,7 +153,7 @@ herdr tab create --label "logs"
herdr pane split 1-1 --direction right
herdr pane run 1-2 "npm test"
-# wait for an agent
+# wait for a pane-level UI attention state
herdr wait agent-status 1-1 --status done
# read output