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.

Simplify Customize Harness copy and controls

dee0c764cf66d50
diff --git a/desktop/lib/settings/appearance/palette_section.dart b/desktop/lib/settings/appearance/palette_section.dart
index 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.dart
index 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.dart
index 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 {
@override
Widget 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.dart
index 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 {
@override
Widget 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);
- }
-
@override
Widget 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.dart
index 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.dart
index 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 {
@override
Widget 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.dart
index 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.dart
index 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.md
index 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. Harness
also names the tab container, application, CLI and device. Custom saved names
and 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 Harness
The 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 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.
+It opens a right-hand pane with **Wallpaper / 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
and 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 reset
controls and stores. Settings now starts at Usage. The device footer stays fixed
above 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 and
keyboard selection, focus restoration, dropdown dismissal, existing-agent entry,
diff --git a/docs/harness-v2-handoff.md b/docs/harness-v2-handoff.md
index 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 f363c9f
New Harness now shows a small **Meet the Harness device** card with a 36-pixel
product image. The description and separate Learn more button are removed.