# Sit & Watch A Herdr window built around two mods. The left sidebar holds the screenshot mode Spaces and Agents lists, and under them the Sit & Watch office, where each agent is a robot at a desk and a developer in a red armchair reacts to how they are doing. The tab bar, pane headers and status bar are the screenshot mode versions too, so one shortcut (Cmd+Shift+H) smudges every hidden space, machine and tab name across the whole window, the office included. ![Sit & Watch](preview.png) ## What you see Left to right, on the theme's `canvas` background with 1px `border` dividers and no system titlebar (macOS traffic lights at 12, 16): 1. **Sidebar**, 281px wide (drag 44 to 480px), theme `chrome` background. Top to bottom: - Brand row, 42px: Herdr's shipped `workspace-chrome` (logo, search, sidebar toggle). Drags the window. - Three cards in a `sidebar-cards` column with 8px padding and 8px gaps. Each card has a 10px radius and a 1px edge in the shown tab's colour at 70%. Spaces and Agents fade top to bottom from a little of that colour into the sidebar's `chrome`, and their 30px title bars take a wash and bottom edge in it. - Spaces list (`screenshot-spaces`), weight 1, at least 31px. Header reads "Spaces" or "Spaces · screenshot mode", with fold, a gear (options popup: Screenshot mode, Denser rows, Hide phrases…, Demo mode), the eye and +. Each space opens into its tabs, agents and sub-agents, with its repo and branch on a line under the name. - Agents list (`screenshot-agents`), weight 1.3, at least 42px. Agents grouped Needs you, Done, Working, Idle, with "12 min" timings. - Sit & Watch office (`sitandwatch`), weight 1, at least 220px, with `props: { role: "panel", radius: 9 }` so its corners sit inside the card. Pixel-art panel: a 23px header (`N/M AT IT`, power bar, `OPTS`, `DEMO`, `_`), the desks, then the armchair, the pets and the speech bubble. - Footer, 69px: `workspace-chrome` with `footer: true` (Settings, Add machine). 2. **Work column**, the rest of the width: - Tab bar (`screenshot-tabs`), 42px, drags the window. Tabs tinted with their own colour, or their space's, `+`, and Files and Changes buttons on the right. - Body with 8px padding and 8px gaps: the active tab's panes, each with a 30px `screenshot-pane` header always showing at the top, 10px corner radius, 1px `border`, 1px in the shown tab's colour when focused, a diagonal fade from a little of that colour into near-black, and 14 x 12px terminal padding. `terminal_opacity: 0` lets the fade show behind the terminal text. A lone pane keeps its header and frame. The panes sit in a `main-stack` stack whose other child, `demo-session`, takes over while demo mode is on. - A right panel, 746px (280 to 900px), hidden until Files or Changes is clicked. A stack of the shipped `files` and `changes` mods, `files` on top. - Status bar (`screenshot-status`), 28px: machine, branch, agent count, `⌘ Shift P commands`. ## How it behaves - Agent status shows in three places at once. Spaces and Agents rows show the spinner (working), a filled dot (done), the needs-you colour and the idle ring. The office shows the same agents as desks: working desks scroll a log, a blocked one makes the developer spill his popcorn, and finishing ones get cheered. The status bar counts them. - Cmd+Shift+H, or the eye next to "Spaces", toggles screenshot mode. Hidden spaces, machines and tabs become soft smudges in the lists, tab bar, pane headers and status bar, and Sit & Watch draws them as `Space N` or their alias. Aliased phrases are swapped in place everywhere. - Clicking "Spaces" or "Agents" folds that section to its header row. Its weight drops to 0, so the Sit & Watch office grows into the freed height. Clicking again restores it. - Dragging the sidebar's right edge resizes it. Dragging the lines between the three sidebar sections resizes them (the sidebar column is `resizable`). - `_` in the office header minimises it to its header. Its own Options can also pin a height. - Files and Changes in the tab bar show and swap the right panel. - Demo mode (last switch in the gear's options) swaps every panel for a made-up world: four spaces, seven agents moving between states, and the office's desks. The terminal area switches to `demo-session`, a made-up Claude Code session for the selected tab, drawn with the same pane fade and focus colour. Switching it off brings the real terminals back. - Switching tab or space, or picking a colour, repaints the card edges and fades, the pane fade and the focus outline in the shown tab's colour (its space's when it has none). `screenshot-status` does this with `layout.set`, so the layout file changes too. - Right-clicking a tab, a tree row or an agent opens the tab menu (`tab-menu`): Rename, colour, New tab and Close. ## Built from - `layouts/sit-and-watch.json`, cloned from Herdr's `main` (0.1.10). Root `row`: `sidebar` column (`brand`, `sidebar-lists` column holding a `sidebar-cards` column of `spaces`, `agents` and `sitandwatch`, then `sidebar-footer`) and `work` column (`tabs`, `work-body` row of a `main-stack` stack (`main` and `demo-session`) and `panel`, then `status`). Keep these ids. Sit & Watch looks for the block id `sitandwatch`, and the screenshot mods find their blocks by mod name to fold them. - `mods/screenshot-spaces`, `screenshot-agents`, `screenshot-tabs`, `screenshot-pane`, `screenshot-status`, `tab-menu`, `demo-session`: the screenshot mode mods, unchanged from [herdr-screenshot-mode](https://github.com/funny-it-worked-last-time-gsv/herdr-screenshot-mode). Their own brief is `screenshot-mode.RECIPE.md` in this folder. - `mods/sitandwatch`, unchanged from [herdr-sit-and-watch](https://github.com/funny-it-worked-last-time-gsv/herdr-sit-and-watch), placed with `props: { role: "panel", radius: 9 }`. Its own brief is `sitandwatch.RECIPE.md` in this folder. - Shipped mods used as they are: `workspace-chrome`, `files`, `changes`. - `keys.json`: `"global": { "cmd-shift-h": "screenshot-spaces.privacy" }`. - The two mod families share state through Herdr's shared `privacy` key (`{ on, hidden, shown, phrases }`), read by the same `privacy.js` file copied into each mod. No other link between them. - Programs run: Sit & Watch calls `hc ls` and `hc get`. `screenshot-spaces` runs `git status` and `git rev-parse` (`exec`) in each space's folder for the repo line. No network. ## Watch out - Sit & Watch's ship, sub-agent and activity hooks are optional Claude Code hooks that live in the Sit & Watch repo, not here. Without them the office still works but shows no explosions, no `2/5` sub-agent counts and only terminal titles in its bubbles. - Sit & Watch needs about 220px of height and at least 260px of width to draw the chair and desks. Narrower than 160px, the sidebar mods draw a compact rail. - Fold works by `layout.resize` with `weight: 0` on the section's block. Giving the Spaces or Agents block a `px` size breaks the hand-off to the office. Keep them as weights. - If an existing install already has a `cmd-shift-h` binding (for example a clone of screenshot mode under another name), merge rather than replace, or one of them stops toggling. - `screenshot-status` rewrites the card and pane backgrounds and edges whenever the shown colour changes. Hand edits to those get painted over, so change `gradient.js` instead. - The Last command line in pane headers needs the zsh snippet from the screenshot mode repo. Without it that line stays empty. ## Done when - `herdr-app check` passes for all eight mods and `herdr-app status` shows `"layout": "sit-and-watch"` with no errors after `layout.switch {"name":"sit-and-watch"}`. - The sidebar shows Spaces, Agents and the office, in that order, with the footer under them. - Starting an agent in any tab adds a desk in the office and a Working row in Agents within a second or two. - Cmd+Shift+H smudges a hidden space in the Spaces list, the tab bar, the status bar and on its office desk at the same time. - Folding Spaces makes the office taller. Unfolding gives the height back. - Files in the tab bar opens the right panel. Clicking it again hides it. - Switching to a tab with a different colour repaints the card edges and the pane fade within a second. - Demo mode on shows made-up spaces, agents and desks, and the terminal area shows a made-up session. Off brings every real one back.