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
feat(mobile): add setup steps to go-to screen
tonye5a6adbd1f34
diff --git a/mobile/lib/phone/agent_home.dart b/mobile/lib/phone/agent_home.dartindex bf2e9c8c6..c721f208f 100644--- a/mobile/lib/phone/agent_home.dart+++ b/mobile/lib/phone/agent_home.dart@@ -1113,10 +1113,11 @@ class _AgentHomeState extends State<AgentHome>/// Settings at the top right is the way out (Sign out among it): a "looking" with no way out is/// one of the things the onboarding leaves out on purpose.///- /// ⚠️ **The account, said at the foot, until the phone adds the computer itself.** The spec's+ /// ⚠️ **What to do on the computer, said under the link, until the phone adds it itself** —+ /// download and install Harness, and sign in with this account ([GoToComputer]). The spec's/// computer is added by the waiting phone and never signs in; until that lands (it needs the- /// desktop and the backend), the computer signs in on its own, and the wrong account there — one- /// of the person's other Google accounts — is the likeliest reason this screen never moves on.+ /// desktop and the backend), the computer signs in on its own — with this account, and it joins,+ /// and this screen moves on; with one of the person's other Google accounts, and it never does.Widget _goToYourComputer() {final notifier = widget.notifier;if (_onboarding) _awaitedComputer = true;@@ -1127,14 +1128,11 @@ class _AgentHomeState extends State<AgentHome>enterFrom: notifier.signedInThisRun ? OnboardingScene.welcome : null,underHeadline: ComputerWatch(notifier: notifier,- child: const GoAddressButton(),+ child: GoToComputer(account: notifier.currentUser?.email),),status: const OnboardingStatus(OnboardingCopy.looking),trailing: PhoneSettingsButton(notifier: notifier),- actions: switch (notifier.currentUser?.email) {- final email? => AccountQuietLine(notifier: notifier, email: email),- null => null,- },+ actions: NotYouSignOut(notifier: notifier),);}diff --git a/mobile/lib/phone/welcome/onboarding_copy.dart b/mobile/lib/phone/welcome/onboarding_copy.dartindex 0ee1a36eb..5ef8fa020 100644--- a/mobile/lib/phone/welcome/onboarding_copy.dart+++ b/mobile/lib/phone/welcome/onboarding_copy.dart@@ -6,6 +6,8 @@/// [Continue with Google] [Continue with Apple] Continue with email/// ② Your computer On your computer, go to [autonomous.ai/go ⇪]/// under the picture: Looking for your computer▌+/// under the link: (1) Install Harness (2) Sign in, With you@…+/// at the foot: Not you? Sign out/// The Mac joins MacBook Pro is ready./// ③ The session by the mic, once: Send it, or say anything./// ```@@ -17,7 +19,10 @@/// with these.////// ⚠️ **Nothing else on these screens** (owner, 2026-10-12): no sample link, no tips, no notification-/// prompt, no fallback lines, no page dots, and never the word "network".+/// prompt, no page dots, and never the word "network". ② says what to do on the computer — which+/// account to sign in with, and where Add Phone is (owner, 2026-10-12, after trying it):+/// until the phone adds the computer itself, the computer signs in on its own, and that is where+/// people stood stuck.abstract final class OnboardingCopy {/// ① The welcome's headline: everything lit, the promise.static const welcome =@@ -40,6 +45,14 @@ abstract final class OnboardingCopy {/// ② Under the picture, while the laptop breathes.static const looking = 'Looking for your computer';+ /// ② The first step under the link: installing Harness — the link above it is the download, so+ /// the step need not say so (`set_up_computer.dart`'s [goToSteps]; the second is signing in with+ /// this account).+ static const installStep = 'Install Harness';++ /// ② The quiet line at the foot, the account named in the steps above.+ static const notYou = 'Not you? Sign out';+/// The moment the computer joins — its own name, as the account knows it.static String ready(String computer) => '$computer is ready.';diff --git a/mobile/lib/phone/welcome/onboarding_frame.dart b/mobile/lib/phone/welcome/onboarding_frame.dartindex e00248e29..564fc0996 100644--- a/mobile/lib/phone/welcome/onboarding_frame.dart+++ b/mobile/lib/phone/welcome/onboarding_frame.dart@@ -5,6 +5,18 @@ import 'package:flutter/material.dart';import '../tty.dart';import '../tty_controls.dart';import 'onboarding_picture.dart';+import 'set_up_computer.dart' show StepsTimeline, goToSteps;++/// How an onboarding screen's slots are measured: the welcome's, or "On your computer, go to"'s —+/// which every screen after signing in shares (its wait, and the computer joining), so the picture+/// stays put from one to the next.+enum OnboardingLayout {+ /// ① A headline of up to three lines; the two accounts and the quiet line at the foot.+ welcome,++ /// ② The headline, the link and the steps on the computer under it; one quiet line at the foot.+ goTo,+}/// The one layout every onboarding screen is drawn on — the welcome, "On your computer, go to" and/// the computer joining — so that going from one to the next only the words change.@@ -13,10 +25,10 @@ import 'onboarding_picture.dart';/// ‹ (leading, trailing)////// Manage all your agents on all headline: 22pt mono semibold, up to three lines-/// your computers from your phone. [underHeadline] — ②'s address+/// your computers from your phone. [underHeadline] — ②'s link and steps////// ┌──────────────────┐-/// │ picture │ the middle, the same place on every screen+/// │ picture │ the middle, the same place on every screen of a [layout]/// └──────────────────┘/// Looking for your computer▌ status///@@ -25,10 +37,11 @@ import 'onboarding_picture.dart';/// Continue with email/// ```///-/// ⚠️ **Every slot is measured the same way on every screen**, whatever it holds — the headline's-/// three lines, room for a button under it, the foot's two buttons and quiet line — so the picture-/// sits at one height whichever screen is up, and never moves (`docs/research/2026-10-11-phone--/// onboarding`, "Type and space"). It only shrinks where the phone is short or the text large.+/// ⚠️ **Every slot is measured the same way on every screen of a [layout]**, whatever it holds — the+/// headline and what goes under it, the foot — so the picture sits at one height whichever of them+/// is up, and never moves (`docs/research/2026-10-11-phone-onboarding`, "Type and space"). It only+/// shrinks where the phone is short or the text large. Between the welcome and the screens after+/// it, the screen changes whole as the phone signs in, and the picture with it.////// Between screens the words rise 8pt into place over 250ms (a 200ms fade under Reduce Motion);/// what changes in the picture is its own business ([OnboardingPicture]).@@ -43,12 +56,16 @@ class OnboardingFrame extends StatelessWidget {this.actions,this.leading,this.trailing,+ this.layout = OnboardingLayout.welcome,});final String headline;final Key? headlineKey;- /// Under the headline, rising with it: "On your computer, go to"'s address.+ /// How the slots are measured — see the class comment.+ final OnboardingLayout layout;++ /// Under the headline, rising with it: "On your computer, go to"'s link and steps.final Widget? underHeadline;/// The picture, laid out in the middle at its own 320 × 300 proportions.@@ -79,6 +96,9 @@ class OnboardingFrame extends StatelessWidget {/// The quiet line's size, and the status line's.static const double quietSize = TtySize.meta;+ /// ②'s steps under the link ([goToSteps]): the gap above them.+ static const double stepsAbove = 24;+/// The picture may reach wider than the words, as far as this from each edge.static const double _pictureSide = 27;@@ -95,9 +115,23 @@ class OnboardingFrame extends StatelessWidget {scaler.scale(TtySize.title) * 1.2 + 20,);final quiet = math.max(44.0, scaler.scale(quietSize) * 1.45);- // The headline's three lines — or two and a button under them, ②'s address.- final head = math.max(3 * line, 2 * line + _underGap + button);- final foot = 2 * button + _buttonGap + quiet + 8;+ final (head, foot) = switch (layout) {+ // The headline's three lines; the two accounts and the quiet line under them.+ OnboardingLayout.welcome => (+ math.max(3 * line, 2 * line + _underGap + button),+ 2 * button + _buttonGap + quiet + 8,+ ),+ // Two lines of headline, the link and the steps; one quiet line.+ OnboardingLayout.goTo => (+ 2 * line ++ _underGap ++ button ++ stepsAbove ++ // With an account named, as it is once signed in.+ StepsTimeline.heightOf(goToSteps('you'), scaler),+ quiet + 8,+ ),+ };// Room for two lines under the picture: a sign-in's failure can run to a second.final statusRow = 2 * scaler.scale(quietSize) * 1.45;@@ -188,12 +222,16 @@ class OnboardingStage extends StatelessWidget {this.leading,this.trailing,this.onTap,+ this.layout = OnboardingLayout.goTo,});final String headline;final Key? headlineKey;final OnboardingScene scene;+ /// "On your computer, go to"'s, for every screen after signing in — see [OnboardingLayout].+ final OnboardingLayout layout;+/// See [OnboardingPicture.enterFrom], [OnboardingPicture.agent] and [OnboardingPicture.join].final OnboardingScene? enterFrom;final String? agent;@@ -231,6 +269,7 @@ class OnboardingStage extends StatelessWidget {actions: actions,leading: leading,trailing: trailing,+ layout: layout,),),),diff --git a/mobile/lib/phone/welcome/set_up_computer.dart b/mobile/lib/phone/welcome/set_up_computer.dartindex 7e89f2641..492188318 100644--- a/mobile/lib/phone/welcome/set_up_computer.dart+++ b/mobile/lib/phone/welcome/set_up_computer.dart@@ -1,44 +1,64 @@+import 'dart:math' as math;+import 'package:flutter/material.dart';import '../tty.dart';import '../tty_controls.dart';+import 'onboarding_copy.dart';import 'scan_to_connect.dart' show kAddPhoneWhere;-/// The steps on a computer that bring up its Add Phone QR code — for the camera opened from-/// Computers, which pairs with a desktop from before the onboarding of 2026-10-12.+/// The steps on a computer, as a timeline ([StepsTimeline]): under "On your computer, go to"'s link+/// (`your_computer.dart`) — [goToSteps] — and under the camera opened from Computers —+/// [computerSteps], which bring up Add Phone's QR code.////// ⚠️ This file used to be **Connect your computer**, the page a phone with no computer stood on/// (signed out, signed in with none, and Computers ▸ Set up another computer). The onboarding/// replaced it (`docs/research/2026-10-11-phone-onboarding`): signed out, the welcome signs in/// (`phone_welcome.dart`); with no computer, "On your computer, go to" (`your_computer.dart`). Only-/// the steps are left, for the camera's sake.+/// the steps are left, for that screen and the camera.-/// The first step on the computer, signed in or out.-const _openHarness = 'Open Harness on your computer';+/// One step: what to do, and a quieter line under it when one is needed — its lines split on `\n`.+typedef ComputerStep = ({String title, String? note});-/// The steps after [_openHarness]: sign in on the computer, then Add Phone and where it is.+/// The first step on the computer, for the camera.///-/// ⚠️ **One set, wherever they are shown (owner, 2026-10-12)** — now only the camera's, from-/// Computers. They used to be two: signed out "Click-/// Add Phone ③ Scan the QR code", signed in "Sign in on your computer ③ Not showing up? Click Add-/// Phone" — one button on one page, and steps that changed under it, and on the camera "Not showing-/// up?" was asked of somebody already scanning. Both halves hold either way: Add Phone asks a-/// computer that is not signed in to sign in before it shows a code, and a computer that turns up-/// by itself is paired just as well by its code. The scan is the button above the steps, and the-/// camera's own title, so it is not a step of its own.+/// ⚠️ **"On your computer" is said once, by the title over the steps** — "On your computer, go to",+/// "Scan the code on your computer" — not again in each step under it (owner, 2026-10-12: three+/// times on one screen read as noise).+const _openHarness = 'Open Harness';++/// The steps under "On your computer, go to"'s link: get Harness from it, and sign in — with+/// [account], the phone's, when there is one to name. Signed in with this account, the computer+/// joins it and the screen moves on by itself: no Add Phone, no code to scan (owner, 2026-10-12).+/// The sign-in step is the camera's, word for word.+List<ComputerStep> goToSteps(String? account) => [+ (title: OnboardingCopy.installStep, note: null),+ _signIn(account),+];++/// The steps under the camera opened from Computers ▸ "Or scan the QR code on your computer", which+/// pairs a phone by Add Phone's code — where the page it came from says none of them+/// ([ScanToConnectPage.steps]): open Harness, sign in — with [account], when there is one to name —+/// then Add Phone and where it is.///-/// [signIn]: under signing in, which account — the phone's, when it has one to name. Null signed-/// out, where the scan signs the phone in to whichever account the computer has.-List<({String title, String? note})> _stepsAfterOpening(String? signIn) => [- (title: 'Sign in on your computer', note: signIn),+/// ⚠️ **One set for the camera (owner, 2026-10-12).** It used to be two: signed out "Click Add+/// Phone ③ Scan the QR code", signed in "Sign in on your computer ③ Not showing up? Click Add+/// Phone" — steps that changed under one button, and on the camera "Not showing up?" was asked of+/// somebody already scanning. Both halves hold either way: Add Phone asks a computer that is not+/// signed in to sign in before it shows a code, and a computer that turns up by itself is paired+/// just as well by its code. The scan is the camera's own title, so it is not a step of its own.+List<ComputerStep> computerSteps(String? account) => [+ (title: _openHarness, note: null),+ _signIn(account),(title: 'Click Add Phone', note: kAddPhoneWhere),];-/// The steps on the computer under the camera, opened from Computers ▸ "Or scan the QR code on your-/// computer" — where the page it came from says none of them ([ScanToConnectPage.steps]).-///-/// For a desktop from before the onboarding of 2026-10-12, which still pairs a phone by its Add-/// Phone QR code; every other computer is added by "On your computer, go to" (`your_computer.dart`).+/// Signing in on the computer — with [account], the phone's, when there is one to name. Null signed+/// out, where a scan signs the phone in to whichever account the computer has.+ComputerStep _signIn(String? account) =>+ (title: 'Sign in', note: account == null ? null : 'With $account.');++/// The steps on the computer under the camera ([computerSteps]) as a [StepsTimeline].class ComputerSteps extends StatelessWidget {const ComputerSteps({super.key, required this.account});@@ -46,24 +66,63 @@ class ComputerSteps extends StatelessWidget {final String? account;@override- Widget build(BuildContext context) {- final account = this.account;- final next = _stepsAfterOpening(account == null ? null : 'With $account.');- return Column(- crossAxisAlignment: CrossAxisAlignment.stretch,- mainAxisSize: MainAxisSize.min,- children: [- const _HowItWorksRow(number: 1, title: _openHarness),- for (final (i, step) in next.indexed)- _HowItWorksRow(- number: i + 2,- title: step.title,- note: step.note,- last: i == next.length - 1,- ),- ],+ Widget build(BuildContext context) =>+ StepsTimeline(steps: computerSteps(account));+}++/// Steps as a timeline — each number in a ring, a thread down to the next:+///+/// ```+/// (1) Install Harness+/// │+/// (2) Sign in+/// With [email protected].+/// ```+///+/// ⚠️ **A line each, ending in "…" rather than wrapping** — a title, and each line of a note — so+/// [heightOf] is exact: "On your computer, go to" holds that much room under its link, and the+/// picture under the steps stays put.+class StepsTimeline extends StatelessWidget {+ const StepsTimeline({super.key, required this.steps});++ final List<ComputerStep> steps;++ /// How tall [steps] stand at [scaler]'s text size: each title at least a ring tall, each note's+ /// lines and the room round them, the gap under every step but the last.+ static double heightOf(List<ComputerStep> steps, TextScaler scaler) {+ final title = math.max(+ _HowItWorksRow._ring,+ scaler.scale(TtySize.row) * 1.2,);+ final line = scaler.scale(TtySize.meta) * _HowItWorksRow._noteHeight;+ var height = 0.0;+ for (final (i, step) in steps.indexed) {+ height += title;+ if (step.note case final note?) {+ height +=+ '\n'.allMatches(note).length * line ++ line ++ _HowItWorksRow.noteInsets.vertical;+ }+ if (i < steps.length - 1) height += _HowItWorksRow._gap;+ }+ return height;}++ @override+ Widget build(BuildContext context) => Column(+ crossAxisAlignment: CrossAxisAlignment.stretch,+ mainAxisSize: MainAxisSize.min,+ children: [+ for (final (i, step) in steps.indexed)+ _HowItWorksRow(+ number: i + 1,+ title: step.title,+ note: step.note,+ last: i == steps.length - 1,+ ),+ ],+ );}/// One step: its number in a ring, a thread down to the next one's, what to do, and under it a@@ -83,6 +142,18 @@ class _HowItWorksRow extends StatelessWidget {static const double _ring = 24;+ /// Under every step but the last: the thread's room down to the next ring.+ ///+ /// ⚠️ With [_threadInset] above and below it, a step with no note under it — "Download and+ /// install Harness" — still leaves a thread long enough to read as one: at 16 and 6 it was four+ /// points, and the two rings read as two dots, not a timeline.+ static const double _gap = 20;++ /// The thread's distance from the ring above it and the ring below.+ static const double _threadInset = 4;++ static const double _noteHeight = 1.45;+static const EdgeInsets noteInsets = EdgeInsets.only(top: 2, bottom: 6);@override@@ -116,7 +187,9 @@ class _HowItWorksRow extends StatelessWidget {Expanded(child: Container(width: 1,- margin: const EdgeInsets.symmetric(vertical: 6),+ margin: const EdgeInsets.symmetric(+ vertical: _threadInset,+ ),color: line,),),@@ -126,7 +199,7 @@ class _HowItWorksRow extends StatelessWidget {const SizedBox(width: 14),Expanded(child: Padding(- padding: EdgeInsets.only(bottom: last ? 0 : 16),+ padding: EdgeInsets.only(bottom: last ? 0 : _gap),child: Column(crossAxisAlignment: CrossAxisAlignment.start,children: [@@ -137,6 +210,9 @@ class _HowItWorksRow extends StatelessWidget {alignment: Alignment.centerLeft,child: Text(title,+ maxLines: 1,+ softWrap: false,+ overflow: TextOverflow.ellipsis,style: tty.style(size: TtySize.row,weight: FontWeight.w600,@@ -144,14 +220,25 @@ class _HowItWorksRow extends StatelessWidget {),),),+ // A line each, ending in "…" rather than wrapping: a long account wrapping onto+ // another would stand the steps taller than [StepsTimeline.heightOf] says.if (note case final note?)Padding(padding: noteInsets,- child: Text(- note,- style: tty- .style(color: tty.faint, size: TtySize.meta)- .copyWith(height: 1.45),+ child: Column(+ crossAxisAlignment: CrossAxisAlignment.start,+ children: [+ for (final part in note.split('\n'))+ Text(+ part,+ maxLines: 1,+ softWrap: false,+ overflow: TextOverflow.ellipsis,+ style: tty+ .style(color: tty.faint, size: TtySize.meta)+ .copyWith(height: _noteHeight),+ ),+ ],),),],diff --git a/mobile/lib/phone/welcome/your_computer.dart b/mobile/lib/phone/welcome/your_computer.dartindex ce6c5f17d..bcfec4457 100644--- a/mobile/lib/phone/welcome/your_computer.dart+++ b/mobile/lib/phone/welcome/your_computer.dart@@ -16,6 +16,7 @@ import 'join_moment.dart';import 'onboarding_copy.dart';import 'onboarding_frame.dart';import 'onboarding_picture.dart';+import 'set_up_computer.dart' show StepsTimeline, goToSteps;/// ② Your computer: "On your computer, go to", the address, and the phone looking for the computer/// that opens it.@@ -29,10 +30,16 @@ import 'onboarding_picture.dart';/// │ the laptop breathes │/// └─────────────────────┘/// Looking for your computer▌+///+/// (1) Install Harness what to do there ([GoToComputer])+/// │+/// (2) Sign in+/// With [email protected]./// ```////// At home this is what an account with no computer stands on (`agent_home.dart`, which builds it-/// from [GoAddressButton] and [ComputerWatch] on its own [OnboardingStage]). This page is the same+/// from [ComputerWatch] and [GoToComputer] on its own [OnboardingStage], with+/// "Not you? Sign out" under the steps). This page is the same/// step pushed from Computers ▸ Add computer, with back: a second computer is set up the way the/// first was (`docs/research/2026-10-11-phone-onboarding`, "More computers, more phones").///@@ -120,7 +127,7 @@ class _YourComputerPageState extends State<YourComputerPage>underHeadline: joined == null? ComputerWatch(notifier: widget.notifier,- child: const GoAddressButton(),+ child: GoToComputer(account: widget.notifier.currentUser?.email),): null,status: joined == null@@ -131,6 +138,48 @@ class _YourComputerPageState extends State<YourComputerPage>}}+/// What goes under "On your computer, go to": the link ([GoAddressButton]) and, under it, what to do+/// there — as a timeline ([goToSteps]): download and install Harness, and sign in with this account.+/// Signed in there with it, the computer joins the account, and the screen moves on by itself+/// ([ComputerWatch]): no Add Phone, nothing to scan.+class GoToComputer extends StatelessWidget {+ const GoToComputer({super.key, required this.account});++ /// The account the computer has to sign in to — this phone's.+ final String? account;++ @override+ Widget build(BuildContext context) => Column(+ mainAxisSize: MainAxisSize.min,+ crossAxisAlignment: CrossAxisAlignment.stretch,+ children: [+ const GoAddressButton(),+ const SizedBox(height: OnboardingFrame.stepsAbove),+ StepsTimeline(steps: goToSteps(account)),+ ],+ );+}++/// "Not you? Sign out", the quiet line at the foot of "On your computer, go to" at home — where this+/// screen is all an account with no computer has, and the account it names in its steps may be the+/// wrong one. Asks first ([confirmSignOut]).+class NotYouSignOut extends StatelessWidget {+ const NotYouSignOut({super.key, required this.notifier});++ final AppNotifier notifier;++ @override+ Widget build(BuildContext context) => Center(+ child: TtyTextButton(+ key: const ValueKey('home-sign-out'),+ label: OnboardingCopy.notYou,+ size: OnboardingFrame.quietSize,+ color: Tty.of(context).faint,+ onPressed: () => unawaited(confirmSignOut(context, notifier)),+ ),+ );+}+/// Asks the account for its computers every few seconds while it is up: nothing pushes a new/// computer to a phone that has none connected, and this is the screen waiting for one.///@@ -286,61 +335,3 @@ class _GoAddressButtonState extends State<GoAddressButton> {);}}--/// `[email protected] · Not you? Sign out` — the account the computer has to sign in to, on the quiet-/// line at the foot of "On your computer, go to", and the way out of it. The whole line signs out,-/// after asking ([confirmSignOut]).-class AccountQuietLine extends StatelessWidget {- const AccountQuietLine({- super.key,- required this.notifier,- required this.email,- });-- final AppNotifier notifier;- final String email;-- @override- Widget build(BuildContext context) {- final tty = Tty.of(context);- return Semantics(- button: true,- label: 'Signed in as $email. Not you? Sign out',- excludeSemantics: true,- child: GestureDetector(- key: const ValueKey('home-sign-out'),- behavior: HitTestBehavior.opaque,- onTap: () {- HapticFeedback.selectionClick();- unawaited(confirmSignOut(context, notifier));- },- child: ConstrainedBox(- constraints: const BoxConstraints(minHeight: 44),- child: Center(- child: Text.rich(- TextSpan(- children: [- TextSpan(text: '$email · '),- TextSpan(- text: 'Not you? Sign out',- style: tty.style(- color: tty.text,- size: OnboardingFrame.quietSize,- ),- ),- ],- ),- textAlign: TextAlign.center,- maxLines: 2,- overflow: TextOverflow.ellipsis,- style: tty.style(- color: tty.faint,- size: OnboardingFrame.quietSize,- ),- ),- ),- ),- ),- );- }-}