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.

docs(mobile): comments that named the cut CLI code say what happens now

deef9d3934d2be7
diff --git a/mobile/lib/analytics/analytics_identity.dart b/mobile/lib/analytics/analytics_identity.dart
index ec2a9fdbc..73e899f63 100644
--- a/mobile/lib/analytics/analytics_identity.dart
+++ b/mobile/lib/analytics/analytics_identity.dart
@@ -46,9 +46,9 @@ class AnalyticsIdentityStore {
static const Duration _persistEvery = Duration(minutes: 1);
/// `~/.harness/computer-id` — the machine identity this app already shares
- /// with the CLI (`LocalCliDiscovery.defaultComputerIdPath`). Resolved the same
- /// way rather than imported, so an analytics detail cannot drag the WS layer
- /// into every test that builds this store.
+ /// with the CLI (the desktop's `LocalCliDiscovery.defaultComputerIdPath`).
+ /// Resolved the same way rather than imported, so an analytics detail cannot
+ /// drag the WS layer into every test that builds this store.
static String _defaultComputerIdPath() =>
'${Directory(HarnessFileStore.defaultDirectoryPath()).parent.path}'
'/computer-id';
diff --git a/mobile/lib/state/app_state.dart b/mobile/lib/state/app_state.dart
index 6d3894fcf..564bb5399 100644
--- a/mobile/lib/state/app_state.dart
+++ b/mobile/lib/state/app_state.dart
@@ -399,8 +399,8 @@ class AppNotifier extends ChangeNotifier {
// finished (an agent's launch), where the only honest control is to
// dismiss it.
bool _lastErrorRetryable = true;
- // Shown on the pre-navigation `bootstrapping` screen while [_finishBootstrapSignedIn] waits on the
- // local daemon — null the rest of the time, including once [status] flips to `authenticated`.
+ // Shown on the pre-navigation `bootstrapping` screen while [_finishBootstrapSignedIn] restores the
+ // local state — null the rest of the time, including once [status] flips to `authenticated`.
String? _bootStatusMessage;
AppStatus status = AppStatus.bootstrapping;
@@ -1256,8 +1256,8 @@ class AppNotifier extends ChangeNotifier {
/// `app_opened`, once, with the answer bootstrap actually reached. Sent from
/// here rather than from the first frame because `signed_in` is not known
- /// until the CLI has been asked, and a first-frame event would report every
- /// launch as signed out.
+ /// until the session has been read, and a first-frame event would report
+ /// every launch as signed out.
void _trackAppOpened() {
if (_appOpenedTracked) return;
_appOpenedTracked = true;
@@ -1991,10 +1991,10 @@ class AppNotifier extends ChangeNotifier {
Future<void> retryOfflineMachine(String machineId) =>
_pollOfflineMachine(machineId);
- /// Runs `harness link connect <machineId> --stdin --json` (via [CliLink]) for a machine the
- /// relay reported `NO_PEER_LINK` for, then reconnects it. Returns null on success, or an error
- /// message to show inline. The app never sees the password's cryptographic use — this just
- /// pipes it to the CLI on stdin, the same as typing it at a terminal prompt would.
+ /// Links [machineId] by its remote password — the exchange `harness link connect` runs on a
+ /// desktop, run here by [peerLinks] (`viewer/password_link.dart`) — for a machine the relay
+ /// reported `NO_PEER_LINK` for, then reconnects it. Returns null on success, or an error
+ /// message to show inline.
Future<String?> connectWithPassword(
String machineId,
String password, {
@@ -2328,9 +2328,9 @@ class AppNotifier extends ChangeNotifier {
return _pool?[machineId]?.isReady == true;
}
- // Every machine — this computer's own, or a relayed one — now speaks the same plaintext local wire
- // protocol to the CLI (which terminates E2EE itself for relayed machines; see remoteRelay.ts in the
- // harness CLI repo). There is no per-machine branching left here at all.
+ // Every machine hands over the same loopback (HTRL) frames: the relay codec has opened the E2EE
+ // envelope before a frame gets here (see `ws/relay_codec.dart`), so there is no per-machine
+ // branching left here at all.
void _wireConnectionHooks(WsConn connection, String machineId) {
connection.onBinaryFrame = (frame) =>
_handleTerminalBinary(machineId, frame);
diff --git a/mobile/lib/viewer/direct_link.dart b/mobile/lib/viewer/direct_link.dart
index 07349d780..bd4494b98 100644
--- a/mobile/lib/viewer/direct_link.dart
+++ b/mobile/lib/viewer/direct_link.dart
@@ -99,8 +99,8 @@ class DirectLink implements PeerLinkClient {
}
}
- // ⚠️ **Both links answer with a result, never an exception** — the same contract `CliLink`
- // keeps. Their callers await them with nothing around them: the password form with its button
+ // ⚠️ **Both links answer with a result, never an exception** — the same contract the desktop's
+ // CLI-backed link keeps. Their callers await them with nothing around them: the password form with its button
// disabled until an answer comes, the QR's pairing screen under "Pairing…". A state file that
// was locked or full threw straight through here, and left each of them waiting for good.