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.

Agent is the who, harness is the session

dee9d311b86fb6c
diff --git a/README.md b/README.md
index 87238c29a..a4e4db03b 100644
--- a/README.md
+++ b/README.md
@@ -9,16 +9,16 @@ is made.
<img src=".github/assets/screenshots/harness.gif" width="960" alt="One window, nine moments: two coding agents side by side, three in columns, a Solid tab with the 3D case beside the Codex agent that made it, a Copper board as schematic, as routed PCB and in 3D beside its Claude Code agent, four panes of Solid and Copper together, and a Marp keynote beside its agent">
</p>
-## One app, many harnesses
+## One app, every agent
-A harness is an agent plus a domain. For code, the agent is the whole harness: fourteen engines,
-unwrapped. Harness reads the transcript each one already writes and installs the vendor's own hooks;
-your credentials stay in your `~/.claude`, `~/.codex`, and so on. For everything else, a harness
-brings the domain with it: its skills in the agent, its toolchain on the machine, its viewer beside
-the terminal, and a header that says where the work is. Three ship today, each on one of the coding
-agents, and yours is a git repository away.
+An agent is the who: Claude Code, Codex, Cursor and eleven more for code, and the specialized ones,
+Solid, Copper and Marp, each an agent plus the skills, toolchain and viewer of its domain. Harness
+never wraps an agent; it reads the transcript each one already writes and installs the vendor's own
+hooks, so your credentials stay in your `~/.claude`, `~/.codex`, and so on. A harness is one
+session of an agent running somewhere: a machine, a project, a pane, and for the domains beyond
+code, the viewer beside it. Pick an agent, and yours is a git repository away.
-| Category | Apps |
+| Category | Agents |
|---|---|
| **Code** | <img src=".github/assets/engines/claude.png" height="28" alt="Claude Code"> Claude Code &nbsp;&nbsp; <img src=".github/assets/engines/codex.png" height="28" alt="Codex"> Codex &nbsp;&nbsp; <img src=".github/assets/engines/cursor.png" height="28" alt="Cursor"> Cursor &nbsp;&nbsp; <img src=".github/assets/engines/opencode.png" height="28" alt="OpenCode"> OpenCode &nbsp;&nbsp; <img src=".github/assets/engines/pi.png" height="28" alt="Pi"> Pi &nbsp;&nbsp; <img src=".github/assets/engines/hermes.png" height="28" alt="Hermes"> Hermes &nbsp;&nbsp; <img src=".github/assets/engines/commandcode.png" height="28" alt="Command Code"> Command Code &nbsp;&nbsp; <img src=".github/assets/engines/devin.png" height="28" alt="Devin"> Devin &nbsp;&nbsp; <img src=".github/assets/engines/muse.png" height="28" alt="Muse Code"> Muse Code &nbsp;&nbsp; <img src=".github/assets/engines/amp.png" height="28" alt="Amp"> Amp &nbsp;&nbsp; <img src=".github/assets/engines/kilo.png" height="28" alt="Kilo"> Kilo &nbsp;&nbsp; <img src=".github/assets/engines/grok.png" height="28" alt="Grok"> Grok &nbsp;&nbsp; <img src=".github/assets/engines/agy.png" height="28" alt="Antigravity"> Antigravity &nbsp;&nbsp; <img src=".github/assets/engines/copilot.png" height="28" alt="GitHub Copilot"> GitHub Copilot |
| **3D design** | <img src=".github/assets/engines/solid.png" height="28" alt="Solid"> Solid |
@@ -34,7 +34,7 @@ ciphertext and holds no keys, and terminal traffic goes machine to machine over
Sessions live on the machine, not in the window. Every agent is a tmux pane there. Close the laptop,
open it on the train: same pane, same scrollback. After a reboot the daemon brings each agent back
with the engine's own `--resume` and the same id. Start an agent on another machine by browsing its
-folders from New Agent, or clone a repository there first.
+folders from New Harness, or clone a repository there first.
<p align="center">
<img src=".github/assets/screenshots/machines-menu.png" width="960" alt="The Machines menu: a MacBook, this Mac with 27 agents, a ThinkPad, an iMac at home with 4 agents and an iMac at the office with 6, and the agents on the iMac at home listed in a submenu">
@@ -65,8 +65,8 @@ https://github.com/user-attachments/assets/97848065-61c6-40df-be66-a8247f69aa4c
## First five minutes
-- **⌘N** New Agent: a harness, a machine, a folder, Create.
-- **⌘O** finds any agent, tab, project or machine; `>` runs a command.
+- **⌘N** New Harness: an agent, a machine, a folder, Create.
+- **⌘O** Open Harness: find any session, tab, project or machine; `>` runs a command.
- **⌘B** takes a task in plain words and routes it to the agent already on it.
- **⌘R** and **⌘D** split right and down.
- **⌘S** picks a layout.
@@ -95,7 +95,7 @@ Every layer has a contract, a starter and a check, and most ways in never touch
A domain harness is a git repository: a manifest, an `AGENTS.md`, skills, a workspace template, a
toolchain that installs itself, and for the pane a viewer server and a verdict file. Harness reads
the manifest and nothing else. Copy the starter, `harness dsh check .`, `harness dsh install . --link`,
-and your tile is in New Agent. [Marp](https://github.com/autonomous-ai/autonomous-marp) is the
+and your tile is in New Harness. [Marp](https://github.com/autonomous-ai/autonomous-marp) is the
smallest complete one and the place to start.
[CONTRIBUTING.md](CONTRIBUTING.md) has the workflow, [SECURITY.md](SECURITY.md) takes security
diff --git a/cli/src/lib/projectFolder.spec.ts b/cli/src/lib/projectFolder.spec.ts
index 77a3e688a..32dfbefc1 100644
--- a/cli/src/lib/projectFolder.spec.ts
+++ b/cli/src/lib/projectFolder.spec.ts
@@ -24,14 +24,14 @@ describe('project folder preparation', () => {
it('creates different folders for two deliberate new projects', async () => {
const folders = await Promise.all([prepareProjectFolder({ source: 'new' }, { root }), prepareProjectFolder({ source: 'new' }, { root })])
expect(new Set(folders).size).toBe(2)
- expect(new Set(folders)).toEqual(new Set([join(root, 'agent-1'), join(root, 'agent-2')]))
+ expect(new Set(folders)).toEqual(new Set([join(root, 'harness-1'), join(root, 'harness-2')]))
expect(await readdir(root)).toHaveLength(2)
})
it('continues numbering past existing folders and files without changing them', async () => {
await mkdir(join(root, 'agent-2'))
await writeFile(join(root, 'agent-4'), 'keep')
- expect(await prepareProjectFolder({ source: 'new' }, { root })).toBe(join(root, 'agent-5'))
+ expect(await prepareProjectFolder({ source: 'new' }, { root })).toBe(join(root, 'harness-5'))
expect(await readFile(join(root, 'agent-4'), 'utf8')).toBe('keep')
})
diff --git a/cli/src/lib/projectFolder.ts b/cli/src/lib/projectFolder.ts
index 8185d8b4e..680fe4845 100644
--- a/cli/src/lib/projectFolder.ts
+++ b/cli/src/lib/projectFolder.ts
@@ -53,10 +53,10 @@ export async function prepareProjectFolder(
try {
await mkdir(root, { recursive: true })
if (project.source === 'new') {
- const numbers = (await readdir(root)).map(name => /^agent-([1-9]\d*)$/.exec(name)?.[1])
+ const numbers = (await readdir(root)).map(name => /^(?:harness|agent)-([1-9]\d*)$/.exec(name)?.[1])
let next = numbers.reduce((max, value) => value && BigInt(value) > max ? BigInt(value) : max, 0n) + 1n
for (;;) {
- const folder = join(root, `agent-${next++}`)
+ const folder = join(root, `harness-${next++}`)
try { await mkdir(folder); return folder }
catch (error) {
// mkdir reserves the name atomically, including simultaneous desktop
diff --git a/cli/src/lib/registry.spec.ts b/cli/src/lib/registry.spec.ts
index f96e9bb69..d0f944ce7 100644
--- a/cli/src/lib/registry.spec.ts
+++ b/cli/src/lib/registry.spec.ts
@@ -1029,20 +1029,20 @@ describe('agent identity: the process owns the agent, the session is bound to it
registry.load()
const first = registry.openPendingAgent({ engine: 'opencode', runtimes: [{ backend: 'tmux', paneId: '%7' }], cwd: '/tmp/demo' })!
const second = registry.openPendingAgent({ engine: 'opencode', runtimes: [{ backend: 'tmux', paneId: '%8' }], cwd: '/tmp/demo' })!
- expect(registry.displayName(first)).toBe('agent-1')
- expect(registry.displayName(second)).toBe('agent-2')
+ expect(registry.displayName(first)).toBe('harness-1')
+ expect(registry.displayName(second)).toBe('harness-2')
const bound = registry.register({ engine: 'opencode', sessionId: 'session-numbered', tmuxPane: '%7', title: 'OC | Greeting' })!.entry
- expect(registry.displayName(bound)).toBe('agent-1')
+ expect(registry.displayName(bound)).toBe('harness-1')
registry.rename(second.agentId, 'My project')
const { registry: reloaded } = await loadRegistryModule()
reloaded.load()
- expect(reloaded.displayName(reloaded.byAgent(first.agentId)!)).toBe('agent-1')
+ expect(reloaded.displayName(reloaded.byAgent(first.agentId)!)).toBe('harness-1')
expect(reloaded.displayName(reloaded.byAgent(second.agentId)!)).toBe('My project')
const third = reloaded.openPendingAgent({ engine: 'codex', runtimes: [{ backend: 'tmux', paneId: '%9' }], cwd: '/tmp/demo' })!
- expect(reloaded.displayName(third)).toBe('agent-3')
- reloaded.rename(third.agentId, 'agent-10')
+ expect(reloaded.displayName(third)).toBe('harness-3')
+ reloaded.rename(third.agentId, 'agent-10') // the old prefix still counts, so a hand-typed agent-10 moves the next default past it
const fourth = reloaded.openPendingAgent({ engine: 'claude', runtimes: [{ backend: 'tmux', paneId: '%10' }], cwd: '/tmp/demo' })!
- expect(reloaded.displayName(fourth)).toBe('agent-11')
+ expect(reloaded.displayName(fourth)).toBe('harness-11')
})
it('persists a failed launch for reconnect while keeping its terminal route', async () => {
diff --git a/cli/src/lib/registry.ts b/cli/src/lib/registry.ts
index 38657345f..a0c0220fd 100644
--- a/cli/src/lib/registry.ts
+++ b/cli/src/lib/registry.ts
@@ -386,7 +386,7 @@ function strictPersistedRow(value: unknown): RegisteredSession | null {
engine: row.engine as AgentEngine,
transcriptPath: typeof row.transcriptPath === 'string' ? row.transcriptPath : null,
projectDir: row.projectDir,
- defaultName: typeof row.defaultName === 'string' && /^agent-[1-9]\d*$/.test(row.defaultName)
+ defaultName: typeof row.defaultName === 'string' && /^(?:harness|agent)-[1-9]\d*$/.test(row.defaultName)
? row.defaultName : undefined,
cwd: typeof row.cwd === 'string' ? row.cwd : null,
runtimes,
@@ -769,7 +769,7 @@ class Registry {
...(rawGridLaunch !== undefined ? { gridLaunch: rawGridLaunch } : {}),
...(raw.bypassPermission === true ? { bypassPermission: true } : {}),
transcriptPath,
- defaultName: typeof raw.defaultName === 'string' && /^agent-[1-9]\d*$/.test(raw.defaultName)
+ defaultName: typeof raw.defaultName === 'string' && /^(?:harness|agent)-[1-9]\d*$/.test(raw.defaultName)
? raw.defaultName : undefined,
title: titleDisplayName(typeof raw.title === 'string' ? raw.title : null),
sessionId: bound ? rawSessionId : '',
@@ -1040,10 +1040,11 @@ class Registry {
...NAME_OVERRIDES.values(),
]
for (const name of names) {
- const match = name && /^agent-([1-9]\d*)$/.exec(name)
+ // `agent-N` is the name this daemon gave sessions before the rename; the count carries on
+ const match = name && /^(?:harness|agent)-([1-9]\d*)$/.exec(name)
if (match && BigInt(match[1]!) >= next) next = BigInt(match[1]!) + 1n
}
- return `agent-${next}`
+ return `harness-${next}`
}
/** Discovered process agents that have no engine session bound yet. */
diff --git a/desktop/lib/core/project_folder.dart b/desktop/lib/core/project_folder.dart
index 026680ee7..e799636ba 100644
--- a/desktop/lib/core/project_folder.dart
+++ b/desktop/lib/core/project_folder.dart
@@ -40,14 +40,14 @@ class ProjectFolderRequest {
}
var next = BigInt.one;
await for (final entry in root.list(followLinks: false)) {
- final match = RegExp(r'^agent-([1-9]\d*)$')
+ final match = RegExp(r'^(?:harness|agent)-([1-9]\d*)$')
.firstMatch(p.basename(entry.path));
if (match == null) continue;
final number = BigInt.parse(match.group(1)!);
if (number >= next) next = number + BigInt.one;
}
for (;;) {
- final folder = p.join(root.path, 'agent-$next');
+ final folder = p.join(root.path, 'harness-$next');
next += BigInt.one;
// Directory.create accepts an existing directory. The platform mkdir
// command reserves it exclusively, so concurrent creates never share
diff --git a/desktop/lib/screens/swarm_screen.dart b/desktop/lib/screens/swarm_screen.dart
index 4eeb88bcb..56c0f5008 100644
--- a/desktop/lib/screens/swarm_screen.dart
+++ b/desktop/lib/screens/swarm_screen.dart
@@ -81,7 +81,7 @@ class _SwarmScreenState extends State<SwarmScreen> {
final _navigation = SwarmNavigationHistory();
final _searchCatalog = SwarmSearchCatalog();
final _searchText = TextEditingController();
- final _searchFocus = FocusNode(debugLabel: 'Find an agent');
+ final _searchFocus = FocusNode(debugLabel: 'Find a harness');
SwarmSearchController? _search;
OverlayEntry? _searchOverlay;
(String, bool)? _searchHeaderState;
@@ -973,7 +973,7 @@ class _SwarmScreenState extends State<SwarmScreen> {
),
),
Semantics(
- label: commandsOnly ? 'Search commands' : 'Find an agent',
+ label: commandsOnly ? 'Search commands' : 'Find a harness',
child: SwarmSearchInput(
inputKey: const ValueKey('swarm-search-input'),
controller: _searchText,
@@ -985,13 +985,13 @@ class _SwarmScreenState extends State<SwarmScreen> {
showClose: true,
rounded: true,
prominent: !commandsOnly,
- hintText: commandsOnly ? null : 'Find an agent',
+ hintText: commandsOnly ? null : 'Find a harness',
trailing: !commandsOnly && search.split != null
? KeymapRegion(
contextKind: KeymapContext.workspace,
child: IconButton(
key: const ValueKey('harness-picker-new'),
- tooltip: 'New Agent',
+ tooltip: 'New Harness',
onPressed: search.canCreate
? () => _runShortcut('agent.new')
: null,
@@ -1623,7 +1623,7 @@ class _SwarmScreenState extends State<SwarmScreen> {
create ? AgentActionIcons.create : AgentActionIcons.open,
size: 16,
),
- label: Text(create ? 'New Agent' : 'Open Agent'),
+ label: Text(create ? 'New Harness' : 'Open Harness'),
);
}
}
diff --git a/desktop/lib/shortcuts/app_shortcuts.dart b/desktop/lib/shortcuts/app_shortcuts.dart
index fe2a8e211..844608b07 100644
--- a/desktop/lib/shortcuts/app_shortcuts.dart
+++ b/desktop/lib/shortcuts/app_shortcuts.dart
@@ -280,7 +280,7 @@ const List<AppShortcut> kAppShortcuts = [
AppShortcut(
action: ShortcutAction.newAgent,
activator: SingleActivator(LogicalKeyboardKey.keyN, meta: true),
- label: 'New Agent',
+ label: 'New Harness',
group: ShortcutGroup.actions,
),
AppShortcut(
@@ -342,7 +342,7 @@ const kSwarmShortcuts = [
AppShortcut(
action: ShortcutAction.addAgent,
activator: SingleActivator(LogicalKeyboardKey.keyO, meta: true),
- label: 'Open Agent',
+ label: 'Open Harness',
group: ShortcutGroup.actions,
),
AppShortcut(
@@ -364,7 +364,7 @@ const kSwarmShortcuts = [
meta: true,
shift: true,
),
- label: 'Reopen last closed agent',
+ label: 'Reopen last closed harness',
group: ShortcutGroup.navigate,
),
AppShortcut(
diff --git a/desktop/lib/shortcuts/keymap_commands.dart b/desktop/lib/shortcuts/keymap_commands.dart
index 531932607..e9d875b53 100644
--- a/desktop/lib/shortcuts/keymap_commands.dart
+++ b/desktop/lib/shortcuts/keymap_commands.dart
@@ -70,7 +70,7 @@ final harnessCommands = <HarnessCommand>[
),
const HarnessCommand(
'swarm.reopen',
- 'Reopen last closed agent',
+ 'Reopen last closed harness',
ShortcutGroup.navigate,
action: ShortcutAction.reopenClosedSwarm,
nativeAction: 'reopen',
@@ -272,14 +272,14 @@ final harnessCommands = <HarnessCommand>[
),
const HarnessCommand(
'agent.add',
- 'Open Agent',
+ 'Open Harness',
ShortcutGroup.actions,
action: ShortcutAction.addAgent,
nativeAction: 'addAgent',
),
const HarnessCommand(
'agent.new',
- 'New Agent',
+ 'New Harness',
ShortcutGroup.actions,
action: ShortcutAction.newAgent,
nativeAction: 'newAgent',
diff --git a/desktop/lib/state/app_state.dart b/desktop/lib/state/app_state.dart
index bc3ec52a4..30fb13681 100644
--- a/desktop/lib/state/app_state.dart
+++ b/desktop/lib/state/app_state.dart
@@ -4524,7 +4524,7 @@ class AppNotifier extends ChangeNotifier {
failure.code == 'UNSUPPORTED_ON_REMOTE' ||
failure.code == 'E2EE_REQUIRED') {
return '$machineName cannot check this creation. '
- 'Use Find an agent to look for it before creating another.';
+ 'Use Find a harness to look for it before creating another.';
}
return unconfirmed;
}
@@ -4571,15 +4571,15 @@ class AppNotifier extends ChangeNotifier {
// receipt-aware version. Missing is not proof that nothing started.
// Check status stays read-only, even across upgrades and reconnects.
return '$machineName has no record of this request. '
- 'Use Find an agent to look for it before creating another.';
+ 'Use Find a harness to look for it before creating another.';
case 'pending':
return '$machineName is still starting your agent. Check again in a moment.';
case 'unconfirmed':
return '$machineName could not confirm whether this agent started. '
- 'Use Open Agent to look for it before creating another.';
+ 'Use Open Harness to look for it before creating another.';
case 'unavailable':
return creation._complete(
- 'This agent was created but is no longer available. '
+ 'This harness was created but is no longer available. '
'You can create a new one.',
);
case 'failed':
@@ -4625,8 +4625,8 @@ class AppNotifier extends ChangeNotifier {
notifyListeners();
if (_creationPlacementError(targetId, split) != null) {
_lastError =
- 'The agent was created, but its original tab or layout changed. '
- 'Use Open Agent to find it.';
+ 'The harness was created, but its original tab or layout changed. '
+ 'Use Open Harness to find it.';
_lastErrorRetryable = false;
notifyListeners();
return null;
diff --git a/desktop/lib/state/swarm.dart b/desktop/lib/state/swarm.dart
index 5ab48ae1d..e5d14c02f 100644
--- a/desktop/lib/state/swarm.dart
+++ b/desktop/lib/state/swarm.dart
@@ -12,8 +12,9 @@ class Swarm {
: name = normalizeName(name);
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.
+ // 'New Harness' was the default until 2026-09-15 and 'New Agent' for a day
+ // after; a layout saved then still carries one, and it must read as the same
+ // fresh tab.
static String normalizeName(String name) =>
const {
'New swarm',
diff --git a/desktop/lib/state/swarm_search.dart b/desktop/lib/state/swarm_search.dart
index 8d8998d9c..cad1fd1c2 100644
--- a/desktop/lib/state/swarm_search.dart
+++ b/desktop/lib/state/swarm_search.dart
@@ -101,7 +101,7 @@ class SwarmSearchController extends ChangeNotifier {
? 'Search commands…'
: history != null
? 'Search history…'
- : 'Find an agent';
+ : 'Find a harness';
bool get canCreate =>
history == null &&
@@ -117,7 +117,7 @@ class SwarmSearchController extends ChangeNotifier {
String get primaryAction => switch (split?.axis) {
PaneResizeAxis.x => 'Split right',
PaneResizeAxis.y => 'Split down',
- null => 'Open Agent',
+ null => 'Open Harness',
};
String actionLabel(SwarmDestination? row) => row?.isCommand == true
@@ -317,7 +317,7 @@ class SwarmSearchController extends ChangeNotifier {
? 'Run command'
: row.closedId != null
? 'Reopen'
- : 'Open Agent';
+ : 'Open Harness';
@override
void dispose() {
diff --git a/desktop/lib/widgets/agent_switcher.dart b/desktop/lib/widgets/agent_switcher.dart
index e03e46de7..47e5b6170 100644
--- a/desktop/lib/widgets/agent_switcher.dart
+++ b/desktop/lib/widgets/agent_switcher.dart
@@ -252,7 +252,7 @@ class _AgentSwitcherState extends State<_AgentSwitcher> {
decoration: InputDecoration(
border: InputBorder.none,
isDense: true,
- hintText: 'Find an agent',
+ hintText: 'Find a harness',
hintStyle: TextStyle(
fontSize: 17,
color: grid.AppPalette.textFaint,
diff --git a/desktop/lib/widgets/delete_agent_dialog.dart b/desktop/lib/widgets/delete_agent_dialog.dart
index bfbe49384..5425549d4 100644
--- a/desktop/lib/widgets/delete_agent_dialog.dart
+++ b/desktop/lib/widgets/delete_agent_dialog.dart
@@ -16,7 +16,7 @@ Future<void> confirmDeleteAgent(
final confirmed = await showAppDialog<bool>(
context: context,
builder: (dialogContext) => AlertDialog(
- title: const Text('Stop Agent'),
+ title: const Text('Stop Harness'),
content: SizedBox(
width: 360,
child: Text(
@@ -35,7 +35,7 @@ Future<void> confirmDeleteAgent(
backgroundColor: grid.AppPalette.dangerFill,
),
onPressed: () => Navigator.of(dialogContext).pop(true),
- child: const Text('Stop Agent'),
+ child: const Text('Stop Harness'),
),
],
),
diff --git a/desktop/lib/widgets/harness_entry_actions.dart b/desktop/lib/widgets/harness_entry_actions.dart
index d5bf58a7a..3a68f100c 100644
--- a/desktop/lib/widgets/harness_entry_actions.dart
+++ b/desktop/lib/widgets/harness_entry_actions.dart
@@ -77,7 +77,7 @@ class HarnessEntryActions extends StatelessWidget {
shape: const StadiumBorder(),
),
icon: const Icon(AgentActionIcons.open, size: 18),
- label: const Text('Open Agent'),
+ label: const Text('Open Harness'),
),
),
_keyboardAction(
@@ -87,7 +87,7 @@ class HarnessEntryActions extends StatelessWidget {
key: newKey,
onPressed: onNew,
icon: const Icon(AgentActionIcons.create, size: 18),
- label: const Text('New Agent'),
+ label: const Text('New Harness'),
style: FilledButton.styleFrom(
enabledMouseCursor: SystemMouseCursors.click,
minimumSize: size,
diff --git a/desktop/lib/widgets/harness_start_page.dart b/desktop/lib/widgets/harness_start_page.dart
index 5f8fe66c0..736bcbcd4 100644
--- a/desktop/lib/widgets/harness_start_page.dart
+++ b/desktop/lib/widgets/harness_start_page.dart
@@ -113,7 +113,7 @@ class _HarnessStartPageState extends State<HarnessStartPage> {
mainAxisSize: MainAxisSize.min,
children: [
Semantics(
- label: 'Find an agent',
+ label: 'Find a harness',
child: SwarmSearchInput(
inputKey: const ValueKey('harness-start-search'),
controller: _query,
@@ -126,7 +126,7 @@ class _HarnessStartPageState extends State<HarnessStartPage> {
groupId: _searchGroup,
autofocus: true,
showClose: _showResults,
- hintText: 'Find an agent',
+ hintText: 'Find a harness',
rounded: true,
prominent: true,
),
diff --git a/desktop/lib/widgets/machine_rail.dart b/desktop/lib/widgets/machine_rail.dart
index e2a33f2cc..eb95696dc 100644
--- a/desktop/lib/widgets/machine_rail.dart
+++ b/desktop/lib/widgets/machine_rail.dart
@@ -817,7 +817,7 @@ class _AgentTree extends StatelessWidget {
return _AgentStatusRow(
icon: Icons.sync,
label: state.connectionStatus == ConnectionStatus.connected
- ? 'preparing agent list…'
+ ? 'preparing harness list…'
: 'connecting…',
);
case AgentLoadStatus.needsLink:
@@ -1204,7 +1204,7 @@ class _AgentRowState extends State<_AgentRow> {
const AppMenuDivider(),
AppMenuItem(
icon: LucideIcons.refreshCw300,
- label: 'Restart Agent',
+ label: 'Restart Harness',
onPressed: () {
_agentMenu.close();
_restartAgent();
@@ -1213,7 +1213,7 @@ class _AgentRowState extends State<_AgentRow> {
const AppMenuDivider(),
AppMenuItem(
icon: Icons.stop_rounded,
- label: 'Stop Agent',
+ label: 'Stop Harness',
danger: true,
onPressed: () {
_agentMenu.close();
diff --git a/desktop/lib/widgets/new_agent_dialog.dart b/desktop/lib/widgets/new_agent_dialog.dart
index 725503d77..115483d13 100644
--- a/desktop/lib/widgets/new_agent_dialog.dart
+++ b/desktop/lib/widgets/new_agent_dialog.dart
@@ -549,9 +549,9 @@ class _NewAgentDialogState extends State<_NewAgentDialog> {
surfaceTintColor: Colors.transparent,
shape: RoundedRectangleBorder(borderRadius: BorderRadius.circular(28)),
title: Text(switch (widget.split?.axis) {
- PaneResizeAxis.x => 'New Agent to the right',
- PaneResizeAxis.y => 'New Agent below',
- null => 'New Agent',
+ PaneResizeAxis.x => 'New Harness to the right',
+ PaneResizeAxis.y => 'New Harness below',
+ null => 'New Harness',
}),
titleTextStyle: Theme.of(context).textTheme.headlineSmall?.copyWith(
fontSize: 24,
@@ -664,7 +664,7 @@ class _NewAgentDialogState extends State<_NewAgentDialog> {
Navigator.of(context)
.pop(NewAgentDialogResult.findExisting),
icon: const Icon(LucideIcons.search, size: 16),
- label: const Text('Find an agent'),
+ label: const Text('Find a harness'),
),
FilledButton(
key: const ValueKey('create-agent-submit'),
@@ -786,7 +786,7 @@ class _NewAgentDialogState extends State<_NewAgentDialog> {
mainAxisSize: MainAxisSize.min,
crossAxisAlignment: CrossAxisAlignment.start,
children: [
- _sectionLabel('Choose a harness'),
+ _sectionLabel('Choose an agent'),
AgentPicker(
compact: true,
tileSize: tileSize,
diff --git a/desktop/lib/widgets/pane_header_actions.dart b/desktop/lib/widgets/pane_header_actions.dart
index cdd1f8abe..de4ccc2c7 100644
--- a/desktop/lib/widgets/pane_header_actions.dart
+++ b/desktop/lib/widgets/pane_header_actions.dart
@@ -106,9 +106,9 @@ class PaneHeaderActions extends StatelessWidget {
onZoom,
),
const SizedBox(width: 2),
- action('Restart Agent', LucideIcons.refreshCw, onRestart),
+ action('Restart Harness', LucideIcons.refreshCw, onRestart),
const SizedBox(width: 2),
- action('Stop Agent', Icons.stop_rounded, onDelete),
+ action('Stop Harness', Icons.stop_rounded, onDelete),
const SizedBox(width: 2),
action('Close Pane', LucideIcons.x, onClose),
],
diff --git a/desktop/lib/widgets/pane_split_edges.dart b/desktop/lib/widgets/pane_split_edges.dart
index d6b59762b..4d31b73fd 100644
--- a/desktop/lib/widgets/pane_split_edges.dart
+++ b/desktop/lib/widgets/pane_split_edges.dart
@@ -135,7 +135,7 @@ class _PaneSplitEdgesState extends State<PaneSplitEdges> {
required bool available,
}) {
final right = axis == PaneResizeAxis.x;
- final action = create ? 'New Agent' : 'Open Agent';
+ final action = create ? 'New Harness' : 'Open Harness';
final direction = right ? 'right' : 'down';
final callback = create ? widget.onNewSplit : widget.onSplit;
return IconButton(
diff --git a/desktop/lib/widgets/rename_agent_dialog.dart b/desktop/lib/widgets/rename_agent_dialog.dart
index 352c97f64..ae313bef5 100644
--- a/desktop/lib/widgets/rename_agent_dialog.dart
+++ b/desktop/lib/widgets/rename_agent_dialog.dart
@@ -112,7 +112,7 @@ class _RenameAgentDialogState extends State<_RenameAgentDialog> {
Widget build(BuildContext context) {
grid.AppTheme.watch(context);
return AlertDialog(
- title: const Text('Rename Agent'),
+ title: const Text('Rename Harness'),
content: SizedBox(
width: 360,
child: Column(
diff --git a/desktop/lib/widgets/swarm_attention.dart b/desktop/lib/widgets/swarm_attention.dart
index 3ed25af76..0dd227779 100644
--- a/desktop/lib/widgets/swarm_attention.dart
+++ b/desktop/lib/widgets/swarm_attention.dart
@@ -237,7 +237,7 @@ class _SwarmAttentionState extends State<_SwarmAttention> {
? 'Unavailable'
: destination.hasView
? 'Jump'
- : 'Open Agent',
+ : 'Open Harness',
style: const TextStyle(
fontSize: 11,
color: Colors.white54,
@@ -257,7 +257,7 @@ class _SwarmAttentionState extends State<_SwarmAttention> {
selected != null && !selected.available
? 'This agent’s terminal is unavailable · Esc to close'
: selected != null && !selected.destination.hasView
- ? '↵ Open Agent in $_targetName · Esc to close'
+ ? '↵ Open Harness in $_targetName · Esc to close'
: '↑↓ or ⌃N ⌃P to choose · Return to jump · Esc to close',
maxLines: 1,
overflow: TextOverflow.ellipsis,
diff --git a/desktop/lib/widgets/swarm_project_agents.dart b/desktop/lib/widgets/swarm_project_agents.dart
index cefbe5a8e..d7df3cc98 100644
--- a/desktop/lib/widgets/swarm_project_agents.dart
+++ b/desktop/lib/widgets/swarm_project_agents.dart
@@ -73,7 +73,7 @@ class _ProjectAgentsState extends State<_ProjectAgents> {
const SizedBox(height: 16),
SwarmSearchField(
autofocus: true,
- hintText: 'Find an agent or machine',
+ hintText: 'Find a harness or machine',
onChanged: (value) => setState(() => _query = value),
),
const SizedBox(height: 12),
@@ -83,7 +83,7 @@ class _ProjectAgentsState extends State<_ProjectAgents> {
builder: (context, _) {
final rows = swarmAgents(widget.app, _query);
if (rows.isEmpty) {
- return const Center(child: Text('No matching agents'));
+ return const Center(child: Text('No matching harnesses'));
}
return ListView.builder(
itemCount: rows.length,
diff --git a/desktop/lib/widgets/swarm_search_field.dart b/desktop/lib/widgets/swarm_search_field.dart
index 1f6d7c0f5..dbee0c2b0 100644
--- a/desktop/lib/widgets/swarm_search_field.dart
+++ b/desktop/lib/widgets/swarm_search_field.dart
@@ -8,7 +8,7 @@ class SwarmSearchField extends StatefulWidget {
this.onSubmitted,
this.onMove,
this.autofocus = false,
- this.hintText = 'Find an agent',
+ this.hintText = 'Find a harness',
this.controller,
this.focusNode,
});
diff --git a/desktop/lib/widgets/swarm_search_input.dart b/desktop/lib/widgets/swarm_search_input.dart
index c4f64b1ba..071f8a5fb 100644
--- a/desktop/lib/widgets/swarm_search_input.dart
+++ b/desktop/lib/widgets/swarm_search_input.dart
@@ -85,7 +85,7 @@ class SwarmSearchInput extends StatelessWidget {
decoration: InputDecoration(
hintText: search?.isCommandMode == true
? search!.hint
- : hintText ?? search?.hint ?? 'Find an agent',
+ : hintText ?? search?.hint ?? 'Find a harness',
hintStyle: const TextStyle(fontSize: 16, color: Colors.white60),
prefixIcon: const Icon(Icons.search, size: 20, color: Colors.white60),
prefixIconConstraints: BoxConstraints(
diff --git a/desktop/lib/widgets/swarm_switcher.dart b/desktop/lib/widgets/swarm_switcher.dart
index 3427cbb5d..b9e9fda8f 100644
--- a/desktop/lib/widgets/swarm_switcher.dart
+++ b/desktop/lib/widgets/swarm_switcher.dart
@@ -411,7 +411,7 @@ class _SwarmSearchResultsState extends State<SwarmSearchResults> {
: search.adding && search.query.isEmpty
? 'Create a new agent to start fresh.'
: search.adding
- ? 'No matching agents'
+ ? 'No matching harnesses'
: 'No matching results',
style: const TextStyle(
fontSize: 14,
diff --git a/desktop/macos/Runner/SwarmTitlebar.swift b/desktop/macos/Runner/SwarmTitlebar.swift
index fc72a98ae..bcb3a8479 100644
--- a/desktop/macos/Runner/SwarmTitlebar.swift
+++ b/desktop/macos/Runner/SwarmTitlebar.swift
@@ -235,8 +235,8 @@ final class SwarmTitlebar: NSObject, NSMenuItemValidation, NSMenuDelegate {
if let file = main.item(withTitle: "File") { main.removeItem(file) }
let file = NSMenu(title: "File")
add(file, "New Tab", "t", "new")
- add(file, "New Agent…", "n", "newAgent")
- add(file, "Open Agent…", "o", "addAgent")
+ add(file, "New Harness…", "n", "newAgent")
+ add(file, "Open Harness…", "o", "addAgent")
add(file, "Rename Tab…", "r", "renameActive", [.command, .shift])
add(file, "Close Tab", "w", "closeActive")
file.addItem(.separator())
@@ -300,7 +300,7 @@ final class SwarmTitlebar: NSObject, NSMenuItemValidation, NSMenuDelegate {
// independent of the link state on the trailing edge.
presence: machine.presence,
status: machine.status,
- count: machine.agentCount.map { "\($0) \($0 == 1 ? "agent" : "agents")" } ?? "")
+ count: machine.agentCount.map { "\($0) \($0 == 1 ? "harness" : "harnesses")" } ?? "")
}
// Preserve the compact menu's proportions, with the requested extra room.
// Leading text = name + presence; trailing column = the agent count, or the
@@ -349,20 +349,20 @@ final class SwarmTitlebar: NSObject, NSMenuItemValidation, NSMenuDelegate {
// reachable-or-connecting node is still fetching.
let title: String
if machine.agentCount == 0 {
- title = "No agents yet"
+ title = "No harnesses yet"
} else if machine.linkRequired {
title = "Link required"
} else if machine.presence == "Offline" {
title = "Offline"
} else {
- title = "Loading agents…"
+ title = "Loading harnesses…"
}
let empty = NSMenuItem(title: title, action: nil, keyEquivalent: "")
empty.isEnabled = false
submenu.addItem(empty)
}
submenu.addItem(.separator())
- let find = NSMenuItem(title: "Find Agents…", action: #selector(machineAction(_:)), keyEquivalent: "")
+ let find = NSMenuItem(title: "Find Harnesses…", action: #selector(machineAction(_:)), keyEquivalent: "")
find.target = self
find.representedObject = machine.id
submenu.addItem(find)
@@ -513,7 +513,7 @@ final class SwarmTitlebar: NSObject, NSMenuItemValidation, NSMenuDelegate {
historyMenu.addItem(item)
}
if entries.isEmpty {
- let item = NSMenuItem(title: closed ? "No Recently Closed Agents" : "No Recent Visits", action: nil, keyEquivalent: "")
+ let item = NSMenuItem(title: closed ? "No Recently Closed Harnesses" : "No Recent Visits", action: nil, keyEquivalent: "")
item.isEnabled = false
historyMenu.addItem(item)
}
@@ -1154,8 +1154,8 @@ private final class SwarmTabStrip: NSView {
button.isEnabled = false
addSubview(button)
}
- textButton(createButton, "New Agent", #selector(createAgent))
- textButton(openButton, "Open Agent", #selector(openHarness))
+ textButton(createButton, "New Harness", #selector(createAgent))
+ textButton(openButton, "Open Harness", #selector(openHarness))
createButton.image = NSImage(systemSymbolName: "plus", accessibilityDescription: nil)
openButton.image = NSImage(systemSymbolName: "arrow.up.right", accessibilityDescription: nil)
updateActionColors()
diff --git a/desktop/test/agent_creation_recovery_test.dart b/desktop/test/agent_creation_recovery_test.dart
index 4f88f082d..a0259eb02 100644
--- a/desktop/test/agent_creation_recovery_test.dart
+++ b/desktop/test/agent_creation_recovery_test.dart
@@ -216,9 +216,9 @@ void main() {
expect(find.byType(SwarmSearchResults), findsNothing);
expect(
find.text(switch (entry) {
- 'Split right' => 'New Agent to the right',
- 'Split down' => 'New Agent below',
- _ => 'New Agent',
+ 'Split right' => 'New Harness to the right',
+ 'Split down' => 'New Harness below',
+ _ => 'New Harness',
}),
findsWidgets,
);
@@ -281,7 +281,7 @@ void main() {
await tester.pumpAndSettle();
expect(find.text('Close'), findsOneWidget);
expect(find.text('Back to Search'), findsNothing);
- expect(find.widgetWithText(TextButton, 'Find an agent'), findsNothing);
+ expect(find.widgetWithText(TextButton, 'Find a harness'), findsNothing);
if (change == 'switch' || change == 'closed') app.newSwarm();
if (change == 'closed') await app.closeSwarm(original.id);
if (change == 'stale split') {
@@ -318,7 +318,7 @@ void main() {
expect(app.activeSwarmId, current);
if (change == 'closed' || change == 'stale split') {
expect(app.allPanes.any((p) => p.agentId == 'created'), isFalse);
- expect(app.lastError, contains('Open Agent'));
+ expect(app.lastError, contains('Open Harness'));
} else {
expect(original.panes.first, same(originalPane));
expect(original.panes.last.agentId, 'created');
@@ -591,7 +591,7 @@ void main() {
app.stateOf('m')!.agents.any((agent) => agent.id == 'created'),
isTrue,
);
- expect(app.lastError, contains('Open Agent'));
+ expect(app.lastError, contains('Open Harness'));
});
testWidgets(
diff --git a/desktop/test/boot_flow_widget_test.dart b/desktop/test/boot_flow_widget_test.dart
index 2a083be56..746db5202 100644
--- a/desktop/test/boot_flow_widget_test.dart
+++ b/desktop/test/boot_flow_widget_test.dart
@@ -836,7 +836,7 @@ void main() {
),
);
await tester.pumpAndSettle();
- expect(find.text('New Agent'), findsWidgets);
+ expect(find.text('New Harness'), findsWidgets);
expect(
tester
.widget<TextField>(
diff --git a/desktop/test/first_workspace_test.dart b/desktop/test/first_workspace_test.dart
index 2df2ca2a2..f15e64f5e 100644
--- a/desktop/test/first_workspace_test.dart
+++ b/desktop/test/first_workspace_test.dart
@@ -441,7 +441,7 @@ void main() {
for (final native in [false, true]) {
testWidgets(
- 'New Agent ${native ? 'native menu' : 'header'} defaults to this computer',
+ 'New Harness ${native ? 'native menu' : 'header'} defaults to this computer',
(tester) async {
tester.binding.defaultBinaryMessenger.setMockMethodCallHandler(
const MethodChannel('harness/swarm_tabs'),
@@ -685,7 +685,7 @@ void main() {
addTearDown(() => FileSelectorPlatform.instance = oldPicker);
await mount(tester, app);
- expect(find.text('New Agent'), findsWidgets);
+ expect(find.text('New Harness'), findsWidgets);
expect(find.text('Machines'), findsNothing);
expect(find.text('Projects'), findsNothing);
expect(app.launches, isEmpty);
@@ -699,7 +699,7 @@ void main() {
expect(engine.value, 'codex');
expect(find.byKey(const Key('new-agent-machine-field')), findsOneWidget);
expect(
- tester.getTopLeft(find.text('Choose a harness')).dy,
+ tester.getTopLeft(find.text('Choose an agent')).dy,
lessThan(
tester
.getTopLeft(find.text('Which project will this agent work in?'))
diff --git a/desktop/test/harness_picker_entry_test.dart b/desktop/test/harness_picker_entry_test.dart
index c643a1db8..00dab676e 100644
--- a/desktop/test/harness_picker_entry_test.dart
+++ b/desktop/test/harness_picker_entry_test.dart
@@ -41,7 +41,7 @@ void main() {
(const Size(600, 680), 2.0),
]) {
testWidgets(
- 'Open Agent shows results separately from New Agent at $size, $scale',
+ 'Open Harness shows results separately from New Harness at $size, $scale',
(tester) async {
tester.view.devicePixelRatio = 1;
tester.view.physicalSize = size;
@@ -80,9 +80,9 @@ void main() {
expect(find.byKey(const ValueKey('harness-picker-open')), findsNothing);
expect(
tester.widget<TextField>(field).decoration!.hintText,
- 'Find an agent',
+ 'Find a harness',
);
- expect(find.text('Find an agent'), findsOneWidget);
+ expect(find.text('Find a harness'), findsOneWidget);
expect(find.byKey(const ValueKey('create-agent-submit')), findsNothing);
final before = tester.getRect(field);
final controller = tester.widget<TextField>(field).controller;
diff --git a/desktop/test/keymap_runtime_test.dart b/desktop/test/keymap_runtime_test.dart
index 07b4cdd7d..e8b8ec963 100644
--- a/desktop/test/keymap_runtime_test.dart
+++ b/desktop/test/keymap_runtime_test.dart
@@ -358,7 +358,7 @@ void main() {
for (final inline in [false, true]) {
testWidgets(
- 'configured picker actions and hints stay in ${inline ? 'start-page' : 'Open Agent'} search',
+ 'configured picker actions and hints stay in ${inline ? 'start-page' : 'Open Harness'} search',
(tester) async {
final map = MemoryKeymap()
..apply('''{"bindings":[
diff --git a/desktop/test/new_agent_project_picker_test.dart b/desktop/test/new_agent_project_picker_test.dart
index 869af0d91..20d90d5e2 100644
--- a/desktop/test/new_agent_project_picker_test.dart
+++ b/desktop/test/new_agent_project_picker_test.dart
@@ -331,7 +331,7 @@ void main() {
await tester.sendKeyEvent(LogicalKeyboardKey.escape);
await tester.pumpAndSettle();
expect(find.text('No recent projects'), findsNothing);
- expect(find.text('New Agent'), findsOneWidget);
+ expect(find.text('New Harness'), findsOneWidget);
expect(app.calls, isEmpty);
});
}
diff --git a/desktop/test/pane_restart_test.dart b/desktop/test/pane_restart_test.dart
index 3edfc05c9..913232d19 100644
--- a/desktop/test/pane_restart_test.dart
+++ b/desktop/test/pane_restart_test.dart
@@ -62,7 +62,7 @@ void main() {
await tester.tap(
find.descendant(
of: controls,
- matching: find.byTooltip('Restart Agent'),
+ matching: find.byTooltip('Restart Harness'),
),
);
await tester.pump();
@@ -85,7 +85,7 @@ void main() {
of: controls,
matching: find.byWidgetPredicate(
(widget) =>
- widget is IconButton && widget.tooltip == 'Restart Agent',
+ widget is IconButton && widget.tooltip == 'Restart Harness',
),
),
);
diff --git a/desktop/test/project_folder_test.dart b/desktop/test/project_folder_test.dart
index 04e863dfc..fc5fd802e 100644
--- a/desktop/test/project_folder_test.dart
+++ b/desktop/test/project_folder_test.dart
@@ -21,14 +21,14 @@ void main() {
request.prepareLocal(projectHome: root.path),
]);
expect(folders.toSet(), hasLength(2));
- expect(folders.map(p.basename).toSet(), {'agent-1', 'agent-2'});
+ expect(folders.map(p.basename).toSet(), {'harness-1', 'harness-2'});
expect(folders.every((folder) => p.isWithin(root.path, folder)), isTrue);
expect(await existing.readAsString(), 'keep');
expect(request.payload, {'projectSource': 'new'});
await File(p.join(root.path, 'agent-4')).writeAsString('keep');
expect(
p.basename(await request.prepareLocal(projectHome: root.path)),
- 'agent-5',
+ 'harness-5',
);
expect(await File(p.join(root.path, 'agent-4')).readAsString(), 'keep');
},
diff --git a/desktop/test/remote_folder_picker_test.dart b/desktop/test/remote_folder_picker_test.dart
index 65823231b..54c3cddcd 100644
--- a/desktop/test/remote_folder_picker_test.dart
+++ b/desktop/test/remote_folder_picker_test.dart
@@ -362,7 +362,7 @@ void main() {
);
testWidgets(
- 'remote selection returns to New Agent without launching or losing choices',
+ 'remote selection returns to New Harness without launching or losing choices',
(tester) async {
final app = _Folders();
addTearDown(app.dispose);
diff --git a/desktop/test/rename_agent_dialog_test.dart b/desktop/test/rename_agent_dialog_test.dart
index 5a12416aa..03378df09 100644
--- a/desktop/test/rename_agent_dialog_test.dart
+++ b/desktop/test/rename_agent_dialog_test.dart
@@ -52,14 +52,14 @@ void main() {
);
await tester.tap(find.text('rename'));
await tester.pumpAndSettle();
- expect(find.text('Rename Agent'), findsOneWidget);
+ expect(find.text('Rename Harness'), findsOneWidget);
await tester.sendKeyEvent(LogicalKeyboardKey.escape);
// Pumped through the WHOLE exit transition, which is the window the bug
// lived in: one pump would settle before the rebuild that threw.
await tester.pumpAndSettle();
- expect(find.text('Rename Agent'), findsNothing);
+ expect(find.text('Rename Harness'), findsNothing);
expect(
tester.takeException(),
isNull,
diff --git a/desktop/test/swarm_add_agent_test.dart b/desktop/test/swarm_add_agent_test.dart
index 6889c3970..1248a46a9 100644
--- a/desktop/test/swarm_add_agent_test.dart
+++ b/desktop/test/swarm_add_agent_test.dart
@@ -13,7 +13,7 @@ import 'swarm_state_test.dart' show createApp;
void main() {
testWidgets(
- 'Open Agent in the header reuses the chosen session in this workspace',
+ 'Open Harness in the header reuses the chosen session in this workspace',
(tester) async {
final app = createApp();
final input = <TerminalBinaryFrame>[];
@@ -44,7 +44,7 @@ void main() {
expect(
find.descendant(
of: find.byKey(const ValueKey('swarm-row-action')),
- matching: find.text('Open Agent'),
+ matching: find.text('Open Harness'),
),
findsOneWidget,
);
diff --git a/desktop/test/swarm_commands_test.dart b/desktop/test/swarm_commands_test.dart
index fe133bbdf..a41b5878d 100644
--- a/desktop/test/swarm_commands_test.dart
+++ b/desktop/test/swarm_commands_test.dart
@@ -18,7 +18,7 @@ void main() {
addTearDown(app.dispose);
final command = SwarmDestination(
id: 'command:swarm.new',
- title: 'New Agent',
+ title: 'New Harness',
detail: 'Navigate',
swarmId: null,
current: false,
@@ -32,7 +32,7 @@ void main() {
commands: () => available ? [command] : [],
);
addTearDown(search.dispose);
- search.setQuery('New Agent');
+ search.setQuery('New Harness');
expect(search.rows.any((row) => row.isCommand), isFalse);
search.setQuery('> new');
expect(search.selected, same(command));
@@ -77,7 +77,7 @@ void main() {
expect(
find.descendant(
of: find.byKey(const ValueKey('swarm-search-results')),
- matching: find.text('Open Agent'),
+ matching: find.text('Open Harness'),
),
findsNothing,
);
@@ -112,7 +112,7 @@ void main() {
);
testWidgets(
- 'New Agent commands use the shared picker and hand focus to the chosen dialog',
+ 'New Harness commands use the shared picker and hand focus to the chosen dialog',
(tester) async {
final app = createApp();
await mount(tester, app);
diff --git a/desktop/test/swarm_entry_picker_test.dart b/desktop/test/swarm_entry_picker_test.dart
index 385d98441..92086e957 100644
--- a/desktop/test/swarm_entry_picker_test.dart
+++ b/desktop/test/swarm_entry_picker_test.dart
@@ -70,7 +70,7 @@ void main() {
findsOneWidget,
);
expect(
- find.descendant(of: selected, matching: find.text('Open Agent')),
+ find.descendant(of: selected, matching: find.text('Open Harness')),
findsOneWidget,
);
await tester.sendKeyEvent(LogicalKeyboardKey.enter);
@@ -82,7 +82,7 @@ void main() {
});
for (final native in [false, true]) {
- testWidgets('start page separates Open and New Agent (native=$native)', (
+ testWidgets('start page separates Open and New Harness (native=$native)', (
tester,
) async {
const channel = MethodChannel('harness/swarm_tabs');
@@ -110,7 +110,7 @@ void main() {
);
expect(
tester.widget<TextField>(_startInput).decoration!.hintText,
- 'Find an agent',
+ 'Find a harness',
);
expect(tester.widget<TextField>(_startInput).focusNode!.hasFocus, isTrue);
expect(find.byKey(const ValueKey('harness-device-link')), findsOneWidget);
diff --git a/desktop/test/swarm_interactions_test.dart b/desktop/test/swarm_interactions_test.dart
index 2a1a95043..114bd4193 100644
--- a/desktop/test/swarm_interactions_test.dart
+++ b/desktop/test/swarm_interactions_test.dart
@@ -245,7 +245,7 @@ void main() {
find.descendant(of: controls, matching: find.byType(IconButton)),
findsNWidgets(5),
);
- expect(find.byTooltip('Stop Agent').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 {
@@ -272,10 +272,10 @@ void main() {
await hover();
await tester.tap(
- find.descendant(of: controls, matching: find.byTooltip('Stop Agent')),
+ find.descendant(of: controls, matching: find.byTooltip('Stop Harness')),
);
await tester.pumpAndSettle();
- expect(find.text('Stop Agent'), findsNWidgets(2));
+ 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'));
diff --git a/desktop/test/swarm_picker_activation_test.dart b/desktop/test/swarm_picker_activation_test.dart
index ad12a3aeb..d331b6982 100644
--- a/desktop/test/swarm_picker_activation_test.dart
+++ b/desktop/test/swarm_picker_activation_test.dart
@@ -68,7 +68,7 @@ void main() {
expect(
find.descendant(
of: find.byKey(const ValueKey('swarm-row-action')),
- matching: find.text('Open Agent'),
+ matching: find.text('Open Harness'),
),
findsOneWidget,
);
diff --git a/desktop/test/swarm_project_members_test.dart b/desktop/test/swarm_project_members_test.dart
index 4c6e295f2..a9951b643 100644
--- a/desktop/test/swarm_project_members_test.dart
+++ b/desktop/test/swarm_project_members_test.dart
@@ -71,7 +71,7 @@ void main() {
find.byWidgetPredicate(
(w) =>
w is TextField &&
- w.decoration?.hintText == 'Find an agent or machine',
+ w.decoration?.hintText == 'Find a harness or machine',
),
'Chess Set',
);
diff --git a/desktop/test/swarm_search_test.dart b/desktop/test/swarm_search_test.dart
index 32ed0169e..ff14eb9f8 100644
--- a/desktop/test/swarm_search_test.dart
+++ b/desktop/test/swarm_search_test.dart
@@ -174,7 +174,7 @@ void main() {
search.setQuery('Test host');
final choice = search.submit();
expect(choice?.destination.isMachine, isTrue);
- expect(SwarmSearchController.action(choice!.destination), 'Open Agent');
+ expect(SwarmSearchController.action(choice!.destination), 'Open Harness');
expect(
await activateSwarmSearchSelection(
app,
@@ -312,7 +312,7 @@ void main() {
expect(
find.descendant(
of: find.byKey(const ValueKey('swarm-row-action')),
- matching: find.text('Open Agent'),
+ matching: find.text('Open Harness'),
),
findsOneWidget,
);
@@ -338,7 +338,7 @@ void main() {
for (final adding in [false, true]) {
testWidgets(
- 'Return waits for composing text in ${adding ? 'Add' : 'New Agent'}',
+ 'Return waits for composing text in ${adding ? 'Add' : 'New Harness'}',
(tester) async {
final app = createApp();
app.adoptSessionForTest(terminal('a0', []));
diff --git a/desktop/test/swarm_split_test.dart b/desktop/test/swarm_split_test.dart
index d86f6c5e8..1300bcc96 100644
--- a/desktop/test/swarm_split_test.dart
+++ b/desktop/test/swarm_split_test.dart
@@ -255,8 +255,8 @@ void main() {
expect(
find.text(
axis == PaneResizeAxis.x
- ? 'New Agent to the right'
- : 'New Agent below',
+ ? 'New Harness to the right'
+ : 'New Harness below',
),
findsOneWidget,
);
@@ -434,7 +434,7 @@ void main() {
isTrue,
);
if (change != 'switch') {
- expect(app.lastError, contains('agent was created'));
+ expect(app.lastError, contains('harness was created'));
}
expect(connection.calls, isNot(contains('agent_delete')));
await tester.pumpWidget(const SizedBox());
@@ -474,7 +474,7 @@ void main() {
expect(find.byType(AlertDialog), findsNothing);
await chord(tester, LogicalKeyboardKey.keyN);
await tester.pump();
- expect(find.text('New Agent to the right'), findsOneWidget);
+ expect(find.text('New Harness to the right'), findsOneWidget);
expect(
find.descendant(
of: find.byKey(const Key('new-agent-project-browse')),
diff --git a/desktop/test/swarm_state_test.dart b/desktop/test/swarm_state_test.dart
index 99c55dbc7..e4cdedc57 100644
--- a/desktop/test/swarm_state_test.dart
+++ b/desktop/test/swarm_state_test.dart
@@ -134,7 +134,7 @@ void main() {
'New swarm',
'New tab',
'New Tab',
- 'New Agent',
+ 'New Harness',
'New Tab',
]) {
test(
diff --git a/desktop/test/swarm_switcher_test.dart b/desktop/test/swarm_switcher_test.dart
index cb8eebe29..ea4809cec 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 Tab offers Open Agent and preserves the selected runtime (native=$nativeTabs)',
+ 'New Tab offers Open Harness and preserves the selected runtime (native=$nativeTabs)',
(tester) async {
const channel = MethodChannel('harness/swarm_tabs');
tester.binding.defaultBinaryMessenger.setMockMethodCallHandler(
@@ -80,7 +80,7 @@ void main() {
);
}
- testWidgets('command search stays commands-only and can open New Agent', (
+ testWidgets('command search stays commands-only and can open New Harness', (
tester,
) async {
final app = createApp();
@@ -104,7 +104,7 @@ void main() {
);
expect(find.byKey(const ValueKey('swarm-search-preview')), findsNothing);
}
- expect(harnessCommandById['agent.new']!.label, 'New Agent');
+ expect(harnessCommandById['agent.new']!.label, 'New Harness');
await tester.tap(find.byKey(const ValueKey('command:swarm.new')));
await tester.pump();
expect(app.activeSwarm.name, 'New Tab');
diff --git a/desktop/test/terminal_panel_presentation_test.dart b/desktop/test/terminal_panel_presentation_test.dart
index 8e598c6b2..59aaf4f9c 100644
--- a/desktop/test/terminal_panel_presentation_test.dart
+++ b/desktop/test/terminal_panel_presentation_test.dart
@@ -54,8 +54,8 @@ void main() {
await tester.pump(const Duration(milliseconds: 120));
await tester.tap(find.byTooltip('Show message composer'));
await tester.tap(find.byTooltip('Zoom Pane'));
- await tester.tap(find.byTooltip('Restart Agent'));
- await tester.tap(find.byTooltip('Stop Agent'));
+ await tester.tap(find.byTooltip('Restart Harness'));
+ await tester.tap(find.byTooltip('Stop Harness'));
await tester.tap(find.byTooltip('Close Pane'));
await tester.pump();
expect(closed, [1]);
@@ -161,7 +161,7 @@ void main() {
tester.getRect(find.text('Test host')).left,
greaterThan(tester.getRect(find.text('main')).right),
);
- expect(find.byTooltip('Stop Agent').hitTestable(), findsNothing);
+ expect(find.byTooltip('Stop Harness').hitTestable(), findsNothing);
expect(
find.descendant(of: controls, matching: find.byType(IconButton)),
findsNWidgets(local ? 4 : 5),
@@ -170,7 +170,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('Stop Agent').hitTestable(), findsOneWidget);
+ expect(find.byTooltip('Stop Harness').hitTestable(), findsOneWidget);
expect(tester.getRect(title), titleBounds);
expect(
tester.widget<TerminalView>(find.byType(TerminalView)),
@@ -179,11 +179,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('Stop Agent').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('Stop Agent'))).nextFocus();
+ Focus.of(tester.element(find.byTooltip('Stop Harness'))).nextFocus();
await tester.pump(const Duration(milliseconds: 120));
- expect(find.byTooltip('Stop Agent').hitTestable(), findsOneWidget);
+ expect(find.byTooltip('Stop Harness').hitTestable(), findsOneWidget);
await mouse.removePointer();
await tester.pumpWidget(const SizedBox());
session.dispose();
diff --git a/desktop/test/web_pane_test.dart b/desktop/test/web_pane_test.dart
index df6d53282..1a06e8804 100644
--- a/desktop/test/web_pane_test.dart
+++ b/desktop/test/web_pane_test.dart
@@ -241,7 +241,7 @@ void main() {
// Its own close control, and no way to end an agent from it.
expect(find.byTooltip('Close viewer'), findsOneWidget);
expect(
- find.byTooltip('Stop Agent'),
+ find.byTooltip('Stop Harness'),
findsOneWidget,
reason: 'the terminal keeps its own',
);
diff --git a/desktop/test/welcome_entry_layout_test.dart b/desktop/test/welcome_entry_layout_test.dart
index faac8e497..544a4204b 100644
--- a/desktop/test/welcome_entry_layout_test.dart
+++ b/desktop/test/welcome_entry_layout_test.dart
@@ -100,7 +100,7 @@ void main() {
expect(find.text('Harness'), findsNothing);
expect(
tester.widget<TextField>(field).decoration!.hintText,
- 'Find an agent',
+ 'Find a harness',
);
expect(tester.widget<TextField>(field).focusNode!.hasFocus, isTrue);
expect(find.byType(ListTile), findsNothing);
diff --git a/desktop/tool/swarm_titlebar_checks.swift b/desktop/tool/swarm_titlebar_checks.swift
index 7670188e9..aef999b81 100644
--- a/desktop/tool/swarm_titlebar_checks.swift
+++ b/desktop/tool/swarm_titlebar_checks.swift
@@ -180,7 +180,7 @@ private extension SwarmTabStrip {
try checkTitlebar(tabs[0].showsDivider && tabs[1].showsDivider, "Separators return when the pointer leaves")
try checkTitlebar(!tabs[10].showsDivider && !tabs[11].showsDivider, "Selected tab remains joined without neighboring separators")
try checkTitlebar(tabs.count == 24, "All overflow tabs exist")
- try checkTitlebar(!newButton.isEnabled, "New Agent is disabled at capacity")
+ try checkTitlebar(!newButton.isEnabled, "New Harness is disabled at capacity")
for (index, tab) in tabs.enumerated() {
try tab.checkAccessibility(expectedName: "Swarm \(index)", active: index == 11)
}
@@ -218,7 +218,7 @@ private extension SwarmTabStrip {
update(state([["id": "swarm-0", "name": "Renamed tab"]], active: "swarm-0"))
try checkTitlebar(tabs.count == 1 && tabs[0] === original, "Closing tabs retains the surviving control")
try original.checkAccessibility(expectedName: "Renamed tab", active: true)
- try checkTitlebar(newButton.isEnabled, "New Agent returns below capacity")
+ try checkTitlebar(newButton.isEnabled, "New Harness returns below capacity")
var fullWithStarter = state(rows, active: "swarm-0")
fullWithStarter["canOpenNewTab"] = true
update(fullWithStarter)
@@ -234,9 +234,9 @@ private extension SwarmTabStrip {
try checkTitlebar(notificationButton.frame.maxX <= scroll.frame.minX,
"The bell is before the tabs beside the traffic lights")
try checkTitlebar((newButton.isHidden || newButton.frame.maxX <= createButton.frame.minX) && scroll.frame.maxX <= createButton.frame.minX && createButton.frame.maxX <= openButton.frame.minX,
- "New and Open Agent have distinct targets on the right")
- try checkTitlebar(openButton.title == "Open Agent" && createButton.title == "New Agent",
- "The titlebar separates New and Open Agent")
+ "New and Open Harness have distinct targets on the right")
+ try checkTitlebar(openButton.title == "Open Harness" && createButton.title == "New Harness",
+ "The titlebar separates New and Open Harness")
try checkTitlebar(!subviews.contains(where: { $0 is NSTextField }), "The titlebar has no competing text editor")
events.removeAll()
newButton.performClick(nil)
@@ -265,7 +265,7 @@ private extension SwarmTabStrip {
try original.checkEnabled(false)
try checkTitlebar(!newButton.isEnabled && !notificationButton.isEnabled && !openButton.isEnabled && !createButton.isEnabled, "Titlebar actions disable with a modal")
try checkTitlebar(actionPixels == [createButton.renderedPixels(), openButton.renderedPixels()],
- "New and Open Agent retain their colors behind a workspace modal")
+ "New and Open Harness retain their colors behind a workspace modal")
original.clickBothActions()
newButton.performClick(nil)
notificationButton.performClick(nil)
@@ -482,7 +482,7 @@ private extension SwarmTitlebar {
try checkTitlebar(newSwarm.keyEquivalent == "t" && newSwarm.toolTip == nil,
"Native shortcuts display in the menu without duplicate hover hints")
try checkTitlebar(addHarness.keyEquivalent == "o" && addHarness.keyEquivalentModifierMask == [.command],
- "The exported keymap keeps Open Agent on Command-O")
+ "The exported keymap keeps Open Harness on Command-O")
setKeymap(changed)
try checkTitlebar(NSApp.mainMenu === main && newSwarm.keyEquivalent == "o",
"Hot reload updates the existing menu to the remapped key")
@@ -578,10 +578,10 @@ private extension SwarmTitlebar {
try checkTitlebar(settings.title == "Settings…" && settings.representedObject as? String == "settings", "Settings stays in the application menu")
let agent = main.item(withTitle: "File")!.submenu!
let addHarness = agent.items.first(where: { $0.representedObject as? String == "addAgent" })!
- try checkTitlebar(addHarness.title == "Open Agent…" && addHarness.keyEquivalent == "o" && addHarness.keyEquivalentModifierMask == [.command],
- "Open Agent advertises Command-O")
- try checkTitlebar(agent.items.contains { $0.title == "New Agent…" && $0.keyEquivalent == "n" && $0.keyEquivalentModifierMask == [.command] && $0.representedObject as? String == "newAgent" },
- "New Agent has its own Command-N menu action")
+ try checkTitlebar(addHarness.title == "Open Harness…" && addHarness.keyEquivalent == "o" && addHarness.keyEquivalentModifierMask == [.command],
+ "Open Harness advertises Command-O")
+ try checkTitlebar(agent.items.contains { $0.title == "New Harness…" && $0.keyEquivalent == "n" && $0.keyEquivalentModifierMask == [.command] && $0.representedObject as? String == "newAgent" },
+ "New Harness has its own Command-N menu action")
let historyMenu = main.item(withTitle: "History")!.submenu!
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 },
diff --git a/docs/app.md b/docs/app.md
index 566296b15..210a64a2b 100644
--- a/docs/app.md
+++ b/docs/app.md
@@ -4,11 +4,11 @@ What the window does, pane by pane. The keys are in [keyboard.md](keyboard.md).
## Sessions
-An agent is one engine process in one tmux pane on one machine. The app calls it an agent. A tab
+A harness is one session: one engine process, the agent, in one tmux pane on one machine. A tab
holds any number of panes, from any mix of machines; the app remembers tabs, pane placement, sizes,
pinned slots, focus and zoom across restarts, in `~/.harness/desktop-app-v2/state.json`.
-**New Agent (⌘N)** asks for four things: the machine, the working folder, the engine, and,
+**New Harness (⌘N)** asks for four things: the machine, the working folder, the engine, and,
under Advanced, two settings most people never touch. The folder picker is the native panel on this
computer and a remote directory list on any other machine, served over the daemon's `fs_list_dir`.
**Clone repository** clones a GitHub URL into a parent folder first. The engine row shows every engine
@@ -21,11 +21,11 @@ hooks.
Creation carries a receipt. If the reply is lost, the button turns into **Check status** rather than
creating a second session.
-Closing a pane is a view operation; the agent keeps running. **Stop Agent** ends the engine process
-and asks first. **Restart Agent** relaunches it in the same pane with the same id, resuming the
+Closing a pane is a view operation; the agent keeps running. **Stop Harness** ends the engine process
+and asks first. **Restart Harness** relaunches it in the same pane with the same id, resuming the
conversation where the engine supports it.
-**Open Agent (⌘O)** is the search: agents, tabs, projects, machines, history and commands, fuzzy
+**Open Harness (⌘O)** is the search: harnesses, tabs, projects, machines, history and commands, fuzzy
matched, with a session preview on the right built from cached recent turns. Type `>` for commands
only (also ⇧⌘P).
diff --git a/docs/keyboard.md b/docs/keyboard.md
index 4ccb0270c..388ce655d 100644
--- a/docs/keyboard.md
+++ b/docs/keyboard.md
@@ -6,8 +6,8 @@ The defaults, in the workspace:
| Keys | Action |
|---|---|
-| ⌘N | New Agent |
-| ⌘O | Open Agent — search sessions, tabs, machines, history; `>` for commands |
+| ⌘N | New Harness |
+| ⌘O | Open Harness — search sessions, tabs, machines, history; `>` for commands |
| ⇧⌘P | Command palette |
| ⌘B | Boss mode: describe a task, it picks the agent |
| ⌘T · ⌘W · ⇧⌘T · ⇧⌘R | New tab · close tab · reopen last closed · rename tab |
diff --git a/dsh/README.md b/dsh/README.md
index 771db7452..5fefbc810 100644
--- a/dsh/README.md
+++ b/dsh/README.md
@@ -2,7 +2,7 @@
A **domain-specific harness (DSH)** turns Harness into a product for one domain: PCB design,
3D CAD, short drama, robot training. It is a git repo that Harness installs on a machine. Users see
-it as one more tile in New Agent — pick **Copper**, choose a folder, prompt — and get
+it as one more tile in New Harness — pick **Copper**, choose a folder, prompt — and get
the domain's skills in the agent, its toolchain on the machine, its viewer in a pane next to the
terminal, and its verdict in the pane header.
@@ -82,7 +82,7 @@ is what lets hundreds of DSHs exist without any of them touching this repo.
harness dsh list # installed here, and what the registry offers
```
- Then New Agent, your tile, a folder, a prompt. For a check without the app,
+ Then New Harness, your tile, a folder, a prompt. For a check without the app,
[`dsh/tools/dsh-e2e.mjs`](tools/) creates an agent over the daemon's loopback socket and
reports the materialized workspace, the viewer URL, the pane's environment and the first verdict.
The viewer process reads its own files when it starts; after you edit it, kill it and the daemon