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.

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.png
new file mode 100644
index 000000000..85602fad5
Binary files /dev/null and b/desktop/design/images/workspace-welcome.png differ
diff --git a/desktop/design/terminal-workspace.md b/desktop/design/terminal-workspace.md
index 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.
+
+![Shared first-launch and New Tab welcome](images/workspace-welcome.png)
+
Use terminal foreground, background, muted text, and selection colors. Workspace
dialogs use the same thin frame as a focused pane. Avoid raised cards, shadows,
rounded action pills, and redundant headings. Tabs use concise text labels, with
diff --git a/desktop/lib/screens/swarm_screen.dart b/desktop/lib/screens/swarm_screen.dart
index 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.dart
index 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;
- }
-
@override
Widget 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.dart
index 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.dart
index 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.dart
index 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.dart
index 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.md
index 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.