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.

Distinguish focused remote panes with a teal border (#556)

Dee24128bec34cf
diff --git a/desktop/design/desktop-design-system.md b/desktop/design/desktop-design-system.md
index db5cbd0e0..25edae5d7 100644
--- a/desktop/design/desktop-design-system.md
+++ b/desktop/design/desktop-design-system.md
@@ -145,6 +145,9 @@ Avoid repeatedly drawing cards inside a dialog.
- Primary text is nearly white or nearly black. Metadata remains readable.
- Blue filled capsules identify the primary action. Blue rows identify the
active keyboard/pointer choice; their labels and secondary text turn white.
+- Focused pane rims use blue for this computer and `AppPalette.teal` for a
+ known remote machine. Only the focused pane carries this location cue;
+ waiting-question borders retain their amber priority.
- A stored choice also has a checkmark. Focus and stored selection differ.
- Ordinary controls use a faint neutral fill and one thin rim. Hover increases
the fill. Press increases it again. Focus has a stable 1.5-point blue boundary.
diff --git a/desktop/design/review/2026-10-01-pane-location-focus.png b/desktop/design/review/2026-10-01-pane-location-focus.png
new file mode 100644
index 000000000..0e2464e3e
Binary files /dev/null and b/desktop/design/review/2026-10-01-pane-location-focus.png differ
diff --git a/desktop/design/terminal-workspace.md b/desktop/design/terminal-workspace.md
index 775aae94f..20e121d61 100644
--- a/desktop/design/terminal-workspace.md
+++ b/desktop/design/terminal-workspace.md
@@ -56,6 +56,12 @@ own selection. Keep the current pane clear while a menu or the tab strip has
keyboard focus. Waiting-question borders remain visible above the veil.
The overlay does not consume the first click or alter terminal state.
+Only the focused pane gets a location-colored rim: blue on this computer,
+teal on a known remote machine, including a single or zoomed pane. Unfocused
+panes keep their neutral rim. The existing amber waiting-question border takes
+precedence over the focus color. Location uses machine identity, independently
+of the connection's transport mode.
+
## Input and review
Retain existing commands and their live remapping. Menus and visible controls
diff --git a/desktop/lib/shared/theme/app_theme.dart b/desktop/lib/shared/theme/app_theme.dart
index b30c0e8d2..7148275dd 100644
--- a/desktop/lib/shared/theme/app_theme.dart
+++ b/desktop/lib/shared/theme/app_theme.dart
@@ -331,7 +331,7 @@ abstract final class AppPalette {
// ground they meet — Paper's search #E2E2DF / Mist's #DCE4EE — not only on
// white: teal 4.90, online 5.02, warn 4.93 there (6.4–6.5 on white).
- // "Owner" badge — a teal that stays legible on either surface.
+ // "Owner" badge and remote pane focus — legible on either surface.
static Color get teal =>
AppTheme.pick(const Color(0xFF0D6B63), const Color(0xFF2DD4BF));
diff --git a/desktop/lib/widgets/box_chrome.dart b/desktop/lib/widgets/box_chrome.dart
index e2fd189ad..ddee42fa4 100644
--- a/desktop/lib/widgets/box_chrome.dart
+++ b/desktop/lib/widgets/box_chrome.dart
@@ -9,10 +9,15 @@ import '../terminal/terminal_text.dart';
const double kTerminalCornerRadius = 3;
/// A stable rim for the terminal pane, independent of the desktop dialog frame.
-BorderSide terminalPaneBorder({bool focused = false}) => BorderSide(
- color: focused ? grid.AppPalette.accentOnSurface : grid.AppPalette.divider,
- width: 1,
-);
+BorderSide terminalPaneBorder({bool focused = false, bool remote = false}) =>
+ BorderSide(
+ color: !focused
+ ? grid.AppPalette.divider
+ : remote
+ ? grid.AppPalette.teal
+ : grid.AppPalette.accentOnSurface,
+ width: 1,
+ );
/// One gutter around the workspace, between panes, and beside command docks.
const double kWorkspaceInset = 9.5;
diff --git a/desktop/lib/widgets/pane_grid.dart b/desktop/lib/widgets/pane_grid.dart
index 6931e6e3d..c1856e67e 100644
--- a/desktop/lib/widgets/pane_grid.dart
+++ b/desktop/lib/widgets/pane_grid.dart
@@ -1217,7 +1217,8 @@ class _PaneCell extends StatelessWidget {
final WidgetBuilder? companionViewer;
/// Drawn alone under [PaneGrid.soloFocused]: it reads as the only view — no
- /// dimming or focus ring, and no zoom, since it already fills the screen.
+ /// dimming or zoom, since it already fills the screen. The focused rim still
+ /// identifies whether its machine is local or remote.
final bool solo;
bool get _single => solo || notifier.panes.length == 1;
@@ -1238,6 +1239,7 @@ class _PaneCell extends StatelessWidget {
Widget _build(BuildContext context) {
grid.AppTheme.watch(context);
final focused = visible && notifier.isPaneFocused(pane.id);
+ final remote = notifier.stateOf(pane.machineId)?.isLocalMachine == false;
// Keep the selected harness's terminal and viewers clear, including while
// a menu owns input. This changes paint, never the keyboard's destination.
final dimmed = !_single && !notifier.isPaneEmphasized(pane);
@@ -1268,9 +1270,8 @@ class _PaneCell extends StatelessWidget {
// edge, now that no shared line does. It only CHANGES COLOUR on
// focus, so nothing resizes as focus moves.
border: Border.fromBorderSide(
- // A lone pane needs no focus distinction. Dialogs use this same
- // rim in its focused state while they own the keyboard.
- terminalPaneBorder(focused: !_single && focused),
+ // Keep the location cue when a pane is alone or zoomed, too.
+ terminalPaneBorder(focused: focused, remote: remote),
),
),
// A neutral gray veil lifts inactive backgrounds and softens their text