docs(workshop): open the seats' terminals where the person can see them (#57)

* docs(workshop): open the seats' terminals where the person can see them

Asked to show the person the team's terminals, an agent ran
`rig terminal open <rig>` from its own shell. The tiles opened where
nobody could see them, and nothing appeared until the person said so.

The using-the-tui-together skill now starts from what the person can
see: only what is open in a terminal they can see. On a desktop,
`rig terminal open <rig> --window` opens the tiles in a new window or
tab in front of them. Headless, such as over SSH, the agent tells them
plainly to open a terminal and gives them the attach command for each
seat. The lead's guidance and the README give the person the same two
routes. Versions before 0.6.7 have no `--window`, so each place names
the attach commands as the way in there.

* docs(workshop): say what --window does from 0.6.7, not why it's needed

From 0.6.7, `rig terminal open` without `--provider` already opens a
window, so "without --window the tiles can open where nobody sees them"
no longer holds. The skill now says `--window` makes the request
explicit, that leaving out `--provider` also opens a window from 0.6.7,
and that `--provider herdr` or `--provider cmux` without `--window`
uses an existing workspace. The intro says that opening a workspace
from your shell doesn't by itself show it to the person.

---------

Co-authored-by: OpenRig contributors <[email protected]>

rigs/workshop/README.md

@@ -106,8 +106,10 @@ for you can do the first one itself:
   then d, to leave it running. `rig ps --nodes --rig workshop --json --fields canonicalSessionName,tmuxAttachCommand`
   prints this command for every seat.
 - Run `rig` for OpenRig's TUI.
-- Open every seat as a tile with `rig terminal open workshop`, if
-  `rig terminal status` shows a terminal provider (herdr by default, or cmux).
+- Open every seat as a tile in a new terminal window with
+  `rig terminal open workshop --window`, run on the machine's desktop (herdr if
+  it's installed, otherwise tmux; versions before 0.6.7 have no `--window`).
+  Without a desktop, such as over SSH, use the `tmux attach` commands above.
 
 A message from your own terminal arrives marked as from an unsigned sender;
 start it with your name if you want the lead to know who sent it:

rigs/workshop/agents/workshop/bundle-skills/using-the-tui-together/SKILL.md

@@ -29,11 +29,22 @@ and let them answer it.
 
 ## Open it
 
+The person sees only what is open in a terminal they can see. Opening a workspace from your shell doesn't by itself
+show it to them: open a visible terminal on their desktop, or tell them what to run.
+
 - `rig tui` opens the TUI in the current terminal.
 - `rig tui --shared` joins the shared TUI that OpenRig's kernel rig runs, so you and the person see the same screen.
   Detach with Ctrl-b d.
-- To show the seats' own terminals beside it: `rig terminal open <rig>` opens each live seat as a tile if herdr is
-  installed; `rig terminal --help` has the options.
+- To show the seats' own terminals:
+  - **On a desktop:** `rig terminal open <rig> --window` opens each live seat as a tile in a new terminal window or
+    tab, in front of the person (herdr if it's installed, otherwise tmux). `--window` makes that request explicit. From
+    0.6.7, leaving out `--provider` also opens a window, while `--provider herdr` or `--provider cmux` without
+    `--window` uses an existing workspace instead. Versions before 0.6.7 have no `--window` (`rig terminal open --help`
+    shows yours); there, give the person the attach commands below.
+  - **Headless, such as over SSH:** nothing can open in front of the person. Tell them plainly to open a terminal on
+    this machine and attach, and give them the commands: `rig ps --nodes --rig <rig> --json --fields
+    canonicalSessionName,tmuxAttachCommand` prints one for each seat.
+  - Then ask whether they can see it. A command that succeeded doesn't show what's on their screen.
 
 ## Drive it, saying what you're doing
 

rigs/workshop/agents/workshop/guidance/lead.md

@@ -114,8 +114,11 @@ own names from `rig whoami --json` (`identity.rigName` and
   `rig capture <your session>` to read your screen;
 - to come to your terminal: `tmux attach -t <your session>` (from inside tmux,
   `tmux switch-client -t <your session>`), or `rig` for OpenRig's TUI;
-- to see the whole team: `rig terminal open <rig>`, when `rig terminal status`
-  shows a terminal provider.
+- to see the whole team: `rig terminal open <rig> --window`, run on this
+  machine's desktop, opens every seat in a new terminal window (versions
+  before 0.6.7 have no `--window`). Without a desktop, such as over SSH, give
+  them the `tmux attach` command for each seat: `rig ps --nodes --rig <rig>
+  --json --fields canonicalSessionName,tmuxAttachCommand`.
 
 ## Scope the work