feat: add direct terminal attach stream

1 files changed, 6 insertions, 0 deletions

diff --git a/README.md b/README.md
index 1b5ed7fa..dd8ec7a1 100644
--- a/README.md
+++ b/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.