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.

Keep inventory footer visible on Welcome and New Tab (#615)

Dee58fc2dbc166b
diff --git a/desktop/design/desktop-design-system.md b/desktop/design/desktop-design-system.md
index 9f2e1bb83..b55370300 100644
--- a/desktop/design/desktop-design-system.md
+++ b/desktop/design/desktop-design-system.md
@@ -296,8 +296,11 @@ reuses `StatusLine`, honoring the selected wording, machine/project/branch
visibility and status font, but omitting ANSI colors and segment backplates.
It is never a second renderer with a hard-coded dot separator.
A new user with no history sees the composer
-without an empty recents section; initial project guidance is neutral. Empty
-tabs hide the workspace footer, which returns when there is work to describe.
+without an empty recents section; initial project guidance is neutral. Keep the
+workspace footer visible on empty tabs so inventory controls are discoverable
+from first launch, including zero counts. Leave the right-side context blank on
+Welcome and New Tab; machine/project/branch context appears when a harness is
+open. Model inventory shows `—` until its first reading.
Before a creation machine is available, show “Harness anything”, a short next
step and a natural-width “Choose a machine” action. Keep that action available
while finding machines. While saved defaults load, show “Preparing your harness…”
diff --git a/desktop/design/review/2026-10-02-welcome-footer-dark.png b/desktop/design/review/2026-10-02-welcome-footer-dark.png
new file mode 100644
index 000000000..8d379d4d2
Binary files /dev/null and b/desktop/design/review/2026-10-02-welcome-footer-dark.png differ
diff --git a/desktop/design/review/2026-10-02-welcome-footer-light.png b/desktop/design/review/2026-10-02-welcome-footer-light.png
new file mode 100644
index 000000000..751809226
Binary files /dev/null and b/desktop/design/review/2026-10-02-welcome-footer-light.png differ
diff --git a/desktop/design/workspace-status-bar.md b/desktop/design/workspace-status-bar.md
index 925848688..7f97ef5b3 100644
--- a/desktop/design/workspace-status-bar.md
+++ b/desktop/design/workspace-status-bar.md
@@ -19,8 +19,13 @@ Harnesses 118 Machines 3 Models 4 [Claude icon] 68% [Codex icon] 18%
```
The context follows the focused pane. The branch stays clickable in the
-footer; pane headers do not repeat it. An empty New Tab keeps the footer when
-there are live sessions to inspect.
+footer; pane headers do not repeat it. An empty New Tab and the first welcome
+screen keep the footer visible, including zero counts, so Machines and Models
+are discoverable. Leave the right-side context blank on Welcome and New Tab;
+show machine/project/branch context only when a harness is open. A fresh computer
+with no sessions or installed models shows `Harnesses 0`, `Machines 1`, and
+`Models 0` after local setup and inventory finish; unread model inventory shows
+`—`.
The left side shows the number of open harnesses across connected owned machines, including
idle and starting sessions. Count each live session even when no tab currently displays it. The
diff --git a/desktop/lib/screens/swarm_screen.dart b/desktop/lib/screens/swarm_screen.dart
index 64a98fba6..bf0222e85 100644
--- a/desktop/lib/screens/swarm_screen.dart
+++ b/desktop/lib/screens/swarm_screen.dart
@@ -1898,7 +1898,6 @@ class _SwarmScreenState extends State<SwarmScreen> {
],
},
'footerCovered':
- !_showWorkspaceFooter ||
(!_routeIsCurrent && !_footerPreviewCurrent) ||
(_newHarnessOverlay != null && !_newHarnessHidden) ||
_searchOverlay != null,
@@ -7111,15 +7110,14 @@ class _SwarmScreenState extends State<SwarmScreen> {
],
),
),
- if (_showWorkspaceFooter)
- MediaQuery.withNoTextScaling(
- child: _native
- ? SizedBox(
- key: const ValueKey('workspace-status-bar'),
- height: _statusBarHeight,
- )
- : _statusBar(),
- ),
+ MediaQuery.withNoTextScaling(
+ child: _native
+ ? SizedBox(
+ key: const ValueKey('workspace-status-bar'),
+ height: _statusBarHeight,
+ )
+ : _statusBar(),
+ ),
],
),
),
@@ -7229,18 +7227,9 @@ class _SwarmScreenState extends State<SwarmScreen> {
// Include the pane's former bottom gutter in this row, so its controls sit
// halfway between the pane edge and window bottom. Pane height is unchanged.
- bool get _showWorkspaceFooter =>
- !newHarnessOpensInBox ||
- _harnessMonitor.live.isNotEmpty ||
- app.panes.isNotEmpty ||
- app.activeSwarm.isStore ||
- app.activeSwarm.isDevices ||
- app.activeSwarm.isOrchestrator ||
- _footerPreviewCurrent;
-
- double get _statusBarHeight => _showWorkspaceFooter
- ? workspaceBarControlHeight(context) + kWorkspaceInset
- : 0;
+ // Keep inventory controls discoverable on the first, empty welcome screen.
+ double get _statusBarHeight =>
+ workspaceBarControlHeight(context) + kWorkspaceInset;
Widget _statusBar() {
final compactFooter = widget.chrome?.compactFooter;
diff --git a/desktop/test/desktop_welcome_composer_test.dart b/desktop/test/desktop_welcome_composer_test.dart
index 3553e3e94..661004081 100644
--- a/desktop/test/desktop_welcome_composer_test.dart
+++ b/desktop/test/desktop_welcome_composer_test.dart
@@ -423,12 +423,28 @@ void main() {
for (final machine in app.machineStates.values) {
machine.agents = [];
}
+ app.machineStates.removeWhere((id, _) => id != 'm');
+ app.machines = [app.machineStates['m']!.machine];
+ app.modelManager
+ ..loaded = true
+ ..inventoryAvailable = true;
await tester.pumpWidget(const SizedBox());
await tester.pumpWidget(preview);
await tester.pumpAndSettle();
expect(find.byKey(const ValueKey('welcome-sessions')), findsNothing);
expect(
find.byKey(const ValueKey('workspace-status-bar')),
+ findsOneWidget,
+ );
+ for (final control in [
+ 'workspace-harness-monitor',
+ 'workspace-machines',
+ 'workspace-models',
+ ]) {
+ expect(find.byKey(ValueKey(control)).hitTestable(), findsOneWidget);
+ }
+ expect(
+ find.byKey(const ValueKey('workspace-pane-context')),
findsNothing,
);
expect(tester.widget<TextField>(task).focusNode!.hasFocus, isTrue);
@@ -439,17 +455,31 @@ void main() {
}
testWidgets(
- 'native footer exposes live sessions on an empty tab and hides with no work',
+ 'native footer keeps zero inventory visible on the empty welcome screen',
(tester) async {
await setup(tester, mac: true);
expect(updates.last['footerCovered'], isFalse);
expect(updates.last['harnessMonitor']['text'], startsWith('Harnesses 2'));
+ expect(updates.last['focusedContext'], isNull);
for (final machine in app.machineStates.values) {
machine.agents = [];
}
+ app.machineStates.removeWhere((id, _) => id != 'm');
+ app.machines = [app.machineStates['m']!.machine];
app.notifyListeners();
await tester.pumpAndSettle();
- expect(updates.last['footerCovered'], isTrue);
+ expect(updates.last['footerCovered'], isFalse);
+ expect(updates.last['harnessMonitor']['text'], 'Harnesses 0');
+ expect(updates.last['footerMachines']['text'], 'Machines 1');
+ expect(updates.last['footerModels']['text'], 'Models —');
+ expect(updates.last['focusedContext'], isNull);
+ app.modelManager
+ ..loaded = true
+ ..inventoryAvailable = true;
+ app.notifyListeners();
+ await tester.pumpAndSettle();
+ expect(updates.last['footerModels']['text'], 'Models 0');
+ expect(updates.last['footerCovered'], isFalse);
app.adoptSessionForTest(terminal('a0', []));
app.notifyListeners();
await tester.pumpAndSettle();