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
Focus New Tab search and clarify Stop Harness controls
dee49568ec1757a
diff --git a/desktop/lib/screens/swarm_screen.dart b/desktop/lib/screens/swarm_screen.dartindex 1b5361967..12f021832 100644--- a/desktop/lib/screens/swarm_screen.dart+++ b/desktop/lib/screens/swarm_screen.dart@@ -69,6 +69,7 @@ class _SwarmScreenState extends State<SwarmScreen> {SwarmProjectStore(storage: kUnderTest ? null : HarnessFileStore.shared);StreamSubscription<SpokenTaskRequest>? _spokenTasks;final _shellFocus = FocusNode(debugLabel: 'Swarm shell');+ final _startSearchFocus = FocusNode(debugLabel: 'Start page search');final _canvasFocus = FocusNode(debugLabel: 'Swarm canvas',canRequestFocus: false,@@ -158,6 +159,7 @@ class _SwarmScreenState extends State<SwarmScreen> {_searchText.dispose();_canvasFocus.dispose();_shellFocus.dispose();+ _startSearchFocus.dispose();unawaited(_spokenTasks?.cancel());if (_native) {_modelsMenu?.removeListener(_syncModels);@@ -987,6 +989,7 @@ class _SwarmScreenState extends State<SwarmScreen> {void _newTab() {app.newSwarm();+ if (app.panes.isEmpty) _startSearchFocus.requestFocus();}Future<void> _addProject() => _dialog(() async {@@ -1217,7 +1220,7 @@ class _SwarmScreenState extends State<SwarmScreen> {onPending: (keys) => setState(() => _pendingKeys = keys),child: Focus(focusNode: _shellFocus,- autofocus: true,+ autofocus: app.panes.isNotEmpty,child: Scaffold(backgroundColor: grid.AppPalette.swarmField,body: Column(@@ -1330,6 +1333,7 @@ class _SwarmScreenState extends State<SwarmScreen> {key: ValueKey('harness-start:${app.activeSwarmId}',),+ focusNode: _startSearchFocus,createSearch: () =>SwarmSearchController(app,diff --git a/desktop/lib/state/app_state.dart b/desktop/lib/state/app_state.dartindex ca09f7418..4dfdf0692 100644--- a/desktop/lib/state/app_state.dart+++ b/desktop/lib/state/app_state.dart@@ -4075,8 +4075,8 @@ class AppNotifier extends ChangeNotifier {return null;}- /// Deletes an agent via `agent_delete`. Returns null on success, or an error message to show- /// inline in the caller's dialog.+ /// Stops an agent via the legacy `agent_delete` request, removing its active+ /// entry while preserving files and saved history. Returns an error on failure.Future<String?> deleteAgent(String machineId, String agentId) async {final machine = machineStates[machineId];if (machine == null) return 'Machine not found';@@ -4085,10 +4085,10 @@ class AppNotifier extends ChangeNotifier {result = await _conn(machineId).request('agent_delete', payload: {'agentId': agentId});} catch (error) {- return 'Delete failed: $error';+ return 'Stop failed: $error';}final error = result['error'];- if (error is String) return 'Delete failed: $error';+ if (error is String) return 'Stop failed: $error';await _removeAgent(machine, agentId);notifyListeners();return null;diff --git a/desktop/lib/widgets/agent_drag.dart b/desktop/lib/widgets/agent_drag.dartindex ed208c4ef..976082e20 100644--- a/desktop/lib/widgets/agent_drag.dart+++ b/desktop/lib/widgets/agent_drag.dart@@ -80,7 +80,7 @@ class PaneCloseButton extends StatelessWidget {Widget build(BuildContext context) {grid.AppTheme.watch(context);return Tooltip(- message: 'Close pane',+ message: 'Close Pane',child: IconButton(onPressed: onPressed,icon: Icon(Icons.close, size: 15, color: AppColors.muted),diff --git a/desktop/lib/widgets/delete_agent_dialog.dart b/desktop/lib/widgets/delete_agent_dialog.dartindex 2ec1b62cc..ee6aa4b1e 100644--- a/desktop/lib/widgets/delete_agent_dialog.dart+++ b/desktop/lib/widgets/delete_agent_dialog.dart@@ -4,13 +4,8 @@ import '../shared/theme/app_theme.dart' as grid;import '../shared/widgets/app_dialog.dart';import '../state/app_state.dart';-/// The one "Delete Harness" confirmation, opened from every place an agent can-/// be deleted: the rail's row menu and the pane's delete button.-///-/// Pulled out of the rail for the reason the rename dialog was: two copies-/// would have been two wordings of one irreversible act, and two ways of-/// reporting that it failed. Returns once the agent is gone or the person-/// backed out; a failure is shown as a snackbar, the way the rail always did.+/// Shared Stop Harness confirmation. The legacy agent_delete request stops the+/// engine and removes its active entry, preserving files and saved history.Future<void> confirmDeleteAgent(BuildContext context,AppNotifier notifier,@@ -21,11 +16,12 @@ Future<void> confirmDeleteAgent(final confirmed = await showAppDialog<bool>(context: context,builder: (dialogContext) => AlertDialog(- title: const Text('Delete Harness'),+ title: const Text('Stop Harness'),content: SizedBox(width: 360,child: Text(- "Delete “$name”? This can't be undone.",+ 'Stop “$name”? This ends the running agent and removes it from your '+ 'active harnesses. Project files and saved conversation history are kept.',style: TextStyle(fontFamily: grid.AppFont.sans, fontSize: 13.5),),),@@ -39,7 +35,7 @@ Future<void> confirmDeleteAgent(backgroundColor: grid.AppPalette.dangerFill,),onPressed: () => Navigator.of(dialogContext).pop(true),- child: const Text('Delete'),+ child: const Text('Stop Harness'),),],),diff --git a/desktop/lib/widgets/harness_start_page.dart b/desktop/lib/widgets/harness_start_page.dartindex 83c3d6370..923ae88a5 100644--- a/desktop/lib/widgets/harness_start_page.dart+++ b/desktop/lib/widgets/harness_start_page.dart@@ -12,10 +12,12 @@ import 'swarm_switcher.dart';class HarnessStartPage extends StatefulWidget {const HarnessStartPage({super.key,+ required this.focusNode,required this.createSearch,required this.onNew,required this.onChoose,});+ final FocusNode focusNode;final SwarmSearchController Function() createSearch;final VoidCallback onNew;final ValueChanged<SwarmSearchSelection> onChoose;@@ -25,7 +27,7 @@ class HarnessStartPage extends StatefulWidget {class _HarnessStartPageState extends State<HarnessStartPage> {final _query = TextEditingController();- final _focus = FocusNode(debugLabel: 'Start page search');+ FocusNode get _focus => widget.focusNode;final _pickerFocus = FocusNode(debugLabel: 'Start page picker',canRequestFocus: false,@@ -90,7 +92,6 @@ class _HarnessStartPageState extends State<HarnessStartPage> {void dispose() {_search?.dispose();_query.dispose();- _focus.dispose();_pickerFocus.dispose();super.dispose();}@@ -167,7 +168,7 @@ class _HarnessStartPageState extends State<HarnessStartPage> {onOpen: _open,onTapOutside: _close,groupId: _searchGroup,- autofocus: false,+ autofocus: true,showClose: _showResults,hintText: '',rounded: true,diff --git a/desktop/lib/widgets/machine_rail.dart b/desktop/lib/widgets/machine_rail.dartindex 3f1f958fa..068f58dcd 100644--- a/desktop/lib/widgets/machine_rail.dart+++ b/desktop/lib/widgets/machine_rail.dart@@ -1233,8 +1233,8 @@ class _AgentRowState extends State<_AgentRow> {),const AppMenuDivider(),AppMenuItem(- icon: LucideIcons.trash2300,- label: 'Delete',+ icon: LucideIcons.circleStop300,+ label: 'Stop Harness',danger: true,onPressed: () {_agentMenu.close();diff --git a/desktop/lib/widgets/pane_header_actions.dart b/desktop/lib/widgets/pane_header_actions.dartindex 8e3f18762..53e384a71 100644--- a/desktop/lib/widgets/pane_header_actions.dart+++ b/desktop/lib/widgets/pane_header_actions.dart@@ -8,7 +8,6 @@ import '../theme/app_theme.dart';class PaneHeaderActions extends StatelessWidget {const PaneHeaderActions({super.key,- required this.name,required this.zoomed,this.onZoom,this.onDelete,@@ -18,7 +17,6 @@ class PaneHeaderActions extends StatelessWidget {this.details,});- final String name;final bool zoomed, composerVisible;final VoidCallback? onZoom, onDelete, onClose, onToggleComposer;@@ -81,14 +79,14 @@ class PaneHeaderActions extends StatelessWidget {const SizedBox(width: 2),],action(- zoomed ? 'Restore panes' : 'Zoom $name',+ 'Zoom Pane',zoomed ? LucideIcons.minimize : LucideIcons.maximize,onZoom,),const SizedBox(width: 2),- action('Delete Harness', LucideIcons.trash2, onDelete),+ action('Stop Harness', LucideIcons.circleStop, onDelete),const SizedBox(width: 2),- action('Close pane', LucideIcons.x, onClose),+ action('Close Pane', LucideIcons.x, onClose),],),),diff --git a/desktop/lib/widgets/terminal_panel.dart b/desktop/lib/widgets/terminal_panel.dartindex 8b451ab92..a950c3e1d 100644--- a/desktop/lib/widgets/terminal_panel.dart+++ b/desktop/lib/widgets/terminal_panel.dart@@ -1613,7 +1613,6 @@ class _TerminalHeader extends StatelessWidget {),),child: PaneHeaderActions(- name: session.agentName,zoomed: zoomed,onZoom: onToggleZoom,onDelete: onDelete,diff --git a/desktop/test/boot_flow_widget_test.dart b/desktop/test/boot_flow_widget_test.dartindex 8516f4f13..06f1ecbb0 100644--- a/desktop/test/boot_flow_widget_test.dart+++ b/desktop/test/boot_flow_widget_test.dart@@ -837,7 +837,7 @@ void main() {).focusNode!.hasFocus,- isFalse,+ isTrue,);expect(find.byKey(const ValueKey('harness-start-open')), findsOneWidget);await tester.tap(find.byKey(const ValueKey('harness-start-new')));@@ -1090,7 +1090,7 @@ void main() {await chord(tester, LogicalKeyboardKey.keyP, shift: true);await tester.enterText(- find.byKey(const ValueKey('swarm-search-input')),+ find.byKey(const ValueKey('harness-start-search')),'> link machine',);await tester.pump();@@ -1176,7 +1176,7 @@ void main() {await chord(tester, LogicalKeyboardKey.keyP, shift: true);await tester.enterText(- find.byKey(const ValueKey('swarm-search-input')),+ find.byKey(const ValueKey('harness-start-search')),'> link machine',);await tester.pump();diff --git a/desktop/test/first_workspace_test.dart b/desktop/test/first_workspace_test.dartindex f3ca11a84..564c82d08 100644--- a/desktop/test/first_workspace_test.dart+++ b/desktop/test/first_workspace_test.dart@@ -241,7 +241,7 @@ void main() {expect(_startInput, findsOneWidget);expect(_newHarness, findsOneWidget);expect(find.byKey(const ValueKey('harness-start-open')), findsOneWidget);- expect(tester.widget<TextField>(_startInput).focusNode!.hasFocus, isFalse);+ expect(tester.widget<TextField>(_startInput).focusNode!.hasFocus, isTrue);expect(find.byType(ListTile), findsNothing);expect(find.byType(AlertDialog), findsNothing);expect(find.text('Saved project'), findsNothing);@@ -273,7 +273,7 @@ void main() {app.machinesLoading = false;app.dismissError();await tester.pump();- expect(tester.widget<TextField>(_startInput).focusNode!.hasFocus, isFalse);+ expect(tester.widget<TextField>(_startInput).focusNode!.hasFocus, isTrue);await tester.tap(_newHarness);await tester.pump();expect(picker.opened, 0);@@ -670,7 +670,7 @@ void main() {expect(find.text('Projects'), findsNothing);expect(app.launches, isEmpty);expect(_startInput, findsOneWidget);- expect(tester.widget<TextField>(_startInput).focusNode!.hasFocus, isFalse);+ expect(tester.widget<TextField>(_startInput).focusNode!.hasFocus, isTrue);await tester.tap(_newHarness);await tester.pump();final engine = tester.widget<AppSelectField<String>>(diff --git a/desktop/test/harness_start_page_test.dart b/desktop/test/harness_start_page_test.dartindex d3c243c25..8844edc71 100644--- a/desktop/test/harness_start_page_test.dart+++ b/desktop/test/harness_start_page_test.dart@@ -16,11 +16,14 @@ void main() {) async {final app = createApp();addTearDown(app.dispose);+ final focus = FocusNode();+ addTearDown(focus.dispose);var searches = 0;await tester.pumpWidget(MaterialApp(home: Scaffold(body: HarnessStartPage(+ focusNode: focus,createSearch: () {searches++;return SwarmSearchController(app, [], adding: true);@@ -31,6 +34,9 @@ void main() {),),);+ await tester.pump();+ expect(focus.hasFocus, isTrue);+ expect(_results, findsNothing);expect(searches, 0);await tester.pumpWidget(const SizedBox());expect(searches, 0, reason: 'Closing an unused page must not index agents');@@ -41,6 +47,8 @@ void main() {) async {final app = createApp();addTearDown(app.dispose);+ final focus = FocusNode();+ addTearDown(focus.dispose);var commandReads = 0;var updated = false;String? chosen;@@ -48,6 +56,7 @@ void main() {MaterialApp(home: Scaffold(body: HarnessStartPage(+ focusNode: focus,createSearch: () => SwarmSearchController(app,[],diff --git a/desktop/test/keymap_runtime_test.dart b/desktop/test/keymap_runtime_test.dartindex 30dc2a8c7..d40e55ad9 100644--- a/desktop/test/keymap_runtime_test.dart+++ b/desktop/test/keymap_runtime_test.dart@@ -202,7 +202,7 @@ void main() {.widget<TextField>(find.byKey(const ValueKey('harness-start-search'))).focusNode!.hasPrimaryFocus,- isFalse,+ isTrue,);expect(find.byType(SwarmSearchResults), findsNothing);expect(original.panes.last, same(focused));@@ -433,7 +433,7 @@ void main() {await mount(tester, app, map);final initialId = app.activeSwarmId;final field = find.byKey(const ValueKey('harness-start-search'));- expect(tester.widget<TextField>(field).focusNode!.hasFocus, isFalse);+ expect(tester.widget<TextField>(field).focusNode!.hasFocus, isTrue);await tester.tap(field);await tester.pump();expect(tester.widget<TextField>(field).focusNode!.hasPrimaryFocus, isTrue);diff --git a/desktop/test/swarm_entry_picker_test.dart b/desktop/test/swarm_entry_picker_test.dartindex aa35e1f5d..3895ef546 100644--- a/desktop/test/swarm_entry_picker_test.dart+++ b/desktop/test/swarm_entry_picker_test.dart@@ -51,13 +51,14 @@ void main() {);}- testWidgets('start-page results filter and open with arrows and Enter', (+ testWidgets('start page accepts typing immediately, then arrows and Enter', (tester,) async {final app = createApp();await mount(tester, app);- await tester.tap(_startInput);- await tester.enterText(_startInput, 'Agent 1');+ expect(find.byKey(const ValueKey('harness-start-results')), findsNothing);+ expect(tester.widget<TextField>(_startInput).focusNode!.hasFocus, isTrue);+ tester.testTextInput.enterText('Agent 1');await tester.pump();await tester.sendKeyEvent(LogicalKeyboardKey.arrowDown);await tester.pump();@@ -106,10 +107,7 @@ void main() {tester.widget<TextField>(_startInput).decoration!.hintText,isEmpty,);- expect(- tester.widget<TextField>(_startInput).focusNode!.hasFocus,- isFalse,- );+ expect(tester.widget<TextField>(_startInput).focusNode!.hasFocus, isTrue);expect(find.byKey(const ValueKey('harness-device-link')), findsOneWidget);expect(find.byType(ListTile), findsNothing);await tester.tap(_startInput);@@ -235,10 +233,11 @@ void main() {await tester.pump();expect(_results, findsNothing);expect(_startInput, findsOneWidget);+ expect(tester.widget<TextField>(_startInput).focusNode!.hasFocus, isTrue);await chord(tester, LogicalKeyboardKey.keyP, shift: true);- expect(tester.widget<TextField>(_input).controller!.text, '> ');+ expect(tester.widget<TextField>(_startInput).controller!.text, '> ');expect(- tester.widget<TextField>(_input).decoration!.hintText,+ tester.widget<TextField>(_startInput).decoration!.hintText,'Search commands…',);await tester.pumpWidget(const SizedBox());diff --git a/desktop/test/swarm_immediate_input_test.dart b/desktop/test/swarm_immediate_input_test.dartindex 3d86463e4..f0869b9bd 100644--- a/desktop/test/swarm_immediate_input_test.dart+++ b/desktop/test/swarm_immediate_input_test.dart@@ -112,7 +112,7 @@ void main() {).focusNode!.hasFocus,- isFalse,+ isTrue,);} else if (action == 'waiting composer') {expect(app.focusedPane, same(first));diff --git a/desktop/test/swarm_interactions_test.dart b/desktop/test/swarm_interactions_test.dartindex 8a4f617fa..e9cf4fbf2 100644--- a/desktop/test/swarm_interactions_test.dart+++ b/desktop/test/swarm_interactions_test.dart@@ -134,7 +134,29 @@ void main() {final input = tester.widget<TextField>(find.byKey(const ValueKey('harness-start-search')),);+ expect(input.focusNode!.hasFocus, isTrue);+ expect(+ find.byKey(const ValueKey('harness-start-results')),+ findsNothing,+ );+ tester.testTextInput.enterText('Agent 1');+ await tester.pump();+ expect(+ find.byKey(const ValueKey('harness-start-results')),+ findsOneWidget,+ );+ await tester.sendKeyEvent(LogicalKeyboardKey.escape);+ await tester.pump();expect(input.focusNode!.hasFocus, isFalse);+ await newFromChrome();+ await tester.pump();+ expect(app.activeSwarmId, starter);+ expect(app.swarms, hasLength(2));+ expect(input.focusNode!.hasFocus, isTrue);+ expect(+ find.byKey(const ValueKey('harness-start-results')),+ findsNothing,+ );}await tester.pumpWidget(const SizedBox());app.dispose();@@ -197,7 +219,7 @@ void main() {},);- testWidgets('pane controls zoom, confirm deletion and close only this view', (+ testWidgets('pane controls zoom, confirm stopping and close only this view', (tester,) async {final app = createApp();@@ -217,7 +239,7 @@ void main() {find.descendant(of: controls, matching: find.byType(IconButton)),findsNWidgets(4),);- expect(find.byTooltip('Delete Harness').first.hitTestable(), findsNothing);+ expect(find.byTooltip('Stop Harness').first.hitTestable(), findsNothing);final mouse = await tester.createGesture(kind: PointerDeviceKind.mouse);await mouse.addPointer(location: const Offset(1, 1));Future<void> hover() async {@@ -234,20 +256,20 @@ void main() {await tester.pump();expect(pane.composerVisible, isFalse);await hover();- await tester.tap(find.byTooltip('Zoom Session a0'));+ await tester.tap(find.byTooltip('Zoom Pane').first);await tester.pump();expect(app.zoomedPaneId, pane.id);await hover();- await tester.tap(find.byTooltip('Restore panes'));+ await tester.tap(find.byTooltip('Zoom Pane'));await tester.pump();expect(app.zoomedPaneId, isNull);await hover();await tester.tap(- find.descendant(of: controls, matching: find.byTooltip('Delete Harness')),+ find.descendant(of: controls, matching: find.byTooltip('Stop Harness')),);await tester.pumpAndSettle();- expect(find.text('Delete Harness'), findsOneWidget);+ expect(find.text('Stop Harness'), findsNWidgets(2));expect(app.panes, contains(pane));expect(original.panes.single.session, same(session));await tester.tap(find.text('Cancel'));@@ -256,7 +278,7 @@ void main() {await hover();await tester.tap(- find.descendant(of: controls, matching: find.byTooltip('Close pane')),+ find.descendant(of: controls, matching: find.byTooltip('Close Pane')),);await tester.pump();await mouse.removePointer();diff --git a/desktop/test/terminal_panel_presentation_test.dart b/desktop/test/terminal_panel_presentation_test.dartindex d49bcdf1c..d4534ae18 100644--- a/desktop/test/terminal_panel_presentation_test.dart+++ b/desktop/test/terminal_panel_presentation_test.dart@@ -51,9 +51,9 @@ void main() {);await tester.pump(const Duration(milliseconds: 120));await tester.tap(find.byTooltip('Show message composer'));- await tester.tap(find.byTooltip('Zoom ${session.agentName}'));- await tester.tap(find.byTooltip('Delete Harness'));- await tester.tap(find.byTooltip('Close pane'));+ await tester.tap(find.byTooltip('Zoom Pane'));+ await tester.tap(find.byTooltip('Stop Harness'));+ await tester.tap(find.byTooltip('Close Pane'));await tester.pump();expect(closed, [1]);expect(deleted, [1]);@@ -78,7 +78,7 @@ void main() {expect(find.text('Renamed terminal'), findsOneWidget);expect(find.text('fast-focus'), findsOneWidget);expect(find.text('terminal'), findsOneWidget);- expect(find.byTooltip('Restore panes'), findsOneWidget);+ expect(find.byTooltip('Zoom Pane'), findsOneWidget);session.status = TerminalSessionStatus.takenOver;revision.value = 3;await tester.pump();@@ -157,7 +157,7 @@ void main() {tester.getRect(find.text('Test host')).left,greaterThan(tester.getRect(find.text('main')).right),);- expect(find.byTooltip('Delete Harness').hitTestable(), findsNothing);+ expect(find.byTooltip('Stop Harness').hitTestable(), findsNothing);expect(find.descendant(of: controls, matching: find.byType(IconButton)),findsNWidgets(local ? 3 : 4),@@ -166,7 +166,7 @@ void main() {await mouse.addPointer(location: tester.getCenter(title));await tester.pump(const Duration(milliseconds: 120));expect(tester.widget<AnimatedOpacity>(details).opacity, 0);- expect(find.byTooltip('Delete Harness').hitTestable(), findsOneWidget);+ expect(find.byTooltip('Stop Harness').hitTestable(), findsOneWidget);expect(tester.getRect(title), titleBounds);expect(tester.widget<TerminalView>(find.byType(TerminalView)),@@ -175,11 +175,11 @@ void main() {await mouse.moveTo(const Offset(300, 200));await tester.pump(const Duration(milliseconds: 120));expect(tester.widget<AnimatedOpacity>(details).opacity, 1);- expect(find.byTooltip('Delete Harness').hitTestable(), findsNothing);+ expect(find.byTooltip('Stop Harness').hitTestable(), findsNothing);// Keyboard users can reveal and reach the same actions without a mouse.- Focus.of(tester.element(find.byTooltip('Delete Harness'))).nextFocus();+ Focus.of(tester.element(find.byTooltip('Stop Harness'))).nextFocus();await tester.pump(const Duration(milliseconds: 120));- expect(find.byTooltip('Delete Harness').hitTestable(), findsOneWidget);+ expect(find.byTooltip('Stop Harness').hitTestable(), findsOneWidget);await mouse.removePointer();await tester.pumpWidget(const SizedBox());session.dispose();diff --git a/desktop/test/welcome_entry_layout_test.dart b/desktop/test/welcome_entry_layout_test.dartindex 3d308f2a1..c49779800 100644--- a/desktop/test/welcome_entry_layout_test.dart+++ b/desktop/test/welcome_entry_layout_test.dart@@ -90,7 +90,7 @@ void main() {final device = find.byKey(const ValueKey('harness-device-link'));expect(find.text('Harness'), findsOneWidget);expect(tester.widget<TextField>(field).decoration!.hintText, isEmpty);- expect(tester.widget<TextField>(field).focusNode!.hasFocus, isFalse);+ expect(tester.widget<TextField>(field).focusNode!.hasFocus, isTrue);expect(find.byType(ListTile), findsNothing);final fieldRect = tester.getRect(field);final createRect = tester.getRect(create);diff --git a/docs/harness-agent-first-tabs.md b/docs/harness-agent-first-tabs.mdindex f51be9aa5..1c0fb2ebe 100644--- a/docs/harness-agent-first-tabs.md+++ b/docs/harness-agent-first-tabs.md@@ -12,9 +12,11 @@ background matches the selected tab. The centered title and search controls sitlower with generous empty space. The field is no wider than 640 logical pixels,with **Open Harness** and accented **+ New Harness** buttons underneath.-The field starts empty and unfocused. Clicking it or Open Harness reveals the-same input, results, highlight, action arrow and keyboard navigation as Cmd-O.-Typing filters immediately; arrows select and Enter opens. Escape or clicking+The field starts empty and focused so typing works immediately. Typing, clicking+it 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+build a search catalog or reveal results. New Tab refocuses an existing unused+page 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.The closed page retains only search text and selection: it does not keep a livesearch subscription or build a catalog when an unused page closes. Reopening@@ -137,8 +139,8 @@ Switching between panes or tabs, closing them, or moving between zoomed panestransfers keyboard and text input to the ready retained view before the nextrendered frame. Its existing terminal, composer orFind field receives the next key with its draft and selection intact. Blank-pages release the previous terminal immediately and leave welcome search-unfocused. A connecting composer releases the old input connection and receives+pages release the previous terminal immediately and focus the start-page search+without showing results until interaction. A connecting composer releases the old input connection and receivesfocus once ready. Dialogs keep input while background destinations or connectionstate change; dismissal returns it to the current destination without restoring anolder agent's focus.@@ -150,10 +152,14 @@ shows **folder • branch • machine**, omitting unavailable folder/branch dataLong details truncate, with full context in the session-name tooltip.Hovering anywhere on the header replaces the details with small, muted controls:-**Zoom, Delete, Close**, with **Keyboard** first for remote sessions. Keyboard+**Zoom Pane, 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. Delete uses the existing confirmation;-Close removes only this view. Keyboard toggles the remote message composer.+and hovering retains the terminal renderer. Stop uses a Lucide circle-stop icon+and an explicit confirmation: it ends the engine process and removes the active+harness, preserving project files and saved conversation history. The existing+`agent_delete` protocol remains unchanged. It is not Pause and promises no live+process suspension/resume. Close Pane removes only this view and leaves the agent+running. Keyboard toggles the remote message composer.Resize grips are invisible while idle and appear on divider hover, keyboardfocus or active drag. Their hit targets and resize behavior stay the same. Thediff --git a/docs/harness-v2-handoff.md b/docs/harness-v2-handoff.mdindex 2a35eedfb..112e5d3b4 100644--- a/docs/harness-v2-handoff.md+++ b/docs/harness-v2-handoff.md@@ -43,14 +43,18 @@ are:The floating bottom-right plus is removed.- **Cmd-T: New Tab; Cmd-N: New Harness; Cmd-O: Open Harness; Cmd-S: Layout.**Cmd-H/J/K/L and Cmd-arrows focus panes; Cmd-1…9 select tabs. User bindings take- precedence. Native menus, help, hover hints and actual dispatch must agree.+ precedence. Cmd-R splits right and Cmd-D splits down. Native menus, help and actual+ dispatch must agree; native menu and titlebar hover hints are removed.- New Tab uses the Google-like page with a **solid selected-tab background**,lower centered controls and generous whitespace. Search is at most 640 logical- pixels wide, blank and unfocused initially. Clicking it reveals the same- results, selection, arrows and Enter behavior as Cmd-O. Open Harness and+ pixels wide, blank and focused initially. Typing, clicking, or pressing an arrow+ reveals the same results, selection, arrows and Enter behavior as Cmd-O.+ Focus alone leaves results hidden and builds no catalog. Open Harness andaccented **+ New Harness** sit below it; a small official device image andintroduction sit well below, linking to autonomous.ai/harness-device.- The five recent-agent rows are removed.+ The five recent-agent rows are removed. Both pairs of actions are rounded+ pills, with transparent outlined Open buttons and hand cursors. The official+ `2.webp` device photo is cropped and centered in its viewport, with a hand cursor.- 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@@ -61,13 +65,19 @@ are:dismissed accidentally; an uncertain outcome retains Close and Check status.The form does not restore search underneath it.- A single-agent tab/search/history entry uses that agent's engine icon;- multiple agents use the group icon. Unused default-name blank pages are excluded- from Recently Closed. File groups harness/tab actions, then pane actions;+ 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+ is allowed; all New Tab actions reuse and focus it, including at the tab limit.+ Restore collapses old duplicate unused pages. Blank pages are excluded+ from Recently Closed. File uses Rename Tab / Close Tab, then pane 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/machine- on the right. Header hover or keyboard focus reveals muted **Zoom, Delete,- Close**, with Keyboard first for remote sessions. Divider grips appear on+ on the right, with a small muted branch glyph before the branch. Header hover+ or keyboard focus reveals **Zoom Pane, Stop Harness, Close Pane**, with+ Keyboard first for remote sessions. Stop uses a circle-stop icon and a clear+ confirmation; the existing action ends the process and removes its active+ entry, preserving project files and saved conversation history. Divider grips appear onhover/focus/drag. Right/bottom edge plus controls retain explicit splitplacement and remain hidden while zoomed or dragging.- New, restored, reopened, reconnected, revisited, resized, relaid-out and@@ -76,104 +86,109 @@ are:## Current source and verification-**f25e5a2** keeps entry choices readable and visible at larger text sizes and is-pushed to main. The inline search reveals its whole viewport; search selection-remains visible after resizing. New Harness agent buttons wrap when their labels-need more room. This includes the preceding immediate navigation/input fixes.-Analysis and full desktop regressions pass. The prepared, verified Release-includes this change; the running preview remains unchanged while the console-is locked.+Recent pushed checkpoints:-| Checkpoint | Verified change |+| Checkpoint | Change || --- | --- |-| **f25e5a2** — entry visibility | The start-page search stays inside the window, resized search results reveal the same selection, and large-text agent choices wrap without truncating Claude Code. Current production surfaces are rendered in all six palettes at 880×560 and text scales 1 and 2. |-| **c35e298** — navigation input | Pane/tab switches, closes and zoom navigation transfer input to the existing view before painting. Find/composer drafts, caret and composition survive. Connecting composers release the old agent and take focus once ready. Dialogs exclude background input and restore the current destination immediately on dismissal. |-| **dff8dfb** — Find opening | Shortcut/native entry immediately activates the focused pane's prepared editor. Early text, composition and Escape belong to Find before its first paint. Sixteen retained terminals keep only one dormant editor, without a search index or output-driven editor rebuilds. |-| **8d754db** — Find dismissal | Escape or the close button previously lost an arrow key and text arriving before the next frame. Dismissal now immediately restores the retained terminal's input connection, or the visible composer's field and draft. The renderer and remembered Find query stay intact. |-| **8b73106** — terminal Find | Ten output updates now rebuild the editor zero times instead of ten. Results update around it while match, caret, composition and focus remain stable. Enter/keypad Enter and Escape return to the platform input method during composition; normal navigation/dismissal resumes afterward. |-| **99d1ac9** — workspace events | Routine heartbeats and dial scrolling no longer rebuild the workspace or visit unrelated retained terminal JSON handlers. Busy-state transitions, watchdog expiry, dial status, hidden ready replies and machine transport failures retain their routing. |-| **d5756ab** — Layout | Repeating the configured Layout chord cycles choices; modified digits/arrows cannot accidentally apply a shape. Highlighting preserves geometry. Large text gets readable, scrollable choices and navigation follows actual wrapped rows. Confirmation retains the agent and latest output. |-| **0c240dd**, **a64ab4e** — picker focus | Input and Tab-focused result rows share shortcut ownership. Native New Harness and command actions use the focused picker, close it before creation, and wait for destination focus. Remapped/unbound keys and composition remain respected. |-| **67c20f4**, **581d0a4**, **b26424e**, **98fc760** — current entry/creation | Current New/Open fixtures replace retired UI expectations. Native/Flutter button styling agrees. Initial folder focus, chooser retry, account lookup, one-step dismissal and original creation destination are covered. |-| **87706a3**, **2aaa48a** — inline search | Command entry synchronizes the field and results; dismissed pages retain no search subscription/catalog work. Reopening refreshes against current state without rebuilding the editor on every arrow selection. |-| **b4baf68**, **e8960fc**, **9288ea4** — live preview baseline | Separate New/Open, the current start page/device image/dialog copy, readable titlebar controls and the incremental Codex resize scrolling fix were built and checked in the correct preview. |--Current checks:--- **1,473 desktop unit/widget checks pass**, with one optional CLI-media- placeholder skipped. Log: /private/tmp/harness-entry-full.log.-- All **four changed Dart files analyze cleanly** in- /private/tmp/harness-entry-analyze.log. The **12 entry render cases** pass in- /private/tmp/harness-entry-render-final.log. Before-fix failures are in- /private/tmp/harness-entry-before.log and /private/tmp/harness-entry-resize-before.log.- Captures are in /private/tmp/harness-entry-after. They use production widgets,- synthetic machines, bundled icons, and Arial/Liberation under the app's font- families; they do not establish native SF font metrics or native window behavior.- The original cases reproduced clipped agent labels and off-window selections;- resizing also removed the selected row from the visible list at normal text size.-- The preceding **18 input transition cases** cover keyboard/native command- entry, ready/connecting views, zoom,- editor drafts/composition, background changes and immediate dialog dismissal.- The original ten failures are in /private/tmp/harness-navigation-input-before.log;- connecting-composer and late-readiness failures are in- /private/tmp/harness-navigation-pending-before.log and- /private/tmp/harness-navigation-composer-before.log. Existing retained-view,- latest-output and idle-work checks still pass.-- The unchanged exported Dart bindings last passed **84 native keyboard checks** and- **363 AppKit titlebar checks**, including hidden native window layout.- Log: /private/tmp/harness-current-native-contract.log. The script completed;- it displayed no windows and opened no agents.-- The normal arm64 **Release build succeeds** through f25e5a2. Both rebuilt- frameworks verified before refreshing the outer ad-hoc signature; the full- bundle passed deep, strict signature verification.- Build log: /private/tmp/harness-entry-release.log.-- Four optional CLI-media checks previously passed at 67c20f4 in- /private/tmp/harness-current-media-smoke.log. They use isolated identities,- synthetic media, loopback transport and a stubbed OS launch boundary.--These are functional checks, isolated renders and deterministic work counts.-They do not establish live native IME behavior, real remote reconnect, first-use-conversion or native event-to-display latency. The-[performance record](harness-v2-performance.md) keeps measurement scopes and-earlier counts separate.+| **300f04d** | Every New Tab entry reuses the existing unused page, including at capacity. Restore collapses old duplicates without changing named or populated tabs. Rebases cleanly on 051ea5b, the separate link-prompt revisit fix. |+| **804eb93** | Clearer cropped official device image, hand cursors, pill buttons and transparent outlined Open buttons; consistent native/pane zoom and close icons; Rename Tab and Close Tab wording. |+| **518977c** | Roomier unified titlebar, hover-only tab close marks, minimal plus/group/branch icons, split shortcuts, and unique useful layout choices through the supported pane limit. |+| **f25e5a2** and preceding input checkpoints | Readable large-text entry choices, visible selected results after resize, retained renderer/input ownership, and immediate navigation/Find transitions. |++The current follow-up focuses start-page search on entry and when reusing an+unused page, while keeping results lazy. The surrounding shell no longer wins+initial autofocus. Pane controls now say Zoom Pane, Stop Harness and Close Pane;+the Stop confirmation accurately distinguishes stopping from deleting files or+pausing a process. The legacy CLI protocol is unchanged.++The final full run passed **1,540 desktop tests**, with one optional media+placeholder skipped. Six assertions in the keymap fixture incorrectly expected+autofocus after deliberate dismissal; after restoring those expectations, all+**20 keymap runtime tests pass**, covering the remaining six cases. Logs:+/private/tmp/harness-focus-stop-full-final.log and+/private/tmp/harness-focus-stop-keymap-final.log. The earlier single-empty-tab+checkpoint passed all 1,545 then-current tests in one run; main subsequently+added the link-prompt revisit case. The latest native contract run passes+**373 AppKit checks**, including hidden window layout,+in /private/tmp/harness-one-start-tab-native.log; the prior keyboard export+passes **85 native keymap checks**. Native latency benchmarking remains deferred.++The updated start page was rendered and inspected at+/private/tmp/harness-focus-stop-captures/entry-1280-1.0.png. These widget renders+use synthetic data; they do not establish native font metrics or live latency.### Prepared build versus running preview-**Prepared, verified Release through f25e5a2:**+Prepared build location:/private/tmp/harness-pane-controls-release/Build/Products/Release/Harness.app-**Running preview, still the b4baf68 baseline:**+Only supported current preview location:/Users/ab/code/autonomous-harness/desktop/build/macos/Build/Products/Release/Harness.app-The newer bundle has **not** replaced the running preview. The exact preview-process was confirmed as PID 92821 (elapsed 04:55:45) during this checkpoint;-recheck before acting.-The console still reports **CGSSessionScreenIsLocked = Yes**. Earlier exact-path-app-control lookups returned cgWindowNotFound despite the process running.-A lookup failure is not evidence that an app stopped.--Only update the current checkout's preview. The user paused the other checkout;-do not open its retired UI, another fixture, or /Applications/Harness.app.-Do not overwrite a running app bundle while the console is locked. When the-console is accessible, use **Quit and Keep Windows**, verify the exact process-has stopped, back up the preview, copy the verified bundle, verify it, and reopen-that exact path. Ordinary Quit can terminate agents. After quitting, a fresh-app-control lookup can relaunch the app; use the process check before replacing-the bundle. A prior backup exists at-/private/tmp/harness-before-final-entry-0bmbrwl5/Harness.app.--Live checks apply only to the baseline preview: both idle workshop Codex panes-held their latest message/prompt across repeated rows/columns changes and delayed-repaint. The app v2 Codex/Claude workspace also held its bottom after restoring-columns. Both workspaces were returned to their original columns. The current-start-page colors/spacing/device image, absent initial caret, click-to-search,-filtering, arrow selection, New Harness title/CTA, absent Cancel and single-outside-click dismissal were verified there. No real agent received test input.-+The preview was updated through **518977c** using Quit and Keep Windows and+verified visually. The console is accessible; older locked-console notes are+obsolete. Before replacing it with later changes, verify the new Release build+and signatures, use **Quit and Keep Windows**, then check the exact process is+stopped. Back up and replace only the current checkout's bundle, verify it, and+reopen that exact path. Ordinary Quit can terminate agents. Do not call getApp+between quitting and copying, since that lookup can relaunch the app.++A verified previous preview backup is+/private/tmp/harness-before-518977c-o88b2e1p/Harness.app.+Do not open the other checkout's retired UI or /Applications/Harness.app. Do not+restart/upgrade the user's CLI daemon or type test commands into working agents.Temporary logs, SDKs, builds, account state and preview processes do not transfer-to another computer with Git.+with Git.++## Discussion still pending implementation++The **larger New Harness creation form is not implemented**. The discussed+shape is New Project / Existing Folder / Clone Repository, remembered agent,+and compact This Machine / linked-machine choices in a spacious form. A new+project would create its own folder, requiring no picker or typing. Do not infer+the project from the current pane in a multiproject workspace. The user has been+told candidly that entry/chrome polish is separate from this form redesign.++The **search preview remains discussion-only**, explicitly by user request.+The old implementation at f04f6d3 read only already-attached terminal buffers,+showed at most twelve nonblank tail lines, provided no group preview, and froze+the snapshot while the selection stayed put. Terminal prompts/tool noise rarely+answered which task this was or what happened. The failure was content selection+and availability, not simply insufficient preview width.++Current metadata is locally cached, but desktop Agent objects have no actual+prompt/reply excerpts. CLI normalization already yields user messages and replies;+`session_get` can read bounded registered-session windows. `agent_recent` exposes+asks and recaps, but recaps can be device-gated and absent. Do not treat nth ask+and nth recap as paired turns or assume coverage for every engine/remote daemon.++Proposed useful content: latest substantive request, latest meaningful answer or+result, and any waiting question, with project/branch/machine context. Groups+could show one useful line per member, waiting agents first. Precompute bounded+records as events arrive, cache by machine/agent/session revision, and render+cached content immediately on highlight. Refresh in the background, discarding+stale replies. Do not read full transcripts, query remotes, or invoke a model+on each arrow. Fresh uncached remote content cannot have literal zero latency;+keep selection responsive and make stale/offline content honest. Inspect real+examples across engines and cold/remote sessions before implementing this UI.++The three Rex posts and demo visuals/full captions have been reviewed, with no+post-inspired implementation:++- [CLI automation](https://x.com/mitchellh/status/2099622049325232505): named sessions,+ layout manipulation without process restarts, process wait/exit status, events,+ and capture/input APIs. Potential lesson: one coherent human/agent workspace+ model with structured events. Process exit alone does not mean an AI task is done.+- [Appearance](https://x.com/mitchellh/status/2097449191325028407), including the+ [quoted demo](https://x.com/almonk/status/2097439320076403125): coordinated app+ themes and comfortable/compact pane density. Potential lesson: hierarchy,+ spacing and whole-app surfaces matter more than isolated rounded controls.+- [Remote continuity](https://x.com/mitchellh/status/2097424868203758046): persistent+ remote sessions and the same directory navigation in local/remote work.+ Potential lesson: preserve place and interaction habits while keeping machine+ identity clear. The demo is not a measurement of Harness latency.## Runtime and recovery invariants@@ -182,7 +197,8 @@ to another computer with Git.session/buffer/controller and leaves source workspaces intact.- Each workspace retains arrangement and focus. Closing views or tabs preservesruntimes; navigation never sends terminal input or takes over another controller.- Delete continues to use its explicit confirmation.+ Stop Harness continues to use its explicit confirmation; files and saved+ conversations are preserved, but the live process ends.- Reopening one agent and then its original swarm reuses that workspace and addsmissing views, retaining newer names, layout, focus and retained sessions. Ifall missing views cannot fit, preserve the closure; do not partially restore,@@ -221,11 +237,10 @@ to another computer with Git.1. **Continue current main and preserve the current product direction.** Inspectlocal changes before a fast-forward update. Save verified work frequently.- When native access returns, update only the correct preview using the process- above. Do not reopen old UI or repeat unchanged menu checks merely to fill a+ Update only the correct preview using the process above. Do not reopen old UI or repeat unchanged menu checks merely to fill averification gap.2. **Complete current keyboard and genuine first-use qualification.** Check- initially unfocused search, expansion/dismissal, command mode, Tab-focused+ initially focused search with hidden results, expansion/dismissal, command mode, Tab-focusedrows, composition and the first key after activation through both nativemenu and keyboard entry. Check New Harness folder focus/cancellation,Layout repeated chords and confirmation, and Find during output/composition,