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 wallpaper customization button compact

dee98e8056d6eaf
diff --git a/desktop/lib/widgets/harness_start_page.dart b/desktop/lib/widgets/harness_start_page.dart
index e744d12da..d03fb3af6 100644
--- a/desktop/lib/widgets/harness_start_page.dart
+++ b/desktop/lib/widgets/harness_start_page.dart
@@ -2,6 +2,8 @@ import 'package:flutter/material.dart';
import 'package:url_launcher/url_launcher.dart';
import '../shared/theme/app_theme.dart' as grid;
+import '../shared/theme/appearance_prefs_store.dart';
+import '../shared/theme/harness_background.dart';
import '../state/swarm_navigation.dart';
import '../state/swarm_search.dart';
import 'harness_entry_actions.dart';
@@ -296,20 +298,41 @@ class _HarnessStartPageState extends State<HarnessStartPage> {
Positioned(
right: 20,
bottom: 16,
- child: FilledButton.icon(
- key: const ValueKey('harness-customize-button'),
- focusNode: _customizeButtonFocus,
- onPressed: _customizing
- ? _closeCustomization
- : _customize,
- icon: const Icon(Icons.edit_outlined, size: 16),
- label: const Text('Customize Harness'),
- style: FilledButton.styleFrom(
- backgroundColor: grid.AppPalette.swarmAccent,
- foregroundColor: grid.AppPalette.swarmTabBar,
- minimumSize: const Size(0, 36),
- shape: const StadiumBorder(),
- ),
+ child: ValueListenableBuilder<AppearancePrefs>(
+ valueListenable: appearancePrefsStore,
+ builder: (context, prefs, _) {
+ final onPressed = _customizing
+ ? _closeCustomization
+ : _customize;
+ if (prefs.background != HarnessBackground.plain) {
+ return IconButton.filled(
+ key: const ValueKey('harness-customize-button'),
+ focusNode: _customizeButtonFocus,
+ onPressed: onPressed,
+ tooltip: 'Customize Harness',
+ icon: const Icon(Icons.edit_outlined, size: 18),
+ style: IconButton.styleFrom(
+ backgroundColor: grid.AppPalette.swarmAccent,
+ foregroundColor: grid.AppPalette.swarmTabBar,
+ fixedSize: const Size.square(40),
+ shape: const CircleBorder(),
+ ),
+ );
+ }
+ return FilledButton.icon(
+ key: const ValueKey('harness-customize-button'),
+ focusNode: _customizeButtonFocus,
+ onPressed: onPressed,
+ icon: const Icon(Icons.edit_outlined, size: 16),
+ label: const Text('Customize Harness'),
+ style: FilledButton.styleFrom(
+ backgroundColor: grid.AppPalette.swarmAccent,
+ foregroundColor: grid.AppPalette.swarmTabBar,
+ minimumSize: const Size(0, 36),
+ shape: const StadiumBorder(),
+ ),
+ );
+ },
),
),
if (_customizing && !sideBySide)
diff --git a/docs/harness-agent-first-tabs.md b/docs/harness-agent-first-tabs.md
index db210ae10..d962994df 100644
--- a/docs/harness-agent-first-tabs.md
+++ b/docs/harness-agent-first-tabs.md
@@ -13,7 +13,10 @@ and protocol identifiers are unchanged.
## Customize Harness
The New Harness page defaults to the selected tab's solid fill, using the same
-workspace palette color. **Customize Harness** is a pill at the bottom right.
+workspace palette color. **Customize Harness** is a pill at the bottom right on
+Default. With any wallpaper selected, it becomes a compact circular pencil
+button with the same tooltip and accessible label; switching back restores the
+full label immediately.
It opens a right-hand pane with **Background / Appearance / Terminal** sections.
Wide windows keep the page beside it; narrow windows overlay the pane without
squeezing the search controls. Closing it restores focus to the Customize button
diff --git a/docs/harness-v2-handoff.md b/docs/harness-v2-handoff.md
index 2e9f8bc7b..dabfd39f2 100644
--- a/docs/harness-v2-handoff.md
+++ b/docs/harness-v2-handoff.md
@@ -34,7 +34,14 @@ user for a benchmark window.
## Current product contract
-### Latest: distinct New/Open edge actions
+### Latest: compact customization button on wallpapers
+
+Default retains the **Customize Harness** pill. Any wallpaper switches it to a
+40-pixel circular pencil button, keeping the tooltip and accessible label.
+The button listens to the existing appearance store so switching backgrounds
+updates it immediately without reopening the page.
+
+### Distinct New/Open edge actions — pushed 9fcaf27
The right and bottom pane edges now reveal **+ New Agent** and **↗ Open Agent**
together. New opens creation directly with the hovered pane's machine/project;
@@ -74,9 +81,18 @@ Logs: `/private/tmp/harness-separate-entry-final-tests.log`,
`/private/tmp/harness-separate-entry-keymap-native.log`, and
`/private/tmp/harness-separate-entry-final-analyze.log`.
Captures: `/private/tmp/harness-separate-entry-picker`.
-The installed preview is still **8873f27** until the next build/install.
-The rollback was pushed first as **aa327c0**. The user requests one feature per
-commit and push; Customize Harness and distinct edge New/Open actions follow separately.
+The rollback was pushed first as **aa327c0**, then customization as **60a95d5**,
+then edge actions as **9fcaf27**. Preserve the user's one-feature-per-push order.
+
+The preview was refreshed to **9fcaf27** at the supported path. Release and
+deep/strict signature verification passed before and after the atomic swap.
+The exact old preview PID 66331 exited after SIGTERM when native Quit repeatedly
+failed; its bundle and saved layout were retained. CUA reopened the new build
+as PID 88857. A fresh app-control connection showed all four restored Harnesses,
+the original active Harness, and separate New/Open titlebar buttons. Subsequent
+actions were rejected as user-changed; the user is reviewing customization.
+The current local receipt is `/private/tmp/harness-agent-preview-install.json`,
+with this checkpoint retained in `/private/tmp/harness-entry-customize-install.json`.
### Earlier September 15 checkpoint (combined form superseded)
@@ -176,7 +192,7 @@ Saved and pushed to `origin/main`: **9d0150d** (remote project preparation),
validation cleanup). The 339-test pass was followed by six passing focused
checks after the analyzer cleanup; changed Dart files now analyze without issues.
-**8873f27 is installed and running at the supported preview path.** The user
+**Historical installation: 8873f27.** The user
confirmed Quit Harness, but exact process lookup still found the old PID 68117.
CUA could not reach that window or its Quit action. The saved four-Harness layout
was backed up before sending SIGTERM to that exact remaining preview process.