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
Simplify Customize Harness copy and controls
dee0c764cf66d50
diff --git a/desktop/lib/settings/appearance/palette_section.dart b/desktop/lib/settings/appearance/palette_section.dartindex ec14a4cea..7dcd02650 100644--- a/desktop/lib/settings/appearance/palette_section.dart+++ b/desktop/lib/settings/appearance/palette_section.dart@@ -20,10 +20,8 @@ class PaletteSection extends StatelessWidget {builder: (context, prefs, _) => Column(crossAxisAlignment: CrossAxisAlignment.start,children: [- const SectionHeading(- 'Color palette',- subtitle: 'A coordinated look for your tabs, search and agents. Changes apply instantly.',- ),+ const SectionHeading('Color palette'),+ const SizedBox(height: 12),LayoutBuilder(builder: (context, constraints) {final columns = constraints.maxWidth >= 660@@ -73,7 +71,7 @@ class _PaletteChoice extends StatelessWidget {button: true,selected: selected,onTap: onChoose,- label: '${palette.label} palette. ${palette.description}',+ label: '${palette.label} palette',child: ExcludeSemantics(child: TextButton(key: ValueKey('palette-${palette.name}'),@@ -91,7 +89,7 @@ class _PaletteChoice extends StatelessWidget {),),shape: WidgetStatePropertyAll(- RoundedRectangleBorder(borderRadius: BorderRadius.circular(10)),+ RoundedRectangleBorder(borderRadius: BorderRadius.circular(12)),),),child: Column(@@ -119,11 +117,6 @@ class _PaletteChoice extends StatelessWidget {),],),- const SizedBox(height: 2),- Text(- palette.description,- style: const TextStyle(fontSize: 11, color: Colors.white70),- ),],),),diff --git a/desktop/lib/settings/appearance/typography_section.dart b/desktop/lib/settings/appearance/typography_section.dartindex 75d066f54..25c258727 100644--- a/desktop/lib/settings/appearance/typography_section.dart+++ b/desktop/lib/settings/appearance/typography_section.dart@@ -100,16 +100,10 @@ class _TypographySectionState extends State<TypographySection> {return Column(crossAxisAlignment: CrossAxisAlignment.start,children: [- const SectionHeading(- 'Typography',- subtitle:- 'The face the app is set in, and how big. The terminal keeps '- 'its own — see Terminal.',- ),- const SizedBox(height: 14),+ const SectionHeading('Text'),+ const SizedBox(height: 12),SettingRow(title: 'UI font',- detail: 'Every label, menu and heading in the app',control: FutureBuilder<List<SelectOption<String?>>>(future: _families,builder: (context, snapshot) {@@ -133,7 +127,6 @@ class _TypographySectionState extends State<TypographySection> {const SizedBox(height: 10),SettingRow(title: 'UI font size',- detail: 'The base size everything else scales against',control: _SizeField(value: prefs.uiSize,onCommitted: (size) =>@@ -252,34 +245,19 @@ class _TypePreview extends StatelessWidget {Widget build(BuildContext context) {grid.AppTheme.watch(context);final theme = Theme.of(context);- return Container(- width: double.infinity,- decoration: BoxDecoration(- color: grid.AppGlass.surfaceFill,- borderRadius: BorderRadius.circular(14),- boxShadow: grid.AppGlass.cardShadow,- ),- padding: const EdgeInsets.fromLTRB(16, 14, 16, 16),+ return Padding(+ padding: const EdgeInsets.symmetric(vertical: 8),child: Column(crossAxisAlignment: CrossAxisAlignment.start,children: [Text('Preview', style: theme.textTheme.titleSmall),const SizedBox(height: 10),- Text(- 'Machines and the agents on them.',- style: theme.textTheme.titleMedium,- ),+ Text('Aa Bb Cc 0123456789', style: theme.textTheme.titleMedium),const SizedBox(height: 6),Text(- 'This is how a line of the app reads at the size you picked — a '- 'heading above it, and the quieter line that explains one.',+ 'The quick brown fox jumps over the lazy dog.',style: theme.textTheme.bodyMedium,),- const SizedBox(height: 6),- Text(- 'Secondary copy, the way a row subtitle is set.',- style: theme.textTheme.bodySmall,- ),],),);diff --git a/desktop/lib/settings/sections/appearance_section.dart b/desktop/lib/settings/sections/appearance_section.dartindex fa47312e3..e03278d38 100644--- a/desktop/lib/settings/sections/appearance_section.dart+++ b/desktop/lib/settings/sections/appearance_section.dart@@ -1,7 +1,6 @@import 'package:flutter/material.dart';import '../../shared/theme/app_theme.dart' as grid;-import '../../shared/widgets/section_scaffold.dart';import '../appearance/typography_section.dart';import '../appearance/palette_section.dart';@@ -15,20 +14,17 @@ class AppearanceSection extends StatelessWidget {@overrideWidget build(BuildContext context) {grid.AppTheme.watch(context);- return SectionScaffold(- title: 'Appearance',- subtitle: 'Make your workspace feel like yours.',- child: SingleChildScrollView(- child: Column(- crossAxisAlignment: CrossAxisAlignment.start,- children: const [- PaletteSection(),- TypographySection(),- // Room under the last card so a scrolled-to-bottom pane does not end- // flush against the window edge.- SizedBox(height: 8),- ],- ),+ return SingleChildScrollView(+ padding: const EdgeInsets.all(20),+ child: Column(+ crossAxisAlignment: CrossAxisAlignment.start,+ children: const [+ PaletteSection(),+ TypographySection(),+ // Room under the last card so a scrolled-to-bottom pane does not end+ // flush against the window edge.+ SizedBox(height: 8),+ ],),);}diff --git a/desktop/lib/settings/sections/terminal_section.dart b/desktop/lib/settings/sections/terminal_section.dartindex 3a405c02a..fe05a8440 100644--- a/desktop/lib/settings/sections/terminal_section.dart+++ b/desktop/lib/settings/sections/terminal_section.dart@@ -6,7 +6,6 @@ import 'package:xterm/xterm.dart';import '../../shared/theme/app_theme.dart' as grid;import '../../shared/widgets/app_icon_button.dart';import '../../shared/widgets/app_select_field.dart';-import '../../shared/widgets/section_scaffold.dart';import '../../shared/widgets/setting_row.dart';import '../../terminal/terminal_font_store.dart';import '../../terminal/terminal_theme.dart';@@ -26,24 +25,21 @@ class TerminalSection extends StatelessWidget {@overrideWidget build(BuildContext context) {grid.AppTheme.watch(context);- return SectionScaffold(- title: 'Terminal',- subtitle: 'Colors and fonts for your agent terminals.',+ return SingleChildScrollView(+ padding: const EdgeInsets.all(20),// A SingleChildScrollView, never a ListView — same reason as Appearance:// a lazy list keeps children across a rebuild and strands them on the// palette they first mounted with.- child: SingleChildScrollView(- child: ValueListenableBuilder<TerminalStyle>(- valueListenable: terminalFontStore,- // Nested rather than merged into one builder: the two stores change- // independently, and this is the pane that has to show both at once.- builder: (context, style, _) =>- ValueListenableBuilder<TerminalThemeChoice>(- valueListenable: terminalThemeStore,- builder: (context, scheme, _) =>- _Controls(style: style, scheme: scheme),- ),- ),+ child: ValueListenableBuilder<TerminalStyle>(+ valueListenable: terminalFontStore,+ // Nested rather than merged into one builder: the two stores change+ // independently, and this is the pane that has to show both at once.+ builder: (context, style, _) =>+ ValueListenableBuilder<TerminalThemeChoice>(+ valueListenable: terminalThemeStore,+ builder: (context, scheme, _) =>+ _Controls(style: style, scheme: scheme),+ ),),);}@@ -65,22 +61,17 @@ class _Controls extends StatelessWidget {// person notices from across the room, and it is the one that// makes the two rows under it look different while they choose.SettingRow(- title: 'Colours',- detail: scheme.detail,+ title: 'Colors',control: _SchemeField(scheme: scheme),),const SizedBox(height: 10),SettingRow(title: 'Font',- detail: 'Font for agent output',control: _FamilyField(family: terminalFontStore.family),),const SizedBox(height: 10),SettingRow(title: 'Size',- detail:- '${TerminalFontStore.minSize.round()}–'- '${TerminalFontStore.maxSize.round()}pt. Resize with ⌘+ and ⌘−',control: _SizeStepper(size: style.fontSize),),const SizedBox(height: 14),@@ -230,62 +221,17 @@ class _Preview extends StatelessWidget {final TerminalStyle style;final TerminalThemeChoice scheme;- /// The cell the renderer would derive from this style.- ///- /// Measured the way `TerminalPainter._measureCharSize` measures it — ten- /// `'m'` glyphs laid out and divided by ten — so the number shown is the one- /// the grid is actually built on, not an estimate of it.- static Size _cell(TerminalStyle style) {- final painter = TextPainter(- text: TextSpan(text: 'mmmmmmmmmm', style: style.toTextStyle()),- textDirection: TextDirection.ltr,- textScaler: TextScaler.noScaling,- )..layout();- return Size(painter.width / 10, painter.height);- }-@overrideWidget build(BuildContext context) {grid.AppTheme.watch(context);final theme = Theme.of(context);- final cell = _cell(style);-- return Container(- width: double.infinity,- decoration: BoxDecoration(- color: grid.AppGlass.surfaceFill,- borderRadius: BorderRadius.circular(14),- boxShadow: grid.AppGlass.cardShadow,- ),- padding: const EdgeInsets.fromLTRB(16, 14, 16, 16),- child: Column(- crossAxisAlignment: CrossAxisAlignment.start,- children: [- Wrap(- alignment: WrapAlignment.spaceBetween,- crossAxisAlignment: WrapCrossAlignment.center,- spacing: 12,- runSpacing: 4,- children: [- Text('Preview', style: theme.textTheme.titleSmall),- // What the pick costs in geometry. This is the number that turns- // into a `terminal_resize` frame and a SIGWINCH at the far end,- // so the screen says it out loud rather than leaving the user to- // discover it by watching a TUI reflow.- Text(- 'cell ${cell.width.toStringAsFixed(1)} × '- '${cell.height.toStringAsFixed(1)} pt',- style: theme.textTheme.bodySmall?.copyWith(- color: grid.AppPalette.textFaint,- fontFeatures: const [FontFeature.tabularFigures()],- ),- ),- ],- ),- const SizedBox(height: 10),- _Screen(style: style, scheme: scheme),- ],- ),+ return Column(+ crossAxisAlignment: CrossAxisAlignment.start,+ children: [+ Text('Preview', style: theme.textTheme.titleSmall),+ const SizedBox(height: 10),+ _Screen(style: style, scheme: scheme),+ ],);}}@@ -331,10 +277,6 @@ class _Screen extends StatelessWidget {TextSpan(style: base,children: [- // The row of `m`s is not decoration: it is the glyph the renderer- // measures the cell with, boxed so a face that fails to sit on- // the grid shows it as a rule that misses its corners.- const TextSpan(text: '┌─ mmmmmmmmmm ─┐\n'),TextSpan(text: 'agent@harness', style: dim),const TextSpan(text: ' ❯ flutter test\n'),TextSpan(text: '✓', style: ok),@@ -384,7 +326,7 @@ class _ResetRow extends StatelessWidget {onPressed: atDefault? null: () => unawaited(terminalFontStore.reset()),- child: const Text('Reset to default'),+ child: const Text('Reset font'),),],);diff --git a/desktop/lib/shared/widgets/setting_row.dart b/desktop/lib/shared/widgets/setting_row.dartindex 38776fdca..34da2c32d 100644--- a/desktop/lib/shared/widgets/setting_row.dart+++ b/desktop/lib/shared/widgets/setting_row.dart@@ -14,13 +14,13 @@ class SettingRow extends StatelessWidget {const SettingRow({super.key,required this.title,- required this.detail,+ this.detail,required this.control,this.alignTop = false,});final String title;- final String detail;+ final String? detail;final Widget control;/// Align taller controls with the title; compact controls stay centered.@@ -41,8 +41,10 @@ class SettingRow extends StatelessWidget {mainAxisSize: MainAxisSize.min,children: [Text(title, style: Theme.of(context).textTheme.titleSmall),- const SizedBox(height: 2),- Text(detail, style: Theme.of(context).textTheme.bodySmall),+ if (detail case final detail?) ...[+ const SizedBox(height: 2),+ Text(detail, style: Theme.of(context).textTheme.bodySmall),+ ],],);@@ -50,12 +52,16 @@ class SettingRow extends StatelessWidget {// A raised block: fill plus a soft lift, no rim. The same recipe the rest// of the app gives a row you can act on, so a setting here sits at the// same height as a row anywhere else.- decoration: BoxDecoration(- color: AppGlass.surfaceFill,- borderRadius: BorderRadius.circular(14),- boxShadow: AppGlass.cardShadow,- ),- padding: const EdgeInsets.symmetric(horizontal: 16, vertical: 12),+ decoration: detail == null+ ? null+ : BoxDecoration(+ color: AppGlass.surfaceFill,+ borderRadius: BorderRadius.circular(14),+ boxShadow: AppGlass.cardShadow,+ ),+ padding: detail == null+ ? const EdgeInsets.symmetric(vertical: 8)+ : const EdgeInsets.symmetric(horizontal: 16, vertical: 12),child: LayoutBuilder(builder: (context, constraints) =>constraints.maxWidth <diff --git a/desktop/lib/widgets/harness_customize_pane.dart b/desktop/lib/widgets/harness_customize_pane.dartindex 206135000..22aea9bc1 100644--- a/desktop/lib/widgets/harness_customize_pane.dart+++ b/desktop/lib/widgets/harness_customize_pane.dart@@ -63,7 +63,7 @@ class HarnessCustomizePane extends StatelessWidget {tabs: const [Tab(key: ValueKey('customize-background'),- text: 'Background',+ text: 'Wallpaper',),Tab(key: ValueKey('customize-appearance'),@@ -97,40 +97,25 @@ class _Backgrounds extends StatelessWidget {@overrideWidget build(BuildContext context) => SingleChildScrollView(padding: const EdgeInsets.all(20),- child: Column(- crossAxisAlignment: CrossAxisAlignment.start,- children: [- Text(- 'Change background',- style: Theme.of(context).textTheme.titleLarge,- ),- const SizedBox(height: 8),- Text(- 'For your New Harness page. Default matches the selected tab.',- style: Theme.of(context).textTheme.bodySmall,- ),- const SizedBox(height: 20),- ValueListenableBuilder<AppearancePrefs>(- valueListenable: store,- builder: (context, prefs, _) => LayoutBuilder(- builder: (context, constraints) => Wrap(- spacing: 12,- runSpacing: 12,- children: [- for (final choice in HarnessBackground.values)- SizedBox(- width: (constraints.maxWidth - 12) / 2,- child: _BackgroundChoice(- choice: choice,- selected: prefs.background == choice,- onChoose: () => unawaited(store.setBackground(choice)),- ),- ),- ],- ),- ),+ child: ValueListenableBuilder<AppearancePrefs>(+ valueListenable: store,+ builder: (context, prefs, _) => LayoutBuilder(+ builder: (context, constraints) => Wrap(+ spacing: 12,+ runSpacing: 12,+ children: [+ for (final choice in HarnessBackground.values)+ SizedBox(+ width: (constraints.maxWidth - 12) / 2,+ child: _BackgroundChoice(+ choice: choice,+ selected: prefs.background == choice,+ onChoose: () => unawaited(store.setBackground(choice)),+ ),+ ),+ ],),- ],+ ),),);}@@ -149,7 +134,7 @@ class _BackgroundChoice extends StatelessWidget {Widget build(BuildContext context) => Semantics(selected: selected,button: true,- label: '${choice.label} background',+ label: '${choice.label} wallpaper',onTap: onChoose,child: ExcludeSemantics(child: TextButton(diff --git a/desktop/test/color_palette_test.dart b/desktop/test/color_palette_test.dartindex ab3ddfb40..b367c8c14 100644--- a/desktop/test/color_palette_test.dart+++ b/desktop/test/color_palette_test.dart@@ -126,7 +126,7 @@ void main() {expect(tester.getSemantics(- find.bySemanticsLabel('Forest palette. Quiet evergreen'),+ find.bySemanticsLabel('Forest palette'),).getSemanticsData().hasAction(SemanticsAction.tap),diff --git a/desktop/test/terminal_settings_section_test.dart b/desktop/test/terminal_settings_section_test.dartindex 5f049c28a..2947ec139 100644--- a/desktop/test/terminal_settings_section_test.dart+++ b/desktop/test/terminal_settings_section_test.dart@@ -13,10 +13,11 @@ import 'package:harness/shared/widgets/app_select_field.dart';import 'package:harness/terminal/terminal_font_store.dart';import 'package:harness/terminal/terminal_theme_store.dart';-/// The sample line inside the preview — the row of `m`s the renderer measures-/// its cell with.+/// The terminal sample remains independent of the app's text scale.final _sample = find.byWidgetPredicate(- (w) => w is Text && (w.textSpan?.toPlainText().startsWith('┌─') ?? false),+ (w) =>+ w is Text &&+ (w.textSpan?.toPlainText().startsWith('agent@harness') ?? false),);Widget _host({double textScale = 1.0}) => MaterialApp(@@ -52,7 +53,7 @@ void main() {await tester.pumpAndSettle();expect(tester.takeException(), isNull);- expect(find.text('Colours'), findsOneWidget);+ expect(find.text('Colors'), findsOneWidget);expect(find.text('Font'), findsOneWidget);expect(find.text('Size'), findsOneWidget);expect(find.text('Preview'), findsOneWidget);diff --git a/docs/harness-agent-first-tabs.md b/docs/harness-agent-first-tabs.mdindex 5458bcca2..55463d4ae 100644--- a/docs/harness-agent-first-tabs.md+++ b/docs/harness-agent-first-tabs.md@@ -10,6 +10,18 @@ New Agent, Stop Agent, Restart Agent, and Find an agent. Harnessalso names the tab container, application, CLI and device. Custom saved namesand protocol identifiers are unchanged.+## UI preference++The user prefers minimal, neat UI: **less is better**. Use short, direct labels.+Avoid repeated headings, promotional taglines and descriptions of self-evident+controls. Show a choice's name and useful preview; add explanation only when it+helps someone decide or recover from an error. Prefer whitespace and restrained+surfaces over extra rules and nested cards. Apply this consistently without+waiting for the user to request copy removal one control at a time.++Action order is **New → Open** in the titlebar, File menu and both split controls.+The **New Harness page is the deliberate exception: Open → New** below search.+## Customize HarnessThe New Harness page defaults to the selected tab's solid fill, using the same@@ -17,12 +29,13 @@ workspace palette color. **Customize Harness** is a pill at the bottom right onDefault. With any wallpaper selected, it becomes a compact circular pencilbutton with the same tooltip and accessible label; switching back restores thefull label immediately.-It opens a right-hand pane with **Background / Appearance / Terminal** sections.+It opens a right-hand pane with **Wallpaper / Appearance / Terminal** sections.Wide windows keep the page beside it; narrow windows overlay the pane withoutsqueezing the search controls. Closing it restores focus to the Customize buttonand preserves the query. Escape closes an open settings menu before the pane.-Background offers **Default, Aurora, Lake, Silk, Threads and Constellation**.+Wallpaper offers **Default, Aurora, Lake, Silk, Threads and Constellation**.+The choices appear directly below the tabs, with no repeated heading or intro.The lake and generated images are restored from the existing asset history;Aurora reuses the existing mesh. Choices apply immediately, persist under`harness_start_background`, and affect only empty Harness pages. Default stays@@ -33,6 +46,10 @@ existing palette, UI font/size, terminal scheme, font/size, preview and resetcontrols and stores. Settings now starts at Usage. The device footer stays fixedabove the bottom-right button while search opens and closes. No uploads,background downloads, theme editor or new dependency is added.+Appearance shows **Color palette** with names only, then **Text** with font and+size controls. Terminal has **Colors, Font, Size**, a working preview and+**Reset font**. Repeated section titles, helper paragraphs, palette descriptions,+terminal cell metrics and unnecessary card layers are removed.Validation: 46 affected Flutter tests pass, including wallpaper persistence andkeyboard selection, focus restoration, dropdown dismissal, existing-agent entry,diff --git a/docs/harness-v2-handoff.md b/docs/harness-v2-handoff.mdindex 33861bff6..d6841deb4 100644--- a/docs/harness-v2-handoff.md+++ b/docs/harness-v2-handoff.md@@ -34,7 +34,24 @@ user for a benchmark window.## Current product contract-### Latest: quiet device companion card+### Latest: minimal Customize Harness++The user explicitly prefers **less is better**: short labels, no repeated titles,+no promotional descriptions and explanations only when a decision needs them.+This preference is recorded in `harness-agent-first-tabs.md` and applies to future+UI work. Background is now **Wallpaper**. All three customization tabs omit+their redundant headers and intros; palette cards show names only. Font controls+use quiet rows and previews omit explanatory paragraphs and cell measurements.+Saved wallpaper, palette, typography and terminal settings retain their stores.+Button order stays **New → Open** everywhere except **Open → New** under search+on the New Harness page, as the user explicitly requested.+Thirty-four affected checks pass, including keyboard selection, saved choices,+focus restoration and terminal scale isolation. Captures and logs:+`/private/tmp/harness-customize-minimal-captures`,+`/private/tmp/harness-customize-minimal-tests.log` and+`/private/tmp/harness-customize-minimal-analyze.log`.++### Quiet device companion card — pushed f363c9fNew Harness now shows a small **Meet the Harness device** card with a 36-pixelproduct image. The description and separate Learn more button are removed.