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.
TypeScript 3d-modelingagent-frameworkagent-harnessai-agentscadclaude-codecodexcoding-agentsdeveloper-toolsesp32game-developmentmcp-servermulti-agentopen-hardwareopencodeopenharnesspcbroboticsterminaltmux
Record the unified Harness entry flow and live verification
dee06fec9e9f9ba
diff --git a/docs/harness-agent-first-tabs.md b/docs/harness-agent-first-tabs.mdindex 9f4033806..13e4e64f8 100644--- a/docs/harness-agent-first-tabs.md+++ b/docs/harness-agent-first-tabs.md@@ -24,7 +24,7 @@ Escape restores both actions and retains the query.The field starts empty and focused so typing works immediately. Typing, clickingit or Open Harness, or pressing an arrow reveals the same input, results,-highlight, action arrow and keyboard navigation as Cmd-O. Focus alone does not+highlight, action arrow and keyboard navigation as the Cmd-N picker. Focus alone does notbuild a search catalog or reveal results. New Tab refocuses an existing unusedpage too. Typing filters immediately; arrows select and Enter opens. Escape or clickingoutside closes the dropdown and hides the caret. The recent-agent list is removed.@@ -38,7 +38,7 @@ A small product image and caption stay in the footer and link tohttps://www.autonomous.ai/harness-device. The bundled image is the officialdevice image from https://cdn.autonomous.ai/production/ecm/260731/2.webp,cropped in the viewport so the device is larger and centered. The caption is-“Meet the Harness device”+“Meet the Harness device”.The start-page actions use the same pill shape as the titlebar. The device linkand both pairs of New/Open buttons show a hand cursor. Open Harness on the startpage is transparent with a subtle border; New@@ -46,15 +46,19 @@ Harness retains its accent fill.Unused default-name empty pages are excluded from Recently Closed.The titlebar places the bell beside the traffic lights, then the tabs and tab-plus. Explicit **New Harness** and **Open Harness** buttons sit on the right.-There is no floating +. Cmd-N opens creation directly; Cmd-O opens existing-work-search. Each has its own popup, with no creation CTA or “or” divider in search,-no Back to Search button in creation, and no stacked dialog on dismissal.-The titlebar actions are 34-point-high pills with generous horizontal padding,-12 points between them and at the right edge. AppKit uses one unified toolbar-row; the Flutter titlebar is 52 points high and uses the same accent/secondary-treatment and app font. Open Harness has a transparent fill and subtle border on both surfaces. Titlebar and native menu hover hints are-removed. Accessible names remain, and menus and Keyboard Shortcuts show bindings.+plus. A single accented **Add Harness** button sits on the right. It and+**Cmd-N** open the same compact chooser: a focused **Find a harness** field,+with outlined **Open Harness** and accented **+ New Harness** beneath it.+Typing, clicking the field, Open Harness, or the first navigation/Enter key+reveals results without opening an unseen session. The field keeps its width+and position. Both buttons remain available after results open; Open activates+the selected result and New replaces search with creation. There is no stacked+picker behind creation. Escape dismisses the chooser and restores terminal focus.+The titlebar button is a 34-point-high pill with generous padding and a 12-point+right margin. Native menu and titlebar hover hints remain removed; accessible+names and shortcut help identify the actions. Workspace modals preserve the+button's normal colors while its actions remain blocked.+The creation dialog title and CTA are **New Harness**. Cancel is removed; Escapeand clicking outside dismiss it. Launch-in-progress and uncertain-outcome statesretain their existing safeguards and recovery actions.@@ -81,7 +85,7 @@ also work immediately after opening the menu, before its first frame.The Open popup keeps its full-width **Find a harness** field, single-choiceresults and 90% black backdrop. Only the highlighted row shows **Open Harness**,**Open N Harnesses**, or **Split right/down**, depending on context.-Both Open and inline start-page search show the same session preview. The Cmd-O+Both Open and inline start-page search show the same session preview. The Cmd-Nsurface can grow to 1120 logical pixels, placing the list and preview side byside. Narrow windows stack them with a compact preview heading. Both sectionsscroll independently; the expanded panel stays within view. Hover selects a@@ -106,8 +110,8 @@ Secondary text is **project · branch · machine**, with one small muted Git bramark immediately before the branch in search and pane headers. Missing metadata is omittedand the containing workspace name is not repeated.The Commands footer stays removed; Shift-Cmd-P and typing `>` expose commands.-An explicit Cmd-N while choosing a split replaces search with creation in that-split position; dismissing creation still returns directly to the terminal.+The visible New Harness action or Shift-Cmd-N while choosing a split replaces+search with creation in that split position; dismissing creation still returns directly to the terminal.The input and result rows share one picker shortcut scope. Tab focus highlightsthe row that Enter will open. Arrow navigation and command-mode entry returnfocus to the input for continued typing; remapped or unbound navigation/Enter@@ -118,11 +122,18 @@ actions too. Command search stays in its field, and creation closes its dropdownbefore opening the form. Native actions wait for the destination focus tree beforehanding keyboard ownership back to Flutter and preserve in-progress search composition.+Rename Tab has one title and an unlabeled, accessible name field, with the+current name selected for immediate typing. Muted focus colors and pill-shaped+Cancel/Rename actions match the entry UI. Blank names stay in the dialog; the+80-character count appears only near the limit. Its 60% veil covers the canvas.+Native tabs consume the whole double-click sequence so opening Rename Tab does+not also trigger the window's titlebar zoom behavior.+## Tabs and menusOne harness shows its engine mark; multiple harnesses use four separate outlinedtiles, matching the native square.grid.2x2 symbol. An empty tab uses a plain plus.-Only one unused New Harness tab is kept. New Tab from the plus, File menu,+Only one unused **New Tab** is kept. New Tab from the plus, File menu,Cmd-T or command search selects that existing page, even at the tab limit.Restoration collapses duplicate unused pages from older builds, preferring theselected one; named tabs and saved layouts are retained.@@ -131,11 +142,11 @@ and accessible actions while idle. Returningto one restores the engine mark. The same rule applies in search and History,including Recently Closed; a closure retains its engine identity even if theagent disappears from discovery. Tab names remain editable. Former default names-`New swarm`, `New tab`, and `New Agent` restore as `New Harness` and still take+`New swarm`, `New tab`, `New Agent`, and `New Harness` restore as `New Tab` and still takethe first agent's name when opened.The macOS menus are **Harness, File, Edit, View, History, Models, Machines,-Window, Help**. File groups **New Tab, New Harness, Open Harness, Rename Tab, Close Tab**;+Window, Help**. File groups **New Tab, Add Harness…, Rename Tab, Close Tab**;then **Split Right, Split Down, Zoom Pane, Close Pane**. Pin/Unpin and Add Projectare removed from this menu. File actions have native system icons, with the samefour-corner Zoom and plain Close cross as the pane header. Machines starts with **Open Machines Manager**, then@@ -145,8 +156,8 @@ machine rename API. It reports failures inline and refreshes names in the menuand pane headers immediately after success. Selecting a computer opens the shared search with itsname filled in; no agent is opened until the user chooses a result.-**Cmd-T** opens the start page, **Cmd-N** opens New Harness-directly, and **Cmd-O** finds an existing harness. **Cmd-S** opens Layout.+**Cmd-T** opens the start page and **Cmd-N** opens Add Harness.+**Shift-Cmd-N** remains a direct creation shortcut; Cmd-O is unbound by default. **Cmd-S** opens Layout.**Cmd-R** splits right and **Cmd-D** splits down, opening the shared picker forthat position. Refresh Machines stays in the Machines menu and command search,without a default chord. The developer-only Debug shortcut is Shift-Cmd-D.@@ -167,8 +178,8 @@ duplicate cards. Their matching explicit card is highlighted when available.**Cmd-1…Cmd-9** select tabs in their visible order; missing numbers do nothing.Cmd-W closes the tab, Shift-Cmd-W closes the focused pane, and Shift-Cmd-Treopens the last closed view. Unused default-name empty pages are never recorded-in Recently Closed, including pages restored from older builds. Shift-Cmd-N and-shifted H/J/K/L are unbound by default. Configured user bindings retain precedence.+in Recently Closed, including pages restored from older builds.+Shifted H/J/K/L are unbound by default. Configured user bindings retain precedence.Each tab retains its focusedpane when switching away and back. Closing viewskeeps agent runtimes alive. Stored layout formats and internal command IDs remain@@ -193,7 +204,7 @@ Long details truncate, with full context in the session-name tooltip.Hovering anywhere on the header replaces the details with small, muted controls:**Zoom Pane, Restart Harness, Stop Harness, Close Pane**, with **Keyboard** first for remote sessions. Keyboardfocus also reveals the controls. The title keeps the same space during the swap,-and hovering retains the terminal renderer. Stop uses a Lucide circle-stop icon+and hovering retains the terminal renderer. Stop uses a plain filled squareand an explicit confirmation: it ends the engine process and removes the activeharness, preserving project files and saved conversation history. The existing`agent_delete` protocol remains unchanged. It is not Pause and promises no livediff --git a/docs/harness-search-preview.md b/docs/harness-search-preview.mdindex 5d818c9fe..1ca939b03 100644--- a/docs/harness-search-preview.md+++ b/docs/harness-search-preview.md@@ -1,6 +1,6 @@# A useful Harness search preview-Both Open Harness and inline start-page search now display existing session+Both Add Harness and inline start-page search now display existing sessioncontent in a shared preview. This document records the content rules, data path,and remaining coverage limits.@@ -11,8 +11,9 @@ The card stays 32 pixels above the window bottom with the caption **Meet theHarness device**. Search uses the remaining space above it. The field keeps itsposition and width when search opens; results and preview appear side byside from 700 pixels wide. The actions hide while searching. The pill buttons-retain their compact 48-pixel height below the taller field. Cmd-O retains-its existing size. Escape restores the actions and retains the query.+retain their compact 48-pixel height below the taller field. Cmd-N now opens+the same compact search-and-buttons choice; its results appear on typing or+explicit search activation, keeping the 64-pixel field position and width. Escape restores the actions and retains the query.Page Up/Down scrolls the preview with overlap while the query keeps keyboard focus.Arrow keys still choose results, and Enter opens the selection. The two previewpaging commands can be remapped or unbound in the Search keymap. Paging only moves@@ -21,6 +22,23 @@ the local viewport; it never refreshes content or rebuilds the search results.**Content rule:** never generate a summary or start a model for previews. Displayonly text and metadata already available from the session.+## Search the existing excerpts++Search also matches the bounded requests, live activity and response excerpts+already held in memory. A lazy lowercase field is retained with each preview+record and invalidated when that record changes. There is no separate index,+new dependency, daemon change, history read, or model call. Ranking reads the+cache without warming it. Coverage ends where the existing cache ends.++Each query word can match a different name, metadata or excerpt field. Names+and metadata keep their fuzzy behavior and rank above content-only matches;+long excerpts use literal fragments, avoiding scattered letters matching across+paragraphs. Live updates add/remove matches using the preview's coalesced+notifications while preserving the order and selection of remaining matches.+An unchanged result set does not rebuild the editor. A new query reranks normally.+Session keys include machine, agent and session identity, so a restart cannot+inherit search matches from the previous session's text.+## Implemented content pathThe desktop now keeps bounded excerpts from the ordinary normalized sessiondiff --git a/docs/harness-v2-handoff.md b/docs/harness-v2-handoff.mdindex a42ef2214..2c9179ea0 100644--- a/docs/harness-v2-handoff.md+++ b/docs/harness-v2-handoff.md@@ -38,10 +38,13 @@ Use [the detailed entry/pane contract](harness-agent-first-tabs.md) when editingor validating UI. The decisions that previously conflicted with older handoffsare:-- **New Harness creates; Open Harness finds existing work.** They are explicit- titlebar buttons with separate popups. The bell is beside the traffic lights.- The floating bottom-right plus is removed.-- **Cmd-T: New Tab; Cmd-N: New Harness; Cmd-O: Open Harness; Cmd-S: Layout.**+- **Add Harness unifies search and creation.** A single titlebar button and+ File → Add Harness… open the compact chooser: search plus Open/New actions.+ Typing or explicit search activation reveals results and preview without+ moving the field. New remains visible after searching and preserves split+ placement. The bell stays beside the traffic lights.+- **Cmd-T: New Tab; Cmd-N: Add Harness; Shift-Cmd-N: direct New Harness; Cmd-S: Layout.**+ Cmd-O is unbound by default.Cmd-H/J/K/L and Cmd-arrows focus panes; Cmd-1…9 select tabs. User bindings takeprecedence. Cmd-R splits right and Cmd-D splits down. Native menus, help and actualdispatch must agree; native menu and titlebar hover hints are removed.@@ -50,12 +53,12 @@ are:harness**. Search starts blank and focused, with results hidden. Open Harnessand New Harness sit underneath, aligned with the search field's left edge.Search has a **64-pixel minimum height** with more vertical padding; the- action buttons remain 48 pixels high. Cmd-O retains its existing input size.+ action buttons remain 48 pixels high. The Cmd-N chooser shares the taller field.Activating search preserves the field position and width; results and previewappear side by side from 700 pixels wide, and the actions hide. The buttonswrap when needed. Escape restores the actions and query.Typing, clicking, or pressing an arrow- reveals the same results, selection, arrows and Enter behavior as Cmd-O.+ reveals the same results, selection, arrows and Enter behavior as the Cmd-N chooser.Focus alone leaves results hidden and builds no catalog. Open Harness andaccented **+ New Harness** share a row below search; a small official deviceimage and **Meet the Harness device** caption stay in a footer 32 pixels above@@ -68,7 +71,8 @@ are:- Search is single-choice. Session names appear above **project · branch ·machine**, without repeated workspace titles. Only the highlighted row shows**Open Harness / Open N Harnesses**, or the explicit split action. The modal- has a 90% black backdrop and no Commands footer, creation CTA or “or” divider.+ has a 90% black backdrop. Its Open/New buttons remain beneath results;+ there is no Commands footer or “or” divider.Commands remain available through Shift-Cmd-P or typing **>**.- Both search entry points show existing session excerpts. Working sessions leadwith the observed request and activity; idle sessions show an existing response.@@ -77,6 +81,8 @@ are:events. No `session_get`, full-history read, or terminal attachment. Cachedselection is immediate; cold data fills asynchronously. Disconnected recordsretain saved text without claiming a live working/waiting state.+ Query words also match those cached excerpts without additional reads; names+ and metadata rank first. Live matches retain selection and stable row order.Page Up/Down scrolls preview content without changing selection or typing focus;both actions participate in the configurable Search keymap.- The Harness application menu includes **Check for Updates…**, using the@@ -92,16 +98,19 @@ are:machine preserves the working folder; large text wraps the buttons.- A single-agent tab/search/history entry uses that agent's engine icon;multiple agents use four outlined tiles. An empty tab uses a plain plus, and- tab close marks appear only on hover/focus. Only one unused New Harness page+ tab close marks appear only on hover/focus. Only one unused New Tab pageis allowed; all New Tab actions reuse and focus it, including at the tab limit.Restore collapses old duplicate unused pages. Blank pages are excludedfrom Recently Closed. File uses Rename Tab / Close Tab, then pane actions;+ Rename has a clean unlabeled field and muted pill actions. Double-clicks are+ contained within the native tab, and modal appearance leaves the titlebar+ button colors intact while blocking their actions.Pin/Unpin and Add Project are absent. Machines follows Models and starts with**Open Machines Manager**, with visible Rename actions.- Pane headers show agent icon/session on the left and folder/branch/machineon the right, with a small muted branch glyph before the branch. Header hoveror keyboard focus reveals **Zoom Pane, Restart Harness, Stop Harness, Close Pane**, with- Keyboard first for remote sessions. Stop uses a circle-stop icon and a clear+ Keyboard first for remote sessions. Stop uses a plain filled square and a clearconfirmation; the existing action ends the process and removes its activeentry, preserving project files and saved conversation history. Divider grips appear onhover/focus/drag. Right/bottom edge plus controls retain explicit split@@ -179,6 +188,26 @@ inspected directly and the user approved its background, preview and footerplacement. The restored native Check for Updates command was verified earlier:it opened the existing update offer; no update was installed.+### September 15 unified entry checkpoint++- **8ada851**: clean Rename Tab; consume native tab mouse-up so rename cannot+ trigger window zoom; preserve titlebar action colors behind a modal.+- **44148d7**: search existing cached session excerpts without extra reads.+ Stop uses the standard filled square; incoming managed tmux work is retained.+- **9af924f**: compact Add Harness chooser on Cmd-N; one titlebar/File entry;+ New Tab label and legacy-name restoration; visible creation for both splits.+- 355 affected Flutter checks are covered by the broad run and the focused+ rerun of corrected expectations. Logs: /private/tmp/harness-unified-entry-regressions.log+ and /private/tmp/harness-unified-entry-final-tests.log. The latter passes all 21.+ Three real-font picker checks pass at 1280, 760 and 600 pixels, including 2×+ text: /private/tmp/harness-picker-render-tests.log. Captures are in+ /private/tmp/harness-picker-entry-captures. The editor retains exact geometry;+ Enter on the focused New button opens creation rather than the selected result.+- Native AppKit: 374 checks pass, including hidden-window geometry, tab click+ isolation, menu/shortcut agreement and identical action colors under a modal.+ Log: /private/tmp/harness-unified-entry-native.log. No benchmark ran.+- Changed Dart analysis is clean after removing one unused test import.+### Prepared build versus running previewPrepared build location:@@ -189,17 +218,25 @@ Only supported current preview location:/Users/ab/code/autonomous-harness/desktop/build/macos/Build/Products/Release/Harness.app-The prepared build includes **021ef72** and passed in-/private/tmp/harness-taller-search-release.log with deep, strict signature-verification. Its window-preserving installation is pending while the user-finishes an active folder chooser.--The running preview was updated through **526b832** using Quit and Keep Windows. The-Release build passed in /private/tmp/harness-lake-entry-release.log; the-prepared and installed bundles passed deep, strict signature verification. The-existing app v2, workshop and personal tabs restored successfully, along with-the unused New Harness tab. The resting New Tab layout was inspected in this-exact build; shared search interactions are covered by the widget checks above.+The prepared and running builds now include **9af924f**. Release succeeded in+/private/tmp/harness-unified-entry-release.log. Both bundles passed deep, strict+signature verification. Installation used **Quit and Keep Windows**, an exact+stopped-process check before and immediately before the swap, and a verified+staging bundle. The previous live bundle is backed up at+/private/tmp/harness-before-unified-entry-wyqay10k/Harness.app.++Live verification confirmed the existing app v2 (three panes), workshop and+personal tabs restored, together with the existing empty page now named New Tab.+The titlebar and File menu each expose one Add Harness action. Both open the+compact chooser; its New button opens the direct-choice creation form. Native+tab double-click opened the cleaned-up Rename Tab without changing window size,+and Add Harness retained its normal colors behind the modal. Rename and creation+were dismissed without changing names or launching a session. The taller lake+start page and fixed device footer were inspected, and New Tab was left selected+for review. CUA's synthetic Command-modifier attempts had no observable effect+for either Cmd-N or the unchanged Cmd-T; shortcut dispatch is covered by the+Flutter and isolated native checks, not claimed as a live CUA keyboard result.+The console is accessible; older locked-console notes are obsolete. Before replacingit with later changes, verify the new Release buildand signatures, use **Quit and Keep Windows**, then check the exact process is@@ -207,7 +244,7 @@ stopped. Back up and replace only the current checkout's bundle, verify it, andreopen that exact path. Ordinary Quit can terminate agents. Do not call getAppbetween quitting and copying, since that lookup can relaunch the app.-The immediately previous preview backup is+The older pre-lake preview backup remains at/private/tmp/harness-before-lake-entry-fmqz73k5/Harness.app.Do not open the other checkout's retired UI or /Applications/Harness.app. Do notrestart/upgrade the user's CLI daemon or type test commands into working agents.