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.

refactor(mobile): the phone calls a harness a harness, as every window does

bubu-dudu6e1fceef815c
diff --git a/mobile/lib/phone/agent_home.dart b/mobile/lib/phone/agent_home.dart
index 56e9881a9..3b6c102f1 100644
--- a/mobile/lib/phone/agent_home.dart
+++ b/mobile/lib/phone/agent_home.dart
@@ -444,7 +444,7 @@ class _AgentHomeState extends State<AgentHome> {
AgentLoadStatus.needsLink => false,
};
});
- return loadingAgents ? 'Loading your agents…' : null;
+ return loadingAgents ? 'Loading your harnesses…' : null;
}
/// The entry naming [agent], if it is in [entries] and can actually be opened.
@@ -903,7 +903,7 @@ class _AgentHomeEmpty extends StatelessWidget {
backgroundColor: AppPalette.windowBg,
floatingActionButton: PhoneFab(
icon: LucideIcons.plus300,
- tooltip: 'New agent',
+ tooltip: 'New Harness',
// The first machine that can host one. Which machine is the form's first question, and it
// is changed there.
onPressed: () =>
@@ -915,15 +915,15 @@ class _AgentHomeEmpty extends StatelessWidget {
children: [
PhoneHeader(
large: true,
- title: 'Agents',
+ title: 'Harnesses',
trailing: [PhoneSearchButton(notifier: notifier)],
),
const Expanded(
child: EmptyState(
icon: LucideIcons.squareTerminal300,
- title: 'No agents yet',
+ title: 'No harnesses yet',
message:
- 'Tap + to start one, or launch an agent from Harness on a '
+ 'Tap + to start one, or launch a harness from Harness on a '
'machine and it will appear here.',
),
),
diff --git a/mobile/lib/phone/agents_list_page.dart b/mobile/lib/phone/agents_list_page.dart
index 5791300d7..117023571 100644
--- a/mobile/lib/phone/agents_list_page.dart
+++ b/mobile/lib/phone/agents_list_page.dart
@@ -51,7 +51,7 @@ class _AgentsListPageState extends State<AgentsListPage> {
]);
final _controller = TextEditingController();
- final _focus = FocusNode(debugLabel: 'Agents list search');
+ final _focus = FocusNode(debugLabel: 'Harnesses list search');
String _query = '';
/// This screen rebuilds on every turn event — it watches the notifier AND the
@@ -101,7 +101,7 @@ class _AgentsListPageState extends State<AgentsListPage> {
bottom: false,
child: Column(
children: [
- PhoneHeader(large: widget.large, title: 'Agents'),
+ PhoneHeader(large: widget.large, title: 'Harnesses'),
// Under the header rather than a magnifier inside it. The field is this screen's
// filter, not a door to another one: what it narrows is the list directly below it,
// and a query typed here keeps the machine headings it is filtering in view. A
@@ -118,7 +118,7 @@ class _AgentsListPageState extends State<AgentsListPage> {
autofocus: false,
// This field filters the list below it; it is not the door to
// the modes, which [PhoneSearchPage] carries.
- hintText: 'Search agents',
+ hintText: 'Search harnesses',
onChanged: (value) => setState(() => _query = value),
onClear: () {
_controller.clear();
@@ -234,10 +234,10 @@ class _BodyState extends State<_Body> {
icon: notifier.machines.isEmpty
? LucideIcons.laptopMinimal300
: LucideIcons.squareTerminal300,
- title: notifier.machines.isEmpty ? 'No machines yet' : 'No agents to show',
+ title: notifier.machines.isEmpty ? 'No machines yet' : 'No harnesses to show',
message: notifier.machines.isEmpty
- ? 'Link a machine and its agents will be listed here.'
- : 'Agents appear here once a machine is linked and answering. '
+ ? 'Link a machine and its harnesses will be listed here.'
+ : 'Harnesses appear here once a machine is linked and answering. '
'Start one from a machine, or from Harness on it.',
);
diff --git a/mobile/lib/phone/agents_page.dart b/mobile/lib/phone/agents_page.dart
index b8c87d788..74f57d4c8 100644
--- a/mobile/lib/phone/agents_page.dart
+++ b/mobile/lib/phone/agents_page.dart
@@ -64,7 +64,7 @@ class AgentsPage extends StatelessWidget {
? null
: PhoneFab(
icon: LucideIcons.plus300,
- tooltip: 'New agent',
+ tooltip: 'New Harness',
onPressed: () => openNewAgent(context, notifier, machineId),
),
body: SafeArea(
@@ -116,7 +116,7 @@ class AgentsPage extends StatelessWidget {
actions: [
PhoneSheetAction(
icon: LucideIcons.refreshCw300,
- label: 'Reload agents',
+ label: 'Reload harnesses',
onTap: () => unawaited(notifier.reloadMachineData(machineId)),
),
// Only where there is a link to replace. A machine that never had one reaches its form by
@@ -155,8 +155,8 @@ class AgentsPage extends StatelessWidget {
context,
title: 'Unlink $name?',
message:
- 'This phone will need $name\'s password again to open its agents. '
- 'The machine itself is not changed, and its agents keep running.',
+ 'This phone will need $name\'s password again to open its harnesses. '
+ 'The machine itself is not changed, and its harnesses keep running.',
confirmLabel: 'Unlink',
);
if (!confirmed || !context.mounted) return;
@@ -222,7 +222,7 @@ class _AgentsBody extends StatelessWidget {
icon: LucideIcons.cloudOff300,
title: "Harness isn't running there",
message:
- 'Start Harness on ${machine.machine.displayName} and its agents '
+ 'Start Harness on ${machine.machine.displayName} and its harnesses '
'will show up here.',
);
}
@@ -233,7 +233,7 @@ class _AgentsBody extends StatelessWidget {
if (agents.isEmpty && loadError != null) {
return EmptyState(
icon: LucideIcons.circleAlert300,
- title: "Couldn't load its agents",
+ title: "Couldn't load its harnesses",
message: loadError,
action: FilledButton(
onPressed: () => notifier.reloadMachineData(_machineId),
@@ -244,11 +244,11 @@ class _AgentsBody extends StatelessWidget {
if (agents.isEmpty) {
return EmptyState(
icon: LucideIcons.squareTerminal300,
- title: 'No agents yet',
+ title: 'No harnesses yet',
message: 'Start one here, or from Harness on that machine.',
action: FilledButton(
onPressed: () => openNewAgent(context, notifier, _machineId),
- child: const Text('New agent'),
+ child: const Text('New Harness'),
),
);
}
@@ -282,7 +282,7 @@ Future<void> showAgentActions(
actions: [
PhoneSheetAction(
icon: LucideIcons.trash2300,
- label: 'Delete agent…',
+ label: 'Stop Harness…',
destructive: true,
onTap: () => unawaited(
confirmDeleteAgent(context, notifier, machineId, agent.id, agent.name),
diff --git a/mobile/lib/phone/delete_agent.dart b/mobile/lib/phone/delete_agent.dart
index 67f31aada..7a27efc53 100644
--- a/mobile/lib/phone/delete_agent.dart
+++ b/mobile/lib/phone/delete_agent.dart
@@ -30,11 +30,18 @@ Future<void> confirmDeleteAgent(
) async {
final confirmed = await confirmPhoneAction(
context,
- title: 'Delete $agentName?',
+ title: 'Stop $agentName?',
+ // ⚠️ **The desktop's own sentence, word for word**, because it is the same
+ // `agent_delete` on the wire (`AppNotifier.deleteAgent`, and desktop's
+ // `widgets/delete_agent_dialog.dart`) — and the two used to describe it
+ // differently. This phone said the unfinished work went with it; the
+ // desktop says the files and the conversation stay. One call cannot be both,
+ // and the desktop's is the one that matches what the daemon does: the
+ // harness and its terminal session end, the folder on the machine does not.
message:
- 'The agent and its terminal session are removed from the machine, '
- "along with any work it has not finished. This can't be undone.",
- confirmLabel: 'Delete',
+ 'Stop this harness? Project files and saved conversation history are '
+ 'kept.',
+ confirmLabel: 'Stop',
);
if (!confirmed || !context.mounted) return;
final error = await notifier.deleteAgent(machineId, agentId);
diff --git a/mobile/lib/phone/desk_add_agent_sheet.dart b/mobile/lib/phone/desk_add_agent_sheet.dart
index a4bde2a15..c3ffa30e5 100644
--- a/mobile/lib/phone/desk_add_agent_sheet.dart
+++ b/mobile/lib/phone/desk_add_agent_sheet.dart
@@ -136,7 +136,7 @@ class _AddAgentSheet extends StatelessWidget {
Padding(
padding: const EdgeInsets.fromLTRB(_sideInset, 0, _sideInset, 8),
child: Text(
- 'Every agent this phone can open is already here.',
+ 'Every harness this phone can open is already here.',
style: TextStyle(
color: AppPalette.textSecondary,
fontSize: 13.5,
@@ -174,7 +174,7 @@ class _NewAgentRow extends StatelessWidget {
const SizedBox(width: 14),
Expanded(
child: Text(
- 'New agent',
+ 'New Harness',
style: TextStyle(
color: AppPalette.textPrimary,
fontSize: 15.5,
diff --git a/mobile/lib/phone/desk_groups.dart b/mobile/lib/phone/desk_groups.dart
index 061a790be..bcac6a468 100644
--- a/mobile/lib/phone/desk_groups.dart
+++ b/mobile/lib/phone/desk_groups.dart
@@ -12,7 +12,7 @@ const String kUntabbedGroupName = 'Other';
/// What the strip falls back to when the account has no tabs at all: one group
/// over everything, which is the phone exactly as it was before the desk.
-const String kEveryAgentGroupName = 'All agents';
+const String kEveryAgentGroupName = 'All harnesses';
/// One tab of the desk as this phone can show it: its name, and the agents of it
/// that can actually be opened right now.
diff --git a/mobile/lib/phone/desk_tabs_popup.dart b/mobile/lib/phone/desk_tabs_popup.dart
index a87aa9bc6..ce8e24c35 100644
--- a/mobile/lib/phone/desk_tabs_popup.dart
+++ b/mobile/lib/phone/desk_tabs_popup.dart
@@ -392,7 +392,7 @@ class _AddAgentRow extends StatelessWidget {
AppTheme.watch(context);
return Semantics(
button: true,
- label: 'Add agent to $tabName',
+ label: 'Add harness to $tabName',
// ⚠️ The words on the row are "this tab", which is clear under a thumb
// that has just read the tab's name and useless read aloud on its own.
// Excluded, the row announces the tab it fills.
@@ -418,7 +418,7 @@ class _AddAgentRow extends StatelessWidget {
const SizedBox(width: 8),
Flexible(
child: Text(
- 'Add agent to this tab',
+ 'Add harness to this tab',
maxLines: 1,
overflow: TextOverflow.ellipsis,
style: TextStyle(
@@ -495,9 +495,9 @@ class _TabIsEmpty extends StatelessWidget {
padding: const EdgeInsets.fromLTRB(_sideInset, 10, _sideInset, 18),
child: Text(
everHeldAgents
- ? 'Nothing here this phone can open — the machine these agents run '
+ ? 'Nothing here this phone can open — the machine these harnesses run '
'on is asleep or wants its password.'
- : 'This tab has no agents yet.',
+ : 'This tab has no harnesses yet.',
style: TextStyle(color: AppPalette.textSecondary, fontSize: 13.5),
),
);
diff --git a/mobile/lib/phone/machine_actions.dart b/mobile/lib/phone/machine_actions.dart
index f409109bb..3ba40b404 100644
--- a/mobile/lib/phone/machine_actions.dart
+++ b/mobile/lib/phone/machine_actions.dart
@@ -38,7 +38,7 @@ void openMachineActions(
actions: [
PhoneSheetAction(
icon: LucideIcons.refreshCw300,
- label: 'Reload agents',
+ label: 'Reload harnesses',
onTap: () => unawaited(notifier.reloadMachineData(machineId)),
),
PhoneSheetAction(
diff --git a/mobile/lib/phone/new_agent_page.dart b/mobile/lib/phone/new_agent_page.dart
index 3687aa8e7..e50b69730 100644
--- a/mobile/lib/phone/new_agent_page.dart
+++ b/mobile/lib/phone/new_agent_page.dart
@@ -398,7 +398,7 @@ class _NewAgentPageState extends State<NewAgentPage> {
children: [
// No machine under the title any more: the MACHINE rows below say it, and are where it
// is changed.
- const PhoneHeader(title: 'New agent'),
+ const PhoneHeader(title: 'New Harness'),
Expanded(
child: ListView(
padding: const EdgeInsets.only(bottom: 16),
@@ -629,7 +629,7 @@ class _NewAgentPageState extends State<NewAgentPage> {
width: double.infinity,
child: FilledButton(
onPressed: ready ? () => unawaited(_create()) : null,
- child: Text(_creating ? 'Starting…' : 'Create agent'),
+ child: Text(_creating ? 'Starting…' : 'Create Harness'),
),
),
),
diff --git a/mobile/lib/phone/phone_search_actions.dart b/mobile/lib/phone/phone_search_actions.dart
index 4a4f091ab..36f96c775 100644
--- a/mobile/lib/phone/phone_search_actions.dart
+++ b/mobile/lib/phone/phone_search_actions.dart
@@ -32,7 +32,7 @@ List<PhoneCommand> phoneSearchCommands(
if (ready.isNotEmpty)
PhoneCommand(
id: 'agent.new',
- title: 'New agent',
+ title: 'New Harness',
detail: ready.length == 1
? 'On ${ready.first.machine.displayName}'
: 'Choose a machine, then an engine',
@@ -41,8 +41,8 @@ List<PhoneCommand> phoneSearchCommands(
),
PhoneCommand(
id: 'navigation.agents',
- title: 'All agents',
- detail: 'Every agent on the account, by machine',
+ title: 'All harnesses',
+ detail: 'Every harness on the account, by machine',
run: () => Navigator.of(
context,
).push(phoneRoute((_) => AgentsListPage(notifier: notifier))),
diff --git a/mobile/lib/phone/phone_search_commands.dart b/mobile/lib/phone/phone_search_commands.dart
index 73e54b580..cc1db3501 100644
--- a/mobile/lib/phone/phone_search_commands.dart
+++ b/mobile/lib/phone/phone_search_commands.dart
@@ -42,8 +42,8 @@ class PhoneCommand {
/// A phone has no key to discover them by, so `?` is the only teacher there is.
List<PhoneDestination> phoneSearchModes(List<PhoneCommand> commands) => [
_mode('commands', '> Commands', 'Run anything by name', '> '),
- _mode('projects', '# Projects', 'Choose a project, then one of its agents', '# '),
- _mode('machines', '@ Machines', 'Choose a machine, then one of its agents', '@ '),
+ _mode('projects', '# Projects', 'Choose a project, then one of its harnesses', '# '),
+ _mode('machines', '@ Machines', 'Choose a machine, then one of its harnesses', '@ '),
for (final command in commands) command.destination,
];
diff --git a/mobile/lib/phone/phone_search_controller.dart b/mobile/lib/phone/phone_search_controller.dart
index 16ce7d472..6ca0accd2 100644
--- a/mobile/lib/phone/phone_search_controller.dart
+++ b/mobile/lib/phone/phone_search_controller.dart
@@ -16,7 +16,7 @@ import 'phone_search_rank.dart';
/// thing, and a hint that named only one of them ("Search agents") was most of
/// why nobody on the phone knew the other three existed.
const kPhoneSearchHint =
- 'Search agents > commands # projects @ machines ? help';
+ 'Search harnesses > commands # projects @ machines ? help';
/// One search session, shared by the field and its results.
///
@@ -107,7 +107,7 @@ class PhoneSearchController extends ChangeNotifier {
: isMachineMode
? 'Machines'
: _groupScope != null
- ? 'Agents · ${_groupScope!.name}'
+ ? 'Harnesses · ${_groupScope!.name}'
: 'Search';
String get hint => isCommandMode
@@ -115,7 +115,7 @@ class PhoneSearchController extends ChangeNotifier {
: isHelpMode
? 'Choose a mode or search help…'
: _groupScope != null
- ? 'Search agents in ${_groupScope!.name}…'
+ ? 'Search harnesses in ${_groupScope!.name}…'
: isProjectMode
? 'Search projects…'
: isMachineMode
diff --git a/mobile/lib/phone/phone_search_results.dart b/mobile/lib/phone/phone_search_results.dart
index 2a2b58d11..c6cfeb0ec 100644
--- a/mobile/lib/phone/phone_search_results.dart
+++ b/mobile/lib/phone/phone_search_results.dart
@@ -141,7 +141,7 @@ class _PhoneSearchResultsState extends State<PhoneSearchResults> {
return const EmptyState(
icon: LucideIcons.laptopMinimal300,
title: 'Nothing to search yet',
- message: 'Link a machine and its agents will be findable from here.',
+ message: 'Link a machine and its harnesses will be findable from here.',
);
}
return EmptyState.noMatches(
diff --git a/mobile/lib/phone/phone_status.dart b/mobile/lib/phone/phone_status.dart
index aeebdead5..097cf28cc 100644
--- a/mobile/lib/phone/phone_status.dart
+++ b/mobile/lib/phone/phone_status.dart
@@ -86,9 +86,9 @@ PhoneSummary phoneMachineSummary(MachineState machine) =>
};
String _agentCount(int count) => switch (count) {
- 0 => 'No agents yet',
- 1 => '1 agent',
- _ => '$count agents',
+ 0 => 'No harnesses yet',
+ 1 => '1 harness',
+ _ => '$count harnesses',
};
/// What an agent is doing, as its row says it. Waiting on the person outranks working, which
diff --git a/mobile/lib/phone/phone_tab_bar.dart b/mobile/lib/phone/phone_tab_bar.dart
index 2f99f7bb9..164d6ace4 100644
--- a/mobile/lib/phone/phone_tab_bar.dart
+++ b/mobile/lib/phone/phone_tab_bar.dart
@@ -14,7 +14,7 @@ enum PhoneTab {
agents(
LucideIcons.squareTerminal300,
LucideIcons.squareTerminal400,
- 'Agents',
+ 'Harnesses',
),
machines(
LucideIcons.laptopMinimal300,
diff --git a/mobile/lib/phone/stats_page.dart b/mobile/lib/phone/stats_page.dart
index 79fc175a8..95a9df861 100644
--- a/mobile/lib/phone/stats_page.dart
+++ b/mobile/lib/phone/stats_page.dart
@@ -83,13 +83,13 @@ class _Body extends StatelessWidget {
: [
_StatCard(
icon: LucideIcons.bot300,
- label: 'Agents spawned',
+ label: 'Harnesses spawned',
value: formatStatCount(summary.agentsSpawned),
),
const SizedBox(height: kStatCardGap),
_StatCard(
icon: LucideIcons.clock300,
- label: 'Time agents worked',
+ label: 'Time harnesses worked',
value: formatWorkedTime(summary.timeWorked),
),
const SizedBox(height: kStatCardGap),
@@ -210,7 +210,7 @@ class _EmptyState extends StatelessWidget {
),
const SizedBox(height: 6),
Text(
- 'Start your first agent and this page begins counting.',
+ 'Start your first harness and this page begins counting.',
textAlign: TextAlign.center,
style: TextStyle(
color: AppPalette.textSecondary,
diff --git a/mobile/lib/phone/terminal_action_column.dart b/mobile/lib/phone/terminal_action_column.dart
index bea14c029..db1f405df 100644
--- a/mobile/lib/phone/terminal_action_column.dart
+++ b/mobile/lib/phone/terminal_action_column.dart
@@ -122,7 +122,7 @@ class TerminalActionColumn extends StatelessWidget {
TerminalRoundAction(
key: const ValueKey('terminal-search'),
icon: LucideIcons.search300,
- label: 'Search agents and machines',
+ label: 'Search harnesses and machines',
onTap: onSearch,
),
),
@@ -131,7 +131,7 @@ class TerminalActionColumn extends StatelessWidget {
TerminalRoundAction(
key: const ValueKey('terminal-new-agent'),
icon: LucideIcons.plus300,
- label: 'New agent',
+ label: 'New Harness',
onTap: onNewAgent,
),
),
diff --git a/mobile/lib/phone/terminal_header.dart b/mobile/lib/phone/terminal_header.dart
index 1b4e2283c..1a6439901 100644
--- a/mobile/lib/phone/terminal_header.dart
+++ b/mobile/lib/phone/terminal_header.dart
@@ -169,7 +169,7 @@ class _Identity extends StatelessWidget {
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Text(
- agent?.name ?? 'Agent',
+ agent?.name ?? 'Harness',
maxLines: 1,
overflow: TextOverflow.ellipsis,
style: TextStyle(
diff --git a/mobile/lib/phone/terminal_key_bar.dart b/mobile/lib/phone/terminal_key_bar.dart
index 245ebc69b..b26df15e5 100644
--- a/mobile/lib/phone/terminal_key_bar.dart
+++ b/mobile/lib/phone/terminal_key_bar.dart
@@ -93,7 +93,7 @@ class TerminalKeyBar extends StatelessWidget {
}
showPhoneSheet(
context,
- title: 'Send a picture to this agent',
+ title: 'Send a picture to this harness',
actions: [
PhoneSheetAction(
icon: LucideIcons.image300,
diff --git a/mobile/lib/phone/terminal_page.dart b/mobile/lib/phone/terminal_page.dart
index 2b495ebc6..84ab7241c 100644
--- a/mobile/lib/phone/terminal_page.dart
+++ b/mobile/lib/phone/terminal_page.dart
@@ -1338,7 +1338,7 @@ class _TerminalPageState extends State<TerminalPage>
// as a menu rather than as a truncation.
icon: LucideIcons.ellipsisVertical300,
size: 21,
- tooltip: 'Agent actions',
+ tooltip: 'Harness actions',
// Last in the row, so its padding stops at
// the header's own right inset.
last: true,
@@ -1467,7 +1467,7 @@ class _TerminalPageState extends State<TerminalPage>
// door rather than a list of its own — the lists belong on the pages behind them, where they
// have room for every row and do not push the rest of this sheet down.
sections: [
- PhoneSheetSection(caption: 'Agent', actions: [..._agentActions(agent)]),
+ PhoneSheetSection(caption: 'Harness', actions: [..._agentActions(agent)]),
PhoneSheetSection(
caption: 'App',
actions: [
@@ -1479,7 +1479,7 @@ class _TerminalPageState extends State<TerminalPage>
// longer than a screenful.
PhoneSheetAction(
icon: LucideIcons.squareTerminal300,
- label: 'Agents',
+ label: 'Harnesses',
onTap: () => unawaited(_openAgentList()),
),
PhoneSheetAction(
@@ -1537,7 +1537,7 @@ class _TerminalPageState extends State<TerminalPage>
),
PhoneSheetAction(
icon: LucideIcons.pencil300,
- label: 'Rename agent…',
+ label: 'Rename Harness…',
onTap: () => showAgentRenameDialog(
context,
widget.notifier,
@@ -1548,7 +1548,7 @@ class _TerminalPageState extends State<TerminalPage>
),
PhoneSheetAction(
icon: LucideIcons.refreshCw300,
- label: 'Restart agent',
+ label: 'Restart Harness',
onTap: () => unawaited(_restart()),
),
// Last, and alone in red: the two above are recoverable and this one is
@@ -1561,7 +1561,7 @@ class _TerminalPageState extends State<TerminalPage>
// the route.
PhoneSheetAction(
icon: LucideIcons.trash2300,
- label: 'Delete agent…',
+ label: 'Stop Harness…',
destructive: true,
onTap: () => unawaited(
confirmDeleteAgent(
@@ -1678,7 +1678,7 @@ class _AgentGone extends StatelessWidget {
const SizedBox(height: 14),
Text(
name == null || name!.isEmpty
- ? 'That agent is gone'
+ ? 'That harness is gone'
: '$name is gone',
textAlign: TextAlign.center,
style: TextStyle(
@@ -1704,7 +1704,7 @@ class _AgentGone extends StatelessWidget {
foregroundColor: AppPalette.accent,
padding: const EdgeInsets.symmetric(horizontal: 18, vertical: 10),
),
- child: const Text('Open another agent'),
+ child: const Text('Open another harness'),
),
],
),
@@ -2052,7 +2052,7 @@ class _AttachingState extends State<_Attaching> with TickerProviderStateMixin {
)!;
final bar = (fontSize * 0.62).clamp(5.0, 12.0).toDouble();
return SkeletonBlock(
- semanticsLabel: 'Attaching to the agent',
+ semanticsLabel: 'Attaching to the harness',
// ⚠️ **One painter, repainted, in a layer of its own** — where this was a
// column of seventy-odd widgets rebuilt on every frame of the breath, under
// a [ShaderMask] that pushed the whole pane through an offscreen buffer on
diff --git a/mobile/lib/phone/usage_page.dart b/mobile/lib/phone/usage_page.dart
index 37f3b4b8a..d9029a419 100644
--- a/mobile/lib/phone/usage_page.dart
+++ b/mobile/lib/phone/usage_page.dart
@@ -103,7 +103,7 @@ class _UsagePageState extends State<UsagePage> {
PhoneHeader(
title: 'Usage',
subtitle: Text(
- 'What your agent accounts have spent',
+ 'What your harness accounts have spent',
style: TextStyle(color: AppPalette.textSecondary, fontSize: 13),
),
),
@@ -204,7 +204,7 @@ class _EmptyUsage extends StatelessWidget {
message: usage.stale
? 'The machines you linked did not answer this time. Pull down to try again.'
: 'Link a machine and connect to it — usage is read on the machine '
- 'your agents run on, not on this phone.',
+ 'your harnesses run on, not on this phone.',
);
}
final signedOut = [
diff --git a/mobile/lib/phone/voice_mic_button.dart b/mobile/lib/phone/voice_mic_button.dart
index 8fdab2361..530d2ffe0 100644
--- a/mobile/lib/phone/voice_mic_button.dart
+++ b/mobile/lib/phone/voice_mic_button.dart
@@ -133,7 +133,7 @@ class _VoiceMicButtonState extends State<VoiceMicButton> {
String get _semanticLabel => switch (_face) {
VoiceMicFace.talk =>
- micHoldsToTalk ? 'Hold to talk to the agent' : 'Talk to the agent',
+ micHoldsToTalk ? 'Hold to talk to the harness' : 'Talk to the harness',
VoiceMicFace.starting => 'Cancel',
VoiceMicFace.listening =>
micHoldsToTalk ? 'Release to send' : 'Done talking',
diff --git a/mobile/lib/state/app_state.dart b/mobile/lib/state/app_state.dart
index 9b5a41c03..9c722f282 100644
--- a/mobile/lib/state/app_state.dart
+++ b/mobile/lib/state/app_state.dart
@@ -655,7 +655,7 @@ class AppNotifier extends ChangeNotifier {
// An unused starter has no work to recover. This also covers empty pages
// restored from builds that did not mark them as drafts.
if (entry is ClosedSwarm &&
- entry.name == 'New Harness' &&
+ entry.name == Swarm.defaultName &&
entry.panes.isEmpty &&
entry.presets.isEmpty) {
return;
@@ -674,7 +674,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.
+ // An untitled 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>{};
@@ -683,14 +683,14 @@ class AppNotifier extends ChangeNotifier {
final swarm = swarms.where((swarm) => swarm.id == id).firstOrNull;
return swarm != null &&
swarm.panes.isEmpty &&
- swarm.name == 'New Harness' &&
+ swarm.name == Swarm.defaultName &&
swarm.presets.isEmpty;
}
- void newSwarm({String name = 'New Harness', bool draft = false}) {
+ void newSwarm({String name = Swarm.defaultName, bool draft = false}) {
// 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 == 'New Harness') {
+ if (name == Swarm.defaultName) {
final starter = activeSwarm.isEmptyStarter
? activeSwarm
: swarms.where((swarm) => swarm.isEmptyStarter).firstOrNull;
@@ -733,7 +733,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];
@@ -741,7 +741,7 @@ class AppNotifier extends ChangeNotifier {
if (returnId == null ||
target == null ||
target.panes.isNotEmpty ||
- target.name != 'New Harness' ||
+ target.name != Swarm.defaultName ||
target.presets.isNotEmpty ||
swarms.length == 1) {
return false;
@@ -840,7 +840,7 @@ class AppNotifier extends ChangeNotifier {
// welcome tabs, evicting the real work from recently closed history.
if (swarms.length == 1 &&
swarms.single.panes.isEmpty &&
- swarms.single.name == 'New Harness' &&
+ swarms.single.name == Swarm.defaultName &&
swarms.single.presets.isEmpty) {
return;
}
@@ -5652,7 +5652,7 @@ class AppNotifier extends ChangeNotifier {
target.arranged = split.after;
target.arrangedKey = key;
}
- if (firstAgent && target.name == 'New Harness') {
+ if (firstAgent && target.name == Swarm.defaultName) {
final name = agent.name.trim();
if (name.isNotEmpty) {
target.name = name.length > 80 ? name.substring(0, 80) : name;
@@ -6201,7 +6201,7 @@ class AppNotifier extends ChangeNotifier {
final swarm = swarms.where((swarm) => swarm.id == id).firstOrNull;
return swarm == null ||
swarm.panes.isNotEmpty ||
- swarm.name != 'New Harness' ||
+ swarm.name != Swarm.defaultName ||
swarm.presets.isNotEmpty;
});
_layoutRevision++;
@@ -6255,7 +6255,7 @@ class AppNotifier extends ChangeNotifier {
0,
(raw['name'] as String).length.clamp(0, 80),
)
- : 'New Harness',
+ : Swarm.defaultName,
);
for (final item in (raw['panes'] as List).take(maxPanes)) {
final entry = PaneLayoutEntry.fromJson(item);
diff --git a/mobile/lib/state/swarm.dart b/mobile/lib/state/swarm.dart
index b47a838ef..901faddb7 100644
--- a/mobile/lib/state/swarm.dart
+++ b/mobile/lib/state/swarm.dart
@@ -8,11 +8,28 @@ import 'terminal_pane.dart';
/// Shared agents reuse the same pane/session across swarms, so the daemon has
/// exactly one controller and switching tabs cannot take over our own stream.
class Swarm {
- Swarm({required this.id, String name = 'New Harness'})
- : name = const {'New swarm', 'New tab', 'New Agent'}.contains(name)
- ? 'New Harness'
+ Swarm({required this.id, String name = defaultName})
+ : name = const {
+ 'New swarm',
+ 'New tab',
+ 'New Tab',
+ 'New Harness',
+ 'New Agent',
+ }.contains(name)
+ ? defaultName
: name;
+ /// What an untouched tab is called, and the desktop's own word for it
+ /// (`desktop/lib/state/swarm.dart`).
+ ///
+ /// ⚠️ **"New Harness" is in the legacy set above, not here, and the two are
+ /// not the same thing.** A *harness* is one agent — what the desktop's menus
+ /// stop, fork and rename. A *tab* is the box several of them sit in. The
+ /// default was 'New Harness' until 2026-09-15, which read as though opening a
+ /// tab opened an agent; a layout saved then still carries the name, and it
+ /// has to come back as the same fresh tab.
+ static const defaultName = 'Untitled Tab';
+
final String id;
String name;
final List<TerminalPane> panes = [];
@@ -28,7 +45,7 @@ class Swarm {
final Map<int, int> pinnedSlots = {};
bool get isEmptyStarter =>
- name == 'New Harness' && panes.isEmpty && presets.isEmpty;
+ name == defaultName && panes.isEmpty && presets.isEmpty;
PaneArrangement? get manualLayout => paneSizes['${panes.length}:manual'];
@@ -183,7 +200,7 @@ class ClosedSwarm extends ClosedWork {
bool replacesUntouchedWelcome(Swarm swarm) =>
swarm.id == replacementId &&
- swarm.name == 'New Harness' &&
+ swarm.name == Swarm.defaultName &&
swarm.panes.isEmpty &&
swarm.presets.isEmpty;
}
diff --git a/mobile/lib/widgets/welcome_workspace_preview.dart b/mobile/lib/widgets/welcome_workspace_preview.dart
index a34b2d7a7..feaafdc94 100644
--- a/mobile/lib/widgets/welcome_workspace_preview.dart
+++ b/mobile/lib/widgets/welcome_workspace_preview.dart
@@ -14,7 +14,7 @@ class WelcomeWorkspacePreview extends StatelessWidget {
final palette = grid.AppTheme.palette.value;
return Semantics(
image: true,
- label: 'Example agent group: Claude Code and Codex working side by side.',
+ label: 'Example harness group: Claude Code and Codex working side by side.',
child: ExcludeSemantics(
child: Container(
decoration: BoxDecoration(
@@ -42,7 +42,7 @@ class WelcomeWorkspacePreview extends StatelessWidget {
),
Spacer(),
Text(
- '2 agents',
+ '2 harnesses',
style: TextStyle(fontSize: 11, color: Colors.white70),
),
],
diff --git a/mobile/test/desk_tab_add_test.dart b/mobile/test/desk_tab_add_test.dart
index 8a54a0078..9f3f3db54 100644
--- a/mobile/test/desk_tab_add_test.dart
+++ b/mobile/test/desk_tab_add_test.dart
@@ -143,7 +143,7 @@ void main() {
await openPanel(tester);
await showTab(tester, 'Docker');
- await tester.tap(find.bySemanticsLabel('Add agent to Docker'));
+ await tester.tap(find.bySemanticsLabel('Add harness to Docker'));
await settleSheet(tester);
await tester.tap(row('d'));
await settleSheet(tester);
@@ -176,7 +176,7 @@ void main() {
);
await openPanel(tester);
- await tester.tap(find.bySemanticsLabel('Add agent to Desktop'));
+ await tester.tap(find.bySemanticsLabel('Add harness to Desktop'));
await settleSheet(tester);
// `a` and `b` are in the tab, and the panel under the sheet still draws
@@ -197,13 +197,13 @@ void main() {
// leftover one — every agent is outside this tab.
await showTab(tester, 'Empty');
- expect(find.text('This tab has no agents yet.'), findsOneWidget);
+ expect(find.text('This tab has no harnesses yet.'), findsOneWidget);
expect(
find.textContaining('asleep'),
findsNothing,
reason: 'a tab holding nothing is not a tab whose machine is away',
);
- expect(find.bySemanticsLabel('Add agent to Empty'), findsOneWidget);
+ expect(find.bySemanticsLabel('Add harness to Empty'), findsOneWidget);
});
testWidgets('a name double-tapped is the tab renamed, and kept custom', (
@@ -290,7 +290,7 @@ void main() {
await showTab(tester, 'Other');
// "Other" is not a tab — there is nothing on the desk to add an agent to.
- expect(find.textContaining('Add agent to'), findsNothing);
+ expect(find.textContaining('Add harness to'), findsNothing);
expect(
find.bySemanticsLabel('New tab'),
findsOneWidget,
diff --git a/mobile/test/phone_delete_agent_test.dart b/mobile/test/phone_delete_agent_test.dart
index 360232bf9..d97544a79 100644
--- a/mobile/test/phone_delete_agent_test.dart
+++ b/mobile/test/phone_delete_agent_test.dart
@@ -100,11 +100,11 @@ void main() {
await tester.longPress(find.byType(AgentTile).first);
await tester.pumpAndSettle();
- expect(find.text('Delete agent…'), findsOneWidget);
+ expect(find.text('Stop Harness…'), findsOneWidget);
- await tester.tap(find.text('Delete agent…'));
+ await tester.tap(find.text('Stop Harness…'));
await tester.pumpAndSettle();
- expect(find.text('Delete Live one?'), findsOneWidget);
+ expect(find.text('Stop Live one?'), findsOneWidget);
await tester.tap(find.text('Cancel'));
await tester.pumpAndSettle();
@@ -121,9 +121,9 @@ void main() {
await tester.longPress(find.byType(AgentTile).first);
await tester.pumpAndSettle();
- await tester.tap(find.text('Delete agent…'));
+ await tester.tap(find.text('Stop Harness…'));
await tester.pumpAndSettle();
- await tester.tap(find.widgetWithText(FilledButton, 'Delete'));
+ await tester.tap(find.widgetWithText(FilledButton, 'Stop'));
await tester.pumpAndSettle();
expect(conn.deleted, ['a0']);
@@ -145,13 +145,13 @@ void main() {
// A tap is the gesture this row refuses; nothing should open.
await tester.tap(gone);
await tester.pumpAndSettle();
- expect(find.text('Delete agent…'), findsNothing);
+ expect(find.text('Stop Harness…'), findsNothing);
await tester.longPress(gone);
await tester.pumpAndSettle();
- await tester.tap(find.text('Delete agent…'));
+ await tester.tap(find.text('Stop Harness…'));
await tester.pumpAndSettle();
- await tester.tap(find.widgetWithText(FilledButton, 'Delete'));
+ await tester.tap(find.widgetWithText(FilledButton, 'Stop'));
await tester.pumpAndSettle();
expect(conn.deleted, ['a1']);
diff --git a/mobile/test/phone_new_agent_opens_test.dart b/mobile/test/phone_new_agent_opens_test.dart
index 1f9d5e98b..02874045b 100644
--- a/mobile/test/phone_new_agent_opens_test.dart
+++ b/mobile/test/phone_new_agent_opens_test.dart
@@ -102,7 +102,7 @@ void main() {
await tester.pump();
await tester.tap(find.text('Claude'));
await tester.pump();
- await tester.tap(find.text('Create agent'));
+ await tester.tap(find.text('Create Harness'));
// The create resolves on a microtask, then the route it pushes has to slide in — and only once
// that transition ends does the form's own route come off the stack.
await tester.pump();
diff --git a/mobile/test/phone_search_test.dart b/mobile/test/phone_search_test.dart
index 9e135feed..83bb40dd0 100644
--- a/mobile/test/phone_search_test.dart
+++ b/mobile/test/phone_search_test.dart
@@ -600,8 +600,8 @@ void main() {
await tester.tap(find.text('box'));
await tester.pump();
- // Scoped: its own agents, and the bar says which machine they are in.
- expect(find.text('Agents · box'), findsOneWidget);
+ // Scoped: its own harnesses, and the bar says which machine they are in.
+ expect(find.text('Harnesses · box'), findsOneWidget);
expect(find.text('work · 3188'), findsOneWidget);
expect(find.text('work · 7777'), findsNothing);
@@ -610,7 +610,7 @@ void main() {
await tester.tap(find.bySemanticsLabel('Back'));
await tester.pumpAndSettle();
expect(find.byType(PhoneSearchPage), findsOneWidget);
- expect(find.text('Agents · box'), findsNothing);
+ expect(find.text('Harnesses · box'), findsNothing);
});
testWidgets('# lists projects, and a machine row says what it holds', (