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.
TypeScript 3d-modelingagent-frameworkagent-harnessai-agentscadclaude-codecodexcoding-agentsdeveloper-toolsesp32game-developmentmcp-servermulti-agentopen-hardwareopencodeopenharnesspcbroboticsterminaltmux
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.pngindex 85602fad5..357112a9f 100644Binary files a/desktop/design/images/workspace-welcome.png and b/desktop/design/images/workspace-welcome.png differdiff --git a/desktop/design/terminal-workspace.md b/desktop/design/terminal-workspace.mdindex 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.diff --git a/desktop/lib/widgets/workspace_welcome.dart b/desktop/lib/widgets/workspace_welcome.dartindex 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.dartindex 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.dartindex 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.dartindex 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')),);