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.

Tab for the group of panes; "Choose a harness" in New Agent

deeb38991b9e288
diff --git a/desktop/lib/screens/swarm_screen.dart b/desktop/lib/screens/swarm_screen.dart
index 8cd903b65..cab842e41 100644
--- a/desktop/lib/screens/swarm_screen.dart
+++ b/desktop/lib/screens/swarm_screen.dart
@@ -1570,7 +1570,7 @@ class _SwarmScreenState extends State<SwarmScreen> {
IconButton(
key: const ValueKey('swarm-new-tab-button'),
onPressed: app.canOpenNewTab ? _newTab : null,
- icon: const Icon(Icons.add, size: 18, semanticLabel: 'New Harness'),
+ icon: const Icon(Icons.add, size: 18, semanticLabel: 'New Tab'),
),
_harnessButton(create: true),
const SizedBox(width: 10),
diff --git a/desktop/lib/shortcuts/app_shortcuts.dart b/desktop/lib/shortcuts/app_shortcuts.dart
index 8d151f227..fe2a8e211 100644
--- a/desktop/lib/shortcuts/app_shortcuts.dart
+++ b/desktop/lib/shortcuts/app_shortcuts.dart
@@ -354,7 +354,7 @@ const kSwarmShortcuts = [
AppShortcut(
action: ShortcutAction.newSwarm,
activator: SingleActivator(LogicalKeyboardKey.keyT, meta: true),
- label: 'New Harness',
+ label: 'New Tab',
group: ShortcutGroup.navigate,
),
AppShortcut(
@@ -370,7 +370,7 @@ const kSwarmShortcuts = [
AppShortcut(
action: ShortcutAction.closeSwarm,
activator: SingleActivator(LogicalKeyboardKey.keyW, meta: true),
- label: 'Close Harness',
+ label: 'Close Tab',
group: ShortcutGroup.navigate,
),
AppShortcut(
@@ -380,7 +380,7 @@ const kSwarmShortcuts = [
meta: true,
shift: true,
),
- label: 'Rename Harness',
+ label: 'Rename Tab',
group: ShortcutGroup.navigate,
),
AppShortcut(
diff --git a/desktop/lib/shortcuts/keymap_commands.dart b/desktop/lib/shortcuts/keymap_commands.dart
index d1e24e1c1..531932607 100644
--- a/desktop/lib/shortcuts/keymap_commands.dart
+++ b/desktop/lib/shortcuts/keymap_commands.dart
@@ -56,14 +56,14 @@ final harnessCommands = <HarnessCommand>[
),
const HarnessCommand(
'swarm.new',
- 'New Harness',
+ 'New Tab',
ShortcutGroup.navigate,
action: ShortcutAction.newSwarm,
nativeAction: 'new',
),
const HarnessCommand(
'swarm.close',
- 'Close Harness',
+ 'Close Tab',
ShortcutGroup.navigate,
action: ShortcutAction.closeSwarm,
nativeAction: 'closeActive',
@@ -93,7 +93,7 @@ final harnessCommands = <HarnessCommand>[
),
const HarnessCommand(
'swarm.rename',
- 'Rename Harness',
+ 'Rename Tab',
ShortcutGroup.actions,
action: ShortcutAction.renameSwarm,
nativeAction: 'renameActive',
diff --git a/desktop/lib/state/app_state.dart b/desktop/lib/state/app_state.dart
index c5b9bb0a2..251901b7b 100644
--- a/desktop/lib/state/app_state.dart
+++ b/desktop/lib/state/app_state.dart
@@ -528,7 +528,7 @@ class AppNotifier extends ChangeNotifier {
bool get canOpenNewTab =>
swarms.length < maxSwarms || swarms.any((swarm) => swarm.isEmptyStarter);
- // A New Harness remains temporary until it has content or a custom name.
+ // A New Tab remains temporary until it has content or a custom name.
// The return destination is session-local; abandoned drafts are never saved.
final _draftSwarmReturns = <String, String>{};
@@ -543,7 +543,7 @@ class AppNotifier extends ChangeNotifier {
void newSwarm({String name = Swarm.defaultName, bool draft = false}) {
name = Swarm.normalizeName(name);
- // Every New Harness entry point reuses the existing start page, including
+ // Every New Tab entry point reuses the existing start page, including
// when another tab is selected or the tab limit has been reached.
if (name == Swarm.defaultName) {
final starter = activeSwarm.isEmptyStarter
@@ -588,7 +588,7 @@ class AppNotifier extends ChangeNotifier {
notifyListeners();
}
- /// Cancel an untouched New Harness without closing a session or recording
+ /// Cancel an untouched New Tab without closing a session or recording
/// Recently Closed. A sole workspace remains the app's starting screen.
bool cancelSwarmDraft(String id) {
final returnId = _draftSwarmReturns[id];
@@ -4377,7 +4377,7 @@ class AppNotifier extends ChangeNotifier {
var targetId = split?.swarmId ?? swarmId ?? activeSwarmId;
// A harness gets a tab of its own, named after it: its viewer is the
// product and needs the width, and the two tiles read as one workspace
- // rather than two more tiles in whatever tab was open. A New Harness
+ // rather than two more tiles in whatever tab was open. A New Tab
// start page the user is already on IS that tab. A split was asked for
// by name and wins; so does a tab other than the current one. The
// current tab is what the dialog passes when nothing was chosen.
diff --git a/desktop/lib/state/swarm.dart b/desktop/lib/state/swarm.dart
index 2e6bcdea8..5ab48ae1d 100644
--- a/desktop/lib/state/swarm.dart
+++ b/desktop/lib/state/swarm.dart
@@ -11,9 +11,17 @@ class Swarm {
Swarm({required this.id, String name = defaultName})
: name = normalizeName(name);
- static const defaultName = 'New Harness';
+ static const defaultName = 'New Tab';
+ // 'New Harness' was the default until 2026-09-15; a layout saved before then
+ // still carries it, and it must read as the same fresh tab.
static String normalizeName(String name) =>
- const {'New swarm', 'New tab', 'New Tab', 'New Agent'}.contains(name)
+ const {
+ 'New swarm',
+ 'New tab',
+ 'New Tab',
+ 'New Harness',
+ 'New Agent',
+ }.contains(name)
? defaultName
: name;
diff --git a/desktop/lib/widgets/new_agent_dialog.dart b/desktop/lib/widgets/new_agent_dialog.dart
index 559d408ef..dbc30b118 100644
--- a/desktop/lib/widgets/new_agent_dialog.dart
+++ b/desktop/lib/widgets/new_agent_dialog.dart
@@ -733,7 +733,7 @@ class _NewAgentDialogState extends State<_NewAgentDialog> {
mainAxisSize: MainAxisSize.min,
crossAxisAlignment: CrossAxisAlignment.start,
children: [
- _sectionLabel('Choose an engine'),
+ _sectionLabel('Choose a harness'),
AgentPicker(
compact: true,
tileSize: tileSize,
diff --git a/desktop/lib/widgets/swarm_dialogs.dart b/desktop/lib/widgets/swarm_dialogs.dart
index 7ade8bba9..75a748511 100644
--- a/desktop/lib/widgets/swarm_dialogs.dart
+++ b/desktop/lib/widgets/swarm_dialogs.dart
@@ -33,7 +33,7 @@ class _RenameSwarmDialogState extends State<_RenameSwarmDialog> {
late final _text = TextEditingController(
text: widget.name,
)..selection = TextSelection(baseOffset: 0, extentOffset: widget.name.length);
- final _focus = FocusNode(debugLabel: 'Rename Harness name');
+ final _focus = FocusNode(debugLabel: 'Rename Tab name');
@override
void initState() {
@@ -68,7 +68,7 @@ class _RenameSwarmDialogState extends State<_RenameSwarmDialog> {
return ListenableBuilder(
listenable: _text,
builder: (context, _) => AlertDialog(
- title: const Text('Rename Harness'),
+ title: const Text('Rename Tab'),
titleTextStyle: Theme.of(context).textTheme.titleMedium,
content: SizedBox(
width: 360,
diff --git a/desktop/macos/Runner/SwarmTitlebar.swift b/desktop/macos/Runner/SwarmTitlebar.swift
index baaf1c1b7..975309efa 100644
--- a/desktop/macos/Runner/SwarmTitlebar.swift
+++ b/desktop/macos/Runner/SwarmTitlebar.swift
@@ -234,11 +234,11 @@ final class SwarmTitlebar: NSObject, NSMenuItemValidation, NSMenuDelegate {
}
if let file = main.item(withTitle: "File") { main.removeItem(file) }
let file = NSMenu(title: "File")
- add(file, "New Harness", "t", "new")
+ add(file, "New Tab", "t", "new")
add(file, "New Agent…", "n", "newAgent")
add(file, "Open Agent…", "o", "addAgent")
- add(file, "Rename Harness…", "r", "renameActive", [.command, .shift])
- add(file, "Close Harness", "w", "closeActive")
+ add(file, "Rename Tab…", "r", "renameActive", [.command, .shift])
+ add(file, "Close Tab", "w", "closeActive")
file.addItem(.separator())
add(file, "Split Right…", "r", "splitRight")
add(file, "Split Down…", "d", "splitDown")
@@ -1111,8 +1111,8 @@ private final class SwarmTabStrip: NSView {
button.setAccessibilityLabel(label)
addSubview(button)
}
- button(newButton, "plus", "New Harness", #selector(newSwarm))
- newButton.setAccessibilityLabel("New Harness")
+ button(newButton, "plus", "New Tab", #selector(newSwarm))
+ newButton.setAccessibilityLabel("New Tab")
newButton.isEnabled = false
button(notificationButton, "bell", "Notifications", #selector(openNotifications))
notificationButton.isEnabled = false
@@ -1190,13 +1190,13 @@ private final class SwarmTabStrip: NSView {
guard let id = row["id"] as? String else { return nil }
let tab = previous[id] ?? SwarmTabButton(id: id)
tab.palette = palette
- tab.name = row["name"] as? String ?? "New Harness"
+ tab.name = row["name"] as? String ?? "New Tab"
let count = row["agentCount"] as? Int ?? 0
tab.icon = count == 1
? icons.image(engine: row["engine"] as? String, asset: row["iconAsset"] as? String)
: count > 1
? SwarmIdentity.menuIcon
- : NSImage(systemSymbolName: "plus", accessibilityDescription: "New Harness")
+ : NSImage(systemSymbolName: "plus", accessibilityDescription: "New Tab")
tab.selected = id == activeId
tab.actionsEnabled = actionsEnabled
tab.attention = (row["attention"] as? Int ?? 0) > 0
@@ -1341,7 +1341,7 @@ private final class SwarmTabButton: NSView, NSDraggingSource, NSMenuItemValidati
didSet { if palette != oldValue { needsDisplay = true } }
}
let swarmId: String
- var name = "New Harness" { didSet { if name != oldValue { invalidateLabel(); updateAccessibility() } } }
+ var name = "New Tab" { didSet { if name != oldValue { invalidateLabel(); updateAccessibility() } } }
var selected = false { didSet { if selected != oldValue { invalidateLabel(); updateAccessibility() } } }
var attention = false { didSet { if attention != oldValue { needsDisplay = true; updateAccessibility() } } }
var showsDivider = false { didSet { if showsDivider != oldValue { needsDisplay = true } } }
@@ -1387,7 +1387,7 @@ private final class SwarmTabButton: NSView, NSDraggingSource, NSMenuItemValidati
selectButton.target = self
selectButton.action = #selector(selectSwarm)
addSubview(selectButton)
- closeButton.image = NSImage(systemSymbolName: "xmark", accessibilityDescription: "Close Harness")
+ closeButton.image = NSImage(systemSymbolName: "xmark", accessibilityDescription: "Close Tab")
closeButton.symbolConfiguration = NSImage.SymbolConfiguration(pointSize: 10, weight: .semibold)
closeButton.contentTintColor = NSColor(white: 0.78, alpha: 1)
closeButton.isBordered = false
@@ -1395,7 +1395,7 @@ private final class SwarmTabButton: NSView, NSDraggingSource, NSMenuItemValidati
closeButton.action = #selector(closeSwarm)
addSubview(closeButton)
let menu = NSMenu()
- for (title, action) in [("Rename Harness…", #selector(renameSwarm)), ("Close Harness", #selector(closeSwarm))] {
+ for (title, action) in [("Rename Tab…", #selector(renameSwarm)), ("Close Tab", #selector(closeSwarm))] {
let item = NSMenuItem(title: title, action: action, keyEquivalent: "")
item.target = self
menu.addItem(item)
diff --git a/desktop/test/harness_tab_test.dart b/desktop/test/harness_tab_test.dart
index d9aab81cf..861c80d0e 100644
--- a/desktop/test/harness_tab_test.dart
+++ b/desktop/test/harness_tab_test.dart
@@ -1,5 +1,5 @@
// A harness created from the dialog gets a tab of its own, named after the
-// harness — the viewer is the product and needs the width. A New Harness start
+// harness — the viewer is the product and needs the width. A New Tab start
// page the user is already on is that tab; a tab with work in it is left alone.
import 'dart:async';
diff --git a/desktop/test/keymap_runtime_test.dart b/desktop/test/keymap_runtime_test.dart
index 3edbd3fd3..c42921b41 100644
--- a/desktop/test/keymap_runtime_test.dart
+++ b/desktop/test/keymap_runtime_test.dart
@@ -177,7 +177,7 @@ void main() {
map.dispose();
});
- testWidgets('Command-T opens New Harness and Command-S opens Layout', (
+ testWidgets('Command-T opens New Tab and Command-S opens Layout', (
tester,
) async {
final app = createApp();
diff --git a/desktop/test/swarm_entry_picker_test.dart b/desktop/test/swarm_entry_picker_test.dart
index 8f55f9352..385d98441 100644
--- a/desktop/test/swarm_entry_picker_test.dart
+++ b/desktop/test/swarm_entry_picker_test.dart
@@ -174,7 +174,7 @@ void main() {
for (final dismissal in ['outside', 'escape']) {
testWidgets(
- 'New Harness has a usable page after $dismissal (native=$native)',
+ 'New Tab has a usable page after $dismissal (native=$native)',
(tester) async {
final app = createApp();
final frames = <TerminalBinaryFrame>[];
diff --git a/desktop/test/swarm_interactions_test.dart b/desktop/test/swarm_interactions_test.dart
index 128818f8b..2a1a95043 100644
--- a/desktop/test/swarm_interactions_test.dart
+++ b/desktop/test/swarm_interactions_test.dart
@@ -70,7 +70,7 @@ Future<void> chord(
void main() {
for (final native in [false, true]) {
testWidgets(
- 'New Harness actions reuse the existing page (native: $native)',
+ 'New Tab actions reuse the existing page (native: $native)',
(tester) async {
const channel = MethodChannel('harness/swarm_tabs');
const codec = StandardMethodCodec();
@@ -121,7 +121,7 @@ void main() {
await chord(tester, LogicalKeyboardKey.keyP, shift: true);
await tester.enterText(
find.byKey(const ValueKey('swarm-search-input')),
- 'New Harness',
+ 'New Tab',
);
await tester.pump();
await tester.sendKeyEvent(LogicalKeyboardKey.enter);
@@ -367,7 +367,7 @@ void main() {
expect(input.single.streamId, 'stream-a1');
expect(String.fromCharCodes(input.single.bytes), 'x');
await activate('rename', {'id': second});
- expect(find.text('Rename Harness'), findsOneWidget);
+ expect(find.text('Rename Tab'), findsOneWidget);
final name = tester.widget<TextField>(find.byType(TextField));
expect(name.focusNode!.hasPrimaryFocus, isTrue);
tester.testTextInput.enterText('Keyboard work');
diff --git a/desktop/test/swarm_screen_test.dart b/desktop/test/swarm_screen_test.dart
index 4fc943dff..1678e5cf9 100644
--- a/desktop/test/swarm_screen_test.dart
+++ b/desktop/test/swarm_screen_test.dart
@@ -120,7 +120,7 @@ void main() {
final app = createApp();
final tab = app.activeSwarm;
await mount(tester, app, nativeTabs: native);
- expect(tab.name, 'New Harness');
+ expect(tab.name, 'New Tab');
expect(
find.byKey(const ValueKey('harness-start-search')),
findsOneWidget,
diff --git a/desktop/test/swarm_state_test.dart b/desktop/test/swarm_state_test.dart
index 01c13779f..99c55dbc7 100644
--- a/desktop/test/swarm_state_test.dart
+++ b/desktop/test/swarm_state_test.dart
@@ -61,7 +61,7 @@ AppNotifier createApp({
void main() {
test(
- 'New Harness reuses the unused page from every tab, even at capacity',
+ 'New Tab reuses the unused page from every tab, even at capacity',
() async {
final app = createApp();
addTearDown(app.dispose);
@@ -135,10 +135,10 @@ void main() {
'New tab',
'New Tab',
'New Agent',
- 'New Harness',
+ 'New Tab',
]) {
test(
- '$legacy empty tabs restore as New Harness and number the first occupied tab',
+ '$legacy empty tabs restore as New Tab and number the first occupied tab',
() async {
final store = MemoryStore();
final original = createApp(store: store);
@@ -153,7 +153,7 @@ void main() {
final restored = createApp(store: store);
addTearDown(restored.dispose);
await restored.restorePaneLayoutForTest();
- expect(restored.activeSwarm.name, 'New Harness');
+ expect(restored.activeSwarm.name, 'New Tab');
await restored.addAgentToSwarm('m', 'a0');
expect(restored.activeSwarm.name, 'harness-1');
},
diff --git a/desktop/test/swarm_switcher_test.dart b/desktop/test/swarm_switcher_test.dart
index 57010ee0c..cb8eebe29 100644
--- a/desktop/test/swarm_switcher_test.dart
+++ b/desktop/test/swarm_switcher_test.dart
@@ -17,7 +17,7 @@ Finder get selectedRow =>
void main() {
for (final nativeTabs in [false, true]) {
testWidgets(
- 'New Harness offers Open Agent and preserves the selected runtime (native=$nativeTabs)',
+ 'New Tab offers Open Agent and preserves the selected runtime (native=$nativeTabs)',
(tester) async {
const channel = MethodChannel('harness/swarm_tabs');
tester.binding.defaultBinaryMessenger.setMockMethodCallHandler(
@@ -56,7 +56,7 @@ void main() {
}
final opened = app.activeSwarm;
expect(opened, isNot(same(original)));
- expect(opened.name, 'New Harness');
+ expect(opened.name, 'New Tab');
expect(opened.panes, isEmpty);
expect(find.byType(AlertDialog), findsNothing);
await chord(tester, LogicalKeyboardKey.keyO);
@@ -107,7 +107,7 @@ void main() {
expect(harnessCommandById['agent.new']!.label, 'New Agent');
await tester.tap(find.byKey(const ValueKey('command:swarm.new')));
await tester.pump();
- expect(app.activeSwarm.name, 'New Harness');
+ expect(app.activeSwarm.name, 'New Tab');
expect(app.panes, isEmpty);
expect(app.allPanes, contains(pane));
expect(find.byKey(const ValueKey('harness-start-search')), findsOneWidget);
diff --git a/desktop/tool/swarm_titlebar_checks.swift b/desktop/tool/swarm_titlebar_checks.swift
index 79782c5ea..7670188e9 100644
--- a/desktop/tool/swarm_titlebar_checks.swift
+++ b/desktop/tool/swarm_titlebar_checks.swift
@@ -223,11 +223,11 @@ private extension SwarmTabStrip {
fullWithStarter["canOpenNewTab"] = true
update(fullWithStarter)
try checkTitlebar(newButton.isEnabled,
- "New Harness can reveal an existing starter at the tab limit")
+ "New Tab can reveal an existing starter at the tab limit")
fullWithStarter["canOpenNewTab"] = false
update(fullWithStarter)
try checkTitlebar(!newButton.isEnabled,
- "New Harness respects the workspace's availability")
+ "New Tab respects the workspace's availability")
update(state([["id": "swarm-0", "name": "Renamed tab"]], active: "swarm-0"))
try checkTitlebar(newButton.toolTip == nil && openButton.toolTip == nil,
"Titlebar actions add no hover hints")
@@ -516,7 +516,7 @@ private extension SwarmTitlebar {
try checkTitlebar(!main.performKeyEquivalent(with: open), "Menu equivalents defer before input dispatch")
setKeymap(defaults)
try checkTitlebar(strip.newButton.toolTip == nil, "Keymap reload does not restore hover hints")
- try checkTitlebar(strip.newButton.accessibilityLabel() == "New Harness", "The plus announces New Harness")
+ try checkTitlebar(strip.newButton.accessibilityLabel() == "New Tab", "The plus announces New Tab")
try checkTitlebar(main.defersToInput(event("n", 45, .command)) && main.defersToInput(event("o", 31, .command)),
"Command-N and Command-O reach their separate New and Open actions")
try checkTitlebar(!main.defersToInput(event("p", 35, .command)), "Command-P no longer opens Navigate")
@@ -586,12 +586,12 @@ private extension SwarmTitlebar {
try checkTitlebar(agent.items.map { $0.isSeparatorItem ? "separator" : ($0.representedObject as? String ?? "") } == ["new", "newAgent", "addAgent", "renameActive", "closeActive", "separator", "splitRight", "splitDown", "zoomPane", "closePane"], "File groups Harness and Pane actions, without Pin or Add Project clutter")
try checkTitlebar(agent.items.filter { !$0.isSeparatorItem }.allSatisfy { $0.image != nil && $0.toolTip == nil },
"Every File action has a native icon and no hover hint")
- try checkTitlebar(agent.items.contains { $0.title == "Rename Harness…" && $0.representedObject as? String == "renameActive" }, "Rename Harness preserves its command")
- try checkTitlebar(agent.items.contains { $0.title == "Close Harness" && $0.representedObject as? String == "closeActive" }, "Close Harness preserves its command")
+ try checkTitlebar(agent.items.contains { $0.title == "Rename Tab…" && $0.representedObject as? String == "renameActive" }, "Rename Tab preserves its command")
+ try checkTitlebar(agent.items.contains { $0.title == "Close Tab" && $0.representedObject as? String == "closeActive" }, "Close Tab preserves its command")
let commands = edit.submenu!.items.first(where: { $0.representedObject as? String == "commands" })!
try checkTitlebar(commands.keyEquivalent == "p" && commands.keyEquivalentModifierMask == [.command, .shift], "Command search keeps its native menu owner")
try checkTitlebar(edit.submenu!.items.allSatisfy { $0.representedObject as? String != "jump" }, "Edit has no Navigate action")
- try checkTitlebar(agent.items.first?.title == "New Harness" && agent.items.first?.keyEquivalent == "t", "New Harness opens the chooser with Command-T")
+ try checkTitlebar(agent.items.first?.title == "New Tab" && agent.items.first?.keyEquivalent == "t", "New Tab opens the chooser with Command-T")
let reopen = historyMenu.items.first(where: { $0.representedObject as? String == "reopen" })!
actionsEnabled = true
canReopen = false