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.

Make the welcome tab show five benefits and their shortcuts (#359)

Deeda5145ec44b5
diff --git a/desktop/design/images/workspace-welcome.png b/desktop/design/images/workspace-welcome.png
index 85602fad5..357112a9f 100644
Binary files a/desktop/design/images/workspace-welcome.png and b/desktop/design/images/workspace-welcome.png differ
diff --git a/desktop/design/terminal-workspace.md b/desktop/design/terminal-workspace.md
index 18129d9c4..4554b698f 100644
--- a/desktop/design/terminal-workspace.md
+++ b/desktop/design/terminal-workspace.md
@@ -75,9 +75,11 @@ actions use `terminalContentStyle()` and follow the terminal font preference.
## Keep surfaces quiet
-First launch uses the same New Tab page as every later visit: “Follow your
-curiosity.” with New Harness, Open Harness, and Harness Store shortcuts. Keep
-this page independent of onboarding progress; no checklist or automatic dialog.
+First launch uses the same New Tab page as every later visit: “Harness like a
+boss.” followed by five clickable shortcuts: Start an agent, Manage all your
+agents, Deploy a local model, Manage all your machines, and Build beyond code.
+Resolve the shortcut hints from the live keymap; unbound actions remain clickable.
+Keep this page independent of onboarding progress; no checklist or automatic dialog.
![Shared first-launch and New Tab welcome](images/workspace-welcome.png)
diff --git a/desktop/lib/widgets/workspace_welcome.dart b/desktop/lib/widgets/workspace_welcome.dart
index 6d8016e8a..9b8237e7b 100644
--- a/desktop/lib/widgets/workspace_welcome.dart
+++ b/desktop/lib/widgets/workspace_welcome.dart
@@ -17,9 +17,11 @@ class WorkspaceWelcome extends StatelessWidget {
final ValueChanged<String> onCommand;
static const _actions = [
- ('agent.new', 'New Harness', 'to start a new harness'),
- ('harnesses.list', 'Open Harness', 'to open a harness'),
- ('app.store', 'Harness Store', 'to browse the harness store'),
+ ('agent.new', 'Start an agent'),
+ ('harnesses.list', 'Manage all your agents'),
+ ('models.list', 'Deploy a local model'),
+ ('machines.list', 'Manage all your machines'),
+ ('app.store', 'Build beyond code'),
];
@override
@@ -39,9 +41,8 @@ class WorkspaceWelcome extends StatelessWidget {
final ink = hasArtwork
? const Color(0xffdededb)
: palette.foreground.withValues(alpha: .75);
- final accent = hasArtwork || Theme.of(context).brightness == Brightness.dark
- ? const Color(0xffa5d786)
- : const Color(0xff356522);
+ // The welcome surface uses a dark workspace palette in both theme modes.
+ const accent = Color(0xffa5d786);
// The page stands where a terminal will, so it is set like one: the
// terminal's face at the terminal's size, following ⌘+ and ⌘−.
final style = terminalTextStyle(
@@ -51,10 +52,9 @@ class WorkspaceWelcome extends StatelessWidget {
);
final keymap = KeymapTheme.of(context)?.current ?? harnessDefaultKeymap;
final rows = [
- for (final (command, label, description) in _actions)
+ for (final (command, description) in _actions)
(
command: command,
- label: label,
description: description,
hint: keymap
.bindingsFor(KeymapContext.workspace)
@@ -74,9 +74,8 @@ class WorkspaceWelcome extends StatelessWidget {
return width;
}
- final prefixWidth = widthOf('press ');
final keyWidth = rows
- .map((row) => widthOf('${row.hint ?? row.label} '))
+ .map((row) => widthOf('${row.hint ?? ''} '))
.reduce((a, b) => a > b ? a : b);
final descriptionWidth = rows
.map((row) => widthOf(row.description))
@@ -109,7 +108,7 @@ class WorkspaceWelcome extends StatelessWidget {
child: Center(
child: ConstrainedBox(
constraints: BoxConstraints(
- maxWidth: prefixWidth + keyWidth + descriptionWidth,
+ maxWidth: keyWidth + descriptionWidth,
),
child: DefaultTextStyle(
style: style,
@@ -119,7 +118,7 @@ class WorkspaceWelcome extends StatelessWidget {
mainAxisSize: MainAxisSize.min,
children: [
Text(
- 'Follow your curiosity.',
+ 'Harness like a boss.',
key: const ValueKey('welcome-tagline'),
),
SizedBox(height: line),
@@ -141,16 +140,10 @@ class WorkspaceWelcome extends StatelessWidget {
child: Row(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
- SizedBox(
- width: prefixWidth,
- child: Text(
- row.hint == null ? 'click' : 'press',
- ),
- ),
SizedBox(
width: keyWidth,
child: Text(
- row.hint ?? row.label,
+ row.hint ?? '',
style: TextStyle(color: accent),
textAlign: TextAlign.left,
),
diff --git a/desktop/test/toolbar_onboarding_test.dart b/desktop/test/toolbar_onboarding_test.dart
index 9c193d5dc..73e3f686f 100644
--- a/desktop/test/toolbar_onboarding_test.dart
+++ b/desktop/test/toolbar_onboarding_test.dart
@@ -142,16 +142,22 @@ void main() {
OnboardingStep.values.where(journey.completed),
OnboardingStep.values.take(completed),
);
- expect(find.text('Follow your curiosity.'), findsOneWidget);
+ expect(find.text('Harness like a boss.'), findsOneWidget);
expect(find.text('○'), findsNothing);
expect(find.text('✓'), findsNothing);
expect(find.byType(NewHarnessForm), findsNothing);
expect(find.byKey(const ValueKey('swarm-search-input')), findsNothing);
- for (final hint in ['⌘N', '⌘P', '⌘S']) {
+ for (final hint in ['⌘N', '⌘P', '⌘I', '⌘M', '⌘S']) {
expect(find.text(hint), findsOneWidget);
}
- final destinations = ['agent.new', 'harnesses.list', 'app.store'];
+ final destinations = [
+ 'agent.new',
+ 'harnesses.list',
+ 'models.list',
+ 'machines.list',
+ 'app.store',
+ ];
for (final command in destinations) {
await tap(tester, find.byKey(ValueKey('welcome-$command')));
switch (command) {
@@ -159,6 +165,10 @@ void main() {
expect(find.byType(NewHarnessForm), findsOneWidget);
case 'harnesses.list':
expect(resourceScope(''), findsOneWidget);
+ case 'models.list':
+ expect(resourceScope(':'), findsOneWidget);
+ case 'machines.list':
+ expect(resourceScope('@'), findsOneWidget);
case 'app.store':
expect(app.activeSwarm.isStore, isTrue);
}
@@ -318,10 +328,10 @@ void main() {
);
await tester.pumpAndSettle();
expect(find.text('✓'), findsNothing);
- expect(find.text('Follow your curiosity.'), findsOneWidget);
+ expect(find.text('Harness like a boss.'), findsOneWidget);
await key(tester, LogicalKeyboardKey.keyT, cmd: true);
await tester.pumpAndSettle();
- expect(find.text('Follow your curiosity.'), findsOneWidget);
+ expect(find.text('Harness like a boss.'), findsOneWidget);
expect(find.text('✓'), findsNothing);
await tap(tester, find.byKey(const ValueKey('welcome-harnesses.list')));
expect(resourceScope(''), findsOneWidget);
@@ -378,8 +388,13 @@ void main() {
expect(journey.next, OnboardingStep.machines);
await openWorkspaceTool(tester, 'machines');
await selectResource(tester, 'machine:m');
- await runResourceCommand(tester, 'Password / connection settings');
- expect(find.text('This computer’s password'), findsOneWidget);
+ await tap(
+ tester,
+ find.byKey(
+ const ValueKey('resource-action:picker.resource_settings'),
+ ),
+ );
+ expect(resourceScope('@'), findsOneWidget);
if (!hasPassword) {
final field = find.byKey(const Key('remote-password-field'));
expect(tester.widget<TextField>(field).focusNode!.hasFocus, isTrue);
@@ -388,7 +403,7 @@ void main() {
find.byKey(const Key('remote-password-confirm-field')),
'123456',
);
- await tap(tester, find.text('Set password'));
+ await tap(tester, find.byKey(const ValueKey('machine-form:Save')));
}
expect(app.password, '123456');
expect(find.text('Set password'), findsNothing);
@@ -402,52 +417,61 @@ void main() {
);
}
- testWidgets('second computer connects then opens only the source harnesses', (
- tester,
- ) async {
- const source = Machine(
- machineId: 'source',
- name: 'M2',
- authMode: MachineAuthMode.remote,
- );
- app.machineStates['source'] = MachineState(source)
- ..nodeOnline = true
- ..needsLink = true
- ..agents = const [
- Agent(
- id: 'existing',
- name: 'Existing work',
- engine: 'codex',
- terminalAvailable: true,
- ),
+ testWidgets(
+ 'second computer connects inline, then its work opens from search',
+ (tester) async {
+ const source = Machine(
+ machineId: 'source',
+ name: 'M2',
+ authMode: MachineAuthMode.remote,
+ );
+ app.machineStates['source'] = MachineState(source)
+ ..nodeOnline = true
+ ..needsLink = true
+ ..agents = const [
+ Agent(
+ id: 'existing',
+ name: 'Existing work',
+ engine: 'codex',
+ terminalAvailable: true,
+ ),
+ ];
+ app.machines = [...app.machines, source];
+ app.stateOf('m')!.agents = const [
+ Agent(id: 'unrelated', name: 'Work on this computer', engine: 'codex'),
];
- app.machines = [...app.machines, source];
- app.stateOf('m')!.agents = const [
- Agent(id: 'unrelated', name: 'Work on this computer', engine: 'codex'),
- ];
- await mount(tester);
- expect(journey.next, OnboardingStep.machines);
- await openWorkspaceTool(tester, 'machines');
- await selectResource(tester, 'machine:source');
- await runResourceCommand(tester, 'Link “M2”');
- final field = find.byType(TextField);
- await tester.enterText(field, 'wrong');
- await key(tester, LogicalKeyboardKey.enter);
- await tester.pumpAndSettle();
- expect(find.text('Incorrect password. Try again.'), findsOneWidget);
- await tester.enterText(field, '123456');
- await key(tester, LogicalKeyboardKey.enter);
- await tester.pumpAndSettle();
- expect(app.connections, ['source']);
- await key(tester, LogicalKeyboardKey.enter);
- expect(resourceScope('@'), findsNothing);
- expect(find.text('Search harnesses in M2'), findsOneWidget);
- expect(find.text('Existing work'), findsWidgets);
- expect(find.text('Work on this computer'), findsNothing);
- expect(journey.completed(OnboardingStep.machines), isFalse);
- expect(tester.takeException(), isNull);
- await tester.pumpWidget(const SizedBox());
- });
+ await mount(tester);
+ expect(journey.next, OnboardingStep.machines);
+ await openWorkspaceTool(tester, 'machines');
+ await selectResource(tester, 'machine:source');
+ await tap(
+ tester,
+ find.byKey(const ValueKey('resource-action:picker.resource_connect')),
+ );
+ final field = find.byKey(const ValueKey('remote-password-connect-field'));
+ await tester.enterText(field, 'wrong');
+ await key(tester, LogicalKeyboardKey.enter);
+ await tester.pumpAndSettle();
+ expect(find.text('Incorrect password. Try again.'), findsOneWidget);
+ await tester.enterText(field, '123456');
+ await key(tester, LogicalKeyboardKey.enter);
+ await tester.pumpAndSettle();
+ expect(app.connections, ['source']);
+ expect(resourceScope('@'), findsOneWidget);
+ await key(tester, LogicalKeyboardKey.enter);
+ expect(resourceScope('@'), findsOneWidget);
+ expect(app.panes, isEmpty);
+ await tester.enterText(resourceField, 'Existing work');
+ await tester.pumpAndSettle();
+ expect(find.text('Existing work'), findsWidgets);
+ expect(find.text('Work on this computer'), findsNothing);
+ await key(tester, LogicalKeyboardKey.enter);
+ expect(app.panes.single.agentId, 'existing');
+ expect(journey.completed(OnboardingStep.machines), isFalse);
+ expect(tester.takeException(), isNull);
+ await tester.pumpWidget(const SizedBox());
+ },
+ );
testWidgets(
'an offline source offers recovery before asking for its password',
@@ -472,8 +496,10 @@ void main() {
app.stateOf('source')!.nodeOnline = true;
app.notifyListeners();
await tester.pumpAndSettle();
- await key(tester, LogicalKeyboardKey.keyP, cmd: true, shift: true);
- expect(find.text('Link “M2”'), findsOneWidget);
+ expect(
+ find.byKey(const ValueKey('resource-action:picker.resource_connect')),
+ findsOneWidget,
+ );
await key(tester, LogicalKeyboardKey.escape);
await tester.pumpWidget(const SizedBox());
},
diff --git a/desktop/test/workspace_start_guide_test.dart b/desktop/test/workspace_start_guide_test.dart
index 454005304..1e5efec43 100644
--- a/desktop/test/workspace_start_guide_test.dart
+++ b/desktop/test/workspace_start_guide_test.dart
@@ -186,7 +186,7 @@ void main() {
addTearDown(app.dispose);
addTearDown(journey.dispose);
await _mount(tester, app, onboarding: journey);
- expect(find.text('Follow your curiosity.'), findsOneWidget);
+ expect(find.text('Harness like a boss.'), findsOneWidget);
expect(find.text('○'), findsNothing);
expect(app.panes, isEmpty);
@@ -237,7 +237,7 @@ void main() {
await key(tester, LogicalKeyboardKey.keyT, cmd: true);
await tester.pumpAndSettle();
expect(find.byType(WorkspaceWelcome), findsOneWidget);
- expect(find.text('Follow your curiosity.'), findsOneWidget);
+ expect(find.text('Harness like a boss.'), findsOneWidget);
expect(find.text('✓'), findsNothing);
expect(find.text('○'), findsNothing);
expect(app.launches, hasLength(1));
@@ -280,7 +280,7 @@ void main() {
await key(tester, LogicalKeyboardKey.escape);
await tester.pumpAndSettle();
expect(find.byType(NewHarnessForm), findsNothing);
- expect(find.text('Follow your curiosity.'), findsOneWidget);
+ expect(find.text('Harness like a boss.'), findsOneWidget);
expect(find.text('○'), findsNothing);
await tester.tap(find.byKey(const ValueKey('welcome-agent.new')));
@@ -306,7 +306,7 @@ void main() {
await _mount(tester, app);
final search = find.byKey(const ValueKey('swarm-search-input'));
expect(find.byType(WorkspaceWelcome), findsOneWidget);
- expect(find.text('Follow your curiosity.'), findsOneWidget);
+ expect(find.text('Harness like a boss.'), findsOneWidget);
expect(find.byType(NewHarnessForm), findsNothing);
expect(search, findsNothing);
await key(tester, LogicalKeyboardKey.keyN, cmd: true);
@@ -316,7 +316,7 @@ void main() {
await key(tester, LogicalKeyboardKey.keyT, cmd: true);
final tab = app.activeSwarmId;
expect(find.byType(WorkspaceWelcome), findsOneWidget);
- expect(find.text('Follow your curiosity.'), findsOneWidget);
+ expect(find.text('Harness like a boss.'), findsOneWidget);
expect(search, findsNothing);
await openHarnessPicker(tester);
await tester.pump();
diff --git a/desktop/test/workspace_welcome_test.dart b/desktop/test/workspace_welcome_test.dart
index ceb082ca2..c78dc112f 100644
--- a/desktop/test/workspace_welcome_test.dart
+++ b/desktop/test/workspace_welcome_test.dart
@@ -104,18 +104,30 @@ void main() {
) async {
for (final tab in ['first', 'next']) {
await mount(tester, tab: tab);
- expect(find.text('Follow your curiosity.'), findsOneWidget);
+ expect(find.text('Harness like a boss.'), findsOneWidget);
expect(find.text('✓'), findsNothing);
expect(find.text('○'), findsNothing);
- for (final hint in ['⌘N', '⌘P', '⌘S']) {
+ for (final hint in ['⌘N', '⌘P', '⌘I', '⌘M', '⌘S']) {
expect(find.text(hint), findsOneWidget);
}
expect(find.text('⌘O'), findsNothing);
commands.clear();
- for (final command in ['agent.new', 'harnesses.list', 'app.store']) {
+ for (final command in [
+ 'agent.new',
+ 'harnesses.list',
+ 'models.list',
+ 'machines.list',
+ 'app.store',
+ ]) {
await tester.tap(find.byKey(ValueKey('welcome-$command')));
}
- expect(commands, ['agent.new', 'harnesses.list', 'app.store']);
+ expect(commands, [
+ 'agent.new',
+ 'harnesses.list',
+ 'models.list',
+ 'machines.list',
+ 'app.store',
+ ]);
await capture(tester, 'new-tab-$tab');
}
});
@@ -136,8 +148,7 @@ void main() {
keymap.apply('{"bindings":[{"keys":"cmd+p","command":null}]}');
await tester.pump();
- expect(find.text('click'), findsOneWidget);
- expect(find.text('Open Harness'), findsOneWidget);
+ expect(find.text('Manage all your agents'), findsOneWidget);
await tester.tap(find.byKey(const ValueKey('welcome-harnesses.list')));
expect(commands, ['harnesses.list', 'harnesses.list']);
expect(tester.takeException(), isNull);
@@ -153,14 +164,31 @@ void main() {
scale: 1.7,
brightness: brightness,
);
- for (final command in ['agent.new', 'harnesses.list', 'app.store']) {
+ final hintInk = tester.widget<Text>(find.text('⌘N')).style!.color!;
+ final contrast =
+ (hintInk.computeLuminance() + .05) /
+ (grid.AppPalette.swarmField.computeLuminance() + .05);
+ expect(contrast, greaterThanOrEqualTo(4.5));
+ for (final command in [
+ 'agent.new',
+ 'harnesses.list',
+ 'models.list',
+ 'machines.list',
+ 'app.store',
+ ]) {
final row = find.byKey(ValueKey('welcome-$command'));
await tester.ensureVisible(row);
await tester.pumpAndSettle();
expect(row.hitTestable(), findsOneWidget);
await tester.tap(row);
}
- expect(commands, ['agent.new', 'harnesses.list', 'app.store']);
+ expect(commands, [
+ 'agent.new',
+ 'harnesses.list',
+ 'models.list',
+ 'machines.list',
+ 'app.store',
+ ]);
final scroll = tester.getRect(
find.byKey(const ValueKey('welcome-scroll')),
);