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.

Reveal split controls at pane edges

dee456c70cf1ca0
diff --git a/desktop/lib/screens/swarm_screen.dart b/desktop/lib/screens/swarm_screen.dart
index a16be6ab4..ce903a76a 100644
--- a/desktop/lib/screens/swarm_screen.dart
+++ b/desktop/lib/screens/swarm_screen.dart
@@ -680,9 +680,10 @@ class _SwarmScreenState extends State<SwarmScreen> {
}
}
- Future<void> _splitAgent(PaneResizeAxis axis) async {
- final split = app.preparePaneSplit(axis);
+ Future<void> _splitAgent(PaneResizeAxis axis, {int? paneId}) async {
+ final split = app.preparePaneSplit(axis, paneId: paneId);
if (split == null) return;
+ if (paneId != null) app.focusPane(split.paneId);
_openSearch(adding: true, split: split);
}
@@ -1302,6 +1303,9 @@ class _SwarmScreenState extends State<SwarmScreen> {
child: PaneGrid(
notifier: app,
swarmMode: true,
+ onSplit: (paneId, axis) => unawaited(
+ _splitAgent(axis, paneId: paneId),
+ ),
empty: SwarmWelcome(
key: ValueKey(app.activeSwarmId),
notifier: app,
diff --git a/desktop/lib/state/app_state.dart b/desktop/lib/state/app_state.dart
index 011d7635d..26495afb3 100644
--- a/desktop/lib/state/app_state.dart
+++ b/desktop/lib/state/app_state.dart
@@ -817,12 +817,13 @@ class AppNotifier extends ChangeNotifier {
notifyListeners();
}
- PaneSplitRequest? preparePaneSplit(PaneResizeAxis axis) {
+ PaneSplitRequest? preparePaneSplit(PaneResizeAxis axis, {int? paneId}) {
if (zoomedPaneId != null || panes.length >= maxPanes) return null;
+ final targetId = paneId ?? focusedPaneId;
final before = activeSwarm.arranged;
final minimum = activeSwarm.arrangedMinimum;
final index = panes.indexWhere(
- (p) => p.id == focusedPaneId && p.agentId != null,
+ (p) => p.id == targetId && p.agentId != null,
);
if (before == null ||
minimum == null ||
@@ -830,10 +831,10 @@ class AppNotifier extends ChangeNotifier {
return null;
}
final after = before.split(index, axis, minimum: minimum);
- if (after == null || focusedPaneId == null) return null;
+ if (after == null || targetId == null) return null;
return PaneSplitRequest(
swarmId: activeSwarmId,
- paneId: focusedPaneId!,
+ paneId: targetId,
axis: axis,
paneIds: panes.map((p) => p.id),
before: before,
diff --git a/desktop/lib/widgets/pane_grid.dart b/desktop/lib/widgets/pane_grid.dart
index 175de7e28..27e9d60ef 100644
--- a/desktop/lib/widgets/pane_grid.dart
+++ b/desktop/lib/widgets/pane_grid.dart
@@ -26,6 +26,7 @@ import 'new_agent_dialog.dart';
import 'delete_agent_dialog.dart';
import 'terminal_panel.dart';
import 'pane_resize_handle.dart';
+import 'pane_split_edges.dart';
/// Terminal views arranged by the chosen preset. Swarms keep each view under
/// one stable parent as its rectangle, visibility and keyboard focus change.
@@ -35,11 +36,13 @@ class PaneGrid extends StatelessWidget {
required this.notifier,
this.swarmMode = false,
this.empty,
+ this.onSplit,
});
final AppNotifier notifier;
final bool swarmMode;
final Widget? empty;
+ final void Function(int paneId, PaneResizeAxis axis)? onSplit;
@override
Widget build(BuildContext context) {
@@ -51,6 +54,7 @@ class PaneGrid extends StatelessWidget {
notifier: notifier,
dragging: dragging,
empty: empty,
+ onSplit: onSplit,
);
}
final panes = notifier.panes;
@@ -210,10 +214,12 @@ class _SwarmCanvas extends StatefulWidget {
required this.notifier,
required this.dragging,
this.empty,
+ this.onSplit,
});
final AppNotifier notifier;
final AgentDragRef? dragging;
final Widget? empty;
+ final void Function(int paneId, PaneResizeAxis axis)? onSplit;
@override
State<_SwarmCanvas> createState() => _SwarmCanvasState();
}
@@ -357,6 +363,12 @@ class _SwarmCanvasState extends State<_SwarmCanvas> {
pinned: app.isPanePinned(pane),
zoomed: app.zoomedPaneId == pane.id,
canSplit: app.canAddPane,
+ splitRight:
+ widget.onSplit != null &&
+ app.preparePaneSplit(PaneResizeAxis.x, paneId: pane.id) != null,
+ splitDown:
+ widget.onSplit != null &&
+ app.preparePaneSplit(PaneResizeAxis.y, paneId: pane.id) != null,
composer: pane.composerVisible,
blocked:
app.questionFor(pane.machineId, pane.agentId ?? session.agentId) !=
@@ -434,6 +446,7 @@ class _SwarmCanvasState extends State<_SwarmCanvas> {
dragging: widget.dragging,
visible: rectangles.containsKey(pane.id),
swarmMode: true,
+ onSplit: widget.onSplit,
),
),
),
@@ -938,6 +951,7 @@ class _PaneCell extends StatelessWidget {
required this.dragging,
this.visible = true,
this.swarmMode = false,
+ this.onSplit,
});
final AppNotifier notifier;
@@ -945,6 +959,7 @@ class _PaneCell extends StatelessWidget {
final AgentDragRef? dragging;
final bool visible;
final bool swarmMode;
+ final void Function(int paneId, PaneResizeAxis axis)? onSplit;
bool get _single => notifier.panes.length == 1;
@@ -970,88 +985,110 @@ class _PaneCell extends StatelessWidget {
// step with the one the keyboard already went to.
behavior: HitTestBehavior.translucent,
onPointerDown: (_) => notifier.focusPane(pane.id),
- child: Container(
- decoration: BoxDecoration(
- // UNCHANGED, and deliberately: the terminal renders its own background
- // inside this box, so a tile that stops matching the window colour
- // shows a seam between the header strip and the terminal under it.
- // What changes to make the gaps visible is the field BEHIND the grid
- // (see _GridField), which is the part the gaps actually show.
- color: grid.AppPalette.windowBg,
- borderRadius: BorderRadius.circular(_paneRadius),
- // The rim is always drawn — it is what gives an unfocused card its
- // edge, now that no shared line does. It only CHANGES COLOUR on
- // focus, so nothing resizes as focus moves.
- border: Border.all(
- // FOCUS IS THE ENGINE'S OWN COLOUR, not the app's blue.
+ child: ValueListenableBuilder<PaneDragRef?>(
+ valueListenable: paneDragging,
+ builder: (context, inFlight, child) => PaneSplitEdges(
+ enabled:
+ swarmMode &&
+ visible &&
+ agentId != null &&
+ onSplit != null &&
+ notifier.zoomedPaneId == null &&
+ notifier.canAddPane &&
+ dragging == null &&
+ inFlight == null,
+ canSplitRight:
+ notifier.preparePaneSplit(PaneResizeAxis.x, paneId: pane.id) !=
+ null,
+ canSplitDown:
+ notifier.preparePaneSplit(PaneResizeAxis.y, paneId: pane.id) !=
+ null,
+ onSplit: onSplit == null ? null : (axis) => onSplit!(pane.id, axis),
+ child: child!,
+ ),
+ child: Container(
+ decoration: BoxDecoration(
+ // UNCHANGED, and deliberately: the terminal renders its own background
+ // inside this box, so a tile that stops matching the window colour
+ // shows a seam between the header strip and the terminal under it.
+ // What changes to make the gaps visible is the field BEHIND the grid
+ // (see _GridField), which is the part the gaps actually show.
+ color: grid.AppPalette.windowBg,
+ borderRadius: BorderRadius.circular(_paneRadius),
+ // The rim is always drawn — it is what gives an unfocused card its
+ // edge, now that no shared line does. It only CHANGES COLOUR on
+ // focus, so nothing resizes as focus moves.
+ border: Border.all(
+ // FOCUS IS THE ENGINE'S OWN COLOUR, not the app's blue.
+ //
+ // One colour per pane, and only its EXTENT changes: the engine's
+ // line runs along the top edge normally and around all four when
+ // the pane is focused. The blue ring said the same thing in a
+ // second colour — and, worse, the old treatment blanked the band
+ // underneath it, so the focused pane was the one pane on the grid
+ // that no longer told you which engine it was running. It went
+ // quiet exactly when you looked at it.
+ //
+ // Only meaningful with company: a ring around the only tile would
+ // be decoration, since there is nowhere else focus could be.
+ color: !_single && focused ? AppColors.accent : AppColors.border,
+ width: 1,
+ ),
+ ),
+ // Attention, drawn OVER the terminal and inside the border above, so a
+ // pane can carry both at once — this one is blocked AND focused is a
+ // normal state, not a conflict to resolve. It is amber and 2px against
+ // the border's 1px accent precisely so the two never read as each
+ // other. Unlike focus, it shows on a single pane too: with one tile
+ // there is nowhere else focus could be, but there is very much a
+ // question waiting.
+ foregroundDecoration: blocked
+ ? BoxDecoration(
+ border: Border.all(color: grid.AppPalette.warn, width: 2),
+ borderRadius: BorderRadius.circular(_paneRadius),
+ )
+ : null,
+ // Keeps a terminal's constant repainting inside its own layer instead
+ // of dirtying the whole grid. No key: nothing reads this boundary, it
+ // only has to exist.
+ child: ClipRRect(
+ // Clipped HERE rather than through Container's own clipBehavior.
//
- // One colour per pane, and only its EXTENT changes: the engine's
- // line runs along the top edge normally and around all four when
- // the pane is focused. The blue ring said the same thing in a
- // second colour — and, worse, the old treatment blanked the band
- // underneath it, so the focused pane was the one pane on the grid
- // that no longer told you which engine it was running. It went
- // quiet exactly when you looked at it.
+ // Both clip, but they clip to different shapes: Container's is the
+ // decoration's OUTER edge, so the child fills the full radius and
+ // paints under the rim, leaving a square-shouldered corner peeking
+ // through the 1px the rim occupies. This one takes the rim's pixel
+ // off the radius, so the fill stops exactly where the rim starts.
//
- // Only meaningful with company: a ring around the only tile would
- // be decoration, since there is nowhere else focus could be.
- color: !_single && focused ? AppColors.accent : AppColors.border,
- width: 1,
- ),
- ),
- // Attention, drawn OVER the terminal and inside the border above, so a
- // pane can carry both at once — this one is blocked AND focused is a
- // normal state, not a conflict to resolve. It is amber and 2px against
- // the border's 1px accent precisely so the two never read as each
- // other. Unlike focus, it shows on a single pane too: with one tile
- // there is nowhere else focus could be, but there is very much a
- // question waiting.
- foregroundDecoration: blocked
- ? BoxDecoration(
- border: Border.all(color: grid.AppPalette.warn, width: 2),
- borderRadius: BorderRadius.circular(_paneRadius),
- )
- : null,
- // Keeps a terminal's constant repainting inside its own layer instead
- // of dirtying the whole grid. No key: nothing reads this boundary, it
- // only has to exist.
- child: ClipRRect(
- // Clipped HERE rather than through Container's own clipBehavior.
- //
- // Both clip, but they clip to different shapes: Container's is the
- // decoration's OUTER edge, so the child fills the full radius and
- // paints under the rim, leaving a square-shouldered corner peeking
- // through the 1px the rim occupies. This one takes the rim's pixel
- // off the radius, so the fill stops exactly where the rim starts.
- //
- // TerminalPanel opens with a ColoredBox across its whole box, and
- // that is what was reaching the corners.
- borderRadius: BorderRadius.circular(_paneRadius - 1),
- child: RepaintBoundary(
- child: _FileDropZone(
- notifier: notifier,
- pane: pane,
- child: _SwapZone(
+ // TerminalPanel opens with a ColoredBox across its whole box, and
+ // that is what was reaching the corners.
+ borderRadius: BorderRadius.circular(_paneRadius - 1),
+ child: RepaintBoundary(
+ child: _FileDropZone(
notifier: notifier,
- paneId: pane.id,
- child: _DropZone(
+ pane: pane,
+ child: _SwapZone(
notifier: notifier,
paneId: pane.id,
- dragging: dragging,
- child: ValueListenableBuilder<PaneDragRef?>(
- valueListenable: paneDragging,
- // The tile being carried fades where it sits, so the grid shows
- // where it came FROM while the ghost shows where it is going.
- builder: (context, inFlight, child) => Opacity(
- opacity: inFlight?.paneId == pane.id ? 0.35 : 1,
- child: child,
- ),
- child: _PaneContent(
- notifier: notifier,
- pane: pane,
- single: _single,
- visible: visible,
- swarmMode: swarmMode,
+ child: _DropZone(
+ notifier: notifier,
+ paneId: pane.id,
+ dragging: dragging,
+ child: ValueListenableBuilder<PaneDragRef?>(
+ valueListenable: paneDragging,
+ // The tile being carried fades where it sits, so the grid shows
+ // where it came FROM while the ghost shows where it is going.
+ builder: (context, inFlight, child) => Opacity(
+ opacity: inFlight?.paneId == pane.id ? 0.35 : 1,
+ child: child,
+ ),
+ child: _PaneContent(
+ notifier: notifier,
+ pane: pane,
+ single: _single,
+ visible: visible,
+ swarmMode: swarmMode,
+ ),
),
),
),
diff --git a/desktop/lib/widgets/pane_split_edges.dart b/desktop/lib/widgets/pane_split_edges.dart
new file mode 100644
index 000000000..7ea4c2a22
--- /dev/null
+++ b/desktop/lib/widgets/pane_split_edges.dart
@@ -0,0 +1,169 @@
+import 'package:flutter/gestures.dart';
+import 'package:flutter/material.dart';
+import 'package:lucide_icons_flutter/lucide_icons.dart';
+
+import '../shared/theme/app_theme.dart' as grid;
+import '../state/pane_arrangement.dart';
+import '../theme/app_theme.dart';
+
+/// Reveals split controls inside the pane, leaving the resize gap untouched.
+/// Hover state stays here so pointer movement never rebuilds the terminal.
+class PaneSplitEdges extends StatefulWidget {
+ const PaneSplitEdges({
+ super.key,
+ required this.child,
+ required this.enabled,
+ required this.canSplitRight,
+ required this.canSplitDown,
+ required this.onSplit,
+ });
+
+ final Widget child;
+ final bool enabled, canSplitRight, canSplitDown;
+ final ValueChanged<PaneResizeAxis>? onSplit;
+
+ @override
+ State<PaneSplitEdges> createState() => _PaneSplitEdgesState();
+}
+
+class _PaneSplitEdgesState extends State<PaneSplitEdges> {
+ static const _buttonSize = 32.0;
+ static const _inset = 8.0;
+ static const _edgeWidth = 44.0;
+ PaneResizeAxis? _edge;
+ Size _size = Size.zero;
+
+ @override
+ void didUpdateWidget(PaneSplitEdges oldWidget) {
+ super.didUpdateWidget(oldWidget);
+ if (!widget.enabled) _edge = null;
+ }
+
+ void _reveal(PaneResizeAxis? edge) {
+ if (_edge == edge) return;
+ setState(() => _edge = edge);
+ }
+
+ void _hover(PointerHoverEvent event) {
+ if (!widget.enabled || event.buttons != 0) return;
+ final point = event.localPosition;
+ // Leave the header controls and both bottom corners alone. Once revealed,
+ // the button itself stays inside the same hover band as the edge.
+ final bottom =
+ point.dy >= _size.height - _edgeWidth &&
+ point.dx >= _edgeWidth &&
+ point.dx <= _size.width - _edgeWidth;
+ final right =
+ point.dx >= _size.width - _edgeWidth &&
+ point.dy >= 60 &&
+ point.dy < _size.height - _edgeWidth;
+ _reveal(
+ bottom
+ ? PaneResizeAxis.y
+ : right
+ ? PaneResizeAxis.x
+ : null,
+ );
+ }
+
+ Rect _buttonRect(PaneResizeAxis axis) => axis == PaneResizeAxis.x
+ ? Rect.fromLTWH(
+ _size.width - _inset - _buttonSize,
+ (_size.height - _buttonSize) / 2,
+ _buttonSize,
+ _buttonSize,
+ )
+ : Rect.fromLTWH(
+ (_size.width - _buttonSize) / 2,
+ _size.height - _inset - _buttonSize,
+ _buttonSize,
+ _buttonSize,
+ );
+
+ void _pressed(PointerDownEvent event) {
+ final edge = _edge;
+ if (edge != null && !_buttonRect(edge).contains(event.localPosition)) {
+ _reveal(null);
+ }
+ }
+
+ Widget _button(PaneResizeAxis axis) {
+ final visible = widget.enabled && _edge == axis;
+ final right = axis == PaneResizeAxis.x;
+ final available = right ? widget.canSplitRight : widget.canSplitDown;
+ final label = right ? 'Split right' : 'Split down';
+ return Positioned.fromRect(
+ rect: _buttonRect(axis),
+ child: IgnorePointer(
+ ignoring: !visible,
+ child: ExcludeFocus(
+ excluding: !visible,
+ child: ExcludeSemantics(
+ excluding: !visible,
+ child: AnimatedOpacity(
+ opacity: visible ? 1 : 0,
+ duration: MediaQuery.disableAnimationsOf(context)
+ ? Duration.zero
+ : const Duration(milliseconds: 100),
+ child: IconButton(
+ key: ValueKey(right ? 'pane-split-right' : 'pane-split-down'),
+ tooltip: available
+ ? label
+ : right
+ ? 'Make this pane wider to split right'
+ : 'Make this pane taller to split down',
+ onPressed: available && widget.onSplit != null
+ ? () {
+ _reveal(null);
+ widget.onSplit!(axis);
+ }
+ : null,
+ icon: const Icon(LucideIcons.plus, size: 18),
+ style: IconButton.styleFrom(
+ fixedSize: const Size.square(_buttonSize),
+ minimumSize: const Size.square(_buttonSize),
+ padding: EdgeInsets.zero,
+ tapTargetSize: MaterialTapTargetSize.shrinkWrap,
+ visualDensity: VisualDensity.standard,
+ foregroundColor: grid.AppPalette.swarmAccent,
+ disabledForegroundColor: AppColors.mutedStrong,
+ backgroundColor: AppColors.surface,
+ disabledBackgroundColor: AppColors.surface,
+ hoverColor: grid.AppSurface.hoverFill,
+ shape: CircleBorder(
+ side: BorderSide(color: AppColors.borderStrong),
+ ),
+ ),
+ ),
+ ),
+ ),
+ ),
+ ),
+ );
+ }
+
+ @override
+ Widget build(BuildContext context) {
+ grid.AppTheme.watch(context);
+ return LayoutBuilder(
+ builder: (context, constraints) {
+ _size = constraints.biggest;
+ return MouseRegion(
+ onHover: _hover,
+ onExit: (_) => _reveal(null),
+ child: Listener(
+ onPointerDown: _pressed,
+ child: Stack(
+ fit: StackFit.expand,
+ children: [
+ widget.child,
+ _button(PaneResizeAxis.x),
+ _button(PaneResizeAxis.y),
+ ],
+ ),
+ ),
+ );
+ },
+ );
+ }
+}
diff --git a/desktop/test/swarm_split_test.dart b/desktop/test/swarm_split_test.dart
index 0f6132900..51286e9a6 100644
--- a/desktop/test/swarm_split_test.dart
+++ b/desktop/test/swarm_split_test.dart
@@ -1,5 +1,6 @@
import 'dart:async';
+import 'package:flutter/gestures.dart';
import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:flutter_test/flutter_test.dart';
@@ -44,6 +45,106 @@ class _Creation extends WsConn {
}
void main() {
+ for (final axis in PaneResizeAxis.values) {
+ final direction = axis == PaneResizeAxis.x ? 'right' : 'down';
+ testWidgets(
+ 'hover split $direction targets that pane without disturbing its neighbor',
+ (tester) async {
+ final app = createApp();
+ final machine = app.machineStates['m']!;
+ machine.nodeOnline = true;
+ machine.localOnly = true;
+ machine.agents[2] = const Agent(
+ id: 'a2',
+ name: 'Existing helper',
+ engine: 'codex',
+ terminalAvailable: true,
+ );
+ final frames = <TerminalBinaryFrame>[];
+ final first = app.adoptSessionForTest(terminal('a0', frames));
+ final neighbor = app.adoptSessionForTest(terminal('a1', frames));
+ final original = app.activeSwarmId;
+ app.newSwarm();
+ final helper = app.adoptSessionForTest(terminal('a2', frames));
+ app.selectSwarm(original);
+ app.focusPane(neighbor.id);
+ await mountWide(tester, app);
+ tester.view.physicalSize = const Size(3000, 1800);
+ await tester.pump();
+ final target = find.byKey(first.cellKey);
+ final rect = tester.getRect(target);
+ final neighborRect = tester.getRect(find.byKey(neighbor.cellKey));
+ final view = find.descendant(
+ of: target,
+ matching: find.byType(TerminalView),
+ );
+ final retained = tester.element(view);
+ final previousFocus = FocusManager.instance.primaryFocus;
+ final button = find.descendant(
+ of: target,
+ matching: find.byKey(ValueKey('pane-split-$direction')),
+ );
+ expect(button.hitTestable(), findsNothing);
+ final mouse = await tester.createGesture(kind: PointerDeviceKind.mouse);
+ await mouse.addPointer(location: rect.center);
+ await mouse.moveTo(
+ axis == PaneResizeAxis.x
+ ? Offset(rect.right - 2, rect.center.dy)
+ : Offset(rect.center.dx, rect.bottom - 2),
+ );
+ await tester.pump(const Duration(milliseconds: 120));
+ expect(button.hitTestable(), findsOneWidget);
+ expect(app.focusedPaneId, neighbor.id);
+ expect(FocusManager.instance.primaryFocus, same(previousFocus));
+ expect(tester.element(view), same(retained));
+ expect(tester.getRect(target), rect);
+ expect(frames, isEmpty);
+
+ // Moving from the border onto the inset button must keep it visible.
+ await mouse.moveTo(tester.getCenter(button));
+ await tester.pump();
+ expect(button.hitTestable(), findsOneWidget);
+ await mouse.down(tester.getCenter(button));
+ await mouse.up();
+ await tester.pump();
+ final search = find.byKey(const ValueKey('swarm-search-input'));
+ expect(search, findsOneWidget);
+ expect(
+ find.byKey(const ValueKey('swarm-search-new-agent')),
+ findsOneWidget,
+ );
+ expect(app.focusedPaneId, first.id);
+ await tester.enterText(search, 'Existing helper');
+ await tester.pump();
+ await tester.sendKeyEvent(LogicalKeyboardKey.enter);
+ await tester.pump();
+ expect(search, findsNothing);
+ expect(app.panes, [first, helper, neighbor]);
+ expect(tester.element(view), same(retained));
+ expect(tester.getRect(find.byKey(neighbor.cellKey)), neighborRect);
+ final splitRect = tester.getRect(target);
+ final addedRect = tester.getRect(find.byKey(helper.cellKey));
+ if (axis == PaneResizeAxis.x) {
+ expect(addedRect.left, greaterThan(splitRect.right));
+ expect(addedRect.top, splitRect.top);
+ expect(addedRect.height, splitRect.height);
+ } else {
+ expect(addedRect.top, greaterThan(splitRect.bottom));
+ expect(addedRect.left, splitRect.left);
+ expect(addedRect.width, splitRect.width);
+ }
+ expect(frames, isEmpty);
+ await tester.sendKeyEvent(LogicalKeyboardKey.arrowRight);
+ await tester.pump(const Duration(milliseconds: 10));
+ expect(frames.single.streamId, helper.session!.streamId);
+ expect(frames.single.bytes, [27, 91, 67]);
+ await mouse.removePointer();
+ await tester.pumpWidget(const SizedBox());
+ app.dispose();
+ },
+ );
+ }
+
testWidgets(
'manual split keeps neighboring terminals and pins, restores offline and closes/reopens precisely',
(tester) async {
diff --git a/docs/harness-v2-handoff.md b/docs/harness-v2-handoff.md
index 572dc4e67..90460bdde 100644
--- a/docs/harness-v2-handoff.md
+++ b/docs/harness-v2-handoff.md
@@ -11,7 +11,7 @@ This is the current product contract and next-work order. It supersedes conflict
historical checkpoints in [the progress log](harness-v2-progress.md). The user
requested a portable checkpoint and later paused the broader goal pending a
breaking change. The goal remains unfinished and is currently blocked. The latest
-pane-header simplification is a separately authorized, bounded change; wait for
+pane-header and hover-edge controls are separately authorized, bounded changes; wait for
the user's instruction before resuming the broader backlog.
**Latest priority:** the user explicitly deferred native benchmarking and further
@@ -28,10 +28,22 @@ archive/delete existing user sessions.
Pane headers now have three direct outline icons, in order: **Zoom**, **Delete
agent**, **Close pane**. The overflow menu, split actions and pin control are gone
from the header. Delete opens the existing confirmation; Close removes only this
-view and keeps the agent running. The native/menu close-view action remains
-**Remove from swarm**. Narrow headers give the name priority over the branch
+view and keeps the agent running. The native/menu close-view action is now
+**Close Agent Pane**. Narrow headers give the name priority over the branch
label; the identity tooltip retains the branch and working folder.
+Hover near a pane's right or bottom edge to reveal an inset **+** for that
+direction. Clicking it opens the shared Add Agent picker, supporting an existing
+agent or **Create Agent** in the chosen position. Keyboard split commands remain
+available. Hover does not change focus or rebuild the terminal; the resize gaps
+remain draggable. Controls stay hidden while zoomed or dragging, and a pane too
+small for the chosen split explains the required width/height in its tooltip.
+This was integrated after the team's agent-first update on main (`16716d0`).
+Twenty-four affected checks pass, with no analyzer errors or warnings. The arm64
+Release build was reopened from the exact workspace bundle at the user's request
+and confirmed active (PID 18687). Recheck the process before future app actions;
+this does not verify native latency. Log: `/private/tmp/harness-split-edges-release.log`.
+
History recovery also reuses a partially restored swarm: reopening an agent and
then its original swarm adds the missing views to the same tab, retaining newer
choices and live sessions. No runtime cleanup was introduced.
diff --git a/docs/harness-v2-progress.md b/docs/harness-v2-progress.md
index 09b4166fb..6289a3cc1 100644
--- a/docs/harness-v2-progress.md
+++ b/docs/harness-v2-progress.md
@@ -6,6 +6,24 @@ Updated 2026-09-14 after integrating the continuation into main. This is a worki
## Continue directly on main
+- Added hover split controls inside the right and bottom pane edges. Each **+**
+ opens shared Add Agent at that position; existing-agent reuse and Create Agent
+ both remain available. Headers retain only Zoom, Delete and Close. Hover is
+ local to the overlay, preserves terminal focus/geometry, and leaves resize
+ gaps untouched. The controls are suppressed for zoom/drag/capacity; minimum
+ pane sizes produce an explanatory disabled tooltip. Pulled the team's
+ agent-first main update (`16716d0`) and preserved its tabs, search and menu
+ changes. All 24 affected workflow checks pass, including mouse activation
+ on an unfocused pane in both directions, retained terminals, unchanged
+ neighbors, resize/cancel recovery and input routing. Analysis reports zero
+ errors/warnings and the 14 existing infos. Logs:
+ `/private/tmp/harness-split-edges-{tests,analyze}.log`. The arm64 Release build
+ succeeds (`/private/tmp/harness-split-edges-release.log`). At the user's request,
+ normally closed the exact workspace preview, replaced its bundle with the
+ verified build and reopened it. Confirmed PID 18687 active at
+ `desktop/build/macos/Build/Products/Release/Harness.app`; the installed app
+ remained running separately. These are process observations, not native
+ latency measurements. Benchmarking and the broader goal stay deferred.
- Simplified the pane header to three direct outline icons: Zoom, Delete agent,
Close pane. Removed the overflow menu and its split/pin controls. Delete still
opens the shared confirmation; closing a pane preserves the agent and its