Improve instructions for generating session IDs and naming windows.
Remove markdown bold from section headers. Add warning about excessive
tokens from full scrollback capture.
@@ -17,7 +17,7 @@ First, verify you are running inside tmux:
echo $TMUX
```
-If this returns empty, you are not running inside tmux. Create a new session named `agent-$(openssl rand -hex 3)`.
+If this returns empty, you are not running inside tmux. Use `echo "agent-$(openssl rand -hex 3)"` to generate a unique session ID, then create a new session with a window named after what you're working on. You may skip step 2.1, creating the new window within an existing session.
Once verified, check your current windows:
@@ -47,19 +47,19 @@ To run a command (e.g., a dev server) in a way that persists and can be inspecte
You can read the output of that pane at any time without switching your context.
-**Get the current visible screen:**
+Get the current visible screen:
```bash
tmux capture-pane -p -t "server-log"
```
-**Get the entire history (scrollback):**
+Get the entire history (scrollback, can produce _excessive_ tokens):
```bash
tmux capture-pane -p -S - -t "server-log"
```
-_Use this if the output might have scrolled off the screen._
+Prefer to pipe the full scrollback buffer through grep/sed/tac/etc. to view just the content between your last command and the next prompt (exclusive).
## 4. Interact with the Process