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
Use the same welcome screen for first launch and new tabs (#331)
Dee01adf93bb656
diff --git a/desktop/design/images/workspace-welcome.png b/desktop/design/images/workspace-welcome.pngnew file mode 100644index 000000000..85602fad5Binary files /dev/null and b/desktop/design/images/workspace-welcome.png differdiff --git a/desktop/design/terminal-workspace.md b/desktop/design/terminal-workspace.mdindex f1d4706b7..d83434cad 100644--- a/desktop/design/terminal-workspace.md+++ b/desktop/design/terminal-workspace.md@@ -58,6 +58,12 @@ 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.+++Use terminal foreground, background, muted text, and selection colors. Workspacedialogs use the same thin frame as a focused pane. Avoid raised cards, shadows,rounded action pills, and redundant headings. Tabs use concise text labels, withdiff --git a/desktop/lib/screens/swarm_screen.dart b/desktop/lib/screens/swarm_screen.dartindex 1f51e0023..835fcf3dc 100644--- a/desktop/lib/screens/swarm_screen.dart+++ b/desktop/lib/screens/swarm_screen.dart@@ -266,7 +266,6 @@ class _SwarmScreenState extends State<SwarmScreen>Widget _startGuide() => WorkspaceWelcome(key: ValueKey('welcome:${app.activeSwarmId}'),- onboarding: _onboarding,onCommand: _runShortcut,);diff --git a/desktop/lib/widgets/workspace_welcome.dart b/desktop/lib/widgets/workspace_welcome.dartindex c8d748dc0..6d8016e8a 100644--- a/desktop/lib/widgets/workspace_welcome.dart+++ b/desktop/lib/widgets/workspace_welcome.dart@@ -8,82 +8,31 @@ import 'terminal_text_action.dart';import '../shortcuts/app_keymap.dart';import '../shortcuts/keymap.dart';import '../shortcuts/keymap_commands.dart';-import '../state/workspace_onboarding.dart';import '../terminal/terminal_text.dart';/// A quiet terminal welcome. Opening a command is always an explicit action.-class WorkspaceWelcome extends StatefulWidget {- const WorkspaceWelcome({super.key, required this.onCommand, this.onboarding});+class WorkspaceWelcome extends StatelessWidget {+ const WorkspaceWelcome({super.key, required this.onCommand});final ValueChanged<String> onCommand;- final WorkspaceOnboarding? onboarding;- @override- State<WorkspaceWelcome> createState() => _WorkspaceWelcomeState();-}--class _WorkspaceWelcomeState extends State<WorkspaceWelcome> {- // Keep the last check visible for this visit. A new tab gets a new widget- // key and chooses its everyday shortcuts after all milestones are complete.- bool? _showOnboarding;- String? _scope;-- static const _onboardingActions = [- (- 'agent.new',- 'New Harness',- 'to start your first harness',- OnboardingStep.harnesses,- ),- (- 'machines.list',- 'Machines',- 'to manage it from anywhere',- OnboardingStep.machines,- ),- (- 'models.list',- 'Models',- 'to power it with a local model',- OnboardingStep.models,- ),- ];- static const _everydayActions = [- ('agent.new', 'New Harness', 'to start a new harness', null),- ('agent.open', 'Open Harness', 'to open a harness', null),- ('app.store', 'Harness Store', 'to browse the harness store', null),+ 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'),];- @override- void didUpdateWidget(WorkspaceWelcome oldWidget) {- super.didUpdateWidget(oldWidget);- if (oldWidget.onboarding != widget.onboarding) _showOnboarding = null;- }-@overrideWidget build(BuildContext context) {TerminalFontScope.watch(context);return ListenableBuilder(- listenable: Listenable.merge([- terminalFontStore,- appearancePrefsStore,- widget.onboarding,- ]),+ listenable: Listenable.merge([terminalFontStore, appearancePrefsStore]),builder: (context, _) => _buildWelcome(context),);}Widget _buildWelcome(BuildContext context) {grid.AppTheme.watch(context);- final onboarding = widget.onboarding;- if (_scope != onboarding?.scope) {- _scope = onboarding?.scope;- _showOnboarding = null;- }- if (onboarding?.loaded == true) {- _showOnboarding ??= !onboarding!.complete;- }- final showOnboarding = onboarding != null && (_showOnboarding ?? true);final palette = grid.AppTheme.palette.value;final background = appearancePrefsStore.value.background;final hasArtwork = background != HarnessBackground.plain;@@ -102,14 +51,11 @@ class _WorkspaceWelcomeState extends State<WorkspaceWelcome> {);final keymap = KeymapTheme.of(context)?.current ?? harnessDefaultKeymap;final rows = [- for (final (command, label, description, step)- in showOnboarding ? _onboardingActions : _everydayActions)+ for (final (command, label, description) in _actions)(command: command,label: label,description: description,- step: step,- completed: step != null && onboarding?.completed(step) == true,hint: keymap.bindingsFor(KeymapContext.workspace).where((binding) => binding.command == command)@@ -128,7 +74,6 @@ class _WorkspaceWelcomeState extends State<WorkspaceWelcome> {return width;}- final progressWidth = showOnboarding ? widthOf('✓ ') : 0.0;final prefixWidth = widthOf('press ');final keyWidth = rows.map((row) => widthOf('${row.hint ?? row.label} '))@@ -164,11 +109,7 @@ class _WorkspaceWelcomeState extends State<WorkspaceWelcome> {child: Center(child: ConstrainedBox(constraints: BoxConstraints(- maxWidth:- progressWidth +- prefixWidth +- keyWidth +- descriptionWidth,+ maxWidth: prefixWidth + keyWidth + descriptionWidth,),child: DefaultTextStyle(style: style,@@ -178,16 +119,14 @@ class _WorkspaceWelcomeState extends State<WorkspaceWelcome> {mainAxisSize: MainAxisSize.min,children: [Text(- showOnboarding- ? 'Harness like a boss.'- : 'Follow your curiosity.',+ 'Follow your curiosity.',key: const ValueKey('welcome-tagline'),),SizedBox(height: line),for (final row in rows)TextButton(key: ValueKey('welcome-${row.command}'),- onPressed: () => widget.onCommand(row.command),+ onPressed: () => onCommand(row.command),style: TextButton.styleFrom(foregroundColor: ink,textStyle: style,@@ -202,23 +141,6 @@ class _WorkspaceWelcomeState extends State<WorkspaceWelcome> {child: Row(crossAxisAlignment: CrossAxisAlignment.start,children: [- if (row.step != null)- SizedBox(- width: progressWidth,- child: Text(- row.completed ? '✓' : '○',- key: ValueKey(- 'welcome-progress-${row.step!.name}',- ),- semanticsLabel: row.completed- ? 'Completed'- : 'Not completed',- textAlign: TextAlign.left,- style: TextStyle(- color: row.completed ? accent : ink,- ),- ),- ),SizedBox(width: prefixWidth,child: Text(@@ -256,7 +178,7 @@ class _WorkspaceWelcomeState extends State<WorkspaceWelcome> {bottom: 16,child: TerminalTextAction(key: const ValueKey('welcome-customize'),- onPressed: () => widget.onCommand('app.customize'),+ onPressed: () => onCommand('app.customize'),label: 'Customize Harness',overArtwork: hasArtwork,),diff --git a/desktop/test/machines_panel_test.dart b/desktop/test/machines_panel_test.dartindex b72be1da8..44027ba62 100644--- a/desktop/test/machines_panel_test.dart+++ b/desktop/test/machines_panel_test.dart@@ -18,10 +18,8 @@ import 'package:harness/shared/theme/app_theme.dart' as grid;import 'package:harness/shortcuts/app_keymap.dart';import 'package:harness/shortcuts/keymap_host.dart';import 'package:harness/state/app_state.dart';-import 'package:harness/state/workspace_onboarding.dart';import 'package:harness/widgets/machines_panel.dart';import 'package:harness/widgets/toolbar_icon.dart';-import 'package:harness/widgets/workspace_welcome.dart';import 'package:lucide_icons_flutter/lucide_icons.dart';import 'keymap_host_test.dart' show MemoryKeymap, key;@@ -1221,41 +1219,4 @@ void main() {await tester.pumpWidget(const SizedBox());},);-- testWidgets('welcome teaches the effective Machines shortcut', (- tester,- ) async {- final map = MemoryKeymap();- addTearDown(map.dispose);- final onboarding = WorkspaceOnboarding();- addTearDown(onboarding.dispose);- onboarding.sync(- scope: 'welcome-test',- observed: {},- otherComputer: false,- modelsAvailable: true,- );- final commands = <String>[];- await tester.pumpWidget(- MaterialApp(- home: KeymapProvider(- keymap: map,- child: WorkspaceWelcome(- onboarding: onboarding,- onCommand: commands.add,- ),- ),- ),- );- expect(find.text('⌘M'), findsOneWidget);- await tester.tap(find.byKey(const ValueKey('welcome-machines.list')));- expect(commands, ['machines.list']);- map.apply(- '{"bindings":[{"keys":"cmd+m","command":null},{"keys":"cmd+y","command":"machines.list"}]}',- );- await tester.pumpAndSettle();- expect(find.text('⌘Y'), findsOneWidget);- expect(find.text('⌘M'), findsNothing);- await tester.pumpWidget(const SizedBox());- });}diff --git a/desktop/test/toolbar_onboarding_test.dart b/desktop/test/toolbar_onboarding_test.dartindex 2a9e90262..37431ea0b 100644--- a/desktop/test/toolbar_onboarding_test.dart+++ b/desktop/test/toolbar_onboarding_test.dart@@ -116,9 +116,9 @@ void main() {app.adoptSessionForTest(terminal('work', []));}- for (var completed = 1; completed <= 3; completed++) {+ for (var completed = 0; completed <= 3; completed++) {testWidgets(- 'returning welcome restores $completed completed steps with working actions',+ 'welcome has the same working actions with $completed saved steps',(tester) async {final storage = MemoryStore();final previous = WorkspaceOnboarding(storage: storage);@@ -142,41 +142,23 @@ void main() {OnboardingStep.values.where(journey.completed),OnboardingStep.values.take(completed),);- if (completed < 3) {- expect(find.text('Harness like a boss.'), findsOneWidget);- for (final (index, step) in OnboardingStep.values.indexed) {- expect(- tester- .widget<Text>(- find.byKey(ValueKey('welcome-progress-${step.name}')),- )- .data,- index < completed ? '✓' : '○',- );- }- } else {- expect(find.text('Follow your curiosity.'), findsOneWidget);- expect(find.text('○'), findsNothing);- expect(find.text('✓'), findsNothing);+ expect(find.text('Follow your curiosity.'), 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']) {+ expect(find.text(hint), findsOneWidget);}- final destinations = completed < 3- ? ['agent.new', 'machines.list', 'models.list']- : ['agent.new', 'agent.open', 'app.store'];+ final destinations = ['agent.new', 'harnesses.list', 'app.store'];for (final command in destinations) {await tap(tester, find.byKey(ValueKey('welcome-$command')));switch (command) {case 'agent.new':expect(find.byType(NewHarnessForm), findsOneWidget);- case 'machines.list':- expect(resourceScope('@'), findsOneWidget);- case 'models.list':- expect(resourceScope(':'), findsOneWidget);- case 'agent.open':- expect(- find.byKey(const ValueKey('swarm-search-input')),- findsOneWidget,- );+ case 'harnesses.list':+ expect(resourceScope(''), findsOneWidget);case 'app.store':expect(app.activeSwarm.isStore, isTrue);}@@ -189,10 +171,8 @@ void main() {}for (final shortcut in [LogicalKeyboardKey.keyN,- if (completed == 3) ...[- LogicalKeyboardKey.keyP,- LogicalKeyboardKey.keyS,- ],+ LogicalKeyboardKey.keyP,+ LogicalKeyboardKey.keyS,LogicalKeyboardKey.keyM,LogicalKeyboardKey.keyI,]) {@@ -258,11 +238,11 @@ void main() {await tester.pumpAndSettle();}- await tap(tester, find.byKey(const ValueKey('welcome-models.list')));- expect(models, findsOneWidget);+ await tap(tester, find.byKey(const ValueKey('welcome-harnesses.list')));+ expect(resourceScope(''), findsOneWidget);await key(tester, LogicalKeyboardKey.keyM, cmd: true);await tester.pumpAndSettle();- expect(models, findsNothing);+ expect(resourceScope(''), findsNothing);expect(machines, findsOneWidget);await key(tester, LogicalKeyboardKey.keyI, cmd: true);await tester.pumpAndSettle();@@ -274,9 +254,9 @@ void main() {expect(find.byType(NewHarnessForm), findsOneWidget);await key(tester, LogicalKeyboardKey.escape);await tester.pumpAndSettle();- await tap(tester, find.byKey(const ValueKey('welcome-machines.list')));- expect(machines, findsOneWidget);- await key(tester, LogicalKeyboardKey.escape);+ await tap(tester, find.byKey(const ValueKey('welcome-app.store')));+ expect(app.activeSwarm.isStore, isTrue);+ await key(tester, LogicalKeyboardKey.keyT, cmd: true);await tester.pumpAndSettle();await tap(tester, find.byKey(const ValueKey('welcome-agent.new')));expect(find.byType(NewHarnessForm), findsOneWidget);@@ -288,9 +268,7 @@ void main() {);}- testWidgets('Models shortcut and welcome hint follow a live remap', (- tester,- ) async {+ testWidgets('Models shortcut follows a live remap', (tester) async {final map = MemoryKeymap();addTearDown(map.dispose);await mount(tester, keymap: map);@@ -301,7 +279,6 @@ void main() {]}''');await tester.pumpAndSettle();expect(find.byTooltip('Models ⌘U'), findsNothing);- expect(find.text('⌘U'), findsOneWidget);await key(tester, LogicalKeyboardKey.keyI, cmd: true);expect(resourceScope(':'), findsNothing);await key(tester, LogicalKeyboardKey.keyU, cmd: true);@@ -324,7 +301,7 @@ void main() {});testWidgets(- 'completed welcome switches on New Tab and everyday clicks open their destinations',+ 'progress changes keep the same welcome on this and the next tab',(tester) async {await mount(tester);journey.sync(@@ -334,14 +311,14 @@ void main() {modelsAvailable: true,);await tester.pumpAndSettle();- expect(find.text('✓'), findsNWidgets(3));- expect(find.text('Harness like a boss.'), findsOneWidget);+ expect(find.text('✓'), findsNothing);+ expect(find.text('Follow your curiosity.'), findsOneWidget);await key(tester, LogicalKeyboardKey.keyT, cmd: true);await tester.pumpAndSettle();expect(find.text('Follow your curiosity.'), findsOneWidget);expect(find.text('✓'), findsNothing);- await tap(tester, find.byKey(const ValueKey('welcome-agent.open')));- expect(find.byKey(const ValueKey('swarm-search-input')), findsOneWidget);+ await tap(tester, find.byKey(const ValueKey('welcome-harnesses.list')));+ expect(resourceScope(''), findsOneWidget);await key(tester, LogicalKeyboardKey.escape);await tester.pumpAndSettle();await tap(tester, find.byKey(const ValueKey('welcome-app.store')));diff --git a/desktop/test/workspace_start_guide_test.dart b/desktop/test/workspace_start_guide_test.dartindex 28b119285..53ed1707b 100644--- a/desktop/test/workspace_start_guide_test.dart+++ b/desktop/test/workspace_start_guide_test.dart@@ -1,4 +1,5 @@import 'support/open_harness.dart';+import 'dart:async';import 'dart:io';@@ -169,8 +170,8 @@ void main() {addTearDown(app.dispose);addTearDown(journey.dispose);await _mount(tester, app, onboarding: journey);- expect(find.text('Harness like a boss.'), findsOneWidget);- expect(find.text('○'), findsNWidgets(3));+ expect(find.text('Follow your curiosity.'), findsOneWidget);+ expect(find.text('○'), findsNothing);expect(app.panes, isEmpty);if (keyboard) {@@ -219,8 +220,9 @@ void main() {await key(tester, LogicalKeyboardKey.keyT, cmd: true);await tester.pumpAndSettle();expect(find.byType(WorkspaceWelcome), findsOneWidget);- expect(find.text('✓'), findsOneWidget);- expect(find.text('○'), findsNWidgets(2));+ expect(find.text('Follow your curiosity.'), findsOneWidget);+ expect(find.text('✓'), findsNothing);+ expect(find.text('○'), findsNothing);expect(app.launches, hasLength(1));expect(tester.takeException(), isNull);await tester.pumpWidget(const SizedBox());@@ -260,7 +262,8 @@ void main() {await key(tester, LogicalKeyboardKey.escape);await tester.pumpAndSettle();expect(find.byType(NewHarnessForm), findsNothing);- expect(find.text('○'), findsNWidgets(3));+ expect(find.text('Follow your curiosity.'), findsOneWidget);+ expect(find.text('○'), findsNothing);await tester.tap(find.byKey(const ValueKey('welcome-agent.new')));await tester.pumpAndSettle();@@ -284,7 +287,7 @@ void main() {await _mount(tester, app);final search = find.byKey(const ValueKey('swarm-search-input'));expect(find.byType(WorkspaceWelcome), findsOneWidget);- expect(find.text('Harness like a boss.'), findsOneWidget);+ expect(find.text('Follow your curiosity.'), findsOneWidget);expect(find.byType(NewHarnessForm), findsNothing);expect(search, findsNothing);await key(tester, LogicalKeyboardKey.keyN, cmd: true);@@ -294,7 +297,7 @@ void main() {await key(tester, LogicalKeyboardKey.keyT, cmd: true);final tab = app.activeSwarmId;expect(find.byType(WorkspaceWelcome), findsOneWidget);- expect(find.text('Harness like a boss.'), findsOneWidget);+ expect(find.text('Follow your curiosity.'), 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 296faa115..ceb082ca2 100644--- a/desktop/test/workspace_welcome_test.dart+++ b/desktop/test/workspace_welcome_test.dart@@ -1,4 +1,3 @@-import 'dart:async';import 'dart:io';import 'dart:ui' as ui;@@ -8,24 +7,14 @@ import 'package:flutter/services.dart';import 'package:flutter_test/flutter_test.dart';import 'package:harness/shared/theme/app_theme.dart' as grid;import 'package:harness/shortcuts/app_keymap.dart';-import 'package:harness/state/workspace_onboarding.dart';import 'package:harness/terminal/terminal_text.dart';import 'package:harness/widgets/workspace_welcome.dart';import 'package:xterm/xterm.dart';import 'keymap_host_test.dart' show MemoryKeymap;import 'support/real_fonts.dart';-import 'swarm_state_test.dart' show MemoryStore;--class _HeldStore extends MemoryStore {- final reads = <String, Completer<String?>>{};- @override- Future<String?> read(String key) =>- (reads[key] = Completer<String?>()).future;-}void main() {- late WorkspaceOnboarding journey;late MemoryKeymap keymap;late TerminalStyle savedFont;late Brightness savedBrightness;@@ -56,21 +45,11 @@ void main() {);});tearDown(() {- journey.dispose();keymap.dispose();terminalFontStore.value = savedFont;grid.AppTheme.brightness.value = savedBrightness;});- void observe(Set<OnboardingStep> steps, {String scope = 'review'}) {- journey.sync(- scope: scope,- observed: steps,- otherComputer: false,- modelsAvailable: true,- );- }-Future<void> mount(WidgetTester tester, {String tab = 'first',@@ -96,11 +75,7 @@ void main() {),home: RepaintBoundary(key: boundary,- child: WorkspaceWelcome(- key: ValueKey(tab),- onboarding: journey,- onCommand: commands.add,- ),+ child: WorkspaceWelcome(key: ValueKey(tab), onCommand: commands.add),),),);@@ -124,135 +99,76 @@ void main() {});}- testWidgets('actual progress stays visible until the next new tab', (+ testWidgets('first launch and new tabs show the same working shortcuts', (tester,) async {- journey = WorkspaceOnboarding();- observe({});- await mount(tester);- expect(find.text('HARNESS'), findsNothing);- expect(find.text('Harness like a boss.'), findsOneWidget);- expect(find.text('○'), findsNWidgets(3));- for (final hint in ['⌘N', '⌘M', '⌘I']) {- expect(find.text(hint), findsOneWidget);- }- await capture(tester, 'new-tab-first');- for (final command in ['agent.new', 'machines.list', 'models.list']) {- await tester.tap(find.byKey(ValueKey('welcome-$command')));- }- expect(commands, ['agent.new', 'machines.list', 'models.list']);- journey.acknowledge(OnboardingStep.harnesses);- await tester.pump();- expect(find.text('✓'), findsNothing);- observe({OnboardingStep.harnesses});- await tester.pump();- expect(find.text('✓'), findsOneWidget);- expect(find.text('○'), findsNWidgets(2));- await capture(tester, 'new-tab-progress');- observe({OnboardingStep.machines, OnboardingStep.models});- await tester.pump();- expect(find.text('✓'), findsNWidgets(3));- expect(find.text('Harness like a boss.'), findsOneWidget);- await capture(tester, 'new-tab-completed');-- // A regular rebuild does not remove the user's last check.- await mount(tester);- expect(find.text('✓'), findsNWidgets(3));- await mount(tester, tab: 'next');- expect(find.text('Follow your curiosity.'), findsOneWidget);- expect(find.text('✓'), findsNothing);- expect(find.text('○'), findsNothing);- for (final hint in ['⌘N', '⌘O', '⌘S']) {- expect(find.text(hint), findsOneWidget);- }- commands.clear();- for (final command in ['agent.new', 'agent.open', 'app.store']) {- await tester.tap(find.byKey(ValueKey('welcome-$command')));- }- expect(commands, ['agent.new', 'agent.open', 'app.store']);- await capture(tester, 'new-tab-everyday');- });-- testWidgets(- 'saved progress loads before choosing the visit and stays account scoped',- (tester) async {- final storage = _HeldStore();- journey = WorkspaceOnboarding(storage: storage);- observe({});- await mount(tester);- storage.reads[WorkspaceOnboarding.storageKey('review')]!.complete(- '{"completed":["harnesses","machines","models"]}',- );- await tester.pumpAndSettle();+ for (final tab in ['first', 'next']) {+ await mount(tester, tab: tab);expect(find.text('Follow your curiosity.'), findsOneWidget);-- observe({}, scope: 'another-account');- await tester.pump();expect(find.text('✓'), findsNothing);- storage.reads[WorkspaceOnboarding.storageKey('another-account')]!- .complete('{"completed":["harnesses"]}');- await tester.pumpAndSettle();- expect(find.text('Harness like a boss.'), findsOneWidget);- expect(find.text('✓'), findsOneWidget);- expect(find.text('○'), findsNWidgets(2));- },- );+ expect(find.text('○'), findsNothing);+ for (final hint in ['⌘N', '⌘P', '⌘S']) {+ expect(find.text(hint), findsOneWidget);+ }+ expect(find.text('⌘O'), findsNothing);+ commands.clear();+ for (final command in ['agent.new', 'harnesses.list', 'app.store']) {+ await tester.tap(find.byKey(ValueKey('welcome-$command')));+ }+ expect(commands, ['agent.new', 'harnesses.list', 'app.store']);+ await capture(tester, 'new-tab-$tab');+ }+ });testWidgets('live remaps and unbinding keep the displayed actions honest', (tester,) async {- journey = WorkspaceOnboarding();- observe({});await mount(tester);keymap.apply('''{"bindings":[- {"keys":"cmd+i","command":null},- {"keys":"cmd+u","command":"models.list"}+ {"keys":"cmd+p","command":null},+ {"keys":"cmd+u","command":"harnesses.list"}]}''');await tester.pump();- expect(find.text('⌘I'), findsNothing);+ expect(find.text('⌘P'), findsNothing);expect(find.text('⌘U'), findsOneWidget);- await tester.tap(find.byKey(const ValueKey('welcome-models.list')));- expect(commands, ['models.list']);+ await tester.tap(find.byKey(const ValueKey('welcome-harnesses.list')));+ expect(commands, ['harnesses.list']);- keymap.apply('{"bindings":[{"keys":"cmd+i","command":null}]}');+ keymap.apply('{"bindings":[{"keys":"cmd+p","command":null}]}');await tester.pump();expect(find.text('click'), findsOneWidget);- expect(find.text('Models'), findsOneWidget);- await tester.tap(find.byKey(const ValueKey('welcome-models.list')));- expect(commands, ['models.list', 'models.list']);+ expect(find.text('Open Harness'), findsOneWidget);+ await tester.tap(find.byKey(const ValueKey('welcome-harnesses.list')));+ expect(commands, ['harnesses.list', 'harnesses.list']);expect(tester.takeException(), isNull);});for (final brightness in Brightness.values) {- testWidgets(- 'onboarding fits a narrow window with large text ($brightness)',- (tester) async {- journey = WorkspaceOnboarding();- observe({OnboardingStep.harnesses});- await mount(- tester,- size: const Size(600, 500),- scale: 1.7,- brightness: brightness,- );- expect(find.text('✓'), findsOneWidget);- for (final command in ['agent.new', 'machines.list', 'models.list']) {- 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', 'machines.list', 'models.list']);- final scroll = tester.getRect(- find.byKey(const ValueKey('welcome-scroll')),- );- final customize = tester.getRect(- find.byKey(const ValueKey('welcome-customize')),- );- expect(scroll.bottom, lessThan(customize.top));- await capture(tester, 'new-tab-narrow-${brightness.name}');- },- );+ testWidgets('welcome fits a narrow window with large text ($brightness)', (+ tester,+ ) async {+ await mount(+ tester,+ size: const Size(600, 500),+ scale: 1.7,+ brightness: brightness,+ );+ for (final command in ['agent.new', 'harnesses.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']);+ final scroll = tester.getRect(+ find.byKey(const ValueKey('welcome-scroll')),+ );+ final customize = tester.getRect(+ find.byKey(const ValueKey('welcome-customize')),+ );+ expect(scroll.bottom, lessThan(customize.top));+ await capture(tester, 'new-tab-narrow-${brightness.name}');+ });}}diff --git a/docs/keyboard.md b/docs/keyboard.mdindex 892ce1299..62bc2b211 100644--- a/docs/keyboard.md+++ b/docs/keyboard.md@@ -31,10 +31,9 @@ The defaults, in the workspace:| ⇧⌘I | Agents needing input || ⌘, · ⌘/ | Settings · keyboard shortcuts |-New Tab starts with three clickable shortcuts: ⌘N to start your first harness,-⌘M to manage it from another computer, and ⌘I to power it with a local model.-Checkmarks record actual use and persist per account on this device. After all-three are complete, the next New Tab shows the everyday ⌘N, ⌘O, and ⌘S shortcuts.+First launch and every New Tab show the same “Follow your curiosity.” page with+three clickable shortcuts: ⌘N to start a new harness, ⌘P to open a harness, and+⌘S to browse the harness store. The hints follow the current keyboard bindings.A harness can have views in several tabs, with one view per tab; closing a pane only removes that view.