Skip to content

The ultimate harness for coding agents and beyond. All your agents. All your machines. One command center. Start with code, then follow your curiosity and build across disciplines: CAD, circuits, robots, games and music.

Web UX review tooling and web-only workspace chrome seams (#1662)

Jacob Pham4862383ac39a
diff --git a/desktop/design/web-ux-audit/README.md b/desktop/design/web-ux-audit/README.md
new file mode 100644
index 000000000..f41fad9ac
--- /dev/null
+++ b/desktop/design/web-ux-audit/README.md
@@ -0,0 +1,723 @@
+# Harness web: UX audit
+
+This audit covers every screen of the Harness web app (the Flutter web build of `desktop/`,
+`lib/web/web_entry.dart`, served at harness.autonomous.ai/harness-web) on phones, a tablet
+and a computer. It records what a person can reach, what goes wrong, and how the fixes could
+be split. It changes no product code.
+
+- **Source revision:** audited on branch `super-tab/fc53732c35338a2ea34cb592` (`a521af922`),
+ from `main` at `d763e16d6`. The review tooling then moved to `main` (`desktop/tool/web_ux/`).
+- **Evidence:** every screenshot here comes from the no-login review fixture, which renders
+ the real widgets with fake data. A live pass against the owner's account did not run;
+ see [Live pass](#live-pass). Every finding is tagged **fixture**, and also says whether
+ the problem is in the **widget code** (it would appear with real data) or in the
+ **fixture data** (needs a live check).
+- **Widths:** 360×740 (Android phone), 390×844 (iPhone), 768×1024 (iPad mini) and
+ 1440×900 (computer, mouse). Phones and the tablet are emulated with touch, a mobile user
+ agent and the platform their browser reports, so Flutter sees iOS or Android and the
+ store bar shows, as it does on a real phone. All widths are captured in dark
+ (Graphite, the default a new user sees). 390 and 1440 are also captured in light (Paper).
+
+## Contents
+
+1. [How to reproduce](#how-to-reproduce)
+2. [Inventory](#inventory)
+3. [Not reachable on web](#not-reachable-on-web)
+4. [Findings](#findings): [blocks](#blocks), [slows](#slows), [polish](#polish)
+5. [Cross-cutting checks](#cross-cutting-checks)
+6. [First load](#first-load)
+7. [Unverified](#unverified)
+8. [Proposed fix groups](#proposed-fix-groups)
+9. [Live pass](#live-pass)
+10. [Pre-existing issues](#pre-existing-issues)
+
+## How to reproduce
+
+The screenshots this README links to are on the audit branch
+(`super-tab/fc53732c35338a2ea34cb592`, revision `a521af922`), not on `main`, so `main` does not
+carry 11 MB of images. Every `screens/…` and `checks/…` link opens that revision on GitHub.
+The baseline results it was written from are here: `checks.json` and `load-time.json`.
+
+Run from `desktop/`:
+
+```bash
+# The whole app, signed in as a fake account; ?scenario= picks the state.
+flutter build web --no-web-resources-cdn --dart-define=HARNESS_TEST=true \
+ -t tool/web_ux_fixture.dart -o /tmp/web-ux
+# The Super Tab, from PR #1570's fixture; ?theme=dark is the Graphite theme.
+flutter build web --no-web-resources-cdn --dart-define=HARNESS_TEST=true \
+ -t tool/super_tab_mobile_fixture.dart -o /tmp/web-ux-super-tab
+
+# Playwright is not a dependency of this repository: install it once outside it.
+pnpm --dir ~/.cache/web-ux-playwright add playwright
+export PLAYWRIGHT_DIR=~/.cache/web-ux-playwright # CHROME_PATH may name an installed Chromium
+
+node tool/web_ux/capture.mjs /tmp/web-ux out # out/screens/<flow>/<width>-<theme>.png
+FIXTURE=super-tab node tool/web_ux/capture.mjs /tmp/web-ux-super-tab out # the super-tab-* flows
+node tool/web_ux/checks.mjs /tmp/web-ux out # tap sizes, wheel, swipe, hover, focus
+flutter build web --release --no-wasm-dry-run --no-web-resources-cdn \
+ --base-href=/harness-web/ -o /tmp/web-release
+node tool/web_ux/load-time.mjs /tmp/web-release out # first load, three network profiles
+```
+
+| File | What it is |
+| --- | --- |
+| `tool/web_ux_fixture.dart` | Runs the real `HarnessApp` (store bar, `RootShell`, browser workspace) on a fake account |
+| `tool/web_ux_scenarios.dart` | Merges every fix group's scenarios into the `?scenario=` names |
+| `tool/web_ux/scenarios/<group>.dart` | One file per fix group (`menus`, `store`, `first_computer`, `first_load`, `pane`, `welcome`, `states`) plus `base`: the state each scenario seeds |
+| `tool/web_ux_seed.dart` | Fake person, computers, tabs and terminal text |
+| `test/support/web_ux_app.dart` | The fake `AppNotifier`: never signs in, reads or dials; API base is a closed loopback port |
+| `test/web_ux_app_test.dart` | Its test |
+| `tool/web_ux/flows/<group>.mjs` | One file per fix group, same keys: each flow is a scenario plus the clicks a person makes, by accessible name. `load-flows.mjs` reads every file in the folder |
+| `tool/web_ux/capture.mjs`, `serve.mjs` | Screenshots; blocks every request that leaves the page (`blocked*.json` is empty) |
+| `tool/web_ux/checks.mjs` | Cross-cutting interaction checks, results in `checks.json` and `checks/` |
+| `tool/web_ux/load-time.mjs` | First load of a release build; results in `load-time.json` |
+| `tool/web_ux/playwright.mjs` | Finds Playwright in `PLAYWRIGHT_DIR` |
+
+A fix group adds its scenarios and flows to its own two files and edits nothing else; a name
+used by two groups stops the fixture or the capture with an error. Flow names are the audit's,
+unchanged.
+
+Flows reach dialogs and panels by clicking through the accessibility tree, the way a person
+does. A flow that cannot be clicked through is recorded as failed in `captures*.json`
+instead of being opened in code.
+
+## Inventory
+
+Every screen and state a web user can reach, with its source and its screenshots under
+[`screens/<flow>/`](https://github.com/autonomous-ai/openharness/tree/a521af922/desktop/design/web-ux-audit/screens) on the audit branch (`360-dark`, `390-dark`, `390-light`, `768-dark`, `1440-dark`,
+`1440-light`). "Web" means the widget lives in `lib/web/`; everything else is shared with the
+Desktop app. A few controls exist only at some widths, so their flows do too:
+- **Phone only (below 720 px):** the tab switcher, the footer dropdown and the Super Tab
+ conversations drawer.
+- **768 and 1440 only:** a tab's right-click, the Add Phone button and the footer's Harness
+ Monitor count. On phones, Add phone is not in the menu, and the Harnesses count sits
+ inside the footer dropdown.
+
+### Before the workspace
+
+| Screen or state | How a person gets there | Source | Flow |
+| --- | --- | --- | --- |
+| Store bar ("Get the app") | Any page on an iPhone, iPad or Android browser | `lib/web/shell/web_store_banner.dart` (web) | every phone and tablet capture |
+| Sign-in | Signed out | `lib/screens/login_screen.dart` `_webPage` | `signin` |
+| Sign-in, waiting for Google or Apple | After a sign-in button | same, `_Action` | `signin-waiting` |
+| Sign-in, error | A failed sign-in | same, `_ErrorTile` | `signin-error` |
+| Sign-in, session expired | The server refused the saved session | same | `signin-expired` |
+| Sign-in with a phone, QR | Scan with your phone (computer widths only) | same | `signin-qr` |
+| Sign-in with a phone, confirm account | The phone approved | same | `signin-confirm` |
+| Starting up | Opening the app | `lib/widgets/bootstrapping_screen.dart` | `booting` |
+| Connect a computer (no computer yet) | Signed in, no computer on the account | `lib/web/onboarding/web_first_machine.dart` (web) | `first-machine` |
+| Before the machine list answers | First seconds after sign-in | `lib/widgets/harness_start_page.dart` | `first-machine-loading` |
+| Connect your computer, one ready | A computer waits for this browser | `lib/web/onboarding/web_your_computers.dart` (web) | `link-machine` |
+| Your computers: offline, ready, removed | Several computers, none connected | same, `ComputerLinkState` | `computers` |
+| Connect, then refused | Connect on a computer that does not trust this browser | same | `link-password` |
+| Only computer offline | The one connected computer goes offline | `web_first_machine.dart` replaces the workspace | `offline-only` |
+| Shared harness link `/s/…` | A link someone sent | `lib/sharing/shared_agent_page.dart` | `shared-link` |
+| Viewer link `/?viewer=1&machine=&agent=` | `hn view` | `lib/viewer/viewer_page.dart` | `viewer-page` |
+| Incomplete viewer link `/?viewer=1` | A cut-off `hn view` link | `lib/app_shell.dart:384-389` | `viewer-incomplete` |
+
+### Workspace
+
+| Screen or state | How a person gets there | Source | Flow |
+| --- | --- | --- | --- |
+| Workspace, three panes / one pane | Signed in with a connected computer | `lib/screens/swarm_screen.dart`, `lib/widgets/pane_grid.dart`, chrome from `lib/web/shell/web_chrome.dart` (web) | `workspace`, `workspace-one` |
+| Phone layout: one pane, tab switcher, footer dropdown | Any width under 720 px | `lib/web/tabs/web_tab_switcher.dart`, `lib/web/footer/web_footer_bar.dart` (web) | every 360/390 capture |
+| Many tabs (tab row scrolls) | 16 tabs | `swarm_screen.dart` tab row, `WorkspaceTabScroller` | `many-tabs` |
+| Tab switcher (phone) | Tap "1:code · 3/3" | `lib/web/tabs/web_tab_switcher.dart`, `web_tab_menu.dart` (web) | `tab-switcher` |
+| Right-click on a tab (computer) | Right-click a tab | `lib/widgets/desktop_workspace_tab.dart:202-243` | `tab-menu` |
+| App menu | ☰ | `lib/web/shell/web_app_menu.dart`, `web_menu_items.dart` (web) | `app-menu` |
+| Footer dropdown (phone) | Tap the machine name at the bottom | `lib/web/footer/web_footer_bar.dart` (web) | `footer-menu` |
+| New tab page | + (or a first tab with no panes) | `lib/widgets/workspace_welcome.dart`, `lib/widgets/harness_start_page.dart` | `new-tab`, `empty-tab` |
+| Error banner with Retry | A launch or sign-in failure | `swarm_screen.dart` (~7990-8080) | `error-banner` |
+| New device band | Another device joined the account | `lib/widgets/new_device_notice.dart` | `new-device` |
+| Notifications | Bell | `showNotificationInbox` | `notifications` |
+| Open Harness (picker) | Search icon | `lib/widgets/swarm_switcher.dart`, `desktop_search_panel.dart` | `open-harness` |
+| Agent picker | Pane header, agent name | same picker, Agents | `agent-picker` |
+| Model and subscription picker | Pane header, model name | same picker, Models; `lib/models/models_panel.dart` | `model-picker`, `models` |
+| Machines | Menu ▸ Machines | `lib/widgets/machines_panel.dart` | `machines` |
+| History | Menu ▸ History | `swarm_screen.dart` navigation history | `history` |
+| All commands | Menu ▸ All commands | `swarm_screen.dart` `_searchCommands` | `all-commands` |
+| Appearance panel | Menu ▸ Appearance | `lib/widgets/harness_customize_pane.dart` | `appearance` |
+| New Harness form (Split pane) | Menu ▸ Split pane | `lib/widgets/new_harness_form.dart` | `split-pane` |
+| Add your phone | Phone icon (computer widths) | `showAddPhoneDialog` | `add-phone` |
+| Harness Monitor | Footer "Harnesses 4" | `lib/state/harness_monitor_controller.dart` | `harness-monitor` |
+| Store, Store product page | Store icon (computer) or Menu ▸ Store (phone) | `lib/store/store_screen.dart` | `store`, `store-product` |
+
+### Terminal panes
+
+| State | When | Source | Flow |
+| --- | --- | --- | --- |
+| Connected | Normal | `lib/widgets/terminal_panel.dart` | `workspace` |
+| Connecting (session opening) | Opening a terminal | `terminal_panel.dart:2741-2770` | `opening` |
+| Computer connecting / reconnecting | The relay is (re)dialling | `pane_grid.dart` header, tab status icon | `connecting`, `reconnecting` |
+| Computer offline (another one still connected) | The computer went to sleep | `pane_grid.dart:1708-1860` | `offline` |
+| View only | A terminal this browser may watch but not type into | `TerminalSession.readOnly` | `view-only` |
+| Another app took control | Opened elsewhere | `terminal_panel.dart` `_ControlBanner` | `taken-over` |
+| Error, Reconnect | The session failed | `terminal_panel.dart` | `terminal-error` |
+
+### Settings
+
+Menu ▸ Settings: a screen with a rail on a computer, a list then a page on a phone
+(`lib/settings/settings_screen.dart`, `settings_compact.dart`).
+
+| Section | Source | Flow |
+| --- | --- | --- |
+| Account | `settings/sections/account_section.dart` | `settings-account` |
+| Appearance (opens the panel) | `harness_customize_pane.dart` | `settings-appearance` |
+| Notifications | `settings/sections/` alerts | `settings-notifications` |
+| Privacy (web only) | `settings/sections/` privacy | `settings-privacy` |
+| Keyboard shortcuts | `lib/shortcuts/shortcuts_browser.dart` | `settings-keyboard-shortcuts` |
+| Usage (browser activity only) | `settings/sections/usage_section.dart:122` | `settings-usage` |
+| Routing | `settings/sections/` routing | `settings-routing` |
+| Tab invites | `settings/sections/tab_invites_section.dart` | `settings-tab-invites` |
+| Experimental | `settings/sections/` experimental | `settings-experimental` |
+| About | `settings/sections/` about | `settings-about` |
+
+### Super Tab
+
+From `tool/super_tab_mobile_fixture.dart` (the real `SuperTabView`, `lib/super_tabs/view.dart`,
+on PR #1570's fake backend). On the web it is reached from Recent Swarms or a tab invite.
+
+| State | Flow |
+| --- | --- |
+| Lead conversation with projects, people, machines | `super-tab` |
+| A work group needing a person, with an unconfirmed delivery | `super-tab-group` |
+| One project | `super-tab-one` |
+| No projects | `super-tab-empty` |
+| Viewer (read only) | `super-tab-viewer` |
+| Backend unreachable | `super-tab-offline` |
+| Conversations drawer (phone) | `super-tab-conversations` |
+| Members and machines | `super-tab-roster` (at 1440 the roster is always open and has no button, so that capture's click is recorded as failed and shows it in place) |
+| Group terminals, Pull requests | `super-tab-terminals`, `super-tab-pull-requests` |
+
+## Not reachable on web
+
+Each is switched off in code; the line is given so the claim can be checked.
+
+| Screen | Why a web user never sees it |
+| --- | --- |
+| Environment check and setup | `lib/state/app_state.dart:5954`: `_prepareEnvironment` returns ready when `viewer != null` (always on web) |
+| Setup tour, desktop sign-in step | `lib/state/app_state.dart:1300`: `signInStepShowing` is false when `viewer != null` |
+| Update notice | `lib/state/app_state.dart:1136`: `updateChecksEnabled` needs `viewer == null` |
+| Devices tab and its button | `lib/state/app_state.dart:2660`: `devicesEnabled => !kIsWeb && !kViewerMode` |
+| Companions (creature, daemon talk) | `lib/screens/swarm_screen.dart:351-355`: `_creatureChoice` needs `app.viewer == null`. A Companions tab would show the text at `swarm_screen.dart:8320` ("available in Settings → Experimental", a switch that the web's Experimental page does not have); no web path creates such a tab |
+| Account avatar menu | `lib/screens/swarm_screen.dart:3268`: `_accountControlShown => app.viewer == null`; the web app menu carries the email and Sign out instead |
+| Finder | `lib/finder/finder_availability.dart:12`: `canOpenFinderOn` needs `!kViewerMode` |
+| Settings ▸ Connectors | `lib/settings/settings_section.dart:110`: hidden when `kIsWeb` |
+| In-window menu bar, Export logs, About dialog | Linux/Windows menu bar and the native menu only (`lib/app_shell.dart` `runAppMenuAction`); Settings ▸ Debug hides Export on web (`settings/sections/debug_toolbar.dart:35`) |
+
+## Findings
+
+Ranked by severity: **blocks** (a person cannot do the task), **slows** (they can, with
+effort or confusion), **polish**. "Widget code" means the problem is in production widgets
+and appears with any data; "fixture data" means it depends on the fake data and needs a live
+check before fixing. Screenshot paths are relative to this folder.
+
+Every finding is tagged **fixture**, because the live pass did not run.
+
+### Blocks
+
+#### B1 · The Store cannot be used on a phone
+- **Screen, width:** Store and a Store product page · 360, 390. At 768 it is tight but usable.
+- **Screenshots:** [`screens/store/360-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/store/360-dark.png), [`screens/store/390-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/store/390-dark.png), [`screens/store-product/390-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/store-product/390-dark.png)
+- **Steps:** on a phone, Menu ▸ Store, then open Claude.
+- **What goes wrong:** the Store keeps its computer layout. Its own left rail (Discover, All
+ harnesses, Disciplines) takes about 45% of the screen, so the catalogue is ~150 px wide. Headings
+ break one letter per line ("S t a r t w…"), and cards and the product page are squeezed into a
+ strip.
+- **Fix:** below 720 px, turn the Store rail into a row of chips or a dropdown above the content,
+ and give the content the full width.
+- **Files, size:** `lib/store/store_screen.dart`, `store_discover.dart` (shared). Add a
+ `compactBelow` seam like Settings already takes from `WorkspaceChrome`; Desktop keeps
+ today's layout. M.
+- **Source:** widget code · fixture.
+
+#### B2 · A Swarm cannot be created with a mouse or on a phone
+- **Screen, width:** app menu, All commands, New tab page · all widths.
+- **Screenshots:** [`screens/app-menu/1440-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/app-menu/1440-dark.png), [`screens/all-commands/1440-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/all-commands/1440-dark.png), [`screens/new-tab/1440-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/new-tab/1440-dark.png)
+- **Steps:** look for a way to start a new Swarm.
+- **What goes wrong:** New Swarm (`super_tab.new`) is `hidden: true`
+ (`lib/shortcuts/keymap_commands.dart:712-718`), so All commands does not list it. No menu or
+ button runs it. The web runs it only from the keyboard (Alt+S), so a phone cannot start one at
+ all. Recent Swarms only reopens a Swarm that already exists (`swarm_screen.dart:7871`).
+ "Ctrl+Alt+S Build beyond code" on the New tab page opens the Store, not a Swarm.
+- **Fix:** add **New Swarm** to the web app menu and the New tab page.
+- **Files, size:** `lib/web/shell/web_menu_items.dart` (web only). S.
+- **Source:** widget code (checked in code) · fixture.
+
+### Slows
+
+#### S1 · Tap targets under 44 px on phones
+- **Screen, width:** app menu, tab switcher, footer dropdown, Machines actions, Settings back, pane
+ header controls · 360, 390.
+- **Screenshots:** [`screens/app-menu/390-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/app-menu/390-dark.png), [`screens/tab-switcher/390-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/tab-switcher/390-dark.png),
+ [`screens/footer-menu/390-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/footer-menu/390-dark.png), [`screens/machines/390-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/machines/390-dark.png); measurements in `checks.json` (`tapTargets`).
+- **Steps:** open any menu on a phone.
+- **What goes wrong:** every phone screen has controls under 44 px (`checks.json`,
+ `tapTargets`, 360 and 390): in the top bar, Menu 31×28, New Tab 23×28, Open Harness and
+ Notifications 31×28; in the pane header, Close Pane 28×28 and the agent and model labels
+ 28 tall; app menu and footer dropdown rows 32 tall; tab switcher rows 40; Machines actions
+ (Rename, Remove, Add machine, History…) 28; picker filter chips 32; Store Back and Forward
+ 32×30; New tab page rows 24; Settings rows and Back 38; New Harness form fields 32.
+- **Fix:** on compact web, give menu rows and bar controls a 44 px minimum hit area. The
+ visible size can stay as it is.
+- **Files, size:** `lib/web/shell/web_app_menu.dart`, `web_menu_items.dart`,
+ `lib/web/tabs/web_tab_menu.dart`, `lib/web/footer/web_footer_bar.dart`,
+ `web_dropdown_control.dart` (web). The pane header and Machines pills are shared: use a seam
+ (`WorkspaceChrome`) for their hit size. M.
+- **Source:** widget code · fixture.
+
+#### S2 · On phones and tablets the pane header hides the harness name and its state
+- **Screen, width:** any pane · 360, 390, and 768 with three panes.
+- **Screenshots:** [`screens/workspace/390-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/workspace/390-dark.png), [`screens/opening/390-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/opening/390-dark.png),
+ [`screens/offline/390-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/offline/390-dark.png), [`screens/taken-over/360-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/taken-over/360-dark.png), [`screens/workspace/768-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/workspace/768-dark.png)
+- **Steps:** open a harness on a phone.
+- **What goes wrong:** the name shrinks to "Fix chec…" while "Claude Code Anthropic" keeps its
+ full width. Status words that a computer shows ("Connecting", "Offline", "Take control")
+ shrink to unlabelled icons. At 768 the three-column grid stays, so each pane is about 250 px
+ and reads "Fix ch… Clau… Anth…".
+- **Fix:** on compact web, put agent and model behind one menu and keep the status word. Between
+ 720 and ~1000 px, use at most two columns.
+- **Files, size:** `lib/widgets/pane_grid.dart` pane header (shared), behind
+ `WorkspaceChrome.compactPaneHeader` (read with `compactPaneHeaderAt(width)`): on for web,
+ off for Desktop. M.
+- **Source:** widget code · fixture.
+
+#### S3 · A computer that is connecting or reconnecting shows only a ⊘ icon
+- **Screen, width:** pane and tab · all widths.
+- **Screenshots:** [`screens/connecting/1440-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/connecting/1440-dark.png), [`screens/reconnecting/1440-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/reconnecting/1440-dark.png), [`screens/reconnecting/390-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/reconnecting/390-dark.png)
+- **Steps:** the relay drops while a terminal is open.
+- **What goes wrong:** the terminal looks live and accepts focus. The only signal is a small ⊘
+ beside the tab and pane names. Its meaning appears only in a tooltip, which phones never show.
+ An offline computer gets a labelled "Offline" chip ([`screens/offline/1440-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/offline/1440-dark.png)), but this
+ state gets none.
+- **Fix:** a "Reconnecting…" chip with the same look as "Offline", and dim the input until the
+ connection is back.
+- **Files, size:** `lib/widgets/pane_grid.dart` (shared), behind
+ `WorkspaceChrome.labelsPaneStatus`: web only, Desktop unchanged (plan section 7, call 1). S.
+- **Source:** widget code · fixture.
+
+#### S4 · A view-only terminal does not say it is view only
+- **Screen, width:** pane · all widths.
+- **Screenshots:** [`screens/view-only/1440-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/view-only/1440-dark.png), [`screens/view-only/390-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/view-only/390-dark.png)
+- **Steps:** open a terminal this browser may watch but not control.
+- **What goes wrong:** only the model name turns grey. Nothing says typing is off, and the cursor
+ still blinks.
+- **Fix:** a "View only" chip in the header, and a lock in place of the cursor.
+- **Files, size:** `lib/widgets/pane_grid.dart`, `terminal_panel.dart` (shared). S.
+- **Source:** widget code · fixture.
+
+#### S5 · When the only computer goes offline, its panes give way to setup instructions
+- **Screen, width:** workspace · all widths.
+- **Screenshots:** [`screens/offline-only/1440-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/offline-only/1440-dark.png), [`screens/offline-only/390-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/offline-only/390-dark.png);
+ compare [`screens/offline/1440-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/offline/1440-dark.png) (another computer still connected).
+- **Steps:** have one computer and let it sleep.
+- **What goes wrong:** the tab row stays, but the open terminals are replaced by "Connect your
+ computer" and the install commands. The person loses the output they were reading and is
+ shown set-up steps for a computer that is already set up. `SwarmScreen._needsFirstConnection`
+ (`swarm_screen.dart:7389-7420`) treats an offline computer as no computer.
+- **Fix:** show the first-computer page only to an account that has never connected one.
+ Otherwise keep the panes in their Offline state, with a band reading "Studio Mac is offline".
+- **Files, size:** `lib/web/onboarding/web_first_machine.dart` (web) and the
+ `_needsFirstConnection` condition (shared, behind the existing `WorkspaceChrome.firstMachine`
+ seam). S.
+- **Source:** widget code · fixture.
+
+#### S6 · First load shows a page and then replaces it
+- **Screen, width:** after sign-in · all widths.
+- **Screenshots:** [`screens/first-machine-loading/1440-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/first-machine-loading/1440-dark.png), then [`screens/first-machine/1440-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/first-machine/1440-dark.png)
+- **Steps:** sign in on an account with no computer.
+- **What goes wrong:** until the machine list answers, the New tab page shows (search, Quick
+ start, Keyboard practice, Store cards, footer "Harnesses 0"). It then jumps to "Connect a
+ computer".
+- **Fix:** while `machineInventoryLoaded` is false, show the connect page's skeleton or
+ "Finding your computers…".
+- **Files, size:** `lib/web/onboarding/web_first_machine.dart` (web), `_needsFirstConnection`
+ (shared seam). S.
+- **Source:** widget code · fixture. How long the gap lasts needs a live check.
+
+#### S7 · The New tab page sells keyboard chords to a mouse-first web
+- **Screen, width:** New tab · all widths, phones included.
+- **Screenshots:** [`screens/new-tab/1440-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/new-tab/1440-dark.png), [`screens/new-tab/390-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/new-tab/390-dark.png), [`screens/empty-tab/390-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/empty-tab/390-dark.png)
+- **Steps:** press +.
+- **What goes wrong:** "Harness like a boss." and a table of Alt+N / Alt+P / Alt+I / Alt+M /
+ Ctrl+Alt+S, in the terminal style, even on a phone. The web hides key hints everywhere else
+ (`WorkspaceChrome.showsKeyHints: false`). The row labels do not match where they go: "Build
+ beyond code" opens the Store. A first tab with no panes shows a different welcome (search,
+ New Tab, New Pane, Quick start, Keyboard practice), so the same moment has two designs.
+- **Fix:** on web, one New tab page with plain buttons (New Harness, Open Harness, Machines,
+ New Swarm, Store) and no chords. Drop Keyboard practice on compact.
+- **Files, size:** `lib/widgets/workspace_welcome.dart` (the chord table) and
+ `lib/widgets/harness_start_page.dart` (the other welcome) (shared, behind the existing
+ `showsKeyHints` seam). S.
+- **Source:** widget code · fixture.
+
+#### S8 · Keyboard instructions on touch screens
+- **Screen, width:** New Harness form, Take control banner, Settings ▸ Keyboard shortcuts, All commands · phones.
+- **Screenshots:** [`screens/split-pane/390-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/split-pane/390-dark.png) ("ctrl-enter create · tab / shift-tab
+ fields · esc close"), [`screens/taken-over/390-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/taken-over/390-dark.png) ("Click here or press ⏎"),
+ [`screens/settings-keyboard-shortcuts/390-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/settings-keyboard-shortcuts/390-dark.png) ("↑↓ Browse · Return Practice"),
+ [`screens/all-commands/390-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/all-commands/390-dark.png) (Alt+B beside rows)
+- **What goes wrong:** instructions a phone cannot follow take space and suggest the wrong way
+ to act. On a computer browser, "cmd-enter" is wrong on Windows and Linux.
+- **Fix:** honour `showsKeyHints: false` in these four places, and hide Keyboard shortcuts and
+ Keyboard practice below 720 px.
+- **Files, size:** `lib/widgets/new_harness_form.dart`, `terminal_panel.dart` (`_ControlBanner`),
+ `lib/shortcuts/shortcuts_browser.dart` (shared, existing `KeyHints` seam). S.
+- **Source:** widget code · fixture.
+
+#### S9 · Three ways to download on a phone, two of them for a computer
+- **Screen, width:** sign-in, workspace, first computer · 360, 390, 768.
+- **Screenshots:** [`screens/signin/390-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/signin/390-dark.png), [`screens/workspace/390-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/workspace/390-dark.png), [`screens/first-machine/390-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/first-machine/390-dark.png)
+- **What goes wrong:** the store bar says **Get the app** (the phone app). The sign-in page also
+ shows **Download app** at the top right, and the workspace footer shows a blue **Download
+ app**, and both send a phone to the desktop download. The footer button takes a third of
+ the only bottom bar.
+- **Fix:** when the store bar is shown (iOS or Android), hide `WebDownloadButton` in the footer and
+ the sign-in header; keep the "Desktop app" card on the first-computer page.
+- **Files, size:** `lib/web/footer/web_footer_bar.dart` (web), `lib/widgets/web_download_button.dart`
+ and the sign-in header in `login_screen.dart` (shared file, web-only branch). S.
+- **Source:** widget code · fixture.
+
+#### S10 · Right-click on a tab does nothing; rename only by double-click
+- **Screen, width:** tab row · 768, 1440.
+- **Screenshots:** [`screens/tab-menu/1440-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/tab-menu/1440-dark.png)
+- **Steps:** right-click a tab to rename or close it.
+- **What goes wrong:** a tab has a context menu only when it has sharing actions
+ (`lib/widgets/desktop_workspace_tab.dart:202-208`, `_hasMenu`). An ordinary tab shows nothing, and
+ the browser's own menu is not suppressed for it. Renaming is a double-click, which nothing on
+ screen suggests except a screen-reader hint. On phones the tab switcher has **Rename this tab**.
+- **Fix:** on web, give every tab a menu with Rename Tab and Close Tab (plus the sharing actions).
+- **Files, size:** `desktop_workspace_tab.dart` (shared), behind
+ `WorkspaceChrome.menuOnEveryTab`; reuse `lib/web/tabs/web_tab_menu.dart` rows (web). S.
+- **Source:** widget code · fixture.
+
+#### S11 · The new-device band cuts off what it is asking about
+- **Screen, width:** band above the workspace · 360, 390.
+- **Screenshots:** [`screens/new-device/390-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/new-device/390-dark.png), [`screens/new-device/360-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/new-device/360-dark.png)
+- **What goes wrong:** "Jamie's iPhone signed in to y…" is cut to one line beside **It's mine** and
+ **Review**. The person must confirm a device without reading the sentence.
+- **Fix:** below 720 px, let the text wrap above the two buttons.
+- **Files, size:** `lib/widgets/new_device_notice.dart` (shared). S.
+- **Source:** widget code · fixture.
+
+#### S12 · Super Tab: an error and an endless "Loading" at once
+- **Screen, width:** Super Tab with the backend unreachable · all widths.
+- **Screenshots:** [`screens/super-tab-offline/1440-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/super-tab-offline/1440-dark.png), [`screens/super-tab-offline/390-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/super-tab-offline/390-dark.png)
+- **What goes wrong:** "Could not refresh this conversation. Try again." with Retry sits above a
+ body and composer that say "Loading conversation…" forever.
+- **Fix:** when the first read fails, show the error as the empty state and disable the composer.
+- **Files, size:** `lib/super_tabs/view.dart` (shared). S.
+- **Source:** widget code, with the fixture's failing reads · fixture.
+
+#### S13 · An incomplete viewer link is a raw error
+- **Screen, width:** `/?viewer=1` · all widths.
+- **Screenshots:** [`screens/viewer-incomplete/1440-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/viewer-incomplete/1440-dark.png), [`screens/viewer-incomplete/390-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/viewer-incomplete/390-dark.png)
+- **What goes wrong:** large red text with yellow double underlines (no `Material` above it),
+ "This viewer link is incomplete. Run hn view again.", and no way back to the workspace.
+- **Fix:** a styled message with `hn view` as code and an **Open Harness** button.
+- **Files, size:** `lib/app_shell.dart:384-389` (shared file, web-only branch); better moved to
+ `lib/viewer/`. S.
+- **Source:** widget code · fixture.
+
+#### S14 · Screen readers find buttons hidden under "Connect a computer"
+- **Screen, width:** first computer · all widths.
+- **Screenshots:** [`screens/first-machine/1440-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/first-machine/1440-dark.png); the tree is in `checks.json`
+ (`tapTargets`, `first-machine`: Keyboard practice, New Pane and New Tab under the page)
+- **Steps:** with a screen reader, or by role in a test, look for the page's buttons.
+- **What goes wrong:** the New tab page stays mounted under the first-computer page and keeps
+ its accessibility tree. Its buttons (New Tab, New Pane, Quick start, Keyboard practice) are
+ announced, but they cannot be pressed: a click on "Keyboard practice" lands on the page
+ above it.
+- **Fix:** exclude the covered workspace from semantics (and from focus) while
+ `firstMachine` is shown.
+- **Files, size:** where `_needsFirstConnection` stacks the page, `swarm_screen.dart:7407`
+ (shared, web path only). S.
+- **Source:** widget code · fixture.
+
+#### S15 · A sign-in error lands below the fold on a computer
+- **Screen, width:** sign-in after a failure · 1440×900.
+- **Screenshots:** [`screens/signin-error/1440-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/signin-error/1440-dark.png)
+- **Steps:** a sign-in fails and the page comes back.
+- **What goes wrong:** only the first line, "Could not sign in", shows at the bottom edge. The
+ reason and **Try again** are below the fold, under a hero that fills most of the screen.
+- **Fix:** put the error tile above the sign-in buttons, or shrink the fleet map while an error
+ shows.
+- **Files, size:** `lib/screens/login_screen.dart` `_webPage` (shared file, web-only branch). S.
+- **Source:** widget code · fixture.
+
+#### S16 · First load is a blank page for 8 to 40 seconds on a phone
+- **Screen, width:** first visit · phones.
+- **Evidence:** the [First load](#first-load) table.
+- **Steps:** open harness.autonomous.ai/harness-web on a phone with an empty cache.
+- **What goes wrong:** nothing is drawn until the engine starts: 8 s on fast 4G, 40 s on slow
+ 4G, on a dark empty page with no logo, progress or text. It looks broken.
+- **Fix:** a static logo and "Opening Harness…" in `web/index.html`, removed when Flutter's
+ first frame lands (the release keeps the same `<body>` background).
+- **Files, size:** `desktop/web/index.html` (web only). S.
+- **Source:** build output · measured locally (production host compression unverified).
+
+#### S17 · 1.5 MB of icon fonts that the app does not use
+- **What goes wrong:** the app uses only Lucide weight 400 (`lib/shared/theme/app_icons.dart`),
+ which the build tree-shakes to 36 KB. The browser still downloads `lucide.ttf` and five other
+ `LucideVariable` weights on first load, 1.53 MB compressed: a fifth of the first load.
+- **Fix:** keep the unused Lucide families out of the web build's font manifest (a build step in
+ `scripts/build-web-release.sh`, or depending on the single weight the app uses).
+- **Files, size:** `desktop/scripts/build-web-release.sh` (web release only); `pubspec.yaml` if
+ the dependency changes (shared, would also shrink the Desktop bundle). S.
+- **Source:** build output · measured locally.
+
+### Polish
+
+#### P1 · Faint text is below 4.5:1
+- **Where:** "End-to-end encrypted" on sign-in, meta lines and hints across the app.
+- **Screenshots:** [`screens/signin/390-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/signin/390-dark.png), [`screens/signin/1440-light.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/signin/1440-light.png)
+- **What goes wrong:** `AppPalette.textFaint` (`lib/shared/theme/app_theme.dart:394`) measures
+ 3.46:1 on the dark page (#6E6E68 on #181818), 3.25:1 on cards (#1E1E1E), 2.87:1 on the
+ workspace (#282828), 4.18:1 on the light page and 3.49:1 on the light workspace (`tool/contrast.py`).
+ Small text needs 4.5:1.
+- **Fix:** use `textSecondary` for text a person must read; keep `textFaint` for decoration.
+- **Files, size:** call sites, mainly `login_screen.dart:659` (shared). Changing the token itself
+ would change Desktop. S.
+- **Source:** widget code · fixture.
+
+#### P2 · The viewer page ignores the theme and is hard to read
+- **Screenshots:** [`screens/viewer-page/390-light.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/viewer-page/390-light.png), [`screens/viewer-page/1440-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/viewer-page/1440-dark.png)
+- **What goes wrong:** the page stays black in light mode. Its message ("This harness has no
+ viewer.") is small dark-red monospace text on black.
+- **Fix:** draw it on the theme's page colour with the app's empty-state style.
+- **Files, size:** `lib/viewer/viewer_page.dart` `_message` (shared, web-reached). S.
+- **Source:** widget code · fixture.
+
+#### P3 · "This computer" in a browser
+- **What goes wrong:** the naming system defines **This computer** as the local execution machine
+ (`docs/naming-system.md`), which a browser is not. The web still says:
+ - Settings ▸ Account: "Your Harness sign-in on this computer." (`settings/sections/account_section.dart:61`)
+ - Tab invites and Tab Activity: "Harness could not reach this computer." (`tab_invites_section.dart:195`,
+ `agent_messages/shared_tabs.dart:368`, `tab_activity.dart:71`)
+ - Store product page: "Connecting to this computer…" (`store/store_screen.dart:1485`)
+ - The footer's subscription tooltip: "On: This computer" (`widgets/workspace_subscription_usage.dart:152`)
+
+ Also: "1 linked machines" (`swarm_screen.dart:1637`); "Rename this tab" where the action name
+ is **Rename Tab**; "Run hn view again" without code formatting.
+- **Screenshots:** [`screens/settings-account/1440-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/settings-account/1440-dark.png), [`screens/settings-tab-invites/390-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/settings-tab-invites/390-dark.png),
+ [`screens/store-product/1440-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/store-product/1440-dark.png), [`screens/footer-menu/390-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/footer-menu/390-dark.png)
+- **Fix:** use "this browser" or the computer's name on web, and fix the plural.
+- **Files, size:** as listed (shared). Settings sections are outside the workspace: one small
+ web-only branch each, with the Desktop wording byte-for-byte the same. The footer tooltip and
+ `swarm_screen.dart` are inside the workspace: no `kIsWeb` there. Use wording that is right on
+ both, such as the plural fix, or a `WorkspaceChrome` field read with `WorkspaceChrome.of`
+ ([Proposed fix groups](#proposed-fix-groups)). S.
+- **Source:** widget code · fixture. The Tab invites and Routing pages also show "Sign in to use
+ Swarm" while signed in. That comes from fixture data (no account id) and needs a live check.
+
+#### P4 · Store cards on the New tab page break words on phones
+- **Screenshots:** [`screens/empty-tab/390-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/empty-tab/390-dark.png), [`screens/empty-tab/360-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/empty-tab/360-dark.png)
+- **What goes wrong:** "Brows e the Harne ss" and "Meet the Harne ss": the card keeps its picture
+ width and squeezes the title.
+- **Fix:** stack picture over title below 720 px, or drop the picture.
+- **Files, size:** `lib/widgets/harness_start_page.dart:285-338` (shared). S.
+- **Source:** widget code · fixture.
+
+#### P5 · Swarm with no projects has no button
+- **Screenshots:** [`screens/super-tab-empty/1440-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/super-tab-empty/1440-dark.png), [`screens/super-tab-empty/390-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/super-tab-empty/390-dark.png)
+- **What goes wrong:** "Create a project to get started." with the action somewhere else.
+- **Fix:** a **New project** button under the sentence.
+- **Files, size:** `lib/super_tabs/view.dart` (shared). S.
+- **Source:** widget code. The review fixture passes no `onNewProject`, so whether the real
+ sidebar shows **New project** needs a live check.
+
+#### P6 · Settings ▸ Usage on web is an empty box
+- **Screenshots:** [`screens/settings-usage/1440-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/settings-usage/1440-dark.png), [`screens/settings-usage/390-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/settings-usage/390-dark.png)
+- **What goes wrong:** one sentence, and a full-height panel saying "Start your first harness to
+ begin tracking." The browser counts only its own activity, so the page is nearly always empty.
+- **Fix:** show the account's subscriptions (as the footer does), or hide the section on web
+ until it has content.
+- **Files, size:** `lib/settings/sections/usage_section.dart` (shared, web branch at line 122). S.
+- **Source:** widget code · fixture.
+
+#### P7 · Sign-in hero labels are unreadable on phones
+- **Screenshots:** [`screens/signin/360-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/signin/360-dark.png)
+- **What goes wrong:** the fleet map's labels ("home · claude, codex", "under the desk") are about 8 px.
+- **Fix:** below 480 px, hide the small labels or the map.
+- **Files, size:** `lib/widgets/login_fleet_map.dart` (shared). S.
+- **Source:** widget code · fixture.
+
+#### P8 · Keyboard focus is hard to see
+- **Screenshots:** [`checks/focus-signin.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/checks/focus-signin.png), [`checks/focus-first-machine.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/checks/focus-first-machine.png), [`checks/focus-settings.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/checks/focus-settings.png)
+- **What goes wrong:** after four presses of Tab, sign-in and the first-computer page show no
+ focus ring. Settings shows only a faint fill on the focused row. The terminal takes Tab, as
+ it should.
+- **Fix:** a visible focus ring for buttons and rows on web (the design system's accent
+ outline).
+- **Files, size:** shared button styles in `lib/shared/theme/app_theme.dart` (`buildAppTheme`)
+ behind a web flag, or per web component. S.
+- **Source:** widget code · fixture. The fixture runs with the accessibility tree on, which
+ changes how browsers move focus, so recheck with it off before fixing.
+
+## Cross-cutting checks
+
+From `checks.mjs` (results in `checks.json`, before and after images in `checks/`) and from
+reading the captures. The fixture is a release build, so Flutter's debug overflow stripes are
+not drawn; clipping was judged from the screenshots.
+
+| Check | Result |
+| --- | --- |
+| Tap targets under 44 px on phones | **Fail → S1.** Every phone screen has some. Top bar: Menu 31×28, New Tab 23×28, Open Harness 31×28, Notifications 31×28. Pane header: Close Pane 28×28, agent and model 28 tall. App menu rows 32 tall; footer dropdown rows 32; tab switcher rows 40; Machines actions (Rename, Remove, Add machine, History…) 28; picker filter chips 32; Store Back and Forward 32×30; New tab page rows 24; Settings rows 38; New Harness form fields 32. |
+| Mouse wheel on every scrolling area (1440, mouse) | **Pass.** The tab row with 16 tabs scrolls with the vertical wheel, Shift+wheel and a sideways trackpad swipe, and its arrows scroll it too. The Store page, picker filter chips, All commands, Appearance panel, Settings ▸ Keyboard shortcuts and the New Harness form all scroll. The first run reported the tab row as stuck: it starts scrolled to its end (the active tab is the last), so the check now wheels backwards. |
+| Touch swipe (390) | **Pass.** The app menu, Store, Keyboard shortcuts, All commands, Machines and the first-computer page scroll by finger. The tab switcher (16 tabs), the Settings list and sign-in fit without scrolling. |
+| Hover (1440) | **Pass.** All ten controls tried (New Tab, Open Harness, Close Pane, agent label, footer Harnesses, a tab, a menu row, Continue with Google, Download app, a Settings row) change on hover and show a pointer cursor. Tooltips stay up after a click until the mouse moves ([`screens/store/1440-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/store/1440-dark.png), [`screens/harness-monitor/1440-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/harness-monitor/1440-dark.png)). |
+| Focus | **Weak → P8.** No visible focus ring on sign-in or the first-computer page after Tab; a faint fill in Settings. |
+| Contrast (`tool/contrast.py`) | The standing checks pass in both themes. **Fail → P1** for `textFaint` (2.87–4.18:1), and **P2** for the viewer page. |
+| Text clipping and overflow | **Fail → B1, S2, S11, S15, P4, P7.** |
+| Panels covering the whole phone screen | **Pass.** Settings, Appearance, the picker, Machines, History and the Store take the whole phone screen with a visible Back or close. The Super Tab drawers leave a veil to tap (PR #1570). The app menu and footer dropdown are popovers. |
+| Features reachable only by keyboard | **Fail → B2** (New Swarm) and **S10** (renaming a tab by double-click only at computer widths). Zoom pane, move pane, layouts, reopening a closed tab and the shortcuts sheet are reachable by clicking only through Menu ▸ All commands. That counts as clickable, but it is a long way round. |
+| Empty, loading and error states | **Fail → S5, S6, S12, S13, S14, P5, P6.** The first-computer page, the error banner with Retry, Notifications ("No notifications") and the History search are clear. |
+| First load of the web bundle | See [First load](#first-load). |
+| Copy against `docs/naming-system.md` | **Fail → P3.** "This computer" in a browser, "1 linked machines", "Rename this tab" instead of **Rename Tab**. Swarm, Product Manager, New Harness, New Tab and Connect a computer follow the system. |
+| Requests leaving the page | None. `blocked*.json` is empty for every run: the fixture never reached a backend. Only Google's font CDN is let through, as production does for missing glyphs. |
+
+## First load
+
+Release build from this revision (`scripts/build-web-release.sh` flags), served gzip-compressed
+at `/harness-web/` with every off-page request blocked, empty cache, three loads per profile,
+median shown (`load-time.mjs`; end screens checked, all three ended on the sign-in page).
+
+| Profile | Flutter view in the page | Sign-in page drawn and still | Transferred |
+| --- | --- | --- | --- |
+| Computer, unthrottled | 1.2 s | 1.2 s | 7.3 MB |
+| Phone, fast 4G (9 Mbps, 40 ms, 2× CPU) | 8.0 s | 8.5 s | 7.3 MB |
+| Phone, slow 4G (1.6 Mbps, 150 ms, 4× CPU; Lighthouse mobile) | 39.8 s | 40.8 s | 7.3 MB |
+
+Largest files on first load (compressed): `main.dart.js` 3.15 MB, `canvaskit.wasm` 2.08 MB,
+**Lucide icon fonts 1.53 MB** (`lucide.ttf` 0.41 MB plus five `LucideVariable-w100…w600`
+weights of ~0.22 MB each), Roboto Mono 0.27 MB. Until the Flutter view appears, the page is
+an empty dark rectangle: `web/index.html` draws nothing while it loads. The findings this
+produces are **S16** and **S17**.
+
+## Unverified
+
+These need a real computer, a real account or a real phone. The fixture cannot show them
+faithfully, so they were not judged.
+
+| What | Why it is unverified |
+| --- | --- |
+| Live terminal behaviour: streaming output, reflow on resize, scrollback, typing latency, P2P against the relay | The fixture writes fixed text into the terminal before layout and has no transport (`tool/web_ux_seed.dart`) |
+| How long Connecting and Reconnecting last, and what a real drop looks like | Needs the relay and a machine |
+| On-screen keyboard over the composer and bars (`lib/web/shell/web_hidden_under_keyboard.dart`), safe areas (notch, home bar), pinch zoom (`web/index.html` viewport rules) | Headless Chrome has no on-screen keyboard or safe-area insets |
+| Add your phone QR | The fixture shows "The computer is offline": the pairing code needs a machine RPC ([`screens/add-phone/1440-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/add-phone/1440-dark.png)) |
+| Harness Monitor | Opening it installs and talks to a machine; the fixture shows a "Lost the connection" toast ([`screens/harness-monitor/1440-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/harness-monitor/1440-dark.png)) |
+| Models and subscription figures ("Checking usage…", "not signed in on the harness's machine") | Needs `usage_read` from a machine ([`screens/models/1440-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/models/1440-dark.png)) |
+| Settings ▸ Experimental, Privacy, Routing, Tab invites with real data | Their errors in the captures come from the fixture having no account id or API |
+| Store install, Remove, Install anyway | Need a machine to install on |
+| Shared harness `/s/…` beyond the incomplete-link state: private, not invited, owner offline, comments | Need the backend and an owner daemon (`lib/sharing/shared_agent_page.dart`) |
+| Viewer page with a running viewer | Needs a harness that serves one |
+| Super Tab inside the web workspace (tab row, store bar, footer around it), Group terminals opening, New project in the sidebar | The Super Tab fixture renders `SuperTabView` alone with stub callbacks; embedding it needs a `SuperTabClient` transport seam in `AppNotifier` |
+| Browser notification permission prompt | Needs a real browser prompt (Settings ▸ Notifications ▸ Desktop notifications) |
+| Device bands other than New device (removal, departed, conflict) and the shared-tab invite band | Not seeded in this pass (`lib/widgets/new_device_notice.dart`, `shared_tab_notice.dart`) |
+| Close confirmation for a working harness (Stop / Cancel) | Needs live activity from a machine |
+| Password link dialog after a refused trusted dial | The fake refuses at once, so the page shows "Couldn't connect" ([`screens/link-password/1440-dark.png`](https://github.com/autonomous-ai/openharness/blob/a521af922/desktop/design/web-ux-audit/screens/link-password/1440-dark.png)) |
+| Hub return (`/hub…`) | Needs the Hub's session handoff |
+| Agent Messages and the Tab Activity dock | Need the account experiment and a shared tab |
+| First load on a real phone network and the production host's compression | Measured locally with throttling (see [First load](#first-load)) |
+
+## Proposed fix groups
+
+Seven groups, split by responsibility. No two groups own the same file. Every blocks and slows
+finding is in exactly one group; polish items ride with the group that owns their file. Each
+group says whether it touches shared code (outside `lib/web/`), and the existing Desktop tests
+must stay green. The rules for shared code (plan section 9):
+
+- **Inside the workspace**, a widget reads the web's switches with `WorkspaceChrome.of(context)`,
+ which works in the workspace's overlays too. The switches are `menuOnEveryTab` (S10),
+ `labelsPaneStatus` (S3, S4) and `compactPaneHeader` (S2), plus the existing `compactBelow`
+ and `showsKeyHints`. Desktop leaves all three off; `lib/web/shell/web_chrome.dart` turns them
+ on. A `kIsWeb` check inside the workspace fails review.
+- **Outside the workspace** (sign-in, the viewer page, the viewer-link branch in
+ `app_shell.dart`, Settings sections, the theme) there is no chrome. Each may use one small
+ web-only branch, with its Desktop path byte-for-byte the same.
+- **S3 and S4 are web only.** Turning the labels on for Desktop later is a separate decision.
+- `lib/state/workspace_chrome.dart` and `web_chrome.dart` belong to the review tooling (group 0);
+ fix groups only read them. Each group adds review fixture scenarios or flows for its own states, and re-captures
+them at 360, 390, 768 and 1440.
+
+| Group | Findings | Owns | Shared code? | Size |
+| --- | --- | --- | --- | --- |
+| 1. Web menus and commands | B2, S1 (web menus), S10, P3 "Rename this tab" | `lib/web/shell/web_app_menu.dart`, `web_menu_items.dart`, `web_dropdown_control.dart`, `lib/web/tabs/*`, `lib/web/footer/web_footer_bar.dart`, `lib/widgets/desktop_workspace_tab.dart` | Yes: `desktop_workspace_tab.dart`, behind `menuOnEveryTab` | M |
+| 2. Store on phones | B1, P3 (Store line) | `lib/store/store_screen.dart`, `store_discover.dart`, `store_explore_widgets.dart` | Yes: Store layout below a `compactBelow` passed by web chrome; Desktop default unchanged | M |
+| 3. Pane header and states | S2, S3, S4, S1 (pane header hit size), S8 (Take control banner) | `lib/widgets/pane_grid.dart`, `lib/widgets/terminal_panel.dart` | Yes, behind `labelsPaneStatus` and `compactPaneHeader`: web only, Desktop unchanged | M |
+| 4. First computer and the offline workspace | S5, S6, S14, P3 "1 linked machines" | `lib/web/onboarding/web_first_machine.dart`, `web_your_computers.dart`, `_needsFirstConnection` in `lib/screens/swarm_screen.dart` | Yes: one condition in `swarm_screen.dart`, behind the existing `firstMachine` seam | S |
+| 5. Welcome pages, hints and download buttons | S7, S8 (form, shortcuts page), S9, S15, P1, P4, P7 | `lib/widgets/workspace_welcome.dart`, `harness_start_page.dart`, `new_harness_form.dart`, `lib/shortcuts/shortcuts_browser.dart`, `lib/widgets/web_download_button.dart`, `lib/screens/login_screen.dart`, `lib/widgets/login_fleet_map.dart` | Yes: all behind `showsKeyHints` or web-only branches | M |
+| 6. Error states, bands and copy | S11, S12, S13, P2, P3 (the remaining lines), P5, P6, P8 | `lib/widgets/new_device_notice.dart`, `lib/super_tabs/view.dart`, `lib/app_shell.dart` (viewer-link branch), `lib/viewer/viewer_page.dart`, `settings/sections/account_section.dart`, `tab_invites_section.dart`, `usage_section.dart`, `agent_messages/shared_tabs.dart`, `tab_activity.dart`, `widgets/workspace_subscription_usage.dart`, `lib/shared/theme/app_theme.dart` (focus ring, behind a web flag) | Yes: copy, empty states, focus; Desktop wording unchanged where it is right | M |
+| 7. First load | S16, S17 | `web/index.html`, `scripts/build-web-release.sh` | Only if the Lucide dependency itself changes (`pubspec.yaml`) | S |
+
+Each P3 line goes to the group that owns its file: the Store line to group 2, "1 linked
+machines" (`swarm_screen.dart`) to group 4 and "Rename this tab" to group 1. P1 goes to group
+5 because its main call site is `login_screen.dart`. Group 4 and group 5 both touch screens drawn
+by `swarm_screen.dart`, but only group 4 edits that file.
+
+**Acceptance checks per group**
+
+1. **Web menus and commands**
+ - The app menu has **New Swarm**, and clicking it opens the new Swarm form at 390 and 1440.
+ - At 360 and 390, every row of the app menu, tab switcher, tab menu and footer dropdown
+ measures at least 44 px tall in `checks.mjs` (`tapTargets`).
+ - Right-clicking an ordinary tab at 1440 opens a menu with Rename Tab and Close Tab.
+ - The Desktop tab tests (`flutter test test/swarm_screen_test.dart`) still pass.
+2. **Store on phones**
+ - At 360 and 390, `screens/store` and `store-product` show the catalogue at full width with
+ no word broken across lines; the rail is a dropdown or chips.
+ - At 1440 the Store matches today's capture.
+ - The Store's widget tests pass.
+3. **Pane header and states**
+ - At 390 the pane header shows the harness name with at least 16 characters, plus a status
+ word for connecting, reconnecting, offline, view only and taken over.
+ - At 768 there are at most two pane columns.
+ - Reconnecting and view-only show a labelled chip at 1440 on web; the Desktop pane header
+ tests pass unchanged and show no new label.
+ - The Desktop pane tests pass with the chrome seam at its default.
+4. **First computer and the offline workspace**
+ - `offline-only` keeps the pane, in its Offline state, plus a band naming the computer.
+ - `first-machine` still shows the connect page for an account that never connected one.
+ - `first-machine-loading` shows a loading state, not the New tab page.
+ - Under "Connect a computer", the accessibility tree has no New tab page buttons.
+5. **Welcome pages, hints and download buttons**
+ - No capture at any width contains a key chord (Alt+, Ctrl+, cmd-, ⏎) outside Settings ▸
+ Keyboard shortcuts and All commands.
+ - At 390 there is exactly one download action (the store bar).
+ - The New tab page has the same buttons whether or not the tab is empty.
+ - On `signin-error` at 1440×900, the error and Try again are fully on screen.
+ - `tool/contrast.py` gives at least 4.5:1 for the sign-in page's small text.
+6. **Error states, bands and copy**
+ - `viewer-incomplete` renders a styled message with a working button.
+ - `super-tab-offline` shows one error state, not "Loading" at the same time.
+ - The new-device band text is fully readable at 360.
+ - After Tab on sign-in at 1440, the focused button shows a visible ring.
+ - A grep of web-reachable copy finds no "this computer" outside places that mean a
+ computer.
+7. **First load**
+ - With `load-time.mjs` on slow 4G, a logo and "Opening Harness…" show within 3 s.
+ - The first load transfers no `lucide.ttf` or `LucideVariable-w1/2/3/5/600` file, and the
+ transfer drops by about 1.5 MB.
+ - Icons still render in every capture.
+
+## Live pass
+
+The owner offered their own sign-in for a look-only pass against harness.autonomous.ai. It did
+not run. Opening the signed-in web app adds the browser to the account's device list by itself
+at start-up (`lib/state/app_state.dart:6448`, `log.register()`), before any computer connects.
+The owner's other devices would then see a "New device" notice, so even looking would change
+the account. The decision went to the owner; the default, applied at 17:00 without an answer,
+is no live pass. Every finding is therefore tagged **fixture**, and what needs real data is in
+[Unverified](#unverified).
+
+## Pre-existing issues
+
+- `flutter analyze` on `main` (`d763e16d6`) reports one error outside this work:
+ `tool/devices_preview.dart:202:16` — "'DevicesReviewApp.showDevicesTerminal' ('Future<void>
+ Function(String, String)') isn't a valid override of 'AppNotifier.showDevicesTerminal'
+ ('Future<void> Function(String, String, {String? swarmId})')" (`invalid_override`). Left alone.
+- `tool/super_tab_mobile_fixture.dart` drew its "light" screens with dark-palette ink, because
+ it set the Material theme but not the design tokens (`grid.AppTheme.palette` and
+ `brightness`), which default to dark. Adding `?theme=` fixed both themes; light stays the
+ default.
diff --git a/desktop/design/web-ux-audit/checks.json b/desktop/design/web-ux-audit/checks.json
new file mode 100644
index 000000000..96a6ca475
--- /dev/null
+++ b/desktop/design/web-ux-audit/checks.json
@@ -0,0 +1,5748 @@
+{
+ "tapTargets": [
+ {
+ "flow": "signin",
+ "width": "360",
+ "small": [
+ {
+ "label": "",
+ "w": 109,
+ "h": 28,
+ "x": 239,
+ "y": 85
+ }
+ ]
+ },
+ {
+ "flow": "first-machine",
+ "width": "360",
+ "small": [
+ {
+ "label": "Menu",
+ "w": 31,
+ "h": 28,
+ "x": 8,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 8,
+ "y": 75
+ },
+ {
+ "label": "Tabs: 1:New Tab",
+ "w": 100,
+ "h": 28,
+ "x": 39,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 100,
+ "h": 28,
+ "x": 39,
+ "y": 75
+ },
+ {
+ "label": "New Tab",
+ "w": 23,
+ "h": 28,
+ "x": 139,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 23,
+ "h": 28,
+ "x": 139,
+ "y": 75
+ },
+ {
+ "label": "Open Harness",
+ "w": 31,
+ "h": 28,
+ "x": 290,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 290,
+ "y": 75
+ },
+ {
+ "label": "Notifications",
+ "w": 31,
+ "h": 28,
+ "x": 321,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 321,
+ "y": 75
+ },
+ {
+ "label": "New Tab",
+ "w": 105,
+ "h": 32,
+ "x": 24,
+ "y": 289
+ },
+ {
+ "label": "New Pane",
+ "w": 113,
+ "h": 32,
+ "x": 141,
+ "y": 289
+ },
+ {
+ "label": "Quick start · 4 steps",
+ "w": 185,
+ "h": 32,
+ "x": 24,
+ "y": 333
+ },
+ {
+ "label": "Keyboard practice",
+ "w": 153,
+ "h": 32,
+ "x": 24,
+ "y": 377
+ },
+ {
+ "label": "Appearance",
+ "w": 94,
+ "h": 32,
+ "x": 246,
+ "y": 655
+ },
+ {
+ "label": "Download app",
+ "w": 135,
+ "h": 32,
+ "x": 45,
+ "y": 356
+ },
+ {
+ "label": "Status: Claude Code — Codex —",
+ "w": 209,
+ "h": 28,
+ "x": 8,
+ "y": 707
+ },
+ {
+ "label": "",
+ "w": 209,
+ "h": 28,
+ "x": 8,
+ "y": 707
+ },
+ {
+ "label": "",
+ "w": 109,
+ "h": 28,
+ "x": 243,
+ "y": 707
+ }
+ ]
+ },
+ {
+ "flow": "computers",
+ "width": "360",
+ "small": [
+ {
+ "label": "Menu",
+ "w": 31,
+ "h": 28,
+ "x": 8,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 8,
+ "y": 75
+ },
+ {
+ "label": "Tabs: 1:New Tab",
+ "w": 100,
+ "h": 28,
+ "x": 39,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 100,
+ "h": 28,
+ "x": 39,
+ "y": 75
+ },
+ {
+ "label": "New Tab",
+ "w": 23,
+ "h": 28,
+ "x": 139,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 23,
+ "h": 28,
+ "x": 139,
+ "y": 75
+ },
+ {
+ "label": "Open Harness",
+ "w": 31,
+ "h": 28,
+ "x": 290,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 290,
+ "y": 75
+ },
+ {
+ "label": "Notifications",
+ "w": 31,
+ "h": 28,
+ "x": 321,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 321,
+ "y": 75
+ },
+ {
+ "label": "New Tab",
+ "w": 105,
+ "h": 32,
+ "x": 24,
+ "y": 289
+ },
+ {
+ "label": "New Pane",
+ "w": 113,
+ "h": 32,
+ "x": 141,
+ "y": 289
+ },
+ {
+ "label": "Quick start · 4 steps",
+ "w": 185,
+ "h": 32,
+ "x": 24,
+ "y": 333
+ },
+ {
+ "label": "Keyboard practice",
+ "w": 153,
+ "h": 32,
+ "x": 24,
+ "y": 377
+ },
+ {
+ "label": "Appearance",
+ "w": 94,
+ "h": 32,
+ "x": 246,
+ "y": 655
+ },
+ {
+ "label": "Connect",
+ "w": 77,
+ "h": 32,
+ "x": 242,
+ "y": 360
+ },
+ {
+ "label": "Download app",
+ "w": 135,
+ "h": 31,
+ "x": 45,
+ "y": 672
+ },
+ {
+ "label": "Status: Claude Code — Codex —",
+ "w": 209,
+ "h": 28,
+ "x": 8,
+ "y": 707
+ },
+ {
+ "label": "",
+ "w": 209,
+ "h": 28,
+ "x": 8,
+ "y": 707
+ },
+ {
+ "label": "",
+ "w": 109,
+ "h": 28,
+ "x": 243,
+ "y": 707
+ }
+ ]
+ },
+ {
+ "flow": "workspace",
+ "width": "360",
+ "small": [
+ {
+ "label": "Menu",
+ "w": 31,
+ "h": 28,
+ "x": 8,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 8,
+ "y": 75
+ },
+ {
+ "label": "Tabs: 1:code · 3/3",
+ "w": 123,
+ "h": 28,
+ "x": 39,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 123,
+ "h": 28,
+ "x": 39,
+ "y": 75
+ },
+ {
+ "label": "New Tab",
+ "w": 23,
+ "h": 28,
+ "x": 162,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 23,
+ "h": 28,
+ "x": 162,
+ "y": 75
+ },
+ {
+ "label": "Open Harness",
+ "w": 31,
+ "h": 28,
+ "x": 290,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 290,
+ "y": 75
+ },
+ {
+ "label": "Notifications",
+ "w": 31,
+ "h": 28,
+ "x": 321,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 321,
+ "y": 75
+ },
+ {
+ "label": "Agent: Claude Code",
+ "w": 102,
+ "h": 28,
+ "x": 129,
+ "y": 125
+ },
+ {
+ "label": "",
+ "w": 102,
+ "h": 28,
+ "x": 129,
+ "y": 125
+ },
+ {
+ "label": "Model: Anthropic",
+ "w": 86,
+ "h": 28,
+ "x": 231,
+ "y": 125
+ },
+ {
+ "label": "",
+ "w": 86,
+ "h": 28,
+ "x": 231,
+ "y": 125
+ },
+ {
+ "label": "Close Pane",
+ "w": 28,
+ "h": 28,
+ "x": 318,
+ "y": 125
+ },
+ {
+ "label": "",
+ "w": 28,
+ "h": 28,
+ "x": 318,
+ "y": 125
+ },
+ {
+ "label": "Status: Studio Mac",
+ "w": 108,
+ "h": 28,
+ "x": 8,
+ "y": 707
+ },
+ {
+ "label": "",
+ "w": 108,
+ "h": 28,
+ "x": 8,
+ "y": 707
+ },
+ {
+ "label": "",
+ "w": 109,
+ "h": 28,
+ "x": 243,
+ "y": 707
+ }
+ ]
+ },
+ {
+ "flow": "app-menu",
+ "width": "360",
+ "small": [
+ {
+ "label": "Machines",
+ "w": 228,
+ "h": 32,
+ "x": 14,
+ "y": 115
+ },
+ {
+ "label": "Models",
+ "w": 228,
+ "h": 32,
+ "x": 14,
+ "y": 147
+ },
+ {
+ "label": "Store",
+ "w": 228,
+ "h": 32,
+ "x": 14,
+ "y": 179
+ },
+ {
+ "label": "Split pane",
+ "w": 228,
+ "h": 32,
+ "x": 14,
+ "y": 220
+ },
+ {
+ "label": "History",
+ "w": 228,
+ "h": 32,
+ "x": 14,
+ "y": 261
+ },
+ {
+ "label": "All commands",
+ "w": 228,
+ "h": 32,
+ "x": 14,
+ "y": 293
+ },
+ {
+ "label": "Settings",
+ "w": 228,
+ "h": 32,
+ "x": 14,
+ "y": 334
+ },
+ {
+ "label": "Appearance",
+ "w": 228,
+ "h": 32,
+ "x": 14,
+ "y": 366
+ },
+ {
+ "label": "Sign out",
+ "w": 228,
+ "h": 32,
+ "x": 14,
+ "y": 434
+ },
+ {
+ "label": "Menu",
+ "w": 31,
+ "h": 28,
+ "x": 8,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 8,
+ "y": 75
+ },
+ {
+ "label": "Tabs: 1:code · 3/3",
+ "w": 123,
+ "h": 28,
+ "x": 39,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 123,
+ "h": 28,
+ "x": 39,
+ "y": 75
+ },
+ {
+ "label": "New Tab",
+ "w": 23,
+ "h": 28,
+ "x": 162,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 23,
+ "h": 28,
+ "x": 162,
+ "y": 75
+ },
+ {
+ "label": "Open Harness",
+ "w": 31,
+ "h": 28,
+ "x": 290,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 290,
+ "y": 75
+ },
+ {
+ "label": "Notifications",
+ "w": 31,
+ "h": 28,
+ "x": 321,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 321,
+ "y": 75
+ },
+ {
+ "label": "Agent: Claude Code",
+ "w": 102,
+ "h": 28,
+ "x": 129,
+ "y": 125
+ },
+ {
+ "label": "",
+ "w": 102,
+ "h": 28,
+ "x": 129,
+ "y": 125
+ },
+ {
+ "label": "Model: Anthropic",
+ "w": 86,
+ "h": 28,
+ "x": 231,
+ "y": 125
+ },
+ {
+ "label": "",
+ "w": 86,
+ "h": 28,
+ "x": 231,
+ "y": 125
+ },
+ {
+ "label": "Close Pane",
+ "w": 28,
+ "h": 28,
+ "x": 318,
+ "y": 125
+ },
+ {
+ "label": "",
+ "w": 28,
+ "h": 28,
+ "x": 318,
+ "y": 125
+ },
+ {
+ "label": "Status: Studio Mac",
+ "w": 108,
+ "h": 28,
+ "x": 8,
+ "y": 707
+ },
+ {
+ "label": "",
+ "w": 108,
+ "h": 28,
+ "x": 8,
+ "y": 707
+ },
+ {
+ "label": "",
+ "w": 109,
+ "h": 28,
+ "x": 243,
+ "y": 707
+ }
+ ]
+ },
+ {
+ "flow": "tab-switcher",
+ "width": "360",
+ "small": [
+ {
+ "label": "Menu",
+ "w": 31,
+ "h": 28,
+ "x": 8,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 8,
+ "y": 75
+ },
+ {
+ "label": "Tabs: 16:infra",
+ "w": 92,
+ "h": 28,
+ "x": 39,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 92,
+ "h": 28,
+ "x": 39,
+ "y": 75
+ },
+ {
+ "label": "New Tab",
+ "w": 23,
+ "h": 28,
+ "x": 131,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 23,
+ "h": 28,
+ "x": 131,
+ "y": 75
+ },
+ {
+ "label": "Open Harness",
+ "w": 31,
+ "h": 28,
+ "x": 290,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 290,
+ "y": 75
+ },
+ {
+ "label": "Notifications",
+ "w": 31,
+ "h": 28,
+ "x": 321,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 321,
+ "y": 75
+ },
+ {
+ "label": "Agent: Codex",
+ "w": 55,
+ "h": 28,
+ "x": 200,
+ "y": 125
+ },
+ {
+ "label": "",
+ "w": 55,
+ "h": 28,
+ "x": 200,
+ "y": 125
+ },
+ {
+ "label": "Model: OpenAI",
+ "w": 63,
+ "h": 28,
+ "x": 255,
+ "y": 125
+ },
+ {
+ "label": "",
+ "w": 63,
+ "h": 28,
+ "x": 255,
+ "y": 125
+ },
+ {
+ "label": "Close Pane",
+ "w": 28,
+ "h": 28,
+ "x": 318,
+ "y": 125
+ },
+ {
+ "label": "",
+ "w": 28,
+ "h": 28,
+ "x": 318,
+ "y": 125
+ },
+ {
+ "label": "Status: Studio Mac",
+ "w": 108,
+ "h": 28,
+ "x": 8,
+ "y": 707
+ },
+ {
+ "label": "",
+ "w": 108,
+ "h": 28,
+ "x": 8,
+ "y": 707
+ },
+ {
+ "label": "",
+ "w": 109,
+ "h": 28,
+ "x": 243,
+ "y": 707
+ },
+ {
+ "label": "1:checkout",
+ "w": 332,
+ "h": 40,
+ "x": 14,
+ "y": 107
+ },
+ {
+ "label": "Close tab",
+ "w": 40,
+ "h": 40,
+ "x": 306,
+ "y": 107
+ },
+ {
+ "label": "2:Refactor the billing reconciliation service end to end",
+ "w": 332,
+ "h": 40,
+ "x": 14,
+ "y": 147
+ },
+ {
+ "label": "Close tab",
+ "w": 40,
+ "h": 40,
+ "x": 306,
+ "y": 147
+ },
+ {
+ "label": "3:docs",
+ "w": 332,
+ "h": 40,
+ "x": 14,
+ "y": 187
+ },
+ {
+ "label": "Close tab",
+ "w": 40,
+ "h": 40,
+ "x": 306,
+ "y": 187
+ },
+ {
+ "label": "4:release 4.2",
+ "w": 332,
+ "h": 40,
+ "x": 14,
+ "y": 227
+ },
+ {
+ "label": "Close tab",
+ "w": 40,
+ "h": 40,
+ "x": 306,
+ "y": 227
+ },
+ {
+ "label": "5:payments-api",
+ "w": 332,
+ "h": 40,
+ "x": 14,
+ "y": 267
+ },
+ {
+ "label": "Close tab",
+ "w": 40,
+ "h": 40,
+ "x": 306,
+ "y": 267
+ },
+ {
+ "label": "6:mobile web",
+ "w": 332,
+ "h": 40,
+ "x": 14,
+ "y": 307
+ },
+ {
+ "label": "Close tab",
+ "w": 40,
+ "h": 40,
+ "x": 306,
+ "y": 307
+ },
+ {
+ "label": "7:infra",
+ "w": 332,
+ "h": 40,
+ "x": 14,
+ "y": 347
+ },
+ {
+ "label": "Close tab",
+ "w": 40,
+ "h": 40,
+ "x": 306,
+ "y": 347
+ },
+ {
+ "label": "8:design review",
+ "w": 332,
+ "h": 40,
+ "x": 14,
+ "y": 387
+ },
+ {
+ "label": "Close tab",
+ "w": 40,
+ "h": 40,
+ "x": 306,
+ "y": 387
+ },
+ {
+ "label": "9:customer escalations this week",
+ "w": 332,
+ "h": 40,
+ "x": 14,
+ "y": 427
+ },
+ {
+ "label": "Close tab",
+ "w": 40,
+ "h": 40,
+ "x": 306,
+ "y": 427
+ },
+ {
+ "label": "10:checkout",
+ "w": 332,
+ "h": 40,
+ "x": 14,
+ "y": 467
+ },
+ {
+ "label": "Close tab",
+ "w": 40,
+ "h": 40,
+ "x": 306,
+ "y": 467
+ },
+ {
+ "label": "11:Refactor the billing reconciliation service end to end",
+ "w": 332,
+ "h": 40,
+ "x": 14,
+ "y": 507
+ },
+ {
+ "label": "Close tab",
+ "w": 40,
+ "h": 40,
+ "x": 306,
+ "y": 507
+ },
+ {
+ "label": "12:docs",
+ "w": 332,
+ "h": 40,
+ "x": 14,
+ "y": 547
+ },
+ {
+ "label": "Close tab",
+ "w": 40,
+ "h": 40,
+ "x": 306,
+ "y": 547
+ },
+ {
+ "label": "13:release 4.2",
+ "w": 332,
+ "h": 40,
+ "x": 14,
+ "y": 587
+ },
+ {
+ "label": "Close tab",
+ "w": 40,
+ "h": 40,
+ "x": 306,
+ "y": 587
+ },
+ {
+ "label": "14:payments-api",
+ "w": 332,
+ "h": 40,
+ "x": 14,
+ "y": 627
+ },
+ {
+ "label": "Close tab",
+ "w": 40,
+ "h": 40,
+ "x": 306,
+ "y": 627
+ },
+ {
+ "label": "15:mobile web",
+ "w": 332,
+ "h": 40,
+ "x": 14,
+ "y": 667
+ },
+ {
+ "label": "Close tab",
+ "w": 40,
+ "h": 40,
+ "x": 306,
+ "y": 667
+ },
+ {
+ "label": "16:infra",
+ "w": 332,
+ "h": 25,
+ "x": 14,
+ "y": 707
+ },
+ {
+ "label": "Close tab",
+ "w": 40,
+ "h": 25,
+ "x": 306,
+ "y": 707
+ }
+ ]
+ },
+ {
+ "flow": "footer-menu",
+ "width": "360",
+ "small": [
+ {
+ "label": "Menu",
+ "w": 31,
+ "h": 28,
+ "x": 8,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 8,
+ "y": 75
+ },
+ {
+ "label": "Tabs: 1:code · 3/3",
+ "w": 123,
+ "h": 28,
+ "x": 39,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 123,
+ "h": 28,
+ "x": 39,
+ "y": 75
+ },
+ {
+ "label": "New Tab",
+ "w": 23,
+ "h": 28,
+ "x": 162,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 23,
+ "h": 28,
+ "x": 162,
+ "y": 75
+ },
+ {
+ "label": "Open Harness",
+ "w": 31,
+ "h": 28,
+ "x": 290,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 290,
+ "y": 75
+ },
+ {
+ "label": "Notifications",
+ "w": 31,
+ "h": 28,
+ "x": 321,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 321,
+ "y": 75
+ },
+ {
+ "label": "Agent: Claude Code",
+ "w": 102,
+ "h": 28,
+ "x": 129,
+ "y": 125
+ },
+ {
+ "label": "",
+ "w": 102,
+ "h": 28,
+ "x": 129,
+ "y": 125
+ },
+ {
+ "label": "Model: Anthropic",
+ "w": 86,
+ "h": 28,
+ "x": 231,
+ "y": 125
+ },
+ {
+ "label": "",
+ "w": 86,
+ "h": 28,
+ "x": 231,
+ "y": 125
+ },
+ {
+ "label": "Close Pane",
+ "w": 28,
+ "h": 28,
+ "x": 318,
+ "y": 125
+ },
+ {
+ "label": "",
+ "w": 28,
+ "h": 28,
+ "x": 318,
+ "y": 125
+ },
+ {
+ "label": "Status: Studio Mac",
+ "w": 108,
+ "h": 28,
+ "x": 8,
+ "y": 707
+ },
+ {
+ "label": "",
+ "w": 108,
+ "h": 28,
+ "x": 8,
+ "y": 707
+ },
+ {
+ "label": "",
+ "w": 109,
+ "h": 28,
+ "x": 243,
+ "y": 707
+ },
+ {
+ "label": "Harnesses 4",
+ "w": 298,
+ "h": 32,
+ "x": 14,
+ "y": 502
+ },
+ {
+ "label": "Machines 1",
+ "w": 298,
+ "h": 32,
+ "x": 14,
+ "y": 534
+ },
+ {
+ "label": "Models —",
+ "w": 298,
+ "h": 32,
+ "x": 14,
+ "y": 566
+ },
+ {
+ "label": "Claude Code —",
+ "w": 298,
+ "h": 32,
+ "x": 14,
+ "y": 598
+ },
+ {
+ "label": "Codex —",
+ "w": 298,
+ "h": 32,
+ "x": 14,
+ "y": 630
+ },
+ {
+ "label": "Subscriptions",
+ "w": 298,
+ "h": 32,
+ "x": 14,
+ "y": 662
+ },
+ {
+ "label": "Machine",
+ "w": 298,
+ "h": 32,
+ "x": 14,
+ "y": 694
+ }
+ ]
+ },
+ {
+ "flow": "notifications",
+ "width": "360",
+ "small": [
+ {
+ "label": "Menu",
+ "w": 31,
+ "h": 28,
+ "x": 8,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 8,
+ "y": 75
+ },
+ {
+ "label": "Tabs: 1:code · 3/3",
+ "w": 123,
+ "h": 28,
+ "x": 39,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 123,
+ "h": 28,
+ "x": 39,
+ "y": 75
+ },
+ {
+ "label": "New Tab",
+ "w": 23,
+ "h": 28,
+ "x": 162,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 23,
+ "h": 28,
+ "x": 162,
+ "y": 75
+ },
+ {
+ "label": "Open Harness",
+ "w": 31,
+ "h": 28,
+ "x": 290,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 290,
+ "y": 75
+ },
+ {
+ "label": "Notifications",
+ "w": 31,
+ "h": 28,
+ "x": 321,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 321,
+ "y": 75
+ },
+ {
+ "label": "Agent: Claude Code",
+ "w": 102,
+ "h": 28,
+ "x": 129,
+ "y": 125
+ },
+ {
+ "label": "",
+ "w": 102,
+ "h": 28,
+ "x": 129,
+ "y": 125
+ },
+ {
+ "label": "Model: Anthropic",
+ "w": 86,
+ "h": 28,
+ "x": 231,
+ "y": 125
+ },
+ {
+ "label": "",
+ "w": 86,
+ "h": 28,
+ "x": 231,
+ "y": 125
+ },
+ {
+ "label": "Close Pane",
+ "w": 28,
+ "h": 28,
+ "x": 318,
+ "y": 125
+ },
+ {
+ "label": "",
+ "w": 28,
+ "h": 28,
+ "x": 318,
+ "y": 125
+ },
+ {
+ "label": "Status: Studio Mac",
+ "w": 108,
+ "h": 28,
+ "x": 8,
+ "y": 707
+ },
+ {
+ "label": "",
+ "w": 108,
+ "h": 28,
+ "x": 8,
+ "y": 707
+ },
+ {
+ "label": "",
+ "w": 109,
+ "h": 28,
+ "x": 243,
+ "y": 707
+ }
+ ]
+ },
+ {
+ "flow": "open-harness",
+ "width": "360",
+ "small": [
+ {
+ "label": "Hide preview",
+ "w": 32,
+ "h": 32,
+ "x": 260,
+ "y": 143
+ },
+ {
+ "label": "Close search",
+ "w": 32,
+ "h": 32,
+ "x": 292,
+ "y": 143
+ },
+ {
+ "label": "Harnesses",
+ "w": 84,
+ "h": 32,
+ "x": 40,
+ "y": 194
+ },
+ {
+ "label": "Machines",
+ "w": 79,
+ "h": 32,
+ "x": 130,
+ "y": 194
+ },
+ {
+ "label": "Projects",
+ "w": 70,
+ "h": 32,
+ "x": 215,
+ "y": 194
+ },
+ {
+ "label": "Agents",
+ "w": 49,
+ "h": 32,
+ "x": 291,
+ "y": 194
+ },
+ {
+ "label": "Models",
+ "w": 65,
+ "h": 32,
+ "x": 360,
+ "y": 194
+ },
+ {
+ "label": "Store",
+ "w": 53,
+ "h": 32,
+ "x": 431,
+ "y": 194
+ },
+ {
+ "label": "Commands",
+ "w": 89,
+ "h": 32,
+ "x": 490,
+ "y": 194
+ }
+ ]
+ },
+ {
+ "flow": "machines",
+ "width": "360",
+ "small": [
+ {
+ "label": "Clear search",
+ "w": 32,
+ "h": 32,
+ "x": 228,
+ "y": 143
+ },
+ {
+ "label": "Hide preview",
+ "w": 32,
+ "h": 32,
+ "x": 260,
+ "y": 143
+ },
+ {
+ "label": "Close search",
+ "w": 32,
+ "h": 32,
+ "x": 292,
+ "y": 143
+ },
+ {
+ "label": "Harnesses",
+ "w": 84,
+ "h": 32,
+ "x": 40,
+ "y": 194
+ },
+ {
+ "label": "Machines",
+ "w": 79,
+ "h": 32,
+ "x": 130,
+ "y": 194
+ },
+ {
+ "label": "Projects",
+ "w": 70,
+ "h": 32,
+ "x": 215,
+ "y": 194
+ },
+ {
+ "label": "Agents",
+ "w": 49,
+ "h": 32,
+ "x": 291,
+ "y": 194
+ },
+ {
+ "label": "Models",
+ "w": 65,
+ "h": 32,
+ "x": 360,
+ "y": 194
+ },
+ {
+ "label": "Store",
+ "w": 53,
+ "h": 32,
+ "x": 431,
+ "y": 194
+ },
+ {
+ "label": "Commands",
+ "w": 89,
+ "h": 32,
+ "x": 490,
+ "y": 194
+ },
+ {
+ "label": "Show in this window All machines",
+ "w": 240,
+ "h": 32,
+ "x": 44,
+ "y": 262
+ },
+ {
+ "label": "View",
+ "w": 46,
+ "h": 28,
+ "x": 38,
+ "y": 597
+ },
+ {
+ "label": "Rename",
+ "w": 66,
+ "h": 28,
+ "x": 92,
+ "y": 597
+ },
+ {
+ "label": "Share",
+ "w": 51,
+ "h": 28,
+ "x": 166,
+ "y": 597
+ },
+ {
+ "label": "Remove",
+ "w": 65,
+ "h": 28,
+ "x": 225,
+ "y": 597
+ },
+ {
+ "label": "Add machine",
+ "w": 95,
+ "h": 28,
+ "x": 40,
+ "y": 648
+ },
+ {
+ "label": "Approve a device",
+ "w": 117,
+ "h": 28,
+ "x": 143,
+ "y": 648
+ },
+ {
+ "label": "History…",
+ "w": 68,
+ "h": 28,
+ "x": 40,
+ "y": 684
+ }
+ ]
+ },
+ {
+ "flow": "all-commands",
+ "width": "360",
+ "small": [
+ {
+ "label": "Clear search",
+ "w": 32,
+ "h": 32,
+ "x": 228,
+ "y": 143
+ },
+ {
+ "label": "Hide preview",
+ "w": 32,
+ "h": 32,
+ "x": 260,
+ "y": 143
+ },
+ {
+ "label": "Close search",
+ "w": 32,
+ "h": 32,
+ "x": 292,
+ "y": 143
+ },
+ {
+ "label": "Harnesses",
+ "w": 84,
+ "h": 32,
+ "x": -219,
+ "y": 194
+ },
+ {
+ "label": "Machines",
+ "w": 79,
+ "h": 32,
+ "x": -129,
+ "y": 194
+ },
+ {
+ "label": "Projects",
+ "w": 6,
+ "h": 32,
+ "x": 20,
+ "y": 194
+ },
+ {
+ "label": "Agents",
+ "w": 63,
+ "h": 32,
+ "x": 32,
+ "y": 194
+ },
+ {
+ "label": "Models",
+ "w": 65,
+ "h": 32,
+ "x": 101,
+ "y": 194
+ },
+ {
+ "label": "Store",
+ "w": 53,
+ "h": 32,
+ "x": 172,
+ "y": 194
+ },
+ {
+ "label": "Commands",
+ "w": 89,
+ "h": 32,
+ "x": 231,
+ "y": 194
+ },
+ {
+ "label": "Add phone",
+ "w": 304,
+ "h": 37,
+ "x": 28,
+ "y": 248
+ },
+ {
+ "label": "Add project",
+ "w": 304,
+ "h": 37,
+ "x": 28,
+ "y": 285
+ },
+ {
+ "label": "Appearance",
+ "w": 304,
+ "h": 37,
+ "x": 28,
+ "y": 322
+ },
+ {
+ "label": "Boss mode: route a task",
+ "w": 304,
+ "h": 37,
+ "x": 28,
+ "y": 359
+ },
+ {
+ "label": "Branches and pull requests",
+ "w": 304,
+ "h": 37,
+ "x": 28,
+ "y": 396
+ }
+ ]
+ },
+ {
+ "flow": "appearance",
+ "width": "360",
+ "small": [
+ {
+ "label": "Starship",
+ "w": 312,
+ "h": 1,
+ "x": 24,
+ "y": 739
+ }
+ ]
+ },
+ {
+ "flow": "split-pane",
+ "width": "360",
+ "small": [
+ {
+ "label": "Harness: Coding. Search harnesss",
+ "w": 300,
+ "h": 32,
+ "x": 30,
+ "y": 213
+ },
+ {
+ "label": "Browse Harness Store…",
+ "w": 158,
+ "h": 32,
+ "x": 30,
+ "y": 245
+ },
+ {
+ "label": "Agent: Claude Code. Search agents",
+ "w": 300,
+ "h": 32,
+ "x": 30,
+ "y": 317
+ },
+ {
+ "label": "Checking…",
+ "w": 83,
+ "h": 32,
+ "x": 247,
+ "y": 355
+ },
+ {
+ "label": "Local or remote?",
+ "w": 141,
+ "h": 32,
+ "x": 189,
+ "y": 483
+ },
+ {
+ "label": ">",
+ "w": 300,
+ "h": 32,
+ "x": 30,
+ "y": 521
+ },
+ {
+ "label": "Where to start?",
+ "w": 133,
+ "h": 32,
+ "x": 197,
+ "y": 609
+ },
+ {
+ "label": ">",
+ "w": 300,
+ "h": 32,
+ "x": 30,
+ "y": 647
+ },
+ {
+ "label": "",
+ "w": 300,
+ "h": 32,
+ "x": 30,
+ "y": 681
+ },
+ {
+ "label": "",
+ "w": 300,
+ "h": 32,
+ "x": 30,
+ "y": 715
+ },
+ {
+ "label": "Advanced settings",
+ "w": 106,
+ "h": 30,
+ "x": 30,
+ "y": 613
+ },
+ {
+ "label": "[+] Advanced",
+ "w": 106,
+ "h": 30,
+ "x": 30,
+ "y": 613
+ },
+ {
+ "label": "New Harness",
+ "w": 110,
+ "h": 34,
+ "x": 220,
+ "y": 611
+ },
+ {
+ "label": "create, ctrl-enter",
+ "w": 131,
+ "h": 29,
+ "x": 38,
+ "y": 654
+ },
+ {
+ "label": "close, esc",
+ "w": 78,
+ "h": 29,
+ "x": 208,
+ "y": 683
+ }
+ ]
+ },
+ {
+ "flow": "store",
+ "width": "360",
+ "small": [
+ {
+ "label": "Menu",
+ "w": 31,
+ "h": 28,
+ "x": 8,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 8,
+ "y": 75
+ },
+ {
+ "label": "Tabs: 2:store",
+ "w": 84,
+ "h": 28,
+ "x": 39,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 84,
+ "h": 28,
+ "x": 39,
+ "y": 75
+ },
+ {
+ "label": "New Tab",
+ "w": 23,
+ "h": 28,
+ "x": 123,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 23,
+ "h": 28,
+ "x": 123,
+ "y": 75
+ },
+ {
+ "label": "Open Harness",
+ "w": 31,
+ "h": 28,
+ "x": 290,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 290,
+ "y": 75
+ },
+ {
+ "label": "Notifications",
+ "w": 31,
+ "h": 28,
+ "x": 321,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 321,
+ "y": 75
+ },
+ {
+ "label": "Discover",
+ "w": 160,
+ "h": 38,
+ "x": 12,
+ "y": 131
+ },
+ {
+ "label": "All harnesses",
+ "w": 160,
+ "h": 38,
+ "x": 12,
+ "y": 169
+ },
+ {
+ "label": "Coding",
+ "w": 160,
+ "h": 38,
+ "x": 12,
+ "y": 256
+ },
+ {
+ "label": "Viewers",
+ "w": 32,
+ "h": 32,
+ "x": 18,
+ "y": 655
+ },
+ {
+ "label": "Back Alt+[",
+ "w": 32,
+ "h": 30,
+ "x": 210,
+ "y": 124
+ },
+ {
+ "label": "Forward Alt+]",
+ "w": 32,
+ "h": 30,
+ "x": 249,
+ "y": 124
+ },
+ {
+ "label": "",
+ "w": 32,
+ "h": 32,
+ "x": 308,
+ "y": 123
+ },
+ {
+ "label": "All coding agents",
+ "w": 121,
+ "h": 32,
+ "x": 221,
+ "y": 557
+ },
+ {
+ "label": "Status: Claude Code — Codex —",
+ "w": 209,
+ "h": 28,
+ "x": 8,
+ "y": 707
+ },
+ {
+ "label": "",
+ "w": 209,
+ "h": 28,
+ "x": 8,
+ "y": 707
+ },
+ {
+ "label": "",
+ "w": 109,
+ "h": 28,
+ "x": 243,
+ "y": 707
+ }
+ ]
+ },
+ {
+ "flow": "settings",
+ "width": "360",
+ "small": [
+ {
+ "label": "Back to app",
+ "w": 332,
+ "h": 38,
+ "x": 14,
+ "y": 94
+ },
+ {
+ "label": "Account",
+ "w": 332,
+ "h": 38,
+ "x": 14,
+ "y": 191
+ },
+ {
+ "label": "Appearance",
+ "w": 332,
+ "h": 38,
+ "x": 14,
+ "y": 267
+ },
+ {
+ "label": "Notifications",
+ "w": 332,
+ "h": 38,
+ "x": 14,
+ "y": 305
+ },
+ {
+ "label": "Privacy",
+ "w": 332,
+ "h": 38,
+ "x": 14,
+ "y": 343
+ },
+ {
+ "label": "Keyboard shortcuts",
+ "w": 332,
+ "h": 38,
+ "x": 14,
+ "y": 381
+ },
+ {
+ "label": "Usage",
+ "w": 332,
+ "h": 38,
+ "x": 14,
+ "y": 457
+ },
+ {
+ "label": "Routing",
+ "w": 332,
+ "h": 38,
+ "x": 14,
+ "y": 495
+ },
+ {
+ "label": "Tab invites",
+ "w": 332,
+ "h": 38,
+ "x": 14,
+ "y": 571
+ },
+ {
+ "label": "Experimental",
+ "w": 332,
+ "h": 38,
+ "x": 14,
+ "y": 609
+ },
+ {
+ "label": "About",
+ "w": 332,
+ "h": 38,
+ "x": 14,
+ "y": 685
+ }
+ ]
+ },
+ {
+ "flow": "settings-notifications",
+ "width": "360",
+ "small": [
+ {
+ "label": "Settings",
+ "w": 332,
+ "h": 38,
+ "x": 14,
+ "y": 82
+ }
+ ]
+ },
+ {
+ "flow": "settings-keyboard-shortcuts",
+ "width": "360",
+ "small": [
+ {
+ "label": "Settings",
+ "w": 332,
+ "h": 38,
+ "x": 14,
+ "y": 82
+ }
+ ]
+ },
+ {
+ "flow": "new-tab",
+ "width": "360",
+ "small": [
+ {
+ "label": "Menu",
+ "w": 31,
+ "h": 28,
+ "x": 8,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 8,
+ "y": 75
+ },
+ {
+ "label": "Tabs: 2:New Tab",
+ "w": 100,
+ "h": 28,
+ "x": 39,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 100,
+ "h": 28,
+ "x": 39,
+ "y": 75
+ },
+ {
+ "label": "New Tab",
+ "w": 23,
+ "h": 28,
+ "x": 139,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 23,
+ "h": 28,
+ "x": 139,
+ "y": 75
+ },
+ {
+ "label": "Open Harness",
+ "w": 31,
+ "h": 28,
+ "x": 290,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 290,
+ "y": 75
+ },
+ {
+ "label": "Notifications",
+ "w": 31,
+ "h": 28,
+ "x": 321,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 321,
+ "y": 75
+ },
+ {
+ "label": "1",
+ "w": 312,
+ "h": 24,
+ "x": 24,
+ "y": 308
+ },
+ {
+ "label": "2",
+ "w": 312,
+ "h": 24,
+ "x": 24,
+ "y": 332
+ },
+ {
+ "label": "3",
+ "w": 312,
+ "h": 24,
+ "x": 24,
+ "y": 356
+ },
+ {
+ "label": "Alt+N",
+ "w": 304,
+ "h": 24,
+ "x": 28,
+ "y": 399
+ },
+ {
+ "label": "Alt+P",
+ "w": 304,
+ "h": 24,
+ "x": 28,
+ "y": 423
+ },
+ {
+ "label": "Alt+I",
+ "w": 304,
+ "h": 24,
+ "x": 28,
+ "y": 447
+ },
+ {
+ "label": "Alt+M",
+ "w": 304,
+ "h": 24,
+ "x": 28,
+ "y": 471
+ },
+ {
+ "label": "Ctrl+Alt+S",
+ "w": 304,
+ "h": 24,
+ "x": 28,
+ "y": 495
+ },
+ {
+ "label": "Work from your phone",
+ "w": 304,
+ "h": 24,
+ "x": 28,
+ "y": 539
+ },
+ {
+ "label": "Appearance",
+ "w": 94,
+ "h": 32,
+ "x": 246,
+ "y": 655
+ },
+ {
+ "label": "Status: Claude Code — Codex —",
+ "w": 209,
+ "h": 28,
+ "x": 8,
+ "y": 707
+ },
+ {
+ "label": "",
+ "w": 209,
+ "h": 28,
+ "x": 8,
+ "y": 707
+ },
+ {
+ "label": "",
+ "w": 109,
+ "h": 28,
+ "x": 243,
+ "y": 707
+ }
+ ]
+ },
+ {
+ "flow": "error-banner",
+ "width": "360",
+ "small": [
+ {
+ "label": "Menu",
+ "w": 31,
+ "h": 28,
+ "x": 8,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 8,
+ "y": 75
+ },
+ {
+ "label": "Tabs: 1:code · 2/2",
+ "w": 123,
+ "h": 28,
+ "x": 39,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 123,
+ "h": 28,
+ "x": 39,
+ "y": 75
+ },
+ {
+ "label": "New Tab",
+ "w": 23,
+ "h": 28,
+ "x": 162,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 23,
+ "h": 28,
+ "x": 162,
+ "y": 75
+ },
+ {
+ "label": "Open Harness",
+ "w": 31,
+ "h": 28,
+ "x": 290,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 290,
+ "y": 75
+ },
+ {
+ "label": "Notifications",
+ "w": 31,
+ "h": 28,
+ "x": 321,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 321,
+ "y": 75
+ },
+ {
+ "label": "Retry",
+ "w": 50,
+ "h": 32,
+ "x": 246,
+ "y": 122
+ },
+ {
+ "label": "Agent: Codex",
+ "w": 55,
+ "h": 28,
+ "x": 200,
+ "y": 182
+ },
+ {
+ "label": "",
+ "w": 55,
+ "h": 28,
+ "x": 200,
+ "y": 182
+ },
+ {
+ "label": "Model: OpenAI",
+ "w": 63,
+ "h": 28,
+ "x": 255,
+ "y": 182
+ },
+ {
+ "label": "",
+ "w": 63,
+ "h": 28,
+ "x": 255,
+ "y": 182
+ },
+ {
+ "label": "Close Pane",
+ "w": 28,
+ "h": 28,
+ "x": 318,
+ "y": 182
+ },
+ {
+ "label": "",
+ "w": 28,
+ "h": 28,
+ "x": 318,
+ "y": 182
+ },
+ {
+ "label": "Status: Studio Mac",
+ "w": 108,
+ "h": 28,
+ "x": 8,
+ "y": 707
+ },
+ {
+ "label": "",
+ "w": 108,
+ "h": 28,
+ "x": 8,
+ "y": 707
+ },
+ {
+ "label": "",
+ "w": 109,
+ "h": 28,
+ "x": 243,
+ "y": 707
+ }
+ ]
+ },
+ {
+ "flow": "new-device",
+ "width": "360",
+ "small": [
+ {
+ "label": "It’s mine",
+ "w": 69,
+ "h": 32,
+ "x": 206,
+ "y": 76
+ },
+ {
+ "label": "Review",
+ "w": 69,
+ "h": 32,
+ "x": 281,
+ "y": 76
+ },
+ {
+ "label": "Menu",
+ "w": 31,
+ "h": 28,
+ "x": 8,
+ "y": 121
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 8,
+ "y": 121
+ },
+ {
+ "label": "Tabs: 1:code · 2/2",
+ "w": 123,
+ "h": 28,
+ "x": 39,
+ "y": 121
+ },
+ {
+ "label": "",
+ "w": 123,
+ "h": 28,
+ "x": 39,
+ "y": 121
+ },
+ {
+ "label": "New Tab",
+ "w": 23,
+ "h": 28,
+ "x": 162,
+ "y": 121
+ },
+ {
+ "label": "",
+ "w": 23,
+ "h": 28,
+ "x": 162,
+ "y": 121
+ },
+ {
+ "label": "Open Harness",
+ "w": 31,
+ "h": 28,
+ "x": 290,
+ "y": 121
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 290,
+ "y": 121
+ },
+ {
+ "label": "Notifications",
+ "w": 31,
+ "h": 28,
+ "x": 321,
+ "y": 121
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 321,
+ "y": 121
+ },
+ {
+ "label": "Agent: Codex",
+ "w": 55,
+ "h": 28,
+ "x": 200,
+ "y": 171
+ },
+ {
+ "label": "",
+ "w": 55,
+ "h": 28,
+ "x": 200,
+ "y": 171
+ },
+ {
+ "label": "Model: OpenAI",
+ "w": 63,
+ "h": 28,
+ "x": 255,
+ "y": 171
+ },
+ {
+ "label": "",
+ "w": 63,
+ "h": 28,
+ "x": 255,
+ "y": 171
+ },
+ {
+ "label": "Close Pane",
+ "w": 28,
+ "h": 28,
+ "x": 318,
+ "y": 171
+ },
+ {
+ "label": "",
+ "w": 28,
+ "h": 28,
+ "x": 318,
+ "y": 171
+ },
+ {
+ "label": "Status: Studio Mac",
+ "w": 108,
+ "h": 28,
+ "x": 8,
+ "y": 707
+ },
+ {
+ "label": "",
+ "w": 108,
+ "h": 28,
+ "x": 8,
+ "y": 707
+ },
+ {
+ "label": "",
+ "w": 109,
+ "h": 28,
+ "x": 243,
+ "y": 707
+ }
+ ]
+ },
+ {
+ "flow": "link-password",
+ "width": "360",
+ "small": [
+ {
+ "label": "Menu",
+ "w": 31,
+ "h": 28,
+ "x": 8,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 8,
+ "y": 75
+ },
+ {
+ "label": "Tabs: 1:New Tab",
+ "w": 100,
+ "h": 28,
+ "x": 39,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 100,
+ "h": 28,
+ "x": 39,
+ "y": 75
+ },
+ {
+ "label": "New Tab",
+ "w": 23,
+ "h": 28,
+ "x": 139,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 23,
+ "h": 28,
+ "x": 139,
+ "y": 75
+ },
+ {
+ "label": "Open Harness",
+ "w": 31,
+ "h": 28,
+ "x": 290,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 290,
+ "y": 75
+ },
+ {
+ "label": "Notifications",
+ "w": 31,
+ "h": 28,
+ "x": 321,
+ "y": 75
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 321,
+ "y": 75
+ },
+ {
+ "label": "New Tab",
+ "w": 105,
+ "h": 32,
+ "x": 24,
+ "y": 289
+ },
+ {
+ "label": "New Pane",
+ "w": 113,
+ "h": 32,
+ "x": 141,
+ "y": 289
+ },
+ {
+ "label": "Quick start · 4 steps",
+ "w": 185,
+ "h": 32,
+ "x": 24,
+ "y": 333
+ },
+ {
+ "label": "Keyboard practice",
+ "w": 153,
+ "h": 32,
+ "x": 24,
+ "y": 377
+ },
+ {
+ "label": "Appearance",
+ "w": 94,
+ "h": 32,
+ "x": 246,
+ "y": 655
+ },
+ {
+ "label": "Try again",
+ "w": 81,
+ "h": 32,
+ "x": 238,
+ "y": 280
+ },
+ {
+ "label": "Download app",
+ "w": 135,
+ "h": 32,
+ "x": 45,
+ "y": 512
+ },
+ {
+ "label": "Status: Claude Code — Codex —",
+ "w": 209,
+ "h": 28,
+ "x": 8,
+ "y": 707
+ },
+ {
+ "label": "",
+ "w": 209,
+ "h": 28,
+ "x": 8,
+ "y": 707
+ },
+ {
+ "label": "",
+ "w": 109,
+ "h": 28,
+ "x": 243,
+ "y": 707
+ }
+ ]
+ },
+ {
+ "flow": "signin",
+ "width": "390",
+ "small": [
+ {
+ "label": "",
+ "w": 109,
+ "h": 28,
+ "x": 269,
+ "y": 72
+ }
+ ]
+ },
+ {
+ "flow": "first-machine",
+ "width": "390",
+ "small": [
+ {
+ "label": "Menu",
+ "w": 31,
+ "h": 28,
+ "x": 8,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 8,
+ "y": 62
+ },
+ {
+ "label": "Tabs: 1:New Tab",
+ "w": 100,
+ "h": 28,
+ "x": 39,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 100,
+ "h": 28,
+ "x": 39,
+ "y": 62
+ },
+ {
+ "label": "New Tab",
+ "w": 23,
+ "h": 28,
+ "x": 139,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 23,
+ "h": 28,
+ "x": 139,
+ "y": 62
+ },
+ {
+ "label": "Open Harness",
+ "w": 31,
+ "h": 28,
+ "x": 320,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 320,
+ "y": 62
+ },
+ {
+ "label": "Notifications",
+ "w": 31,
+ "h": 28,
+ "x": 351,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 351,
+ "y": 62
+ },
+ {
+ "label": "New Tab",
+ "w": 105,
+ "h": 32,
+ "x": 24,
+ "y": 329
+ },
+ {
+ "label": "New Pane",
+ "w": 113,
+ "h": 32,
+ "x": 141,
+ "y": 329
+ },
+ {
+ "label": "Quick start · 4 steps",
+ "w": 185,
+ "h": 32,
+ "x": 24,
+ "y": 373
+ },
+ {
+ "label": "Keyboard practice",
+ "w": 153,
+ "h": 32,
+ "x": 24,
+ "y": 417
+ },
+ {
+ "label": "Appearance",
+ "w": 94,
+ "h": 32,
+ "x": 276,
+ "y": 759
+ },
+ {
+ "label": "Download app",
+ "w": 135,
+ "h": 32,
+ "x": 45,
+ "y": 370
+ },
+ {
+ "label": "Status: Claude Code — Codex —",
+ "w": 209,
+ "h": 28,
+ "x": 8,
+ "y": 811
+ },
+ {
+ "label": "",
+ "w": 209,
+ "h": 28,
+ "x": 8,
+ "y": 811
+ },
+ {
+ "label": "",
+ "w": 109,
+ "h": 28,
+ "x": 273,
+ "y": 811
+ }
+ ]
+ },
+ {
+ "flow": "computers",
+ "width": "390",
+ "small": [
+ {
+ "label": "Menu",
+ "w": 31,
+ "h": 28,
+ "x": 8,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 8,
+ "y": 62
+ },
+ {
+ "label": "Tabs: 1:New Tab",
+ "w": 100,
+ "h": 28,
+ "x": 39,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 100,
+ "h": 28,
+ "x": 39,
+ "y": 62
+ },
+ {
+ "label": "New Tab",
+ "w": 23,
+ "h": 28,
+ "x": 139,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 23,
+ "h": 28,
+ "x": 139,
+ "y": 62
+ },
+ {
+ "label": "Open Harness",
+ "w": 31,
+ "h": 28,
+ "x": 320,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 320,
+ "y": 62
+ },
+ {
+ "label": "Notifications",
+ "w": 31,
+ "h": 28,
+ "x": 351,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 351,
+ "y": 62
+ },
+ {
+ "label": "New Tab",
+ "w": 105,
+ "h": 32,
+ "x": 24,
+ "y": 329
+ },
+ {
+ "label": "New Pane",
+ "w": 113,
+ "h": 32,
+ "x": 141,
+ "y": 329
+ },
+ {
+ "label": "Quick start · 4 steps",
+ "w": 185,
+ "h": 32,
+ "x": 24,
+ "y": 373
+ },
+ {
+ "label": "Keyboard practice",
+ "w": 153,
+ "h": 32,
+ "x": 24,
+ "y": 417
+ },
+ {
+ "label": "Appearance",
+ "w": 94,
+ "h": 32,
+ "x": 276,
+ "y": 759
+ },
+ {
+ "label": "Connect",
+ "w": 77,
+ "h": 32,
+ "x": 272,
+ "y": 339
+ },
+ {
+ "label": "Download app",
+ "w": 135,
+ "h": 32,
+ "x": 45,
+ "y": 643
+ },
+ {
+ "label": "Status: Claude Code — Codex —",
+ "w": 209,
+ "h": 28,
+ "x": 8,
+ "y": 811
+ },
+ {
+ "label": "",
+ "w": 209,
+ "h": 28,
+ "x": 8,
+ "y": 811
+ },
+ {
+ "label": "",
+ "w": 109,
+ "h": 28,
+ "x": 273,
+ "y": 811
+ }
+ ]
+ },
+ {
+ "flow": "workspace",
+ "width": "390",
+ "small": [
+ {
+ "label": "Menu",
+ "w": 31,
+ "h": 28,
+ "x": 8,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 8,
+ "y": 62
+ },
+ {
+ "label": "Tabs: 1:code · 3/3",
+ "w": 123,
+ "h": 28,
+ "x": 39,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 123,
+ "h": 28,
+ "x": 39,
+ "y": 62
+ },
+ {
+ "label": "New Tab",
+ "w": 23,
+ "h": 28,
+ "x": 162,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 23,
+ "h": 28,
+ "x": 162,
+ "y": 62
+ },
+ {
+ "label": "Open Harness",
+ "w": 31,
+ "h": 28,
+ "x": 320,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 320,
+ "y": 62
+ },
+ {
+ "label": "Notifications",
+ "w": 31,
+ "h": 28,
+ "x": 351,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 351,
+ "y": 62
+ },
+ {
+ "label": "Agent: Claude Code",
+ "w": 102,
+ "h": 28,
+ "x": 159,
+ "y": 112
+ },
+ {
+ "label": "",
+ "w": 102,
+ "h": 28,
+ "x": 159,
+ "y": 112
+ },
+ {
+ "label": "Model: Anthropic",
+ "w": 86,
+ "h": 28,
+ "x": 261,
+ "y": 112
+ },
+ {
+ "label": "",
+ "w": 86,
+ "h": 28,
+ "x": 261,
+ "y": 112
+ },
+ {
+ "label": "Close Pane",
+ "w": 28,
+ "h": 28,
+ "x": 348,
+ "y": 112
+ },
+ {
+ "label": "",
+ "w": 28,
+ "h": 28,
+ "x": 348,
+ "y": 112
+ },
+ {
+ "label": "Status: Studio Mac",
+ "w": 108,
+ "h": 28,
+ "x": 8,
+ "y": 811
+ },
+ {
+ "label": "",
+ "w": 108,
+ "h": 28,
+ "x": 8,
+ "y": 811
+ },
+ {
+ "label": "",
+ "w": 109,
+ "h": 28,
+ "x": 273,
+ "y": 811
+ }
+ ]
+ },
+ {
+ "flow": "app-menu",
+ "width": "390",
+ "small": [
+ {
+ "label": "Machines",
+ "w": 228,
+ "h": 32,
+ "x": 14,
+ "y": 102
+ },
+ {
+ "label": "Models",
+ "w": 228,
+ "h": 32,
+ "x": 14,
+ "y": 134
+ },
+ {
+ "label": "Store",
+ "w": 228,
+ "h": 32,
+ "x": 14,
+ "y": 166
+ },
+ {
+ "label": "Split pane",
+ "w": 228,
+ "h": 32,
+ "x": 14,
+ "y": 207
+ },
+ {
+ "label": "History",
+ "w": 228,
+ "h": 32,
+ "x": 14,
+ "y": 248
+ },
+ {
+ "label": "All commands",
+ "w": 228,
+ "h": 32,
+ "x": 14,
+ "y": 280
+ },
+ {
+ "label": "Settings",
+ "w": 228,
+ "h": 32,
+ "x": 14,
+ "y": 321
+ },
+ {
+ "label": "Appearance",
+ "w": 228,
+ "h": 32,
+ "x": 14,
+ "y": 353
+ },
+ {
+ "label": "Sign out",
+ "w": 228,
+ "h": 32,
+ "x": 14,
+ "y": 421
+ },
+ {
+ "label": "Menu",
+ "w": 31,
+ "h": 28,
+ "x": 8,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 8,
+ "y": 62
+ },
+ {
+ "label": "Tabs: 1:code · 3/3",
+ "w": 123,
+ "h": 28,
+ "x": 39,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 123,
+ "h": 28,
+ "x": 39,
+ "y": 62
+ },
+ {
+ "label": "New Tab",
+ "w": 23,
+ "h": 28,
+ "x": 162,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 23,
+ "h": 28,
+ "x": 162,
+ "y": 62
+ },
+ {
+ "label": "Open Harness",
+ "w": 31,
+ "h": 28,
+ "x": 320,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 320,
+ "y": 62
+ },
+ {
+ "label": "Notifications",
+ "w": 31,
+ "h": 28,
+ "x": 351,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 351,
+ "y": 62
+ },
+ {
+ "label": "Agent: Claude Code",
+ "w": 102,
+ "h": 28,
+ "x": 159,
+ "y": 112
+ },
+ {
+ "label": "",
+ "w": 102,
+ "h": 28,
+ "x": 159,
+ "y": 112
+ },
+ {
+ "label": "Model: Anthropic",
+ "w": 86,
+ "h": 28,
+ "x": 261,
+ "y": 112
+ },
+ {
+ "label": "",
+ "w": 86,
+ "h": 28,
+ "x": 261,
+ "y": 112
+ },
+ {
+ "label": "Close Pane",
+ "w": 28,
+ "h": 28,
+ "x": 348,
+ "y": 112
+ },
+ {
+ "label": "",
+ "w": 28,
+ "h": 28,
+ "x": 348,
+ "y": 112
+ },
+ {
+ "label": "Status: Studio Mac",
+ "w": 108,
+ "h": 28,
+ "x": 8,
+ "y": 811
+ },
+ {
+ "label": "",
+ "w": 108,
+ "h": 28,
+ "x": 8,
+ "y": 811
+ },
+ {
+ "label": "",
+ "w": 109,
+ "h": 28,
+ "x": 273,
+ "y": 811
+ }
+ ]
+ },
+ {
+ "flow": "tab-switcher",
+ "width": "390",
+ "small": [
+ {
+ "label": "1:checkout",
+ "w": 348,
+ "h": 40,
+ "x": 14,
+ "y": 126
+ },
+ {
+ "label": "Close tab",
+ "w": 40,
+ "h": 40,
+ "x": 322,
+ "y": 126
+ },
+ {
+ "label": "2:Refactor the billing reconciliation service end to end",
+ "w": 348,
+ "h": 40,
+ "x": 14,
+ "y": 166
+ },
+ {
+ "label": "Close tab",
+ "w": 40,
+ "h": 40,
+ "x": 322,
+ "y": 166
+ },
+ {
+ "label": "3:docs",
+ "w": 348,
+ "h": 40,
+ "x": 14,
+ "y": 206
+ },
+ {
+ "label": "Close tab",
+ "w": 40,
+ "h": 40,
+ "x": 322,
+ "y": 206
+ },
+ {
+ "label": "4:release 4.2",
+ "w": 348,
+ "h": 40,
+ "x": 14,
+ "y": 246
+ },
+ {
+ "label": "Close tab",
+ "w": 40,
+ "h": 40,
+ "x": 322,
+ "y": 246
+ },
+ {
+ "label": "5:payments-api",
+ "w": 348,
+ "h": 40,
+ "x": 14,
+ "y": 286
+ },
+ {
+ "label": "Close tab",
+ "w": 40,
+ "h": 40,
+ "x": 322,
+ "y": 286
+ },
+ {
+ "label": "6:mobile web",
+ "w": 348,
+ "h": 40,
+ "x": 14,
+ "y": 326
+ },
+ {
+ "label": "Close tab",
+ "w": 40,
+ "h": 40,
+ "x": 322,
+ "y": 326
+ },
+ {
+ "label": "7:infra",
+ "w": 348,
+ "h": 40,
+ "x": 14,
+ "y": 366
+ },
+ {
+ "label": "Close tab",
+ "w": 40,
+ "h": 40,
+ "x": 322,
+ "y": 366
+ },
+ {
+ "label": "8:design review",
+ "w": 348,
+ "h": 40,
+ "x": 14,
+ "y": 406
+ },
+ {
+ "label": "Close tab",
+ "w": 40,
+ "h": 40,
+ "x": 322,
+ "y": 406
+ },
+ {
+ "label": "9:customer escalations this week",
+ "w": 348,
+ "h": 40,
+ "x": 14,
+ "y": 446
+ },
+ {
+ "label": "Close tab",
+ "w": 40,
+ "h": 40,
+ "x": 322,
+ "y": 446
+ },
+ {
+ "label": "10:checkout",
+ "w": 348,
+ "h": 40,
+ "x": 14,
+ "y": 486
+ },
+ {
+ "label": "Close tab",
+ "w": 40,
+ "h": 40,
+ "x": 322,
+ "y": 486
+ },
+ {
+ "label": "11:Refactor the billing reconciliation service end to end",
+ "w": 348,
+ "h": 40,
+ "x": 14,
+ "y": 526
+ },
+ {
+ "label": "Close tab",
+ "w": 40,
+ "h": 40,
+ "x": 322,
+ "y": 526
+ },
+ {
+ "label": "12:docs",
+ "w": 348,
+ "h": 40,
+ "x": 14,
+ "y": 566
+ },
+ {
+ "label": "Close tab",
+ "w": 40,
+ "h": 40,
+ "x": 322,
+ "y": 566
+ },
+ {
+ "label": "13:release 4.2",
+ "w": 348,
+ "h": 40,
+ "x": 14,
+ "y": 606
+ },
+ {
+ "label": "Close tab",
+ "w": 40,
+ "h": 40,
+ "x": 322,
+ "y": 606
+ },
+ {
+ "label": "14:payments-api",
+ "w": 348,
+ "h": 40,
+ "x": 14,
+ "y": 646
+ },
+ {
+ "label": "Close tab",
+ "w": 40,
+ "h": 40,
+ "x": 322,
+ "y": 646
+ },
+ {
+ "label": "15:mobile web",
+ "w": 348,
+ "h": 40,
+ "x": 14,
+ "y": 686
+ },
+ {
+ "label": "Close tab",
+ "w": 40,
+ "h": 40,
+ "x": 322,
+ "y": 686
+ },
+ {
+ "label": "16:infra",
+ "w": 348,
+ "h": 40,
+ "x": 14,
+ "y": 726
+ },
+ {
+ "label": "Close tab",
+ "w": 40,
+ "h": 40,
+ "x": 322,
+ "y": 726
+ },
+ {
+ "label": "Rename this tab",
+ "w": 348,
+ "h": 32,
+ "x": 14,
+ "y": 766
+ },
+ {
+ "label": "Menu",
+ "w": 31,
+ "h": 28,
+ "x": 8,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 8,
+ "y": 62
+ },
+ {
+ "label": "Tabs: 16:infra",
+ "w": 92,
+ "h": 28,
+ "x": 39,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 92,
+ "h": 28,
+ "x": 39,
+ "y": 62
+ },
+ {
+ "label": "New Tab",
+ "w": 23,
+ "h": 28,
+ "x": 131,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 23,
+ "h": 28,
+ "x": 131,
+ "y": 62
+ },
+ {
+ "label": "Open Harness",
+ "w": 31,
+ "h": 28,
+ "x": 320,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 320,
+ "y": 62
+ },
+ {
+ "label": "Notifications",
+ "w": 31,
+ "h": 28,
+ "x": 351,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 351,
+ "y": 62
+ },
+ {
+ "label": "Agent: Codex",
+ "w": 55,
+ "h": 28,
+ "x": 230,
+ "y": 112
+ },
+ {
+ "label": "",
+ "w": 55,
+ "h": 28,
+ "x": 230,
+ "y": 112
+ },
+ {
+ "label": "Model: OpenAI",
+ "w": 63,
+ "h": 28,
+ "x": 285,
+ "y": 112
+ },
+ {
+ "label": "",
+ "w": 63,
+ "h": 28,
+ "x": 285,
+ "y": 112
+ },
+ {
+ "label": "Close Pane",
+ "w": 28,
+ "h": 28,
+ "x": 348,
+ "y": 112
+ },
+ {
+ "label": "",
+ "w": 28,
+ "h": 28,
+ "x": 348,
+ "y": 112
+ },
+ {
+ "label": "Status: Studio Mac",
+ "w": 108,
+ "h": 28,
+ "x": 8,
+ "y": 811
+ },
+ {
+ "label": "",
+ "w": 108,
+ "h": 28,
+ "x": 8,
+ "y": 811
+ },
+ {
+ "label": "",
+ "w": 109,
+ "h": 28,
+ "x": 273,
+ "y": 811
+ }
+ ]
+ },
+ {
+ "flow": "footer-menu",
+ "width": "390",
+ "small": [
+ {
+ "label": "Menu",
+ "w": 31,
+ "h": 28,
+ "x": 8,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 8,
+ "y": 62
+ },
+ {
+ "label": "Tabs: 1:code · 3/3",
+ "w": 123,
+ "h": 28,
+ "x": 39,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 123,
+ "h": 28,
+ "x": 39,
+ "y": 62
+ },
+ {
+ "label": "New Tab",
+ "w": 23,
+ "h": 28,
+ "x": 162,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 23,
+ "h": 28,
+ "x": 162,
+ "y": 62
+ },
+ {
+ "label": "Open Harness",
+ "w": 31,
+ "h": 28,
+ "x": 320,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 320,
+ "y": 62
+ },
+ {
+ "label": "Notifications",
+ "w": 31,
+ "h": 28,
+ "x": 351,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 351,
+ "y": 62
+ },
+ {
+ "label": "Agent: Claude Code",
+ "w": 102,
+ "h": 28,
+ "x": 159,
+ "y": 112
+ },
+ {
+ "label": "",
+ "w": 102,
+ "h": 28,
+ "x": 159,
+ "y": 112
+ },
+ {
+ "label": "Model: Anthropic",
+ "w": 86,
+ "h": 28,
+ "x": 261,
+ "y": 112
+ },
+ {
+ "label": "",
+ "w": 86,
+ "h": 28,
+ "x": 261,
+ "y": 112
+ },
+ {
+ "label": "Close Pane",
+ "w": 28,
+ "h": 28,
+ "x": 348,
+ "y": 112
+ },
+ {
+ "label": "",
+ "w": 28,
+ "h": 28,
+ "x": 348,
+ "y": 112
+ },
+ {
+ "label": "Status: Studio Mac",
+ "w": 108,
+ "h": 28,
+ "x": 8,
+ "y": 811
+ },
+ {
+ "label": "",
+ "w": 108,
+ "h": 28,
+ "x": 8,
+ "y": 811
+ },
+ {
+ "label": "",
+ "w": 109,
+ "h": 28,
+ "x": 273,
+ "y": 811
+ },
+ {
+ "label": "Harnesses 4",
+ "w": 298,
+ "h": 32,
+ "x": 14,
+ "y": 606
+ },
+ {
+ "label": "Machines 1",
+ "w": 298,
+ "h": 32,
+ "x": 14,
+ "y": 638
+ },
+ {
+ "label": "Models —",
+ "w": 298,
+ "h": 32,
+ "x": 14,
+ "y": 670
+ },
+ {
+ "label": "Claude Code —",
+ "w": 298,
+ "h": 32,
+ "x": 14,
+ "y": 702
+ },
+ {
+ "label": "Codex —",
+ "w": 298,
+ "h": 32,
+ "x": 14,
+ "y": 734
+ },
+ {
+ "label": "Subscriptions",
+ "w": 298,
+ "h": 32,
+ "x": 14,
+ "y": 766
+ },
+ {
+ "label": "Machine",
+ "w": 298,
+ "h": 32,
+ "x": 14,
+ "y": 798
+ }
+ ]
+ },
+ {
+ "flow": "notifications",
+ "width": "390",
+ "small": [
+ {
+ "label": "Menu",
+ "w": 31,
+ "h": 28,
+ "x": 8,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 8,
+ "y": 62
+ },
+ {
+ "label": "Tabs: 1:code · 3/3",
+ "w": 123,
+ "h": 28,
+ "x": 39,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 123,
+ "h": 28,
+ "x": 39,
+ "y": 62
+ },
+ {
+ "label": "New Tab",
+ "w": 23,
+ "h": 28,
+ "x": 162,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 23,
+ "h": 28,
+ "x": 162,
+ "y": 62
+ },
+ {
+ "label": "Open Harness",
+ "w": 31,
+ "h": 28,
+ "x": 320,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 320,
+ "y": 62
+ },
+ {
+ "label": "Notifications",
+ "w": 31,
+ "h": 28,
+ "x": 351,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 351,
+ "y": 62
+ },
+ {
+ "label": "Agent: Claude Code",
+ "w": 102,
+ "h": 28,
+ "x": 159,
+ "y": 112
+ },
+ {
+ "label": "",
+ "w": 102,
+ "h": 28,
+ "x": 159,
+ "y": 112
+ },
+ {
+ "label": "Model: Anthropic",
+ "w": 86,
+ "h": 28,
+ "x": 261,
+ "y": 112
+ },
+ {
+ "label": "",
+ "w": 86,
+ "h": 28,
+ "x": 261,
+ "y": 112
+ },
+ {
+ "label": "Close Pane",
+ "w": 28,
+ "h": 28,
+ "x": 348,
+ "y": 112
+ },
+ {
+ "label": "",
+ "w": 28,
+ "h": 28,
+ "x": 348,
+ "y": 112
+ },
+ {
+ "label": "Status: Studio Mac",
+ "w": 108,
+ "h": 28,
+ "x": 8,
+ "y": 811
+ },
+ {
+ "label": "",
+ "w": 108,
+ "h": 28,
+ "x": 8,
+ "y": 811
+ },
+ {
+ "label": "",
+ "w": 109,
+ "h": 28,
+ "x": 273,
+ "y": 811
+ }
+ ]
+ },
+ {
+ "flow": "open-harness",
+ "width": "390",
+ "small": [
+ {
+ "label": "Hide preview",
+ "w": 32,
+ "h": 32,
+ "x": 290,
+ "y": 146
+ },
+ {
+ "label": "Close search",
+ "w": 32,
+ "h": 32,
+ "x": 322,
+ "y": 146
+ },
+ {
+ "label": "Harnesses",
+ "w": 84,
+ "h": 32,
+ "x": 40,
+ "y": 197
+ },
+ {
+ "label": "Machines",
+ "w": 79,
+ "h": 32,
+ "x": 130,
+ "y": 197
+ },
+ {
+ "label": "Projects",
+ "w": 70,
+ "h": 32,
+ "x": 215,
+ "y": 197
+ },
+ {
+ "label": "Agents",
+ "w": 63,
+ "h": 32,
+ "x": 291,
+ "y": 197
+ },
+ {
+ "label": "Models",
+ "w": 10,
+ "h": 32,
+ "x": 360,
+ "y": 197
+ },
+ {
+ "label": "Store",
+ "w": 53,
+ "h": 32,
+ "x": 431,
+ "y": 197
+ },
+ {
+ "label": "Commands",
+ "w": 89,
+ "h": 32,
+ "x": 490,
+ "y": 197
+ }
+ ]
+ },
+ {
+ "flow": "machines",
+ "width": "390",
+ "small": [
+ {
+ "label": "Clear search",
+ "w": 32,
+ "h": 32,
+ "x": 258,
+ "y": 146
+ },
+ {
+ "label": "Hide preview",
+ "w": 32,
+ "h": 32,
+ "x": 290,
+ "y": 146
+ },
+ {
+ "label": "Close search",
+ "w": 32,
+ "h": 32,
+ "x": 322,
+ "y": 146
+ },
+ {
+ "label": "Harnesses",
+ "w": 84,
+ "h": 32,
+ "x": 40,
+ "y": 197
+ },
+ {
+ "label": "Machines",
+ "w": 79,
+ "h": 32,
+ "x": 130,
+ "y": 197
+ },
+ {
+ "label": "Projects",
+ "w": 70,
+ "h": 32,
+ "x": 215,
+ "y": 197
+ },
+ {
+ "label": "Agents",
+ "w": 63,
+ "h": 32,
+ "x": 291,
+ "y": 197
+ },
+ {
+ "label": "Models",
+ "w": 10,
+ "h": 32,
+ "x": 360,
+ "y": 197
+ },
+ {
+ "label": "Store",
+ "w": 53,
+ "h": 32,
+ "x": 431,
+ "y": 197
+ },
+ {
+ "label": "Commands",
+ "w": 89,
+ "h": 32,
+ "x": 490,
+ "y": 197
+ },
+ {
+ "label": "Show in this window All machines",
+ "w": 240,
+ "h": 32,
+ "x": 44,
+ "y": 265
+ },
+ {
+ "label": "View",
+ "w": 46,
+ "h": 28,
+ "x": 38,
+ "y": 717
+ },
+ {
+ "label": "Rename",
+ "w": 66,
+ "h": 28,
+ "x": 92,
+ "y": 717
+ },
+ {
+ "label": "Share",
+ "w": 51,
+ "h": 28,
+ "x": 166,
+ "y": 717
+ },
+ {
+ "label": "Remove",
+ "w": 65,
+ "h": 28,
+ "x": 225,
+ "y": 717
+ },
+ {
+ "label": "Add machine",
+ "w": 95,
+ "h": 28,
+ "x": 40,
+ "y": 768
+ },
+ {
+ "label": "Approve a device",
+ "w": 117,
+ "h": 28,
+ "x": 143,
+ "y": 768
+ },
+ {
+ "label": "History…",
+ "w": 68,
+ "h": 28,
+ "x": 268,
+ "y": 768
+ }
+ ]
+ },
+ {
+ "flow": "all-commands",
+ "width": "390",
+ "small": [
+ {
+ "label": "Clear search",
+ "w": 32,
+ "h": 32,
+ "x": 258,
+ "y": 146
+ },
+ {
+ "label": "Hide preview",
+ "w": 32,
+ "h": 32,
+ "x": 290,
+ "y": 146
+ },
+ {
+ "label": "Close search",
+ "w": 32,
+ "h": 32,
+ "x": 322,
+ "y": 146
+ },
+ {
+ "label": "Harnesses",
+ "w": 84,
+ "h": 32,
+ "x": -189,
+ "y": 197
+ },
+ {
+ "label": "Machines",
+ "w": 79,
+ "h": 32,
+ "x": -99,
+ "y": 197
+ },
+ {
+ "label": "Projects",
+ "w": 36,
+ "h": 32,
+ "x": 20,
+ "y": 197
+ },
+ {
+ "label": "Agents",
+ "w": 63,
+ "h": 32,
+ "x": 62,
+ "y": 197
+ },
+ {
+ "label": "Models",
+ "w": 65,
+ "h": 32,
+ "x": 131,
+ "y": 197
+ },
+ {
+ "label": "Store",
+ "w": 53,
+ "h": 32,
+ "x": 202,
+ "y": 197
+ },
+ {
+ "label": "Commands",
+ "w": 89,
+ "h": 32,
+ "x": 261,
+ "y": 197
+ },
+ {
+ "label": "Add phone",
+ "w": 334,
+ "h": 37,
+ "x": 28,
+ "y": 251
+ },
+ {
+ "label": "Add project",
+ "w": 334,
+ "h": 37,
+ "x": 28,
+ "y": 288
+ },
+ {
+ "label": "Appearance",
+ "w": 334,
+ "h": 37,
+ "x": 28,
+ "y": 325
+ },
+ {
+ "label": "Boss mode: route a task",
+ "w": 334,
+ "h": 37,
+ "x": 28,
+ "y": 362
+ },
+ {
+ "label": "Branches and pull requests",
+ "w": 334,
+ "h": 37,
+ "x": 28,
+ "y": 399
+ }
+ ]
+ },
+ {
+ "flow": "appearance",
+ "width": "390",
+ "small": []
+ },
+ {
+ "flow": "split-pane",
+ "width": "390",
+ "small": [
+ {
+ "label": "Harness: Coding. Search harnesss",
+ "w": 330,
+ "h": 32,
+ "x": 30,
+ "y": 182
+ },
+ {
+ "label": "Browse Harness Store…",
+ "w": 158,
+ "h": 32,
+ "x": 30,
+ "y": 214
+ },
+ {
+ "label": "Agent: Claude Code. Search agents",
+ "w": 330,
+ "h": 32,
+ "x": 30,
+ "y": 286
+ },
+ {
+ "label": "Checking…",
+ "w": 83,
+ "h": 32,
+ "x": 277,
+ "y": 324
+ },
+ {
+ "label": "Local or remote?",
+ "w": 141,
+ "h": 32,
+ "x": 219,
+ "y": 452
+ },
+ {
+ "label": ">",
+ "w": 330,
+ "h": 32,
+ "x": 30,
+ "y": 490
+ },
+ {
+ "label": "Where to start?",
+ "w": 133,
+ "h": 32,
+ "x": 227,
+ "y": 578
+ },
+ {
+ "label": ">",
+ "w": 330,
+ "h": 32,
+ "x": 30,
+ "y": 616
+ },
+ {
+ "label": "",
+ "w": 330,
+ "h": 32,
+ "x": 30,
+ "y": 650
+ },
+ {
+ "label": "",
+ "w": 330,
+ "h": 15,
+ "x": 30,
+ "y": 684
+ },
+ {
+ "label": "",
+ "w": 330,
+ "h": 32,
+ "x": 30,
+ "y": 718
+ },
+ {
+ "label": "Advanced settings",
+ "w": 106,
+ "h": 30,
+ "x": 30,
+ "y": 717
+ },
+ {
+ "label": "[+] Advanced",
+ "w": 106,
+ "h": 30,
+ "x": 30,
+ "y": 717
+ },
+ {
+ "label": "New Harness",
+ "w": 110,
+ "h": 34,
+ "x": 250,
+ "y": 715
+ },
+ {
+ "label": "create, ctrl-enter",
+ "w": 131,
+ "h": 29,
+ "x": 38,
+ "y": 758
+ },
+ {
+ "label": "close, esc",
+ "w": 78,
+ "h": 29,
+ "x": 38,
+ "y": 787
+ }
+ ]
+ },
+ {
+ "flow": "store",
+ "width": "390",
+ "small": [
+ {
+ "label": "Menu",
+ "w": 31,
+ "h": 28,
+ "x": 8,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 8,
+ "y": 62
+ },
+ {
+ "label": "Tabs: 2:store",
+ "w": 84,
+ "h": 28,
+ "x": 39,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 84,
+ "h": 28,
+ "x": 39,
+ "y": 62
+ },
+ {
+ "label": "New Tab",
+ "w": 23,
+ "h": 28,
+ "x": 123,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 23,
+ "h": 28,
+ "x": 123,
+ "y": 62
+ },
+ {
+ "label": "Open Harness",
+ "w": 31,
+ "h": 28,
+ "x": 320,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 320,
+ "y": 62
+ },
+ {
+ "label": "Notifications",
+ "w": 31,
+ "h": 28,
+ "x": 351,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 351,
+ "y": 62
+ },
+ {
+ "label": "Discover",
+ "w": 160,
+ "h": 38,
+ "x": 12,
+ "y": 118
+ },
+ {
+ "label": "All harnesses",
+ "w": 160,
+ "h": 38,
+ "x": 12,
+ "y": 156
+ },
+ {
+ "label": "Coding",
+ "w": 160,
+ "h": 38,
+ "x": 12,
+ "y": 243
+ },
+ {
+ "label": "Viewers",
+ "w": 32,
+ "h": 32,
+ "x": 18,
+ "y": 759
+ },
+ {
+ "label": "Back Alt+[",
+ "w": 32,
+ "h": 30,
+ "x": 210,
+ "y": 111
+ },
+ {
+ "label": "Forward Alt+]",
+ "w": 32,
+ "h": 30,
+ "x": 249,
+ "y": 111
+ },
+ {
+ "label": "",
+ "w": 32,
+ "h": 32,
+ "x": 338,
+ "y": 110
+ },
+ {
+ "label": "All coding agents",
+ "w": 121,
+ "h": 32,
+ "x": 249,
+ "y": 524
+ },
+ {
+ "label": "Status: Claude Code — Codex —",
+ "w": 209,
+ "h": 28,
+ "x": 8,
+ "y": 811
+ },
+ {
+ "label": "",
+ "w": 209,
+ "h": 28,
+ "x": 8,
+ "y": 811
+ },
+ {
+ "label": "",
+ "w": 109,
+ "h": 28,
+ "x": 273,
+ "y": 811
+ }
+ ]
+ },
+ {
+ "flow": "settings",
+ "width": "390",
+ "small": [
+ {
+ "label": "Back to app",
+ "w": 362,
+ "h": 38,
+ "x": 14,
+ "y": 81
+ },
+ {
+ "label": "Account",
+ "w": 362,
+ "h": 38,
+ "x": 14,
+ "y": 178
+ },
+ {
+ "label": "Appearance",
+ "w": 362,
+ "h": 38,
+ "x": 14,
+ "y": 254
+ },
+ {
+ "label": "Notifications",
+ "w": 362,
+ "h": 38,
+ "x": 14,
+ "y": 292
+ },
+ {
+ "label": "Privacy",
+ "w": 362,
+ "h": 38,
+ "x": 14,
+ "y": 330
+ },
+ {
+ "label": "Keyboard shortcuts",
+ "w": 362,
+ "h": 38,
+ "x": 14,
+ "y": 368
+ },
+ {
+ "label": "Usage",
+ "w": 362,
+ "h": 38,
+ "x": 14,
+ "y": 444
+ },
+ {
+ "label": "Routing",
+ "w": 362,
+ "h": 38,
+ "x": 14,
+ "y": 482
+ },
+ {
+ "label": "Tab invites",
+ "w": 362,
+ "h": 38,
+ "x": 14,
+ "y": 558
+ },
+ {
+ "label": "Experimental",
+ "w": 362,
+ "h": 38,
+ "x": 14,
+ "y": 596
+ },
+ {
+ "label": "About",
+ "w": 362,
+ "h": 38,
+ "x": 14,
+ "y": 672
+ }
+ ]
+ },
+ {
+ "flow": "settings-notifications",
+ "width": "390",
+ "small": [
+ {
+ "label": "Settings",
+ "w": 362,
+ "h": 38,
+ "x": 14,
+ "y": 69
+ }
+ ]
+ },
+ {
+ "flow": "settings-keyboard-shortcuts",
+ "width": "390",
+ "small": [
+ {
+ "label": "Settings",
+ "w": 362,
+ "h": 38,
+ "x": 14,
+ "y": 69
+ },
+ {
+ "label": "Find in the focused terminal, Alt+F. Practice shortcut",
+ "w": 358,
+ "h": 42,
+ "x": 16,
+ "y": 269
+ },
+ {
+ "label": "Keyboard shortcuts, Alt+/. Practice shortcut",
+ "w": 358,
+ "h": 42,
+ "x": 16,
+ "y": 315
+ },
+ {
+ "label": "New Harness, Alt+N. Practice shortcut",
+ "w": 358,
+ "h": 42,
+ "x": 16,
+ "y": 361
+ },
+ {
+ "label": "New Tab, Alt+T. Practice shortcut",
+ "w": 358,
+ "h": 42,
+ "x": 16,
+ "y": 407
+ },
+ {
+ "label": "Open Project, Alt+O. Practice shortcut",
+ "w": 358,
+ "h": 42,
+ "x": 16,
+ "y": 453
+ },
+ {
+ "label": "Search commands, Alt+Shift+P. Practice shortcut",
+ "w": 358,
+ "h": 42,
+ "x": 16,
+ "y": 499
+ },
+ {
+ "label": "Zoom or restore the focused pane, Alt+enter. Practice shortc",
+ "w": 358,
+ "h": 42,
+ "x": 16,
+ "y": 545
+ },
+ {
+ "label": "Close Tab, Alt+W. Practice shortcut",
+ "w": 358,
+ "h": 42,
+ "x": 16,
+ "y": 633
+ },
+ {
+ "label": "Go back, Alt+[. Practice shortcut",
+ "w": 358,
+ "h": 42,
+ "x": 16,
+ "y": 679
+ },
+ {
+ "label": "Go forward, Alt+]. Practice shortcut",
+ "w": 358,
+ "h": 42,
+ "x": 16,
+ "y": 725
+ },
+ {
+ "label": "Next Tab, Alt+Shift+]. Practice shortcut",
+ "w": 358,
+ "h": 30,
+ "x": 16,
+ "y": 771
+ },
+ {
+ "label": "Next terminal match, Alt+G. Practice shortcut",
+ "w": 358,
+ "h": 42,
+ "x": 16,
+ "y": 817
+ }
+ ]
+ },
+ {
+ "flow": "new-tab",
+ "width": "390",
+ "small": [
+ {
+ "label": "Menu",
+ "w": 31,
+ "h": 28,
+ "x": 8,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 8,
+ "y": 62
+ },
+ {
+ "label": "Tabs: 2:New Tab",
+ "w": 100,
+ "h": 28,
+ "x": 39,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 100,
+ "h": 28,
+ "x": 39,
+ "y": 62
+ },
+ {
+ "label": "New Tab",
+ "w": 23,
+ "h": 28,
+ "x": 139,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 23,
+ "h": 28,
+ "x": 139,
+ "y": 62
+ },
+ {
+ "label": "Open Harness",
+ "w": 31,
+ "h": 28,
+ "x": 320,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 320,
+ "y": 62
+ },
+ {
+ "label": "Notifications",
+ "w": 31,
+ "h": 28,
+ "x": 351,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 351,
+ "y": 62
+ },
+ {
+ "label": "1",
+ "w": 342,
+ "h": 24,
+ "x": 24,
+ "y": 353
+ },
+ {
+ "label": "2",
+ "w": 342,
+ "h": 24,
+ "x": 24,
+ "y": 377
+ },
+ {
+ "label": "3",
+ "w": 342,
+ "h": 24,
+ "x": 24,
+ "y": 401
+ },
+ {
+ "label": "Alt+N",
+ "w": 304,
+ "h": 24,
+ "x": 43,
+ "y": 445
+ },
+ {
+ "label": "Alt+P",
+ "w": 304,
+ "h": 24,
+ "x": 43,
+ "y": 469
+ },
+ {
+ "label": "Alt+I",
+ "w": 304,
+ "h": 24,
+ "x": 43,
+ "y": 493
+ },
+ {
+ "label": "Alt+M",
+ "w": 304,
+ "h": 24,
+ "x": 43,
+ "y": 517
+ },
+ {
+ "label": "Ctrl+Alt+S",
+ "w": 304,
+ "h": 24,
+ "x": 43,
+ "y": 541
+ },
+ {
+ "label": "Work from your phone",
+ "w": 304,
+ "h": 24,
+ "x": 43,
+ "y": 585
+ },
+ {
+ "label": "Appearance",
+ "w": 94,
+ "h": 32,
+ "x": 276,
+ "y": 759
+ },
+ {
+ "label": "Status: Claude Code — Codex —",
+ "w": 209,
+ "h": 28,
+ "x": 8,
+ "y": 811
+ },
+ {
+ "label": "",
+ "w": 209,
+ "h": 28,
+ "x": 8,
+ "y": 811
+ },
+ {
+ "label": "",
+ "w": 109,
+ "h": 28,
+ "x": 273,
+ "y": 811
+ }
+ ]
+ },
+ {
+ "flow": "error-banner",
+ "width": "390",
+ "small": [
+ {
+ "label": "Menu",
+ "w": 31,
+ "h": 28,
+ "x": 8,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 8,
+ "y": 62
+ },
+ {
+ "label": "Tabs: 1:code · 2/2",
+ "w": 123,
+ "h": 28,
+ "x": 39,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 123,
+ "h": 28,
+ "x": 39,
+ "y": 62
+ },
+ {
+ "label": "New Tab",
+ "w": 23,
+ "h": 28,
+ "x": 162,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 23,
+ "h": 28,
+ "x": 162,
+ "y": 62
+ },
+ {
+ "label": "Open Harness",
+ "w": 31,
+ "h": 28,
+ "x": 320,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 320,
+ "y": 62
+ },
+ {
+ "label": "Notifications",
+ "w": 31,
+ "h": 28,
+ "x": 351,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 351,
+ "y": 62
+ },
+ {
+ "label": "Retry",
+ "w": 50,
+ "h": 32,
+ "x": 276,
+ "y": 104
+ },
+ {
+ "label": "Agent: Codex",
+ "w": 55,
+ "h": 28,
+ "x": 230,
+ "y": 160
+ },
+ {
+ "label": "",
+ "w": 55,
+ "h": 28,
+ "x": 230,
+ "y": 160
+ },
+ {
+ "label": "Model: OpenAI",
+ "w": 63,
+ "h": 28,
+ "x": 285,
+ "y": 160
+ },
+ {
+ "label": "",
+ "w": 63,
+ "h": 28,
+ "x": 285,
+ "y": 160
+ },
+ {
+ "label": "Close Pane",
+ "w": 28,
+ "h": 28,
+ "x": 348,
+ "y": 160
+ },
+ {
+ "label": "",
+ "w": 28,
+ "h": 28,
+ "x": 348,
+ "y": 160
+ },
+ {
+ "label": "Status: Studio Mac",
+ "w": 108,
+ "h": 28,
+ "x": 8,
+ "y": 811
+ },
+ {
+ "label": "",
+ "w": 108,
+ "h": 28,
+ "x": 8,
+ "y": 811
+ },
+ {
+ "label": "",
+ "w": 109,
+ "h": 28,
+ "x": 273,
+ "y": 811
+ }
+ ]
+ },
+ {
+ "flow": "new-device",
+ "width": "390",
+ "small": [
+ {
+ "label": "It’s mine",
+ "w": 69,
+ "h": 32,
+ "x": 236,
+ "y": 63
+ },
+ {
+ "label": "Review",
+ "w": 69,
+ "h": 32,
+ "x": 311,
+ "y": 63
+ },
+ {
+ "label": "Menu",
+ "w": 31,
+ "h": 28,
+ "x": 8,
+ "y": 108
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 8,
+ "y": 108
+ },
+ {
+ "label": "Tabs: 1:code · 2/2",
+ "w": 123,
+ "h": 28,
+ "x": 39,
+ "y": 108
+ },
+ {
+ "label": "",
+ "w": 123,
+ "h": 28,
+ "x": 39,
+ "y": 108
+ },
+ {
+ "label": "New Tab",
+ "w": 23,
+ "h": 28,
+ "x": 162,
+ "y": 108
+ },
+ {
+ "label": "",
+ "w": 23,
+ "h": 28,
+ "x": 162,
+ "y": 108
+ },
+ {
+ "label": "Open Harness",
+ "w": 31,
+ "h": 28,
+ "x": 320,
+ "y": 108
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 320,
+ "y": 108
+ },
+ {
+ "label": "Notifications",
+ "w": 31,
+ "h": 28,
+ "x": 351,
+ "y": 108
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 351,
+ "y": 108
+ },
+ {
+ "label": "Agent: Codex",
+ "w": 55,
+ "h": 28,
+ "x": 230,
+ "y": 158
+ },
+ {
+ "label": "",
+ "w": 55,
+ "h": 28,
+ "x": 230,
+ "y": 158
+ },
+ {
+ "label": "Model: OpenAI",
+ "w": 63,
+ "h": 28,
+ "x": 285,
+ "y": 158
+ },
+ {
+ "label": "",
+ "w": 63,
+ "h": 28,
+ "x": 285,
+ "y": 158
+ },
+ {
+ "label": "Close Pane",
+ "w": 28,
+ "h": 28,
+ "x": 348,
+ "y": 158
+ },
+ {
+ "label": "",
+ "w": 28,
+ "h": 28,
+ "x": 348,
+ "y": 158
+ },
+ {
+ "label": "Status: Studio Mac",
+ "w": 108,
+ "h": 28,
+ "x": 8,
+ "y": 811
+ },
+ {
+ "label": "",
+ "w": 108,
+ "h": 28,
+ "x": 8,
+ "y": 811
+ },
+ {
+ "label": "",
+ "w": 109,
+ "h": 28,
+ "x": 273,
+ "y": 811
+ }
+ ]
+ },
+ {
+ "flow": "link-password",
+ "width": "390",
+ "small": [
+ {
+ "label": "Menu",
+ "w": 31,
+ "h": 28,
+ "x": 8,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 8,
+ "y": 62
+ },
+ {
+ "label": "Tabs: 1:New Tab",
+ "w": 100,
+ "h": 28,
+ "x": 39,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 100,
+ "h": 28,
+ "x": 39,
+ "y": 62
+ },
+ {
+ "label": "New Tab",
+ "w": 23,
+ "h": 28,
+ "x": 139,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 23,
+ "h": 28,
+ "x": 139,
+ "y": 62
+ },
+ {
+ "label": "Open Harness",
+ "w": 31,
+ "h": 28,
+ "x": 320,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 320,
+ "y": 62
+ },
+ {
+ "label": "Notifications",
+ "w": 31,
+ "h": 28,
+ "x": 351,
+ "y": 62
+ },
+ {
+ "label": "",
+ "w": 31,
+ "h": 28,
+ "x": 351,
+ "y": 62
+ },
+ {
+ "label": "New Tab",
+ "w": 105,
+ "h": 32,
+ "x": 24,
+ "y": 329
+ },
+ {
+ "label": "New Pane",
+ "w": 113,
+ "h": 32,
+ "x": 141,
+ "y": 329
+ },
+ {
+ "label": "Quick start · 4 steps",
+ "w": 185,
+ "h": 32,
+ "x": 24,
+ "y": 373
+ },
+ {
+ "label": "Keyboard practice",
+ "w": 153,
+ "h": 32,
+ "x": 24,
+ "y": 417
+ },
+ {
+ "label": "Appearance",
+ "w": 94,
+ "h": 32,
+ "x": 276,
+ "y": 759
+ },
+ {
+ "label": "Try again",
+ "w": 81,
+ "h": 32,
+ "x": 268,
+ "y": 259
+ },
+ {
+ "label": "Download app",
+ "w": 135,
+ "h": 32,
+ "x": 45,
+ "y": 483
+ },
+ {
+ "label": "Status: Claude Code — Codex —",
+ "w": 209,
+ "h": 28,
+ "x": 8,
+ "y": 811
+ },
+ {
+ "label": "",
+ "w": 209,
+ "h": 28,
+ "x": 8,
+ "y": 811
+ },
+ {
+ "label": "",
+ "w": 109,
+ "h": 28,
+ "x": 273,
+ "y": 811
+ }
+ ]
+ }
+ ],
+ "wheel": [
+ {
+ "flow": "many-tabs",
+ "area": "tab row",
+ "box": [
+ 60,
+ 0,
+ 1300,
+ 40
+ ],
+ "wheel": [
+ 0,
+ -300
+ ],
+ "scrolled": true,
+ "images": "checks/many-tabs-tab-row-{before,after}.png"
+ },
+ {
+ "flow": "many-tabs",
+ "area": "tab row (shift+wheel)",
+ "box": [
+ 60,
+ 0,
+ 1300,
+ 40
+ ],
+ "wheel": [
+ 0,
+ -300
+ ],
+ "shift": true,
+ "scrolled": true,
+ "images": "checks/many-tabs-tab-row-shift-wheel--{before,after}.png"
+ },
+ {
+ "flow": "many-tabs",
+ "area": "tab row (trackpad sideways)",
+ "box": [
+ 60,
+ 0,
+ 1300,
+ 40
+ ],
+ "wheel": [
+ -300,
+ 0
+ ],
+ "scrolled": true,
+ "images": "checks/many-tabs-tab-row-trackpad-sideways--{before,after}.png"
+ },
+ {
+ "flow": "store",
+ "area": "store page",
+ "box": [
+ 120,
+ 60,
+ 1300,
+ 860
+ ],
+ "wheel": [
+ 0,
+ 600
+ ],
+ "scrolled": true,
+ "images": "checks/store-store-page-{before,after}.png"
+ },
+ {
+ "flow": "open-harness",
+ "area": "picker filter chips",
+ "box": [
+ 320,
+ 330,
+ 1100,
+ 360
+ ],
+ "wheel": [
+ 0,
+ 200
+ ],
+ "scrolled": true,
+ "images": "checks/open-harness-picker-filter-chips-{before,after}.png"
+ },
+ {
+ "flow": "all-commands",
+ "area": "command list",
+ "box": [
+ 320,
+ 380,
+ 720,
+ 880
+ ],
+ "wheel": [
+ 0,
+ 400
+ ],
+ "scrolled": true,
+ "images": "checks/all-commands-command-list-{before,after}.png"
+ },
+ {
+ "flow": "appearance",
+ "area": "appearance panel",
+ "box": [
+ 1230,
+ 120,
+ 1440,
+ 900
+ ],
+ "wheel": [
+ 0,
+ 500
+ ],
+ "scrolled": true,
+ "images": "checks/appearance-appearance-panel-{before,after}.png"
+ },
+ {
+ "flow": "settings-keyboard-shortcuts",
+ "area": "shortcut list",
+ "box": [
+ 270,
+ 100,
+ 1440,
+ 900
+ ],
+ "wheel": [
+ 0,
+ 600
+ ],
+ "scrolled": true,
+ "images": "checks/settings-keyboard-shortcuts-shortcut-list-{before,after}.png"
+ },
+ {
+ "flow": "split-pane",
+ "area": "new harness form",
+ "box": [
+ 300,
+ 150,
+ 1140,
+ 880
+ ],
+ "wheel": [
+ 0,
+ 400
+ ],
+ "scrolled": true,
+ "images": "checks/split-pane-new-harness-form-{before,after}.png"
+ }
+ ],
+ "swipe": [
+ {
+ "flow": "tab-switcher",
+ "area": "tab switcher list",
+ "from": [
+ 195,
+ 600
+ ],
+ "to": [
+ 195,
+ 250
+ ],
+ "scrolled": false,
+ "images": "checks/swipe-tab-switcher-{before,after}.png"
+ },
+ {
+ "flow": "machines",
+ "area": "machines list",
+ "from": [
+ 195,
+ 600
+ ],
+ "to": [
+ 195,
+ 250
+ ],
+ "scrolled": true,
+ "images": "checks/swipe-machines-{before,after}.png"
+ },
+ {
+ "flow": "app-menu",
+ "area": "app menu",
+ "from": [
+ 120,
+ 500
+ ],
+ "to": [
+ 120,
+ 200
+ ],
+ "scrolled": true,
+ "images": "checks/swipe-app-menu-{before,after}.png"
+ },
+ {
+ "flow": "store",
+ "area": "store page",
+ "from": [
+ 195,
+ 650
+ ],
+ "to": [
+ 195,
+ 200
+ ],
+ "scrolled": true,
+ "images": "checks/swipe-store-{before,after}.png"
+ },
+ {
+ "flow": "settings",
+ "area": "settings list",
+ "from": [
+ 195,
+ 650
+ ],
+ "to": [
+ 195,
+ 200
+ ],
+ "scrolled": false,
+ "images": "checks/swipe-settings-{before,after}.png"
+ },
+ {
+ "flow": "settings-keyboard-shortcuts",
+ "area": "shortcut list",
+ "from": [
+ 195,
+ 650
+ ],
+ "to": [
+ 195,
+ 200
+ ],
+ "scrolled": true,
+ "images": "checks/swipe-settings-keyboard-shortcuts-{before,after}.png"
+ },
+ {
+ "flow": "all-commands",
+ "area": "command list",
+ "from": [
+ 195,
+ 650
+ ],
+ "to": [
+ 195,
+ 250
+ ],
+ "scrolled": true,
+ "images": "checks/swipe-all-commands-{before,after}.png"
+ },
+ {
+ "flow": "first-machine",
+ "area": "connect page",
+ "from": [
+ 195,
+ 650
+ ],
+ "to": [
+ 195,
+ 200
+ ],
+ "scrolled": true,
+ "images": "checks/swipe-first-machine-{before,after}.png"
+ },
+ {
+ "flow": "signin",
+ "area": "sign-in page",
+ "from": [
+ 195,
+ 650
+ ],
+ "to": [
+ 195,
+ 200
+ ],
+ "scrolled": false,
+ "images": "checks/swipe-signin-{before,after}.png"
+ }
+ ],
+ "hover": [
+ {
+ "flow": "workspace",
+ "name": "New Tab",
+ "changed": true,
+ "cursor": "pointer",
+ "images": "checks/hover-workspace-New-Tab-{before,after}.png"
+ },
+ {
+ "flow": "workspace",
+ "name": "Open Harness",
+ "changed": true,
+ "cursor": "pointer",
+ "images": "checks/hover-workspace-Open-Harness-{before,after}.png"
+ },
+ {
+ "flow": "workspace",
+ "name": "Close Pane",
+ "changed": true,
+ "cursor": "pointer",
+ "images": "checks/hover-workspace-Close-Pane-{before,after}.png"
+ },
+ {
+ "flow": "workspace",
+ "name": "Agent: Claude Code",
+ "changed": true,
+ "cursor": "pointer",
+ "images": "checks/hover-workspace-Agent-Claude-Code-{before,after}.png"
+ },
+ {
+ "flow": "workspace",
+ "name": "Click to open Harness Monitor",
+ "changed": true,
+ "cursor": "pointer",
+ "images": "checks/hover-workspace-Click-to-open-Harness-Monitor-{before,after}.png"
+ },
+ {
+ "flow": "many-tabs",
+ "name": "docs",
+ "changed": true,
+ "cursor": "pointer",
+ "images": "checks/hover-many-tabs-docs-{before,after}.png"
+ },
+ {
+ "flow": "app-menu",
+ "name": "Settings",
+ "exact": true,
+ "changed": true,
+ "cursor": "pointer",
+ "images": "checks/hover-app-menu-Settings-{before,after}.png"
+ },
+ {
+ "flow": "signin",
+ "name": "Continue with Google",
+ "changed": true,
+ "cursor": "pointer",
+ "images": "checks/hover-signin-Continue-with-Google-{before,after}.png"
+ },
+ {
+ "flow": "first-machine",
+ "name": "Download app",
+ "changed": true,
+ "cursor": "pointer",
+ "images": "checks/hover-first-machine-Download-app-{before,after}.png"
+ },
+ {
+ "flow": "settings",
+ "name": "Privacy",
+ "exact": true,
+ "changed": true,
+ "cursor": "pointer",
+ "images": "checks/hover-settings-Privacy-{before,after}.png"
+ }
+ ],
+ "focus": [
+ {
+ "flow": "signin",
+ "afterTabs": 4,
+ "active": "flutter-view Your agents, wherever they runAt home, a",
+ "image": "checks/focus-signin.png"
+ },
+ {
+ "flow": "first-machine",
+ "afterTabs": 4,
+ "active": "flt-semantics ",
+ "image": "checks/focus-first-machine.png"
+ },
+ {
+ "flow": "workspace",
+ "afterTabs": 4,
+ "active": "textarea Terminal input",
+ "image": "checks/focus-workspace.png"
+ },
+ {
+ "flow": "settings",
+ "afterTabs": 4,
+ "active": "flt-semantics Notifications",
+ "image": "checks/focus-settings.png"
+ }
+ ],
+ "blocked": []
+}
\ No newline at end of file
diff --git a/desktop/design/web-ux-audit/load-time.json b/desktop/design/web-ux-audit/load-time.json
new file mode 100644
index 000000000..5374e11da
--- /dev/null
+++ b/desktop/design/web-ux-audit/load-time.json
@@ -0,0 +1,71 @@
+[
+ {
+ "profile": "computer, cable",
+ "firstFrameMs": 1207,
+ "settledMs": 1224,
+ "transferredMB": 7.29,
+ "runs": [
+ {
+ "firstFrame": 1543,
+ "signIn": 1564,
+ "megabytes": 7.29
+ },
+ {
+ "firstFrame": 1191,
+ "signIn": 1209,
+ "megabytes": 7.29
+ },
+ {
+ "firstFrame": 1207,
+ "signIn": 1224,
+ "megabytes": 7.29
+ }
+ ]
+ },
+ {
+ "profile": "phone, slow 4G",
+ "firstFrameMs": 39827,
+ "settledMs": 40810,
+ "transferredMB": 7.29,
+ "runs": [
+ {
+ "firstFrame": 39692,
+ "signIn": 40684,
+ "megabytes": 7.29
+ },
+ {
+ "firstFrame": 39827,
+ "signIn": 40810,
+ "megabytes": 7.29
+ },
+ {
+ "firstFrame": 39932,
+ "signIn": 40891,
+ "megabytes": 7.29
+ }
+ ]
+ },
+ {
+ "profile": "phone, fast 4G",
+ "firstFrameMs": 8048,
+ "settledMs": 8516,
+ "transferredMB": 7.29,
+ "runs": [
+ {
+ "firstFrame": 8048,
+ "signIn": 8541,
+ "megabytes": 7.29
+ },
+ {
+ "firstFrame": 8218,
+ "signIn": 8516,
+ "megabytes": 7.29
+ },
+ {
+ "firstFrame": 7878,
+ "signIn": 8341,
+ "megabytes": 7.29
+ }
+ ]
+ }
+]
diff --git a/desktop/lib/screens/swarm_screen.dart b/desktop/lib/screens/swarm_screen.dart
index ac3b8debf..44738ada8 100644
--- a/desktop/lib/screens/swarm_screen.dart
+++ b/desktop/lib/screens/swarm_screen.dart
@@ -4003,7 +4003,7 @@ class _SwarmScreenState extends State<SwarmScreen> {
return;
}
final content = _newHarnessContent();
- _newHarnessOverlay = OverlayEntry(
+ _newHarnessOverlay = _workspaceOverlay(
// Hidden, not removed, while a dialog ROUTE is up — see
// [_withNewHarnessHidden]. The form keeps its State and its draft.
builder: (context) => Offstage(
@@ -5542,7 +5542,7 @@ class _SwarmScreenState extends State<SwarmScreen> {
_closeDaemonPreview();
return;
}
- _daemonPreview = OverlayEntry(
+ _daemonPreview = _workspaceOverlay(
builder: (context) {
final width = math.min(
350.0,
@@ -5688,7 +5688,7 @@ class _SwarmScreenState extends State<SwarmScreen> {
if (overlay == null) return false;
_closeDaemonPreview();
_closeDaemonHint();
- _daemonHintOverlay = OverlayEntry(
+ _daemonHintOverlay = _workspaceOverlay(
builder: (context) {
final cell = workspaceBarCellSizeOf(context);
return Positioned(
@@ -5781,7 +5781,7 @@ class _SwarmScreenState extends State<SwarmScreen> {
_closeSearch(restoreFocus: false);
dismissTransientMenus();
_preparePaneFocus();
- _daemonOverlay = OverlayEntry(
+ _daemonOverlay = _workspaceOverlay(
builder: (context) => _anchoredBesideSlot(
onBarrierTap: _closeDaemon,
width: 480,
@@ -5897,7 +5897,7 @@ class _SwarmScreenState extends State<SwarmScreen> {
_face.beginReveal(kind: egg.kind);
final result = _zoo.hatch(egg.id);
_preparePaneFocus();
- _hatchOverlay = OverlayEntry(
+ _hatchOverlay = _workspaceOverlay(
builder: (context) => _anchoredBesideSlot(
onBarrierTap: _closeHatch,
cells: daemonRevealCells,
@@ -5977,7 +5977,7 @@ class _SwarmScreenState extends State<SwarmScreen> {
app.markModelsOpened();
unawaited(app.modelManager.refresh());
unawaited(_modelsMenu!.refresh());
- _modelsOverlay = OverlayEntry(
+ _modelsOverlay = _workspaceOverlay(
builder: (context) => LayoutBuilder(
builder: (context, constraints) => Stack(
children: [
@@ -6399,7 +6399,7 @@ class _SwarmScreenState extends State<SwarmScreen> {
},
);
_search!.addListener(_syncSearch);
- _searchOverlay = OverlayEntry(builder: _buildSearchOverlay);
+ _searchOverlay = _workspaceOverlay(builder: _buildSearchOverlay);
Overlay.of(context).insert(_searchOverlay!);
_syncSearch();
// The overlay and focus nodes update independently of the retained canvas.
@@ -7914,9 +7914,19 @@ class _SwarmScreenState extends State<SwarmScreen> {
if (mounted) linuxTitleBarActions.refresh();
});
}
- return _buildWorkspace(context);
+ return _inChrome(_buildWorkspace(context));
}
+ /// [child] under this workspace's host chrome, so [WorkspaceChrome.of]
+ /// reads the chrome this screen was given. The workspace and every overlay
+ /// it opens go through here; an overlay is outside the workspace's subtree.
+ Widget _inChrome(Widget child) =>
+ WorkspaceChromeScope(chrome: widget.chrome, child: child);
+
+ /// An overlay of this workspace, under its host chrome ([_inChrome]).
+ OverlayEntry _workspaceOverlay({required WidgetBuilder builder}) =>
+ OverlayEntry(builder: (context) => _inChrome(builder(context)));
+
/// Search, notifications and Store, for the right end of the Linux title
/// bar — the same three the tab strip draws on every other host.
Widget _buildTitleBarActions(BuildContext context) {
diff --git a/desktop/lib/state/workspace_chrome.dart b/desktop/lib/state/workspace_chrome.dart
index d45e54988..535e6fe76 100644
--- a/desktop/lib/state/workspace_chrome.dart
+++ b/desktop/lib/state/workspace_chrome.dart
@@ -65,8 +65,24 @@ class WorkspaceChrome {
this.compactFooter,
this.compactBelow = 0,
this.firstMachine,
+ this.menuOnEveryTab = false,
+ this.labelsPaneStatus = false,
+ this.compactPaneHeader = false,
});
+ /// What a workspace with no host chrome (Desktop) reads: every switch at
+ /// today's behavior.
+ static final _none = WorkspaceChrome(
+ leadingWidth: (_) => 0,
+ leading: (_, _) => const SizedBox.shrink(),
+ );
+
+ /// The chrome the enclosing workspace was given, or the defaults when it
+ /// was given none. For widgets the workspace builds, its overlays included;
+ /// `SwarmScreen`'s own State code reads `widget.chrome` directly.
+ static WorkspaceChrome of(BuildContext context) =>
+ WorkspaceChromeScope.maybeOf(context) ?? _none;
+
/// Shown over the workspace while none of the account's computers is
/// connected, instead of opening the machine picker unasked. Null keeps the
/// picker.
@@ -107,4 +123,42 @@ class WorkspaceChrome {
final Widget Function(BuildContext context, WorkspaceFooter footer)?
compactFooter;
final double compactBelow;
+
+ /// True gives every tab a right-click menu (Rename Tab, Close Tab), not only
+ /// a shared one. Audit finding S10.
+ final bool menuOnEveryTab;
+
+ /// True labels a pane whose computer is connecting or reconnecting, or whose
+ /// terminal is view only, in words beside its name. Audit findings S3, S4.
+ final bool labelsPaneStatus;
+
+ /// True draws a denser pane header below [compactBelow]: the harness name
+ /// first, agent and model behind one control. Audit finding S2.
+ final bool compactPaneHeader;
+
+ /// Whether a window [width] wide gets the compact pane header.
+ bool compactPaneHeaderAt(double width) =>
+ compactPaneHeader && width < compactBelow;
+}
+
+/// Hands the workspace's [WorkspaceChrome] to every widget below it, so a
+/// widget the workspace builds reads it with [WorkspaceChrome.of] instead of
+/// taking it as a parameter.
+class WorkspaceChromeScope extends InheritedWidget {
+ const WorkspaceChromeScope({
+ super.key,
+ required this.chrome,
+ required super.child,
+ });
+
+ /// The chrome the workspace was given; null on Desktop.
+ final WorkspaceChrome? chrome;
+
+ static WorkspaceChrome? maybeOf(BuildContext context) => context
+ .dependOnInheritedWidgetOfExactType<WorkspaceChromeScope>()
+ ?.chrome;
+
+ @override
+ bool updateShouldNotify(WorkspaceChromeScope oldWidget) =>
+ !identical(chrome, oldWidget.chrome);
}
diff --git a/desktop/lib/web/shell/web_chrome.dart b/desktop/lib/web/shell/web_chrome.dart
index d52a78e1c..c670bcfc0 100644
--- a/desktop/lib/web/shell/web_chrome.dart
+++ b/desktop/lib/web/shell/web_chrome.dart
@@ -10,8 +10,20 @@ import 'web_machine_choice.dart';
/// Everything the browser adds to the shared workspace: a menu before the
/// tabs, a tab switcher and a one-dropdown footer on narrow screens, a clickable Back in the picker
/// with its key hints hidden, and a connected machine for New Harness, since
-/// a browser is not a machine.
-WorkspaceChrome webWorkspaceChrome(AppNotifier app) => WorkspaceChrome(
+/// a browser is not a machine. It also turns on a menu on every tab, worded
+/// pane states and the compact pane header, which the web reads and Desktop
+/// leaves off.
+///
+/// Made once per [AppNotifier]: the signed-in screen is rebuilt on every app
+/// notification, and a new chrome each time would rebuild every widget that
+/// reads it ([WorkspaceChromeScope] compares by identity). Nothing in it
+/// depends on more than [app].
+WorkspaceChrome webWorkspaceChrome(AppNotifier app) =>
+ _webChromes[app] ??= _webWorkspaceChrome(app);
+
+final _webChromes = Expando<WorkspaceChrome>('webWorkspaceChrome');
+
+WorkspaceChrome _webWorkspaceChrome(AppNotifier app) => WorkspaceChrome(
leadingWidth: WebAppMenuButton.widthOf,
leading: (context, commands) =>
WebAppMenuButton(app: app, commands: commands),
@@ -26,4 +38,7 @@ WorkspaceChrome webWorkspaceChrome(AppNotifier app) => WorkspaceChrome(
compactFooter: (context, footer) => WebFooterBar(footer: footer),
compactBelow: kWebCompactBelow,
firstMachine: (context) => WebFirstMachine(app: app),
+ menuOnEveryTab: true,
+ labelsPaneStatus: true,
+ compactPaneHeader: true,
);
diff --git a/desktop/test/support/web_ux_app.dart b/desktop/test/support/web_ux_app.dart
new file mode 100644
index 000000000..bb2521696
--- /dev/null
+++ b/desktop/test/support/web_ux_app.dart
@@ -0,0 +1,128 @@
+/// An [AppNotifier] for the web UX review fixtures (`tool/web_ux_*.dart`).
+///
+/// It is seeded in memory and never signs in, reads a machine list or dials a
+/// machine: every call that would leave the page answers locally. The API base
+/// is a closed loopback port, so anything that still slips past fails at once
+/// instead of reaching a real backend.
+library;
+
+import 'dart:async';
+
+import 'package:harness/auth/auth_session.dart';
+import 'package:harness/auth/sign_in_provider.dart';
+import 'package:harness/core/config.dart';
+import 'package:harness/core/models.dart';
+import 'package:harness/state/app_state.dart';
+import 'package:harness/terminal/terminal_session.dart';
+
+/// Nothing listens on port 9 (discard), so a stray request fails fast.
+const webUxConfig = AppConfig(apiBaseUrl: 'http://127.0.0.1:9');
+
+class WebUxApp extends AppNotifier {
+ WebUxApp()
+ : super(
+ config: webUxConfig,
+ authSession: AuthSession(),
+ configStore: null,
+ );
+
+ /// Whether the first machine list has answered.
+ bool inventoryLoaded = true;
+
+ /// A sign-in that never finishes, so its waiting state stays on screen.
+ bool loginHangs = false;
+
+ /// The error banner's text, as a failed launch or sign-in leaves it.
+ String? error;
+
+ /// A session the server refused, which asks for sign-in again.
+ bool expired = false;
+
+ @override
+ bool get machineInventoryLoaded => inventoryLoaded;
+
+ @override
+ String? get lastError => error ?? super.lastError;
+
+ @override
+ bool get sessionExpired => expired || super.sessionExpired;
+
+ @override
+ Future<void> bootstrap() async {}
+
+ @override
+ Future<bool> refreshMachines() async => true;
+
+ @override
+ Future<void> rereadMachines() async {}
+
+ @override
+ Future<bool> connectTrusted(String machineId, {Duration? timeout}) async =>
+ false;
+
+ @override
+ Future<void> login([SignInProvider? provider]) async {
+ signingIn = true;
+ status = AppStatus.bootstrapping;
+ notifyListeners();
+ if (loginHangs) await Completer<void>().future;
+ }
+
+ @override
+ Future<void> openLoginBrowser() async {}
+
+ @override
+ Future<void> logout() async {}
+
+ /// Adds a machine in [status], with [agents] running on it.
+ MachineState addMachine(
+ String id,
+ String name, {
+ ConnectionStatus status = ConnectionStatus.connected,
+ bool online = true,
+ bool needsLink = false,
+ List<Agent> agents = const [],
+ }) {
+ final machine = Machine(
+ machineId: id,
+ name: name,
+ authMode: MachineAuthMode.remote,
+ );
+ machines = [...machines, machine];
+ final state = MachineState(machine)
+ ..nodeOnline = online
+ ..connectionStatus = status
+ ..needsLink = needsLink
+ ..agentLoadStatus = needsLink
+ ? AgentLoadStatus.needsLink
+ : AgentLoadStatus.loaded
+ ..agents = agents;
+ machineStates[id] = state;
+ return state;
+ }
+
+ /// Opens [agent]'s terminal on [machineId] as a pane, showing [screen].
+ TerminalSession openTerminal(
+ String machineId,
+ Agent agent, {
+ String screen = '',
+ TerminalSessionStatus status = TerminalSessionStatus.controlling,
+ bool readOnly = false,
+ }) {
+ final session =
+ TerminalSession(
+ machineId: machineId,
+ agentId: agent.id,
+ agentName: agent.name,
+ engineId: agent.engine,
+ readOnly: readOnly,
+ send: (_, _) async => true,
+ sendBinary: (_) async => true,
+ )
+ ..status = status
+ ..streamId = 'stream-${agent.id}';
+ if (screen.isNotEmpty) session.terminal.write(screen);
+ adoptSessionForTest(session);
+ return session;
+ }
+}
diff --git a/desktop/test/web_ux_app_test.dart b/desktop/test/web_ux_app_test.dart
new file mode 100644
index 000000000..5df4c458d
--- /dev/null
+++ b/desktop/test/web_ux_app_test.dart
@@ -0,0 +1,80 @@
+// The web UX review fixture's fake account: it must show the states it is
+// seeded with and never wait on a backend.
+
+import 'package:flutter_test/flutter_test.dart';
+import 'package:harness/auth/sign_in_provider.dart';
+import 'package:harness/core/models.dart';
+import 'package:harness/state/app_state.dart';
+import 'package:harness/terminal/terminal_session.dart';
+
+import 'support/web_ux_app.dart';
+
+const _agent = Agent(
+ id: 'a1',
+ name: 'Fix checkout flow',
+ engine: 'claude',
+ terminalAvailable: true,
+);
+
+void main() {
+ test('a sign-in waits on screen without reaching a backend', () async {
+ final app = WebUxApp()..status = AppStatus.unauthenticated;
+ addTearDown(app.dispose);
+
+ await app.login(SignInProvider.google);
+
+ expect(app.status, AppStatus.bootstrapping);
+ expect(app.signingIn, isTrue);
+ });
+
+ test('a machine is listed in the connection state it was seeded with', () {
+ final app = WebUxApp();
+ addTearDown(app.dispose);
+
+ app.addMachine(
+ 'm1',
+ 'Studio Mac',
+ status: ConnectionStatus.reconnecting,
+ needsLink: true,
+ agents: const [_agent],
+ );
+
+ expect(app.machines.single.displayName, 'Studio Mac');
+ final state = app.stateOf('m1')!;
+ expect(state.connectionStatus, ConnectionStatus.reconnecting);
+ expect(state.needsLink, isTrue);
+ expect(state.agentLoadStatus, AgentLoadStatus.needsLink);
+ expect(state.agents.single.id, 'a1');
+ });
+
+ test('a terminal opens as the focused pane showing its screen', () {
+ final app = WebUxApp()..addMachine('m1', 'Studio Mac');
+ addTearDown(app.dispose);
+
+ final session = app.openTerminal(
+ 'm1',
+ _agent,
+ screen: 'hello from the fixture',
+ status: TerminalSessionStatus.takenOver,
+ readOnly: true,
+ );
+
+ expect(app.focusedPane?.session, same(session));
+ expect(session.status, TerminalSessionStatus.takenOver);
+ expect(session.readOnly, isTrue);
+ expect(
+ session.terminal.buffer.lines[0].toString(),
+ startsWith('hello from the fixture'),
+ );
+ });
+
+ test('a seeded error and expired session read as the real ones do', () {
+ final app = WebUxApp()
+ ..error = 'Could not start Claude Code.'
+ ..expired = true;
+ addTearDown(app.dispose);
+
+ expect(app.lastError, 'Could not start Claude Code.');
+ expect(app.sessionExpired, isTrue);
+ });
+}
diff --git a/desktop/test/workspace_chrome_scope_test.dart b/desktop/test/workspace_chrome_scope_test.dart
new file mode 100644
index 000000000..70621123f
--- /dev/null
+++ b/desktop/test/workspace_chrome_scope_test.dart
@@ -0,0 +1,191 @@
+// The workspace's host chrome, read from context: the exact object the screen
+// was given, Desktop's defaults when there is none, and the web's values.
+
+import 'package:flutter/material.dart';
+import 'package:flutter_test/flutter_test.dart';
+import 'package:harness/screens/swarm_screen.dart';
+import 'package:harness/shared/theme/app_theme.dart' as grid;
+import 'package:harness/state/app_state.dart';
+import 'package:harness/state/workspace_chrome.dart';
+import 'package:harness/terminal/terminal_binary.dart';
+import 'package:harness/web/shell/web_chrome.dart';
+import 'package:harness/web/shell/web_workspace.dart';
+import 'package:harness/widgets/swarm_switcher.dart';
+import 'package:harness/widgets/pane_grid.dart';
+import 'package:harness/widgets/terminal_panel.dart';
+
+import 'swarm_screen_test.dart' show terminal;
+import 'swarm_state_test.dart' show createApp;
+
+Future<void> _mount(
+ WidgetTester tester,
+ AppNotifier app, {
+ WorkspaceChrome? chrome,
+ Size size = const Size(1280, 800),
+}) async {
+ tester.view.devicePixelRatio = 1;
+ tester.view.physicalSize = size;
+ addTearDown(tester.view.reset);
+ await tester.pumpWidget(
+ MaterialApp(
+ theme: grid.buildAppTheme(brightness: Brightness.dark),
+ home: SwarmScreen(notifier: app, chrome: chrome),
+ ),
+ );
+ await tester.pump(const Duration(milliseconds: 100));
+}
+
+/// A widget the workspace draws: a pane grid needs a pane.
+BuildContext _insideWorkspace(WidgetTester tester) =>
+ tester.element(find.byType(PaneGrid).first);
+
+AppNotifier _appWithPane() {
+ final app = createApp(connected: true);
+ app.adoptSessionForTest(terminal('a0', <TerminalBinaryFrame>[]));
+ return app;
+}
+
+WorkspaceChrome _hostChrome({bool flags = false}) => WorkspaceChrome(
+ leadingWidth: (_) => 0,
+ leading: (_, _) => const SizedBox.shrink(),
+ menuOnEveryTab: flags,
+ labelsPaneStatus: flags,
+ compactPaneHeader: flags,
+ compactBelow: 720,
+);
+
+void main() {
+ testWidgets('a widget under the workspace reads the chrome it was given', (
+ tester,
+ ) async {
+ final app = _appWithPane();
+ addTearDown(app.dispose);
+ final chrome = _hostChrome();
+
+ await _mount(tester, app, chrome: chrome);
+
+ final context = _insideWorkspace(tester);
+ expect(WorkspaceChromeScope.maybeOf(context), same(chrome));
+ expect(WorkspaceChrome.of(context), same(chrome));
+ await tester.pumpWidget(const SizedBox.shrink());
+ });
+
+ testWidgets('Desktop, with no host chrome, keeps every new switch off', (
+ tester,
+ ) async {
+ final app = _appWithPane();
+ addTearDown(app.dispose);
+
+ await _mount(tester, app);
+
+ final context = _insideWorkspace(tester);
+ expect(WorkspaceChromeScope.maybeOf(context), isNull);
+ final chrome = WorkspaceChrome.of(context);
+ expect(chrome.menuOnEveryTab, isFalse);
+ expect(chrome.labelsPaneStatus, isFalse);
+ expect(chrome.compactPaneHeader, isFalse);
+ expect(chrome.compactPaneHeaderAt(320), isFalse);
+ await tester.pumpWidget(const SizedBox.shrink());
+ });
+
+ test('a host chrome that names none of them leaves them off', () {
+ final chrome = WorkspaceChrome(
+ leadingWidth: (_) => 0,
+ leading: (_, _) => const SizedBox.shrink(),
+ );
+
+ expect(chrome.menuOnEveryTab, isFalse);
+ expect(chrome.labelsPaneStatus, isFalse);
+ expect(chrome.compactPaneHeader, isFalse);
+ });
+
+ test('the web chrome turns all three on', () {
+ final app = createApp();
+ addTearDown(app.dispose);
+
+ final chrome = webWorkspaceChrome(app);
+
+ expect(chrome.menuOnEveryTab, isTrue);
+ expect(chrome.labelsPaneStatus, isTrue);
+ expect(chrome.compactPaneHeader, isTrue);
+ });
+
+ test('the compact pane header applies only below compactBelow', () {
+ final chrome = _hostChrome(flags: true);
+
+ expect(chrome.compactPaneHeaderAt(390), isTrue);
+ expect(chrome.compactPaneHeaderAt(719), isTrue);
+ expect(chrome.compactPaneHeaderAt(720), isFalse);
+ expect(chrome.compactPaneHeaderAt(1440), isFalse);
+ });
+
+ testWidgets('a new chrome reaches the workspace without remounting it', (
+ tester,
+ ) async {
+ final app = _appWithPane();
+ addTearDown(app.dispose);
+ await _mount(tester, app, chrome: _hostChrome());
+ final terminal = tester.state(find.byType(TerminalPanel).first);
+
+ final next = _hostChrome(flags: true);
+ await _mount(tester, app, chrome: next);
+
+ expect(tester.state(find.byType(TerminalPanel).first), same(terminal));
+ expect(WorkspaceChrome.of(_insideWorkspace(tester)), same(next));
+ await tester.pumpWidget(const SizedBox.shrink());
+ });
+
+ testWidgets('a widget in the search overlay reads the chrome it was given', (
+ tester,
+ ) async {
+ final app = _appWithPane();
+ addTearDown(app.dispose);
+ final chrome = _hostChrome();
+ await _mount(tester, app, chrome: chrome);
+
+ await tester.tap(find.byKey(const ValueKey('swarm-search-button')));
+ await tester.pump(const Duration(milliseconds: 200));
+ await tester.pump();
+
+ final results = find.byType(SwarmSearchResults);
+ expect(results, findsOneWidget);
+ expect(WorkspaceChrome.of(tester.element(results)), same(chrome));
+ await tester.pumpWidget(const SizedBox.shrink());
+ });
+
+ test('the web chrome is made once per app', () {
+ final app = createApp();
+ final other = createApp();
+ addTearDown(app.dispose);
+ addTearDown(other.dispose);
+
+ expect(webWorkspaceChrome(app), same(webWorkspaceChrome(app)));
+ expect(webWorkspaceChrome(other), isNot(same(webWorkspaceChrome(app))));
+ });
+
+ testWidgets('an app notification does not hand the workspace a new chrome', (
+ tester,
+ ) async {
+ final app = _appWithPane();
+ addTearDown(app.dispose);
+ tester.view.devicePixelRatio = 1;
+ tester.view.physicalSize = const Size(1280, 800);
+ addTearDown(tester.view.reset);
+ Widget page() => MaterialApp(
+ theme: grid.buildAppTheme(brightness: Brightness.dark),
+ home: WebWorkspace(app: app),
+ );
+ await tester.pumpWidget(page());
+ await tester.pump(const Duration(milliseconds: 100));
+ final before = WorkspaceChrome.of(_insideWorkspace(tester));
+
+ // What RootShell does on every AppNotifier notification: build the
+ // signed-in screen again.
+ app.notifyListeners();
+ await tester.pumpWidget(page());
+ await tester.pump();
+
+ expect(WorkspaceChrome.of(_insideWorkspace(tester)), same(before));
+ await tester.pumpWidget(const SizedBox.shrink());
+ });
+}
diff --git a/desktop/tool/super_tab_mobile_fixture.dart b/desktop/tool/super_tab_mobile_fixture.dart
index d74d8fab1..433ea4afd 100644
--- a/desktop/tool/super_tab_mobile_fixture.dart
+++ b/desktop/tool/super_tab_mobile_fixture.dart
@@ -1,7 +1,8 @@
/// No-login review fixture for the Super Tab on mobile web.
///
/// Build for web with `--dart-define=HARNESS_TEST=true` and open with a
-/// `?scenario=rich|empty|one|viewer|offline` and optional `?group=<id>` query.
+/// `?scenario=rich|empty|one|viewer|offline` and optional `?group=<id>` and
+/// `?theme=dark` (Graphite; light Paper is the default) queries.
/// This is a review-only target: it renders the real [SuperTabView] against an
/// in-memory fake backend and never touches a real account or production data.
library;
@@ -10,6 +11,7 @@ import 'dart:async';
import 'package:flutter/material.dart';
import 'package:harness/shared/theme/app_theme.dart' as grid;
+import 'package:harness/shared/theme/color_palette.dart';
import 'package:harness/super_tabs/controller.dart';
import 'package:harness/super_tabs/view.dart';
@@ -21,6 +23,13 @@ Future<void> main() async {
WidgetsBinding.instance.ensureSemantics();
final query = Uri.base.queryParameters;
final scenario = query['scenario'] ?? 'rich';
+ // The design tokens follow the palette, not the Material theme: set both,
+ // as the app's root does, or a light theme draws dark-palette ink.
+ final palette = query['theme'] == 'dark'
+ ? HarnessPalette.graphite
+ : HarnessPalette.paper;
+ grid.AppTheme.palette.value = palette;
+ grid.AppTheme.brightness.value = palette.brightness;
final server = _seed(scenario);
final controller = server.controller(
account: scenario == 'viewer' ? 'viewer' : 'owner',
@@ -38,7 +47,7 @@ Future<void> main() async {
runApp(
MaterialApp(
debugShowCheckedModeBanner: false,
- theme: grid.buildAppTheme(brightness: Brightness.light),
+ theme: grid.buildAppTheme(brightness: palette.brightness),
home: _Fixture(controller: controller),
),
);
diff --git a/desktop/tool/web_ux/capture.mjs b/desktop/tool/web_ux/capture.mjs
new file mode 100644
index 000000000..74bd41dc7
--- /dev/null
+++ b/desktop/tool/web_ux/capture.mjs
@@ -0,0 +1,148 @@
+// Screenshots every flow in flows/ at the audit's widths.
+//
+// node tool/web_ux/capture.mjs <build-dir> <out-dir> [flow ...]
+//
+// <build-dir> is `flutter build web --no-web-resources-cdn
+// --dart-define=HARNESS_TEST=true -t tool/web_ux_fixture.dart` (the release
+// also builds without the CDN). It is served here with an index fallback, so
+// /s/… share links reach the app. Phones and the tablet are emulated with
+// touch, a mobile user agent and the platform their browser reports, so
+// Flutter sees iOS or Android; the computer width uses a mouse. Every request
+// that leaves the served origin is blocked and listed in blocked.json, so a
+// fixture can never reach a backend; only Google's font CDN, which the engine
+// falls back to for missing glyphs in production too, is let through.
+// Run from desktop/ with PLAYWRIGHT_DIR set (see playwright.mjs). CHROME_PATH
+// uses an already-installed Chromium; WIDTHS=360,1440 captures only some widths
+// (separate runs can go in parallel); FIXTURE=super-tab captures the Super Tab
+// flows from a build of tool/super_tab_mobile_fixture.dart.
+import { chromium, devices } from './playwright.mjs';
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { loadFlows } from './load-flows.mjs';
+import { serve } from './serve.mjs';
+
+export const VIEWPORTS = [
+ { name: '360', width: 360, height: 740, device: 'Galaxy S9+', platform: 'Linux armv8l', themes: ['dark'] },
+ { name: '390', width: 390, height: 844, device: 'iPhone 13', platform: 'iPhone', themes: ['dark', 'light'] },
+ { name: '768', width: 768, height: 1024, device: 'iPad Mini', platform: 'iPad', themes: ['dark'] },
+ { name: '1440', width: 1440, height: 900, device: null, platform: null, themes: ['dark', 'light'] },
+];
+
+const COMPACT_BELOW = 720;
+
+export async function contextFor(browser, viewport, theme, origin, blocked) {
+ const base = viewport.device ? { ...devices[viewport.device] } : {};
+ const context = await browser.newContext({
+ ...base,
+ viewport: { width: viewport.width, height: viewport.height },
+ deviceScaleFactor: 1,
+ colorScheme: theme,
+ });
+ if (viewport.platform) {
+ await context.addInitScript((platform) => {
+ Object.defineProperty(navigator, 'platform', { get: () => platform });
+ }, viewport.platform);
+ }
+ await context.route('**/*', (route) => {
+ const url = route.request().url();
+ if (url.startsWith(origin) || url.startsWith('https://fonts.gstatic.com/')) {
+ return route.continue();
+ }
+ blocked.add(url);
+ return route.abort();
+ });
+ return context;
+}
+
+export function urlFor(origin, flow, theme) {
+ const [path, hash] = (flow.path ?? '/').split('#');
+ const url = new URL(path, origin);
+ url.searchParams.set('scenario', flow.scenario);
+ url.searchParams.set('theme', theme);
+ return hash ? `${url}#${hash}` : `${url}`;
+}
+
+/// Flutter is up once its view is in the page, the first frames are done and
+/// the network is quiet: glyphs the bundled fonts lack (●, ✓) arrive from the
+/// font CDN later, and a capture taken before them drops those characters.
+export async function settle(page) {
+ await page.waitForSelector('flutter-view', { timeout: 30000 });
+ await page.waitForLoadState('networkidle');
+ await page.waitForTimeout(1500);
+}
+
+export async function runStep(page, [kind, target], touch) {
+ const press = touch ? 'tap' : 'click';
+ const button = (exact) => page.getByRole('button', { name: target, exact }).first();
+ switch (kind) {
+ case 'click': return button(false)[press]({ timeout: 5000 });
+ case 'exact': return button(true)[press]({ timeout: 5000 });
+ case 'text': return page.getByText(target).first()[press]({ timeout: 5000 });
+ case 'rclick':
+ return page.getByRole('button', { name: target }).first().click({ button: 'right', timeout: 5000 });
+ case 'key': return page.keyboard.press(target);
+ default: throw new Error(`unknown step ${kind}`);
+ }
+}
+
+function stepsFor(flow, viewport) {
+ const compact = viewport.width < COMPACT_BELOW;
+ if (flow.only === 'wide' && compact) return null;
+ if (flow.only === 'compact' && !compact) return null;
+ return (compact ? flow.compact : flow.wide) ?? flow.steps ?? [];
+}
+
+async function shoot(context, origin, flow, viewport, theme, outDir) {
+ const steps = stepsFor(flow, viewport);
+ if (!steps) return null;
+ const page = await context.newPage();
+ const errors = [];
+ page.on('pageerror', (e) => errors.push(String(e).split('\n')[0]));
+ const shot = `screens/${flow.name}/${viewport.name}-${theme}.png`;
+ let failed = null;
+ try {
+ await page.goto(urlFor(origin, flow, theme));
+ await settle(page);
+ for (const step of steps) {
+ await runStep(page, step, Boolean(viewport.device));
+ await page.waitForTimeout(700);
+ }
+ } catch (e) {
+ failed = String(e).split('\n')[0];
+ }
+ mkdirSync(join(outDir, 'screens', flow.name), { recursive: true });
+ await page.screenshot({ path: join(outDir, shot) });
+ await page.close();
+ return { flow: flow.name, width: viewport.name, theme, shot, failed, errors };
+}
+
+async function main() {
+ const [buildDir, outDir, ...only] = process.argv.slice(2);
+ const fixture = process.env.FIXTURE ?? 'app';
+ const all = await loadFlows(fixture);
+ const flows = only.length ? all.filter((f) => only.includes(f.name)) : all;
+ const server = await serve(buildDir);
+ const origin = server.origin;
+ const browser = await chromium.launch({ executablePath: process.env.CHROME_PATH });
+ const blocked = new Set();
+ const results = [];
+ const widths = process.env.WIDTHS?.split(',');
+ for (const viewport of VIEWPORTS.filter((v) => !widths || widths.includes(v.name))) {
+ for (const theme of viewport.themes) {
+ const context = await contextFor(browser, viewport, theme, origin, blocked);
+ for (const flow of flows) {
+ const result = await shoot(context, origin, flow, viewport, theme, outDir);
+ if (result) results.push(result);
+ if (result?.failed) console.error(`${flow.name} ${viewport.name}-${theme}: ${result.failed}`);
+ }
+ await context.close();
+ }
+ }
+ const tag = `${fixture === 'app' ? '' : `-${fixture}`}${widths ? `-${widths.join('-')}` : ''}`;
+ writeFileSync(join(outDir, `captures${tag}.json`), JSON.stringify(results, null, 2));
+ writeFileSync(join(outDir, `blocked${tag}.json`), JSON.stringify([...blocked], null, 2));
+ await browser.close();
+ server.close();
+}
+
+if (import.meta.url === `file://${process.argv[1]}`) await main();
diff --git a/desktop/tool/web_ux/checks.mjs b/desktop/tool/web_ux/checks.mjs
new file mode 100644
index 000000000..5b38725f3
--- /dev/null
+++ b/desktop/tool/web_ux/checks.mjs
@@ -0,0 +1,243 @@
+// Cross-cutting interaction checks over the fixture build.
+//
+// node tool/web_ux/checks.mjs <build-dir> <out-dir>
+//
+// 1. Tap targets: on the phone widths, every control the accessibility tree
+// exposes whose box is under 44 px in either direction.
+// 2. Scrolling: a mouse wheel (vertical and shift/horizontal) and a touch
+// swipe over each scrolling area; the area "scrolls" when its pixels change.
+// 3. Hover and focus: a control's pixels with and without the mouse over it,
+// and the page after Tab presses, to see whether a focus ring shows.
+// Results go to <out-dir>/checks.json, with before/after images under
+// <out-dir>/checks/.
+import { chromium } from './playwright.mjs';
+import { createHash } from 'node:crypto';
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { loadFlows } from './load-flows.mjs';
+import { VIEWPORTS, contextFor, runStep, settle, urlFor } from './capture.mjs';
+import { serve } from './serve.mjs';
+
+const FLOWS = await loadFlows();
+const flow = (name) => FLOWS.find((f) => f.name === name);
+const PHONES = VIEWPORTS.filter((v) => v.width < 720);
+const COMPUTER = VIEWPORTS.find((v) => v.name === '1440');
+
+// Flows whose controls are measured for tap size on phones.
+const TAP_FLOWS = [
+ 'signin', 'first-machine', 'computers', 'workspace', 'app-menu', 'tab-switcher',
+ 'footer-menu', 'notifications', 'open-harness', 'machines', 'all-commands',
+ 'appearance', 'split-pane', 'store', 'settings', 'settings-notifications',
+ 'settings-keyboard-shortcuts', 'new-tab', 'error-banner', 'new-device', 'link-password',
+];
+
+// Scrolling areas: the flow that shows one, and where it is.
+const SCROLLERS = [
+ // The active tab is the last, so the row starts scrolled to its end: wheel back.
+ { flow: 'many-tabs', area: 'tab row', box: [60, 0, 1300, 40], wheel: [0, -300] },
+ { flow: 'many-tabs', area: 'tab row (shift+wheel)', box: [60, 0, 1300, 40], wheel: [0, -300], shift: true },
+ { flow: 'many-tabs', area: 'tab row (trackpad sideways)', box: [60, 0, 1300, 40], wheel: [-300, 0] },
+ { flow: 'store', area: 'store page', box: [120, 60, 1300, 860], wheel: [0, 600] },
+ { flow: 'open-harness', area: 'picker filter chips', box: [320, 330, 1100, 360], wheel: [0, 200] },
+ { flow: 'all-commands', area: 'command list', box: [320, 380, 720, 880], wheel: [0, 400] },
+ { flow: 'appearance', area: 'appearance panel', box: [1230, 120, 1440, 900], wheel: [0, 500] },
+ { flow: 'settings-keyboard-shortcuts', area: 'shortcut list', box: [270, 100, 1440, 900], wheel: [0, 600] },
+ { flow: 'split-pane', area: 'new harness form', box: [300, 150, 1140, 880], wheel: [0, 400] },
+];
+
+// Phone areas scrolled with a finger.
+const SWIPES = [
+ { flow: 'tab-switcher', area: 'tab switcher list', from: [195, 600], to: [195, 250] },
+ { flow: 'machines', area: 'machines list', from: [195, 600], to: [195, 250] },
+ { flow: 'app-menu', area: 'app menu', from: [120, 500], to: [120, 200] },
+ { flow: 'store', area: 'store page', from: [195, 650], to: [195, 200] },
+ { flow: 'settings', area: 'settings list', from: [195, 650], to: [195, 200] },
+ { flow: 'settings-keyboard-shortcuts', area: 'shortcut list', from: [195, 650], to: [195, 200] },
+ { flow: 'all-commands', area: 'command list', from: [195, 650], to: [195, 250] },
+ { flow: 'first-machine', area: 'connect page', from: [195, 650], to: [195, 200] },
+ { flow: 'signin', area: 'sign-in page', from: [195, 650], to: [195, 200] },
+];
+
+// Controls hovered with the mouse at 1440.
+const HOVERS = [
+ { flow: 'workspace', name: 'New Tab' },
+ { flow: 'workspace', name: 'Open Harness' },
+ { flow: 'workspace', name: 'Close Pane' },
+ { flow: 'workspace', name: 'Agent: Claude Code' },
+ { flow: 'workspace', name: 'Click to open Harness Monitor' },
+ { flow: 'many-tabs', name: 'docs' },
+ { flow: 'app-menu', name: 'Settings', exact: true },
+ { flow: 'signin', name: 'Continue with Google' },
+ { flow: 'first-machine', name: 'Download app' },
+ { flow: 'settings', name: 'Privacy', exact: true },
+];
+
+const digest = (buffer) => createHash('sha1').update(buffer).digest('hex');
+const clip = ([x0, y0, x1, y1]) => ({ x: x0, y: y0, width: x1 - x0, height: y1 - y0 });
+
+/// A page showing flow [name], or a rejection when the flow is unknown or a
+/// step cannot be clicked; the page is closed before rejecting.
+async function open(context, origin, name, viewport, theme = 'dark') {
+ const f = flow(name);
+ if (!f) throw new Error(`no flow "${name}"`);
+ const page = await context.newPage();
+ try {
+ await page.goto(urlFor(origin, f, theme));
+ await settle(page);
+ const compact = viewport.width < 720;
+ for (const step of (compact ? f.compact : f.wide) ?? f.steps ?? []) {
+ await runStep(page, step, Boolean(viewport.device));
+ await page.waitForTimeout(700);
+ }
+ return page;
+ } catch (error) {
+ await page.close();
+ throw error;
+ }
+}
+
+async function tapTargets(browser, origin, blocked) {
+ const out = [];
+ for (const viewport of PHONES) {
+ const context = await contextFor(browser, viewport, 'dark', origin, blocked);
+ for (const name of TAP_FLOWS) {
+ const f = flow(name);
+ if (f?.only === 'wide') continue;
+ const page = await open(context, origin, name, viewport).catch(() => null);
+ if (!page) { out.push({ flow: name, width: viewport.name, small: null, note: 'flow did not open' }); continue; }
+ const small = await page.evaluate(() =>
+ Array.from(document.querySelectorAll('flt-semantics[flt-tappable], flt-semantics[role="button"], flt-semantics[role="link"], flt-semantics[role="checkbox"], flt-semantics[role="switch"], flt-semantics[role="tab"], flt-semantics[role="radio"]'))
+ .map((e) => {
+ const r = e.getBoundingClientRect();
+ const label = (e.getAttribute('aria-label') || e.textContent || '').split('\n')[0].trim().slice(0, 60);
+ return { label, w: Math.round(r.width), h: Math.round(r.height), x: Math.round(r.x), y: Math.round(r.y) };
+ })
+ .filter((c) => c.w > 0 && c.h > 0 && (c.w < 44 || c.h < 44) && c.y < window.innerHeight && c.y + c.h > 0));
+ out.push({ flow: name, width: viewport.name, small });
+ await page.close();
+ }
+ await context.close();
+ }
+ return out;
+}
+
+async function wheels(browser, origin, blocked, dir) {
+ const context = await contextFor(browser, COMPUTER, 'dark', origin, blocked);
+ const out = [];
+ for (const s of SCROLLERS) {
+ const page = await open(context, origin, s.flow, COMPUTER).catch(() => null);
+ if (!page) { out.push({ ...s, scrolled: null, note: 'flow did not open' }); continue; }
+ const [x0, y0, x1, y1] = s.box;
+ await page.mouse.move((x0 + x1) / 2, (y0 + y1) / 2);
+ const before = await page.screenshot({ clip: clip(s.box) });
+ if (s.shift) await page.keyboard.down('Shift');
+ await page.mouse.wheel(...s.wheel);
+ if (s.shift) await page.keyboard.up('Shift');
+ await page.waitForTimeout(800);
+ const after = await page.screenshot({ clip: clip(s.box) });
+ const file = `${s.flow}-${s.area.replace(/\W+/g, '-')}`;
+ writeFileSync(join(dir, `${file}-before.png`), before);
+ writeFileSync(join(dir, `${file}-after.png`), after);
+ out.push({ ...s, scrolled: digest(before) !== digest(after), images: `checks/${file}-{before,after}.png` });
+ await page.close();
+ }
+ await context.close();
+ return out;
+}
+
+async function swipes(browser, origin, blocked, dir) {
+ const viewport = VIEWPORTS.find((v) => v.name === '390');
+ const context = await contextFor(browser, viewport, 'dark', origin, blocked);
+ const out = [];
+ for (const s of SWIPES) {
+ const page = await open(context, origin, s.flow, viewport).catch(() => null);
+ if (!page) { out.push({ ...s, scrolled: null, note: 'flow did not open' }); continue; }
+ const before = await page.screenshot();
+ const cdp = await context.newCDPSession(page);
+ await cdp.send('Input.synthesizeScrollGesture', {
+ x: s.from[0], y: s.from[1], xDistance: s.to[0] - s.from[0], yDistance: s.to[1] - s.from[1],
+ gestureSourceType: 'touch', speed: 800,
+ });
+ await page.waitForTimeout(800);
+ const after = await page.screenshot();
+ const file = `swipe-${s.flow}`;
+ writeFileSync(join(dir, `${file}-before.png`), before);
+ writeFileSync(join(dir, `${file}-after.png`), after);
+ out.push({ ...s, scrolled: digest(before) !== digest(after), images: `checks/${file}-{before,after}.png` });
+ await page.close();
+ }
+ await context.close();
+ return out;
+}
+
+async function hovers(browser, origin, blocked, dir) {
+ const context = await contextFor(browser, COMPUTER, 'dark', origin, blocked);
+ const out = [];
+ for (const h of HOVERS) {
+ const page = await open(context, origin, h.flow, COMPUTER).catch(() => null);
+ if (!page) { out.push({ ...h, changed: null, note: 'flow did not open' }); continue; }
+ const target = page.getByRole('button', { name: h.name, exact: Boolean(h.exact) }).first();
+ const box = await target.boundingBox().catch(() => null);
+ if (!box) { out.push({ ...h, changed: null, note: 'not found' }); await page.close(); continue; }
+ const area = { x: Math.max(0, box.x - 8), y: Math.max(0, box.y - 8), width: box.width + 16, height: box.height + 16 };
+ await page.mouse.move(5, 895);
+ await page.waitForTimeout(300);
+ const before = await page.screenshot({ clip: area });
+ await page.mouse.move(box.x + box.width / 2, box.y + box.height / 2);
+ await page.waitForTimeout(600);
+ const after = await page.screenshot({ clip: area });
+ const cursor = await page.evaluate(() => getComputedStyle(document.querySelector('flutter-view')).cursor);
+ const file = `hover-${h.flow}-${h.name.replace(/\W+/g, '-')}`;
+ writeFileSync(join(dir, `${file}-before.png`), before);
+ writeFileSync(join(dir, `${file}-after.png`), after);
+ out.push({ ...h, changed: digest(before) !== digest(after), cursor, images: `checks/${file}-{before,after}.png` });
+ await page.close();
+ }
+ await context.close();
+ return out;
+}
+
+async function focus(browser, origin, blocked, dir) {
+ const context = await contextFor(browser, COMPUTER, 'dark', origin, blocked);
+ const out = [];
+ for (const name of ['signin', 'first-machine', 'workspace', 'settings']) {
+ const page = await open(context, origin, name, COMPUTER).catch(() => null);
+ if (!page) { out.push({ flow: name, active: null, note: 'flow did not open' }); continue; }
+ for (let i = 1; i <= 4; i++) {
+ await page.keyboard.press('Tab');
+ await page.waitForTimeout(300);
+ }
+ const file = `focus-${name}.png`;
+ await page.screenshot({ path: join(dir, file) });
+ const active = await page.evaluate(() => {
+ const a = document.activeElement;
+ return a ? `${a.tagName.toLowerCase()} ${a.getAttribute('aria-label') || a.textContent?.slice(0, 40) || ''}` : null;
+ });
+ out.push({ flow: name, afterTabs: 4, active, image: `checks/${file}` });
+ await page.close();
+ }
+ await context.close();
+ return out;
+}
+
+async function main() {
+ const [buildDir, outDir] = process.argv.slice(2);
+ const dir = join(outDir, 'checks');
+ mkdirSync(dir, { recursive: true });
+ const server = await serve(buildDir);
+ const browser = await chromium.launch({ executablePath: process.env.CHROME_PATH });
+ const blocked = new Set();
+ const results = {
+ tapTargets: await tapTargets(browser, server.origin, blocked),
+ wheel: await wheels(browser, server.origin, blocked, dir),
+ swipe: await swipes(browser, server.origin, blocked, dir),
+ hover: await hovers(browser, server.origin, blocked, dir),
+ focus: await focus(browser, server.origin, blocked, dir),
+ blocked: [...blocked],
+ };
+ writeFileSync(join(outDir, 'checks.json'), JSON.stringify(results, null, 2));
+ await browser.close();
+ server.close();
+}
+
+await main();
diff --git a/desktop/tool/web_ux/flows/base.mjs b/desktop/tool/web_ux/flows/base.mjs
new file mode 100644
index 000000000..c9fac56ab
--- /dev/null
+++ b/desktop/tool/web_ux/flows/base.mjs
@@ -0,0 +1,16 @@
+// Flows more than one fix group reviews.
+//
+// Fix group: none (shared). Each group keeps its flows here, so parallel groups never
+// edit the same file; load-flows.mjs reads every file in this folder.
+import { menu } from './steps.mjs';
+
+export const FLOWS = [
+ { name: 'workspace', scenario: 'workspace' },
+ { name: 'notifications', scenario: 'workspace', steps: [['exact', 'Notifications']] },
+ { name: 'open-harness', scenario: 'workspace', steps: [['exact', 'Open Harness']] },
+ { name: 'models', scenario: 'workspace', steps: menu('Models') },
+ { name: 'history', scenario: 'workspace', steps: menu('History') },
+ { name: 'appearance', scenario: 'workspace', steps: menu('Appearance') },
+ { name: 'add-phone', scenario: 'workspace', only: 'wide', steps: [['exact', 'Add Phone']] },
+ { name: 'harness-monitor', scenario: 'workspace', only: 'wide', steps: [['click', 'Click to open Harness Monitor']] },
+];
diff --git a/desktop/tool/web_ux/flows/first_computer.mjs b/desktop/tool/web_ux/flows/first_computer.mjs
new file mode 100644
index 000000000..ae23116e8
--- /dev/null
+++ b/desktop/tool/web_ux/flows/first_computer.mjs
@@ -0,0 +1,12 @@
+// Flows for the first-computer page and an offline workspace.
+//
+// Fix group: 4, first computer and offline workspace. Each group keeps its flows here, so parallel groups never
+// edit the same file; load-flows.mjs reads every file in this folder.
+export const FLOWS = [
+ { name: 'first-machine', scenario: 'first-machine' },
+ { name: 'first-machine-loading', scenario: 'first-machine-loading' },
+ { name: 'link-machine', scenario: 'link-machine' },
+ { name: 'computers', scenario: 'computers' },
+ { name: 'link-password', scenario: 'link-machine', steps: [['exact', 'Connect']] },
+ { name: 'offline-only', scenario: 'offline-only' },
+];
diff --git a/desktop/tool/web_ux/flows/first_load.mjs b/desktop/tool/web_ux/flows/first_load.mjs
new file mode 100644
index 000000000..112a2de18
--- /dev/null
+++ b/desktop/tool/web_ux/flows/first_load.mjs
@@ -0,0 +1,7 @@
+// Flows for start-up; the bundle's load time is load-time.mjs.
+//
+// Fix group: 7, first load. Each group keeps its flows here, so parallel groups never
+// edit the same file; load-flows.mjs reads every file in this folder.
+export const FLOWS = [
+ { name: 'booting', scenario: 'booting' },
+];
diff --git a/desktop/tool/web_ux/flows/menus.mjs b/desktop/tool/web_ux/flows/menus.mjs
new file mode 100644
index 000000000..1c1cbffee
--- /dev/null
+++ b/desktop/tool/web_ux/flows/menus.mjs
@@ -0,0 +1,16 @@
+// Flows for the web menus, tabs, the footer dropdown and Settings' Back.
+//
+// Fix group: 1, web menus, commands and hit sizes. Each group keeps its flows here, so parallel groups never
+// edit the same file; load-flows.mjs reads every file in this folder.
+import { menu } from './steps.mjs';
+
+export const FLOWS = [
+ { name: 'app-menu', scenario: 'workspace', steps: [['exact', 'Menu']] },
+ { name: 'many-tabs', scenario: 'many-tabs' },
+ { name: 'tab-switcher', scenario: 'many-tabs', only: 'compact', steps: [['click', 'Tabs:']] },
+ { name: 'tab-menu', scenario: 'many-tabs', only: 'wide', steps: [['rclick', 'docs']] },
+ { name: 'footer-menu', scenario: 'workspace', only: 'compact', steps: [['click', 'Status:']] },
+ { name: 'all-commands', scenario: 'workspace', steps: menu('All commands') },
+ { name: 'machines', scenario: 'workspace', steps: menu('Machines') },
+ { name: 'settings', scenario: 'workspace', steps: menu('Settings') },
+];
diff --git a/desktop/tool/web_ux/flows/pane.mjs b/desktop/tool/web_ux/flows/pane.mjs
new file mode 100644
index 000000000..546116171
--- /dev/null
+++ b/desktop/tool/web_ux/flows/pane.mjs
@@ -0,0 +1,16 @@
+// Flows for terminal panes, their states and header pickers.
+//
+// Fix group: 3, pane header and states. Each group keeps its flows here, so parallel groups never
+// edit the same file; load-flows.mjs reads every file in this folder.
+export const FLOWS = [
+ { name: 'workspace-one', scenario: 'workspace-one' },
+ { name: 'connecting', scenario: 'connecting' },
+ { name: 'reconnecting', scenario: 'reconnecting' },
+ { name: 'offline', scenario: 'offline' },
+ { name: 'view-only', scenario: 'view-only' },
+ { name: 'opening', scenario: 'opening' },
+ { name: 'taken-over', scenario: 'taken-over' },
+ { name: 'terminal-error', scenario: 'terminal-error' },
+ { name: 'agent-picker', scenario: 'workspace', steps: [['click', 'Agent: ']] },
+ { name: 'model-picker', scenario: 'workspace', steps: [['click', 'Model: ']] },
+];
diff --git a/desktop/tool/web_ux/flows/states.mjs b/desktop/tool/web_ux/flows/states.mjs
new file mode 100644
index 000000000..376d127a2
--- /dev/null
+++ b/desktop/tool/web_ux/flows/states.mjs
@@ -0,0 +1,28 @@
+// Flows for error and empty states, device bands, outside links, Settings pages and the Super Tab.
+//
+// Fix group: 6, error states, bands and copy. Each group keeps its flows here, so parallel groups never
+// edit the same file; load-flows.mjs reads every file in this folder.
+import { settings } from './steps.mjs';
+
+// The Super Tab flows run on tool/super_tab_mobile_fixture.dart (FIXTURE=super-tab).
+const superTab = (name, scenario, more = {}) => ({ fixture: 'super-tab', name, scenario, ...more });
+
+export const FLOWS = [
+ { name: 'error-banner', scenario: 'error-banner' },
+ { name: 'new-device', scenario: 'new-device' },
+ { name: 'shared-link', scenario: 'signin', path: '/s/0b6f6a8e-2c1d-4f3e-9a7b-5d4c3b2a1f00#key=fixture' },
+ { name: 'viewer-incomplete', scenario: 'workspace', path: '/?viewer=1' },
+ { name: 'viewer-page', scenario: 'workspace', path: '/?viewer=1&machine=m1&agent=a1' },
+ ...['Account', 'Appearance', 'Notifications', 'Privacy', 'Usage', 'Routing',
+ 'Tab invites', 'Experimental', 'About'].map(settings),
+ superTab('super-tab', 'rich'),
+ superTab('super-tab-group', 'rich', { path: '/?group=wg-blocked' }),
+ superTab('super-tab-one', 'one'),
+ superTab('super-tab-empty', 'empty'),
+ superTab('super-tab-viewer', 'viewer'),
+ superTab('super-tab-offline', 'offline'),
+ superTab('super-tab-roster', 'rich', { steps: [['click', 'Members and machines']] }),
+ superTab('super-tab-conversations', 'rich', { only: 'compact', steps: [['click', 'Conversations']] }),
+ superTab('super-tab-terminals', 'rich', { steps: [['click', 'Group terminals']] }),
+ superTab('super-tab-pull-requests', 'rich', { steps: [['click', 'Pull requests']] }),
+];
diff --git a/desktop/tool/web_ux/flows/steps.mjs b/desktop/tool/web_ux/flows/steps.mjs
new file mode 100644
index 000000000..93ec6618e
--- /dev/null
+++ b/desktop/tool/web_ux/flows/steps.mjs
@@ -0,0 +1,11 @@
+// Click paths more than one flow file uses.
+
+/// ☰ then a row of the web app menu.
+export const menu = (row) => [['exact', 'Menu'], ['exact', row]];
+
+/// One Settings section, opened from the app menu: flow `settings-<section>`.
+export const settings = (section) => ({
+ name: `settings-${section.toLowerCase().replace(/ /g, '-')}`,
+ scenario: 'workspace',
+ steps: [...menu('Settings'), ['exact', section]],
+});
diff --git a/desktop/tool/web_ux/flows/store.mjs b/desktop/tool/web_ux/flows/store.mjs
new file mode 100644
index 000000000..37dd8d62c
--- /dev/null
+++ b/desktop/tool/web_ux/flows/store.mjs
@@ -0,0 +1,19 @@
+// Flows for the Store and a product page.
+//
+// Fix group: 2, Store on phones. Each group keeps its flows here, so parallel groups never
+// edit the same file; load-flows.mjs reads every file in this folder.
+const toStore = {
+ wide: [['exact', 'Harness Store']],
+ compact: [['exact', 'Menu'], ['exact', 'Store']],
+};
+const claude = ['text', 'Work with Claude directly'];
+
+export const FLOWS = [
+ { name: 'store', scenario: 'workspace', ...toStore },
+ {
+ name: 'store-product',
+ scenario: 'workspace',
+ wide: [...toStore.wide, claude],
+ compact: [...toStore.compact, claude],
+ },
+];
diff --git a/desktop/tool/web_ux/flows/welcome.mjs b/desktop/tool/web_ux/flows/welcome.mjs
new file mode 100644
index 000000000..658e275be
--- /dev/null
+++ b/desktop/tool/web_ux/flows/welcome.mjs
@@ -0,0 +1,18 @@
+// Flows for sign-in, the New tab pages, the New Harness form and the shortcuts page.
+//
+// Fix group: 5, welcome pages, hints and downloads. Each group keeps its flows here, so parallel groups never
+// edit the same file; load-flows.mjs reads every file in this folder.
+import { menu, settings } from './steps.mjs';
+
+export const FLOWS = [
+ { name: 'signin', scenario: 'signin' },
+ { name: 'signin-waiting', scenario: 'signin-waiting' },
+ { name: 'signin-error', scenario: 'signin-error' },
+ { name: 'signin-expired', scenario: 'signin-expired' },
+ { name: 'signin-qr', scenario: 'signin-qr' },
+ { name: 'signin-confirm', scenario: 'signin-confirm' },
+ { name: 'new-tab', scenario: 'workspace', steps: [['exact', 'New Tab']] },
+ { name: 'empty-tab', scenario: 'empty-tab' },
+ { name: 'split-pane', scenario: 'workspace', steps: menu('Split pane') },
+ settings('Keyboard shortcuts'),
+];
diff --git a/desktop/tool/web_ux/load-flows.mjs b/desktop/tool/web_ux/load-flows.mjs
new file mode 100644
index 000000000..32d402bbb
--- /dev/null
+++ b/desktop/tool/web_ux/load-flows.mjs
@@ -0,0 +1,34 @@
+// Every flow in flows/<group>.mjs for one fixture build. A new file in that
+// folder is picked up as it is; a flow name in two files is an error.
+//
+// step: ['click', name] button by accessible name (substring)
+// ['exact', name] button by exact accessible name
+// ['text', text] first element showing that text
+// ['rclick', name] right-click a control
+// ['key', key] a key press
+// `wide` / `compact` steps replace `steps` at >= 720 px / below it; a flow
+// with `only: 'wide'|'compact'` is skipped at the other widths. `fixture`
+// names the build it runs on: 'app' (tool/web_ux_fixture.dart, the default)
+// or 'super-tab' (tool/super_tab_mobile_fixture.dart).
+import { readdirSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const folder = join(dirname(fileURLToPath(import.meta.url)), 'flows');
+
+export async function loadFlows(fixture = 'app') {
+ const all = [];
+ const files = readdirSync(folder).filter((f) => f.endsWith('.mjs') && f !== 'steps.mjs').sort();
+ for (const file of files) {
+ const { FLOWS } = await import(join(folder, file));
+ for (const flow of FLOWS) all.push({ ...flow, group: file.replace(/\.mjs$/, '') });
+ }
+ const seen = new Map();
+ for (const flow of all) {
+ if (seen.has(flow.name)) {
+ throw new Error(`Flow "${flow.name}" is in both ${seen.get(flow.name)} and ${flow.group}`);
+ }
+ seen.set(flow.name, flow.group);
+ }
+ return all.filter((flow) => (flow.fixture ?? 'app') === fixture);
+}
diff --git a/desktop/tool/web_ux/load-time.mjs b/desktop/tool/web_ux/load-time.mjs
new file mode 100644
index 000000000..d2a53df7b
--- /dev/null
+++ b/desktop/tool/web_ux/load-time.mjs
@@ -0,0 +1,127 @@
+// First load of a release build of the web app, as a new visitor sees it.
+//
+// node tool/web_ux/load-time.mjs <release-build-dir> [screenshot-dir]
+//
+// <release-build-dir> is `flutter build web --release --no-wasm-dry-run
+// --no-web-resources-cdn --base-href=/harness-web/` (scripts/build-web-release.sh
+// without packaging). It is served at /harness-web/ with gzip, like a static
+// host, with every request off the page blocked, so the app stops at the
+// sign-in page. Each profile loads with an empty cache three times; the
+// median is reported: time until Flutter's view is in the page, time until
+// the screen stops changing (the sign-in page drawn; a release build has no
+// accessibility tree to wait on), and bytes transferred. The last screen of
+// each profile is saved beside the results so the end state can be checked.
+import { chromium } from './playwright.mjs';
+import { createServer } from 'node:http';
+import { readFile } from 'node:fs/promises';
+import { extname, join, normalize } from 'node:path';
+import { gzipSync } from 'node:zlib';
+import { createHash } from 'node:crypto';
+import { writeFileSync } from 'node:fs';
+
+const TYPES = {
+ '.html': 'text/html', '.js': 'text/javascript', '.json': 'application/json',
+ '.wasm': 'application/wasm', '.png': 'image/png', '.ttf': 'font/ttf',
+ '.otf': 'font/otf', '.webp': 'image/webp', '.jpg': 'image/jpeg', '.bin': 'application/octet-stream',
+};
+
+const PROFILES = [
+ { name: 'computer, cable', viewport: { width: 1440, height: 900 }, network: null, cpu: 1 },
+ // Lighthouse's mobile preset: 1.6 Mbps down, 750 kbps up, 150 ms RTT, 4x CPU.
+ {
+ name: 'phone, slow 4G',
+ viewport: { width: 390, height: 844 },
+ network: { latency: 150, downloadThroughput: 1.6e6 / 8, uploadThroughput: 750e3 / 8 },
+ cpu: 4,
+ },
+ // A good phone connection: 9 Mbps down, 40 ms RTT, 2x CPU.
+ {
+ name: 'phone, fast 4G',
+ viewport: { width: 390, height: 844 },
+ network: { latency: 40, downloadThroughput: 9e6 / 8, uploadThroughput: 1.5e6 / 8 },
+ cpu: 2,
+ },
+];
+
+function serve(root) {
+ const cache = new Map();
+ const server = createServer(async (req, res) => {
+ let path = normalize(decodeURIComponent(new URL(req.url, 'http://x').pathname));
+ if (!path.startsWith('/harness-web/')) { res.writeHead(404); return res.end(); }
+ path = path.slice('/harness-web/'.length) || 'index.html';
+ const file = join(root, path);
+ let body = cache.get(file);
+ if (!body) {
+ const raw = await readFile(file).catch(() => readFile(join(root, 'index.html')));
+ body = gzipSync(raw, { level: 6 });
+ cache.set(file, body);
+ }
+ res.writeHead(200, { 'content-type': TYPES[extname(file)] ?? 'text/html', 'content-encoding': 'gzip' });
+ res.end(body);
+ });
+ return new Promise((resolve) => server.listen(0, '127.0.0.1', () =>
+ resolve({ origin: `http://127.0.0.1:${server.address().port}`, close: () => server.close() })));
+}
+
+/// When the page last changed, once it has held still for [quietMs]. A page
+/// that keeps animating is cut off after [limitMs] and reported as such.
+async function settled(page, start, quietMs = 2000, limitMs = 120000) {
+ let last = null;
+ let changedAt = Date.now();
+ for (;;) {
+ const shot = await page.screenshot({ type: 'jpeg', quality: 40 });
+ const hash = createHash('sha1').update(shot).digest('hex');
+ if (hash !== last) { last = hash; changedAt = Date.now(); }
+ if (Date.now() - changedAt >= quietMs) return { at: changedAt - start, shot };
+ if (Date.now() - start >= limitMs) return { at: null, shot };
+ await page.waitForTimeout(100);
+ }
+}
+
+async function once(browser, origin, profile) {
+ const context = await browser.newContext({ viewport: profile.viewport, deviceScaleFactor: 1 });
+ await context.route('**/*', (route) =>
+ route.request().url().startsWith(origin) ? route.continue() : route.abort());
+ const page = await context.newPage();
+ const cdp = await context.newCDPSession(page);
+ await cdp.send('Network.enable');
+ await cdp.send('Network.setCacheDisabled', { cacheDisabled: true });
+ if (profile.network) {
+ await cdp.send('Network.emulateNetworkConditions', { offline: false, ...profile.network });
+ }
+ await cdp.send('Emulation.setCPUThrottlingRate', { rate: profile.cpu });
+ let bytes = 0;
+ cdp.on('Network.loadingFinished', (e) => { bytes += e.encodedDataLength; });
+ const start = Date.now();
+ await page.goto(`${origin}/harness-web/`);
+ await page.waitForSelector('flutter-view', { timeout: 180000 });
+ const firstFrame = Date.now() - start;
+ const { at: signIn, shot } = await settled(page, start);
+ await context.close();
+ return { firstFrame, signIn, megabytes: +(bytes / 1e6).toFixed(2), shot };
+}
+
+const median = (xs) => xs.includes(null)
+ ? null
+ : [...xs].sort((a, b) => a - b)[Math.floor(xs.length / 2)];
+
+const [root, shotDir] = process.argv.slice(2);
+const server = await serve(root);
+const browser = await chromium.launch({ executablePath: process.env.CHROME_PATH });
+const results = [];
+for (const profile of PROFILES) {
+ const runs = [];
+ for (let i = 0; i < 3; i++) runs.push(await once(browser, server.origin, profile));
+ if (shotDir) writeFileSync(`${shotDir}/load-${profile.name.replace(/\W+/g, '-')}.jpg`, runs.at(-1).shot);
+ for (const run of runs) delete run.shot;
+ results.push({
+ profile: profile.name,
+ firstFrameMs: median(runs.map((r) => r.firstFrame)),
+ settledMs: median(runs.map((r) => r.signIn)),
+ transferredMB: median(runs.map((r) => r.megabytes)),
+ runs,
+ });
+}
+console.log(JSON.stringify(results, null, 2));
+await browser.close();
+server.close();
diff --git a/desktop/tool/web_ux/playwright.mjs b/desktop/tool/web_ux/playwright.mjs
new file mode 100644
index 000000000..6c68a3fee
--- /dev/null
+++ b/desktop/tool/web_ux/playwright.mjs
@@ -0,0 +1,11 @@
+// Playwright is not a dependency of this repository. Install it once anywhere
+// (`pnpm --dir <folder> add playwright`) and point PLAYWRIGHT_DIR at that
+// folder; without it, Node's normal lookup is used.
+import { createRequire } from 'node:module';
+import { join } from 'node:path';
+
+const from = process.env.PLAYWRIGHT_DIR
+ ? createRequire(join(process.env.PLAYWRIGHT_DIR, 'package.json'))
+ : createRequire(import.meta.url);
+
+export const { chromium, devices } = from('playwright');
diff --git a/desktop/tool/web_ux/scenarios/base.dart b/desktop/tool/web_ux/scenarios/base.dart
new file mode 100644
index 000000000..023d19171
--- /dev/null
+++ b/desktop/tool/web_ux/scenarios/base.dart
@@ -0,0 +1,12 @@
+/// Scenarios more than one fix group reviews.
+///
+/// Fix group: none (shared). Each group keeps its scenarios here, so parallel groups never
+/// edit the same file; `tool/web_ux_scenarios.dart` merges every group's map.
+library;
+
+import '../../web_ux_seed.dart';
+import 'scenario.dart';
+
+final Map<String, WebUxScenario> baseScenarios = {
+ 'workspace': WebUxScenario(() => withPanes(signedIn(), 3)),
+};
diff --git a/desktop/tool/web_ux/scenarios/first_computer.dart b/desktop/tool/web_ux/scenarios/first_computer.dart
new file mode 100644
index 000000000..9980ebea7
--- /dev/null
+++ b/desktop/tool/web_ux/scenarios/first_computer.dart
@@ -0,0 +1,31 @@
+/// Scenarios for the first-computer page and an offline workspace.
+///
+/// Fix group: 4, first computer and offline workspace. Each group keeps its scenarios here, so parallel groups never
+/// edit the same file; `tool/web_ux_scenarios.dart` merges every group's map.
+library;
+
+import 'package:harness/core/models.dart';
+
+import '../../web_ux_seed.dart';
+import 'scenario.dart';
+
+final Map<String, WebUxScenario> firstComputerScenarios = {
+ 'first-machine': WebUxScenario(() => signedIn()),
+ 'first-machine-loading': WebUxScenario(
+ () => signedIn()..inventoryLoaded = false,
+ ),
+ 'link-machine': WebUxScenario(
+ () => signedIn()..addMachine('m1', 'Studio Mac', needsLink: true),
+ ),
+ 'computers': WebUxScenario(() => withComputers(signedIn())),
+ // The only computer offline: the workspace gives way to "Connect your
+ // computer". `offline` in pane.dart keeps a second computer connected.
+ 'offline-only': WebUxScenario(
+ () => withPanes(
+ signedIn(),
+ 1,
+ status: ConnectionStatus.disconnected,
+ online: false,
+ ),
+ ),
+};
diff --git a/desktop/tool/web_ux/scenarios/first_load.dart b/desktop/tool/web_ux/scenarios/first_load.dart
new file mode 100644
index 000000000..3865a07d2
--- /dev/null
+++ b/desktop/tool/web_ux/scenarios/first_load.dart
@@ -0,0 +1,14 @@
+/// Scenarios for start-up. The bundle's load time is measured by `load-time.mjs`.
+///
+/// Fix group: 7, first load. Each group keeps its scenarios here, so parallel groups never
+/// edit the same file; `tool/web_ux_scenarios.dart` merges every group's map.
+library;
+
+import 'package:harness/state/app_state.dart';
+
+import '../../../test/support/web_ux_app.dart';
+import 'scenario.dart';
+
+final Map<String, WebUxScenario> firstLoadScenarios = {
+ 'booting': WebUxScenario(() => WebUxApp()..status = AppStatus.bootstrapping),
+};
diff --git a/desktop/tool/web_ux/scenarios/menus.dart b/desktop/tool/web_ux/scenarios/menus.dart
new file mode 100644
index 000000000..09ff5ad30
--- /dev/null
+++ b/desktop/tool/web_ux/scenarios/menus.dart
@@ -0,0 +1,12 @@
+/// Scenarios for the web menus, tab menus and tab switcher.
+///
+/// Fix group: 1, web menus, commands and hit sizes. Each group keeps its scenarios here, so parallel groups never
+/// edit the same file; `tool/web_ux_scenarios.dart` merges every group's map.
+library;
+
+import '../../web_ux_seed.dart';
+import 'scenario.dart';
+
+final Map<String, WebUxScenario> menusScenarios = {
+ 'many-tabs': WebUxScenario(() => withTabs(signedIn(), 16)),
+};
diff --git a/desktop/tool/web_ux/scenarios/pane.dart b/desktop/tool/web_ux/scenarios/pane.dart
new file mode 100644
index 000000000..a5192c2c6
--- /dev/null
+++ b/desktop/tool/web_ux/scenarios/pane.dart
@@ -0,0 +1,42 @@
+/// Scenarios for terminal panes and their connection states.
+///
+/// Fix group: 3, pane header and states. Each group keeps its scenarios here, so parallel groups never
+/// edit the same file; `tool/web_ux_scenarios.dart` merges every group's map.
+library;
+
+import 'package:harness/core/models.dart';
+import 'package:harness/terminal/terminal_session.dart';
+
+import '../../web_ux_seed.dart';
+import 'scenario.dart';
+
+final Map<String, WebUxScenario> paneScenarios = {
+ 'workspace-one': WebUxScenario(() => withPanes(signedIn(), 1)),
+ 'connecting': WebUxScenario(
+ () => withPanes(signedIn(), 1, status: ConnectionStatus.connecting),
+ ),
+ 'reconnecting': WebUxScenario(
+ () => withPanes(signedIn(), 1, status: ConnectionStatus.reconnecting),
+ ),
+ // Offline while another computer stays connected, so the pane shows.
+ 'offline': WebUxScenario(
+ () => withPanes(
+ signedIn()..addMachine('m2', 'Build server'),
+ 1,
+ status: ConnectionStatus.disconnected,
+ online: false,
+ ),
+ ),
+ 'view-only': WebUxScenario(
+ () => withPanes(signedIn(), 1, readOnly: true),
+ ),
+ 'opening': WebUxScenario(
+ () => withPanes(signedIn(), 1, session: TerminalSessionStatus.opening),
+ ),
+ 'taken-over': WebUxScenario(
+ () => withPanes(signedIn(), 1, session: TerminalSessionStatus.takenOver),
+ ),
+ 'terminal-error': WebUxScenario(
+ () => withPanes(signedIn(), 1, session: TerminalSessionStatus.error),
+ ),
+};
diff --git a/desktop/tool/web_ux/scenarios/scenario.dart b/desktop/tool/web_ux/scenarios/scenario.dart
new file mode 100644
index 000000000..e75c8baa4
--- /dev/null
+++ b/desktop/tool/web_ux/scenarios/scenario.dart
@@ -0,0 +1,12 @@
+/// One state the web UX fixture can open, by its `?scenario=` name.
+library;
+
+import '../../../test/support/web_ux_app.dart';
+
+class WebUxScenario {
+ const WebUxScenario(this.seed);
+
+ /// The app in the state this scenario reviews. Dialogs and panels are
+ /// opened by clicking, in `tool/web_ux/flows/`.
+ final WebUxApp Function() seed;
+}
diff --git a/desktop/tool/web_ux/scenarios/states.dart b/desktop/tool/web_ux/scenarios/states.dart
new file mode 100644
index 000000000..1182332a9
--- /dev/null
+++ b/desktop/tool/web_ux/scenarios/states.dart
@@ -0,0 +1,28 @@
+/// Scenarios for error banners and device bands.
+///
+/// Fix group: 6, error states, bands and copy. Each group keeps its scenarios here, so parallel groups never
+/// edit the same file; `tool/web_ux_scenarios.dart` merges every group's map.
+library;
+
+import 'package:harness/state/account_devices.dart';
+
+import '../../web_ux_seed.dart';
+import 'scenario.dart';
+
+final Map<String, WebUxScenario> statesScenarios = {
+ 'error-banner': WebUxScenario(
+ () => withPanes(signedIn(), 2)
+ ..error =
+ 'Could not start Claude Code on Studio Mac: the folder no longer exists.',
+ ),
+ 'new-device': WebUxScenario(
+ () => withPanes(signedIn(), 2)
+ ..newDevices.add(
+ const NewDeviceNotice(
+ pub: 'fixture-key',
+ label: "Jamie's iPhone",
+ kind: 'phone',
+ ),
+ ),
+ ),
+};
diff --git a/desktop/tool/web_ux/scenarios/store.dart b/desktop/tool/web_ux/scenarios/store.dart
new file mode 100644
index 000000000..564e4c16f
--- /dev/null
+++ b/desktop/tool/web_ux/scenarios/store.dart
@@ -0,0 +1,9 @@
+/// Scenarios for the Store. Its flows open the Store from `workspace`.
+///
+/// Fix group: 2, Store on phones. Each group keeps its scenarios here, so parallel groups never
+/// edit the same file; `tool/web_ux_scenarios.dart` merges every group's map.
+library;
+
+import 'scenario.dart';
+
+final Map<String, WebUxScenario> storeScenarios = {};
diff --git a/desktop/tool/web_ux/scenarios/welcome.dart b/desktop/tool/web_ux/scenarios/welcome.dart
new file mode 100644
index 000000000..1648c2c1c
--- /dev/null
+++ b/desktop/tool/web_ux/scenarios/welcome.dart
@@ -0,0 +1,43 @@
+/// Scenarios for sign-in and the New tab pages.
+///
+/// Fix group: 5, welcome pages, hints and downloads. Each group keeps its scenarios here, so parallel groups never
+/// edit the same file; `tool/web_ux_scenarios.dart` merges every group's map.
+library;
+
+import 'package:harness/state/app_state.dart';
+
+import '../../../test/support/web_ux_app.dart';
+import '../../web_ux_seed.dart';
+import 'scenario.dart';
+
+final Map<String, WebUxScenario> welcomeScenarios = {
+ 'signin': WebUxScenario(() => WebUxApp()..status = AppStatus.unauthenticated),
+ 'signin-waiting': WebUxScenario(
+ () => WebUxApp()
+ ..status = AppStatus.bootstrapping
+ ..signingIn = true,
+ ),
+ 'signin-error': WebUxScenario(
+ () => WebUxApp()
+ ..status = AppStatus.unauthenticated
+ ..error = 'Could not complete sign-in. Please sign in again.',
+ ),
+ 'signin-expired': WebUxScenario(
+ () => WebUxApp()
+ ..status = AppStatus.unauthenticated
+ ..expired = true,
+ ),
+ 'signin-qr': WebUxScenario(
+ () => WebUxApp()
+ ..status = AppStatus.bootstrapping
+ ..signingIn = true
+ ..pendingQrLink = 'https://harness.autonomous.ai/pair#fixture',
+ ),
+ 'signin-confirm': WebUxScenario(
+ () => WebUxApp()
+ ..status = AppStatus.bootstrapping
+ ..signingIn = true
+ ..pendingConfirmEmail = webUxEmail,
+ ),
+ 'empty-tab': WebUxScenario(() => withPanes(signedIn(), 0)),
+};
diff --git a/desktop/tool/web_ux/serve.mjs b/desktop/tool/web_ux/serve.mjs
new file mode 100644
index 000000000..0c9581612
--- /dev/null
+++ b/desktop/tool/web_ux/serve.mjs
@@ -0,0 +1,30 @@
+// A static server for a Flutter web build that answers unknown paths with
+// index.html, as the production host does for /s/… links.
+import { createServer } from 'node:http';
+import { readFile } from 'node:fs/promises';
+import { extname, join, normalize } from 'node:path';
+
+const TYPES = {
+ '.html': 'text/html', '.js': 'text/javascript', '.mjs': 'text/javascript',
+ '.json': 'application/json', '.wasm': 'application/wasm', '.png': 'image/png',
+ '.ico': 'image/x-icon', '.otf': 'font/otf', '.ttf': 'font/ttf', '.svg': 'image/svg+xml',
+};
+
+export function serve(root, port = 0) {
+ const server = createServer(async (req, res) => {
+ const path = normalize(decodeURIComponent(new URL(req.url, 'http://x').pathname));
+ const file = join(root, path.endsWith('/') ? 'index.html' : path);
+ const body = await readFile(file).catch(() => readFile(join(root, 'index.html')));
+ const type = TYPES[extname(file)] ?? 'text/html';
+ res.writeHead(200, { 'content-type': type });
+ res.end(body);
+ });
+ return new Promise((resolve) => {
+ server.listen(port, '127.0.0.1', () => {
+ resolve({
+ origin: `http://127.0.0.1:${server.address().port}`,
+ close: () => server.close(),
+ });
+ });
+ });
+}
diff --git a/desktop/tool/web_ux_fixture.dart b/desktop/tool/web_ux_fixture.dart
new file mode 100644
index 000000000..47f32a7d4
--- /dev/null
+++ b/desktop/tool/web_ux_fixture.dart
@@ -0,0 +1,42 @@
+/// No-login review fixture for the whole Harness web app.
+///
+/// Build for web with `--dart-define=HARNESS_TEST=true` and open with
+/// `?scenario=<name>` (see [webUxScenarios]) and optional `?theme=light|dark`.
+/// It runs the real [HarnessApp] — the web frame, [RootShell] and the browser
+/// workspace — against an in-memory [WebUxApp], so every screen is the
+/// production widget with fake data. Review only: it never signs in, reads a
+/// machine list or reaches a machine.
+library;
+
+import 'package:flutter/widgets.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:harness/app_shell.dart';
+import 'package:harness/shared/theme/appearance_prefs_store.dart';
+import 'package:harness/shared/theme/color_palette.dart';
+import 'package:harness/state/app_state.dart';
+import 'package:harness/web/web_entry.dart';
+
+import 'web_ux_scenarios.dart';
+
+Future<void> main() async {
+ WidgetsFlutterBinding.ensureInitialized();
+ // Let headless browsers address the rendered controls by role and name.
+ WidgetsBinding.instance.ensureSemantics();
+ final query = Uri.base.queryParameters;
+ final scenario = webUxScenarios[query['scenario'] ?? 'workspace'];
+ appearancePrefsStore.value = appearancePrefsStore.value.copyWith(
+ palette: query['theme'] == 'light'
+ ? HarnessPalette.paper
+ : HarnessPalette.graphite,
+ );
+ final app = scenario?.seed() ?? (WebUxApp()..status = AppStatus.authenticated);
+ runApp(
+ ProviderScope(
+ overrides: [appStateProvider.overrideWithValue(app)],
+ child: HarnessApp(
+ authenticatedScreen: authenticatedWorkspace,
+ frame: appFrame,
+ ),
+ ),
+ );
+}
diff --git a/desktop/tool/web_ux_scenarios.dart b/desktop/tool/web_ux_scenarios.dart
new file mode 100644
index 000000000..b294f8920
--- /dev/null
+++ b/desktop/tool/web_ux_scenarios.dart
@@ -0,0 +1,45 @@
+/// The screens and states [main] in `web_ux_fixture.dart` can open, by the
+/// `?scenario=` name a review script passes. Each fix group keeps its own in
+/// `tool/web_ux/scenarios/<group>.dart`; this merges them, refusing a name two
+/// groups both claim.
+library;
+
+import 'web_ux/scenarios/base.dart';
+import 'web_ux/scenarios/first_computer.dart';
+import 'web_ux/scenarios/first_load.dart';
+import 'web_ux/scenarios/menus.dart';
+import 'web_ux/scenarios/pane.dart';
+import 'web_ux/scenarios/scenario.dart';
+import 'web_ux/scenarios/states.dart';
+import 'web_ux/scenarios/store.dart';
+import 'web_ux/scenarios/welcome.dart';
+
+export '../test/support/web_ux_app.dart' show WebUxApp;
+export 'web_ux/scenarios/scenario.dart';
+
+final Map<String, WebUxScenario> webUxScenarios = mergeScenarios([
+ baseScenarios,
+ menusScenarios,
+ storeScenarios,
+ firstComputerScenarios,
+ firstLoadScenarios,
+ paneScenarios,
+ welcomeScenarios,
+ statesScenarios,
+]);
+
+/// Every group's scenarios in one map; a name in two groups is an error.
+Map<String, WebUxScenario> mergeScenarios(
+ List<Map<String, WebUxScenario>> groups,
+) {
+ final merged = <String, WebUxScenario>{};
+ for (final group in groups) {
+ for (final MapEntry(:key, :value) in group.entries) {
+ if (merged.containsKey(key)) {
+ throw StateError('Scenario "$key" is defined by two fix groups.');
+ }
+ merged[key] = value;
+ }
+ }
+ return merged;
+}
diff --git a/desktop/tool/web_ux_seed.dart b/desktop/tool/web_ux_seed.dart
new file mode 100644
index 000000000..8a03291f7
--- /dev/null
+++ b/desktop/tool/web_ux_seed.dart
@@ -0,0 +1,121 @@
+/// Fake account data for the web UX review fixture: the person, their
+/// computers, and what their terminals show.
+library;
+
+import 'package:harness/core/models.dart';
+import 'package:harness/state/app_state.dart';
+import 'package:harness/terminal/terminal_session.dart';
+
+import '../test/support/web_ux_app.dart';
+
+const webUxEmail = '[email protected]';
+
+/// Signed in, with no computer yet.
+WebUxApp signedIn() => WebUxApp()
+ ..status = AppStatus.authenticated
+ ..currentUser = const CurrentUserProfile(
+ name: 'Jamie Rivera',
+ email: webUxEmail,
+ );
+
+const _agents = [
+ Agent(
+ id: 'a1',
+ name: 'Fix checkout flow',
+ engine: 'claude',
+ terminalAvailable: true,
+ ),
+ Agent(
+ id: 'a2',
+ name: 'Review pull request 482',
+ engine: 'codex',
+ terminalAvailable: true,
+ ),
+ Agent(id: 'a3', name: 'Docs pass', engine: 'claude', terminalAvailable: true),
+ Agent(id: 'a4', name: 'Release notes', engine: 'codex', terminalAvailable: true),
+];
+
+/// [app] with one computer whose first [count] agents are open as panes.
+WebUxApp withPanes(
+ WebUxApp app,
+ int count, {
+ ConnectionStatus status = ConnectionStatus.connected,
+ bool online = true,
+ bool readOnly = false,
+ TerminalSessionStatus session = TerminalSessionStatus.controlling,
+}) {
+ app.addMachine(
+ 'm1',
+ 'Studio Mac',
+ status: status,
+ online: online,
+ agents: _agents,
+ );
+ for (final agent in _agents.take(count)) {
+ app.openTerminal(
+ 'm1',
+ agent,
+ screen: _screen(agent),
+ status: session,
+ readOnly: readOnly,
+ );
+ }
+ return app;
+}
+
+String _screen(Agent agent) => [
+ '\x1b[1m> ${agent.name}\x1b[0m',
+ '',
+ '\x1b[36m●\x1b[0m Reading src/checkout/cart.ts',
+ '\x1b[36m●\x1b[0m Running pnpm test -- cart',
+ ' \x1b[32m✓\x1b[0m 42 tests passed',
+ '\x1b[36m●\x1b[0m Editing src/checkout/total.ts (+12 -4)',
+ '',
+ 'The total now rounds once, after tax, instead of per line item.',
+ '',
+ '\x1b[2m╭──────────────────────────────────────────────╮\x1b[0m',
+ '\x1b[2m│\x1b[0m > ',
+ '\x1b[2m╰──────────────────────────────────────────────╯\x1b[0m',
+].join('\r\n');
+
+/// The account's computers, none connected: one off, one waiting for this
+/// browser's password, one just removed.
+WebUxApp withComputers(WebUxApp app) {
+ app
+ ..addMachine(
+ 'm1',
+ 'Studio Mac',
+ status: ConnectionStatus.disconnected,
+ online: false,
+ )
+ ..addMachine('m2', 'Build server (ubuntu-24)', needsLink: true)
+ ..addMachine('m3', 'Old laptop', status: ConnectionStatus.disconnected);
+ app.removedMachines = {'m3': DateTime.now().millisecondsSinceEpoch};
+ return app;
+}
+
+/// [count] tabs, each with one pane, and names long enough to clip.
+WebUxApp withTabs(WebUxApp app, int count) {
+ withPanes(app, 0);
+ const names = [
+ 'checkout',
+ 'Refactor the billing reconciliation service end to end',
+ 'docs',
+ 'release 4.2',
+ 'payments-api',
+ 'mobile web',
+ 'infra',
+ 'design review',
+ 'customer escalations this week',
+ ];
+ for (var i = 0; i < count; i++) {
+ if (i > 0) app.newSwarm(name: names[i % names.length]);
+ app.renameSwarm(app.activeSwarmId, names[i % names.length]);
+ app.openTerminal(
+ 'm1',
+ _agents[i % _agents.length],
+ screen: _screen(_agents[i % _agents.length]),
+ );
+ }
+ return app;
+}