@boxes-dev/dvb-runtime 1.0.1051 → 1.0.1053

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/bin/dvbd.mjs CHANGED
@@ -1,6 +1,6 @@
1
1
  #!/usr/bin/env node
2
2
 
3
- !function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="a9afcb43-4806-5154-9842-36529ed47771")}catch(e){}}();
3
+ !function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="7d72dc90-582f-5b5e-adc3-cf59e376ab6d")}catch(e){}}();
4
4
  import { createRequire as __dvbCreateRequire } from "node:module";
5
5
  import { dirname as __dvbDirname } from "node:path";
6
6
  import { fileURLToPath as __dvbFileURLToPath } from "node:url";
@@ -45,13 +45,6 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
45
45
  mod
46
46
  ));
47
47
 
48
- // ../../../../shared/devboxCore/dist/directMoshProtocol.js
49
- var init_directMoshProtocol = __esm({
50
- "../../../../shared/devboxCore/dist/directMoshProtocol.js"() {
51
- "use strict";
52
- }
53
- });
54
-
55
48
  // ../../../../node_modules/ws/lib/constants.js
56
49
  var require_constants = __commonJS({
57
50
  "../../../../node_modules/ws/lib/constants.js"(exports, module2) {
@@ -23924,6 +23917,68 @@ var init_mcpOAuth = __esm({
23924
23917
  }
23925
23918
  });
23926
23919
 
23920
+ // ../../../../shared/devboxCore/dist/codexChatGptAuthJson.js
23921
+ var init_codexChatGptAuthJson = __esm({
23922
+ "../../../../shared/devboxCore/dist/codexChatGptAuthJson.js"() {
23923
+ "use strict";
23924
+ }
23925
+ });
23926
+
23927
+ // ../../../../shared/devboxCore/dist/codexManagedAuth.js
23928
+ var init_codexManagedAuth = __esm({
23929
+ "../../../../shared/devboxCore/dist/codexManagedAuth.js"() {
23930
+ "use strict";
23931
+ }
23932
+ });
23933
+
23934
+ // ../../../../shared/devboxCore/dist/codexOAuthParams.js
23935
+ var CODEX_OAUTH_ISSUER, CODEX_OAUTH_AUTHORIZE_URL, CODEX_OAUTH_TOKEN_URL;
23936
+ var init_codexOAuthParams = __esm({
23937
+ "../../../../shared/devboxCore/dist/codexOAuthParams.js"() {
23938
+ "use strict";
23939
+ CODEX_OAUTH_ISSUER = "https://auth.openai.com";
23940
+ CODEX_OAUTH_AUTHORIZE_URL = `${CODEX_OAUTH_ISSUER}/oauth/authorize`;
23941
+ CODEX_OAUTH_TOKEN_URL = `${CODEX_OAUTH_ISSUER}/oauth/token`;
23942
+ }
23943
+ });
23944
+
23945
+ // ../../../../shared/devboxCore/dist/boxesLogoSvg.js
23946
+ var init_boxesLogoSvg = __esm({
23947
+ "../../../../shared/devboxCore/dist/boxesLogoSvg.js"() {
23948
+ "use strict";
23949
+ }
23950
+ });
23951
+
23952
+ // ../../../../shared/devboxCore/dist/oauthCallbackPage.js
23953
+ var init_oauthCallbackPage = __esm({
23954
+ "../../../../shared/devboxCore/dist/oauthCallbackPage.js"() {
23955
+ "use strict";
23956
+ init_boxesLogoSvg();
23957
+ }
23958
+ });
23959
+
23960
+ // ../../../../shared/devboxCore/dist/chatGptBrowserSignIn.js
23961
+ var DEFAULT_TIMEOUT_MS;
23962
+ var init_chatGptBrowserSignIn = __esm({
23963
+ "../../../../shared/devboxCore/dist/chatGptBrowserSignIn.js"() {
23964
+ "use strict";
23965
+ init_codexChatGptAuthJson();
23966
+ init_codexManagedAuth();
23967
+ init_codexOAuthParams();
23968
+ init_oauthCallbackPage();
23969
+ DEFAULT_TIMEOUT_MS = 10 * 6e4;
23970
+ }
23971
+ });
23972
+
23973
+ // ../../../../shared/devboxCore/dist/claudeOAuthParams.js
23974
+ var CLAUDE_SETUP_TOKEN_EXPIRES_IN_SECONDS;
23975
+ var init_claudeOAuthParams = __esm({
23976
+ "../../../../shared/devboxCore/dist/claudeOAuthParams.js"() {
23977
+ "use strict";
23978
+ CLAUDE_SETUP_TOKEN_EXPIRES_IN_SECONDS = 365 * 24 * 60 * 60;
23979
+ }
23980
+ });
23981
+
23927
23982
  // ../../../../shared/devboxCore/dist/agentConfigImport/types.js
23928
23983
  var init_types2 = __esm({
23929
23984
  "../../../../shared/devboxCore/dist/agentConfigImport/types.js"() {
@@ -64612,9 +64667,9 @@ var init_sentry = __esm({
64612
64667
  uncaughtExceptionMonitorInstalled = false;
64613
64668
  currentDevboxSentryUser = null;
64614
64669
  readBuildMetadata = () => {
64615
- const rawPackageVersion = "1.0.1051";
64616
- const rawGitSha = "a146f896d6bb73d0ee0446cd7d2f7fbf92250dd8";
64617
- const rawSentryRelease = "boxes-dev-dvb@1.0.1051+a146f896d6bb73d0ee0446cd7d2f7fbf92250dd8";
64670
+ const rawPackageVersion = "1.0.1053";
64671
+ const rawGitSha = "76361e7078c6a6e750a6d2ba0cf73167ab361588";
64672
+ const rawSentryRelease = "boxes-dev-dvb@1.0.1053+76361e7078c6a6e750a6d2ba0cf73167ab361588";
64618
64673
  const packageVersion = typeof rawPackageVersion === "string" ? rawPackageVersion : void 0;
64619
64674
  const gitSha = typeof rawGitSha === "string" ? rawGitSha : void 0;
64620
64675
  const sentryRelease = typeof rawSentryRelease === "string" ? rawSentryRelease : void 0;
@@ -66473,6 +66528,112 @@ var init_npmCli = __esm({
66473
66528
  }
66474
66529
  });
66475
66530
 
66531
+ // ../../../../shared/devboxCore/dist/packageUpdates.js
66532
+ import fs5 from "node:fs/promises";
66533
+ import os5 from "node:os";
66534
+ import path6 from "node:path";
66535
+ var createEmptyCache, resolvePackageUpdateCacheDir, resolvePackageUpdateCachePath, ensureCacheDir, writeJsonAtomic, parseEntry, loadPackageUpdateCache, savePackageUpdateCache, writeCachedPackageVersion;
66536
+ var init_packageUpdates = __esm({
66537
+ "../../../../shared/devboxCore/dist/packageUpdates.js"() {
66538
+ "use strict";
66539
+ init_config();
66540
+ createEmptyCache = () => ({
66541
+ version: 1,
66542
+ packages: {}
66543
+ });
66544
+ resolvePackageUpdateCacheDir = (homeDir = os5.homedir()) => path6.join(resolveDevboxDir(homeDir), "cache");
66545
+ resolvePackageUpdateCachePath = (homeDir = os5.homedir()) => path6.join(resolvePackageUpdateCacheDir(homeDir), "package-updates.json");
66546
+ ensureCacheDir = async (homeDir) => {
66547
+ const dir = resolvePackageUpdateCacheDir(homeDir);
66548
+ await fs5.mkdir(dir, { recursive: true, mode: 448 });
66549
+ try {
66550
+ await fs5.chmod(dir, 448);
66551
+ } catch {
66552
+ }
66553
+ return dir;
66554
+ };
66555
+ writeJsonAtomic = async (filePath, payload) => {
66556
+ const dir = path6.dirname(filePath);
66557
+ const tempPath = path6.join(dir, `.tmp-${path6.basename(filePath)}-${Date.now()}`);
66558
+ await fs5.writeFile(tempPath, JSON.stringify(payload, null, 2), {
66559
+ mode: 384
66560
+ });
66561
+ await fs5.rename(tempPath, filePath);
66562
+ try {
66563
+ await fs5.chmod(filePath, 384);
66564
+ } catch {
66565
+ }
66566
+ };
66567
+ parseEntry = (value) => {
66568
+ if (!value || typeof value !== "object")
66569
+ return null;
66570
+ const record2 = value;
66571
+ if (typeof record2.latestVersion !== "string")
66572
+ return null;
66573
+ if (typeof record2.checkedAt !== "string")
66574
+ return null;
66575
+ const latestVersion = record2.latestVersion.trim();
66576
+ const checkedAt = record2.checkedAt.trim();
66577
+ if (!latestVersion || !checkedAt)
66578
+ return null;
66579
+ return { latestVersion, checkedAt };
66580
+ };
66581
+ loadPackageUpdateCache = async (options = {}) => {
66582
+ const filePath = resolvePackageUpdateCachePath(options.homeDir);
66583
+ try {
66584
+ const raw = await fs5.readFile(filePath, "utf8");
66585
+ const parsed = JSON.parse(raw);
66586
+ if (!parsed || parsed.version !== 1)
66587
+ return createEmptyCache();
66588
+ if (!parsed.packages || typeof parsed.packages !== "object") {
66589
+ return createEmptyCache();
66590
+ }
66591
+ const packages = {};
66592
+ for (const [packageName, entryValue] of Object.entries(parsed.packages)) {
66593
+ const entry = parseEntry(entryValue);
66594
+ if (!entry)
66595
+ continue;
66596
+ packages[packageName] = entry;
66597
+ }
66598
+ return {
66599
+ version: 1,
66600
+ packages
66601
+ };
66602
+ } catch (error4) {
66603
+ if (error4 instanceof Error && "code" in error4 && error4.code === "ENOENT") {
66604
+ return createEmptyCache();
66605
+ }
66606
+ throw error4;
66607
+ }
66608
+ };
66609
+ savePackageUpdateCache = async (cache, options = {}) => {
66610
+ await ensureCacheDir(options.homeDir);
66611
+ const filePath = resolvePackageUpdateCachePath(options.homeDir);
66612
+ await writeJsonAtomic(filePath, cache);
66613
+ };
66614
+ writeCachedPackageVersion = async (packageName, latestVersion, options = {}) => {
66615
+ const trimmedPackageName = packageName.trim();
66616
+ const trimmedVersion = latestVersion.trim();
66617
+ if (!trimmedPackageName || !trimmedVersion)
66618
+ return;
66619
+ const cache = await loadPackageUpdateCache(options);
66620
+ cache.packages[trimmedPackageName] = {
66621
+ latestVersion: trimmedVersion,
66622
+ checkedAt: options.checkedAt ?? (/* @__PURE__ */ new Date()).toISOString()
66623
+ };
66624
+ await savePackageUpdateCache(cache, options);
66625
+ };
66626
+ }
66627
+ });
66628
+
66629
+ // ../../../../shared/devboxCore/dist/managedCodexVersions.js
66630
+ var init_managedCodexVersions = __esm({
66631
+ "../../../../shared/devboxCore/dist/managedCodexVersions.js"() {
66632
+ "use strict";
66633
+ init_packageUpdates();
66634
+ }
66635
+ });
66636
+
66476
66637
  // ../../../../shared/devboxCore/dist/desktopInitContracts.js
66477
66638
  var DESKTOP_INIT_UPLOAD_URL_TTL_SECONDS, DESKTOP_INIT_DOWNLOAD_URL_TTL_SECONDS, DESKTOP_INIT_MAX_UNCOMPRESSED_BUNDLE_BYTES, DESKTOP_INIT_MAX_COMBINED_BUNDLE_BYTES, DESKTOP_INIT_SHELL_ENV_CAPTURE_MAX_BYTES, DESKTOP_INIT_PHASES, DESKTOP_INIT_JOB_STATUSES, DESKTOP_INIT_WORKFLOW_STEPS, PHASE_SET, JOB_STATUS_SET, WORKFLOW_OWNED_PHASES, DESKTOP_INIT_UNTRACKED_AUTO_EXCLUDE_DIR_NAMES, DESKTOP_INIT_UNTRACKED_BUILD_OUTPUT_DIR_NAMES, DESKTOP_INIT_UNTRACKED_AUTO_EXCLUDE_DIR_NAME_SET, DESKTOP_INIT_UNTRACKED_BUILD_OUTPUT_DIR_NAME_SET;
66478
66639
  var init_desktopInitContracts = __esm({
@@ -66656,7 +66817,7 @@ var init_desktopSetupReview = __esm({
66656
66817
 
66657
66818
  // ../../../../shared/devboxCore/dist/installOwner.js
66658
66819
  import { existsSync as existsSync2 } from "node:fs";
66659
- import path6 from "node:path";
66820
+ import path7 from "node:path";
66660
66821
  var DEVBOX_INSTALL_OWNER_PATHS_ENV, trimOwnerPath, resolveInstallOwnerPaths, findMissingInstallOwnerPaths;
66661
66822
  var init_installOwner = __esm({
66662
66823
  "../../../../shared/devboxCore/dist/installOwner.js"() {
@@ -66668,7 +66829,7 @@ var init_installOwner = __esm({
66668
66829
  if (!raw) {
66669
66830
  return [];
66670
66831
  }
66671
- const values = raw.split(path6.delimiter).map(trimOwnerPath).filter((value) => value.length > 0);
66832
+ const values = raw.split(path7.delimiter).map(trimOwnerPath).filter((value) => value.length > 0);
66672
66833
  return [...new Set(values)];
66673
66834
  };
66674
66835
  findMissingInstallOwnerPaths = (ownerPaths, exists = existsSync2) => ownerPaths.map(trimOwnerPath).filter((ownerPath) => ownerPath.length > 0 && !exists(ownerPath));
@@ -66682,104 +66843,6 @@ var init_strings = __esm({
66682
66843
  }
66683
66844
  });
66684
66845
 
66685
- // ../../../../shared/devboxCore/dist/packageUpdates.js
66686
- import fs5 from "node:fs/promises";
66687
- import os5 from "node:os";
66688
- import path7 from "node:path";
66689
- var createEmptyCache, resolvePackageUpdateCacheDir, resolvePackageUpdateCachePath, ensureCacheDir, writeJsonAtomic, parseEntry, loadPackageUpdateCache, savePackageUpdateCache, writeCachedPackageVersion;
66690
- var init_packageUpdates = __esm({
66691
- "../../../../shared/devboxCore/dist/packageUpdates.js"() {
66692
- "use strict";
66693
- init_config();
66694
- createEmptyCache = () => ({
66695
- version: 1,
66696
- packages: {}
66697
- });
66698
- resolvePackageUpdateCacheDir = (homeDir = os5.homedir()) => path7.join(resolveDevboxDir(homeDir), "cache");
66699
- resolvePackageUpdateCachePath = (homeDir = os5.homedir()) => path7.join(resolvePackageUpdateCacheDir(homeDir), "package-updates.json");
66700
- ensureCacheDir = async (homeDir) => {
66701
- const dir = resolvePackageUpdateCacheDir(homeDir);
66702
- await fs5.mkdir(dir, { recursive: true, mode: 448 });
66703
- try {
66704
- await fs5.chmod(dir, 448);
66705
- } catch {
66706
- }
66707
- return dir;
66708
- };
66709
- writeJsonAtomic = async (filePath, payload) => {
66710
- const dir = path7.dirname(filePath);
66711
- const tempPath = path7.join(dir, `.tmp-${path7.basename(filePath)}-${Date.now()}`);
66712
- await fs5.writeFile(tempPath, JSON.stringify(payload, null, 2), {
66713
- mode: 384
66714
- });
66715
- await fs5.rename(tempPath, filePath);
66716
- try {
66717
- await fs5.chmod(filePath, 384);
66718
- } catch {
66719
- }
66720
- };
66721
- parseEntry = (value) => {
66722
- if (!value || typeof value !== "object")
66723
- return null;
66724
- const record2 = value;
66725
- if (typeof record2.latestVersion !== "string")
66726
- return null;
66727
- if (typeof record2.checkedAt !== "string")
66728
- return null;
66729
- const latestVersion = record2.latestVersion.trim();
66730
- const checkedAt = record2.checkedAt.trim();
66731
- if (!latestVersion || !checkedAt)
66732
- return null;
66733
- return { latestVersion, checkedAt };
66734
- };
66735
- loadPackageUpdateCache = async (options = {}) => {
66736
- const filePath = resolvePackageUpdateCachePath(options.homeDir);
66737
- try {
66738
- const raw = await fs5.readFile(filePath, "utf8");
66739
- const parsed = JSON.parse(raw);
66740
- if (!parsed || parsed.version !== 1)
66741
- return createEmptyCache();
66742
- if (!parsed.packages || typeof parsed.packages !== "object") {
66743
- return createEmptyCache();
66744
- }
66745
- const packages = {};
66746
- for (const [packageName, entryValue] of Object.entries(parsed.packages)) {
66747
- const entry = parseEntry(entryValue);
66748
- if (!entry)
66749
- continue;
66750
- packages[packageName] = entry;
66751
- }
66752
- return {
66753
- version: 1,
66754
- packages
66755
- };
66756
- } catch (error4) {
66757
- if (error4 instanceof Error && "code" in error4 && error4.code === "ENOENT") {
66758
- return createEmptyCache();
66759
- }
66760
- throw error4;
66761
- }
66762
- };
66763
- savePackageUpdateCache = async (cache, options = {}) => {
66764
- await ensureCacheDir(options.homeDir);
66765
- const filePath = resolvePackageUpdateCachePath(options.homeDir);
66766
- await writeJsonAtomic(filePath, cache);
66767
- };
66768
- writeCachedPackageVersion = async (packageName, latestVersion, options = {}) => {
66769
- const trimmedPackageName = packageName.trim();
66770
- const trimmedVersion = latestVersion.trim();
66771
- if (!trimmedPackageName || !trimmedVersion)
66772
- return;
66773
- const cache = await loadPackageUpdateCache(options);
66774
- cache.packages[trimmedPackageName] = {
66775
- latestVersion: trimmedVersion,
66776
- checkedAt: options.checkedAt ?? (/* @__PURE__ */ new Date()).toISOString()
66777
- };
66778
- await savePackageUpdateCache(cache, options);
66779
- };
66780
- }
66781
- });
66782
-
66783
66846
  // ../../../../shared/devboxCore/dist/packageVersion.js
66784
66847
  import { readFileSync as readFileSync2, realpathSync } from "node:fs";
66785
66848
  import path8 from "node:path";
@@ -66821,7 +66884,7 @@ var init_packageVersion = __esm({
66821
66884
  return path8.join(process.cwd(), "dvb");
66822
66885
  };
66823
66886
  readEmbeddedPackageVersion = () => {
66824
- const raw = "1.0.1051";
66887
+ const raw = "1.0.1053";
66825
66888
  return trimVersion(raw);
66826
66889
  };
66827
66890
  readNearestPackageMetadata = (basePath) => {
@@ -67056,7 +67119,6 @@ var init_authRefresh = __esm({
67056
67119
  var init_dist3 = __esm({
67057
67120
  "../../../../shared/devboxCore/dist/index.js"() {
67058
67121
  "use strict";
67059
- init_directMoshProtocol();
67060
67122
  init_codexLocalRenderer();
67061
67123
  init_codexLocalImageFrame();
67062
67124
  init_mcpCommandImport();
@@ -67068,6 +67130,11 @@ var init_dist3 = __esm({
67068
67130
  init_githubGitCredentials();
67069
67131
  init_githubGhCredentials();
67070
67132
  init_mcpOAuth();
67133
+ init_chatGptBrowserSignIn();
67134
+ init_claudeOAuthParams();
67135
+ init_codexChatGptAuthJson();
67136
+ init_codexOAuthParams();
67137
+ init_oauthCallbackPage();
67071
67138
  init_agentConfigImport();
67072
67139
  init_profile();
67073
67140
  init_codingAgents();
@@ -67104,6 +67171,7 @@ var init_dist3 = __esm({
67104
67171
  init_loopbackServer();
67105
67172
  init_portProxying();
67106
67173
  init_npmCli();
67174
+ init_managedCodexVersions();
67107
67175
  init_desktopInitContracts();
67108
67176
  init_desktopObjectTransfers();
67109
67177
  init_desktopInitPaths();
@@ -79968,4 +80036,4 @@ smol-toml/dist/index.js:
79968
80036
  *)
79969
80037
  */
79970
80038
 
79971
- //# debugId=a9afcb43-4806-5154-9842-36529ed47771
80039
+ //# debugId=7d72dc90-582f-5b5e-adc3-cf59e376ab6d
@@ -8,6 +8,10 @@ description: Product documentation for boxes.dev, the platform running this mach
8
8
  Use this skill when the user asks how boxes.dev works or how to use a boxes.dev
9
9
  feature.
10
10
 
11
+ When explaining where to find a desktop control or setting in a boxes.dev
12
+ conversation, read `references/ui-references.md` and use its supported inline
13
+ references where they help the user follow your explanation.
14
+
11
15
  For human-readable walkthroughs, point signed-in users to
12
16
  `https://boxes.dev/help`. The help center covers these same product topics in
13
17
  task-oriented articles, with search and screenshots.
@@ -4,9 +4,11 @@ The boxes.dev CLI is `dvb`. It is useful when you prefer terminal workflows,
4
4
  need direct shell access, want to copy a file into a machine, or want to manage
5
5
  machine lifecycle from scripts.
6
6
 
7
- The desktop app is the primary setup path for most new users. CLI setup is
8
- separate from desktop sign-in: if you sign in on desktop and later run CLI
9
- commands, the CLI may ask you to sign in again.
7
+ Most new users set up their first project by giving the setup prompt from the
8
+ boxes.dev website to a coding agent on their computer, which installs and
9
+ signs in the CLI (see Set Up A Project). CLI sign-in is separate from desktop
10
+ sign-in: if you sign in on desktop and later run CLI commands, the CLI may ask
11
+ you to sign in again.
10
12
 
11
13
  For exact flags, run `dvb --help` or `dvb <command> --help`.
12
14
 
@@ -53,10 +55,11 @@ Never install or run `dvb` on a boxes.dev machine: it can destabilize or
53
55
  permanently break that machine, and boxes.dev is not responsible for recovering
54
56
  a machine knowingly modified this way.
55
57
 
56
- Production installs are:
58
+ Production installs of the standalone build, which includes its own runtime,
59
+ for macOS or Linux on x64 or arm64:
57
60
 
58
61
  ```bash
59
- npm install -g @boxes-dev/dvb
62
+ npm install -g @boxes-dev/cli
60
63
  ```
61
64
 
62
65
  or:
@@ -65,6 +68,9 @@ or:
65
68
  curl -fsSL https://boxes.dev/install.sh | sh
66
69
  ```
67
70
 
71
+ With Node.js 22 or newer, `npm install -g @boxes-dev/dvb` installs a build
72
+ that uses the local Node.js runtime instead.
73
+
68
74
  ## Sign In And Agent Setup
69
75
 
70
76
  Use:
@@ -75,7 +81,9 @@ dvb setup
75
81
 
76
82
  This signs the CLI into boxes.dev and configures coding agents for CLI-created
77
83
  or CLI-managed work. It can also be used later to repair or update CLI agent
78
- auth.
84
+ auth. Someone setting up their first project doesn't need it: the setup
85
+ prompt signs the CLI in, and `dvb agent-init accounts` connects their coding
86
+ agents.
79
87
 
80
88
  Use `dvb setup --agents` when you only need to revisit coding-agent auth. For
81
89
  Codex auth on managed machines, use this command on your own computer instead of
@@ -92,14 +100,18 @@ Useful account commands:
92
100
 
93
101
  ## Set Up A Project
94
102
 
95
- The desktop app is the default project setup path. Terminal-first users can ask
96
- a coding agent working in the local repository to run:
103
+ The default project setup path has a coding agent working in the local
104
+ repository run:
97
105
 
98
106
  ```bash
99
107
  dvb agent-init
100
108
  ```
101
109
 
102
- The command gives the agent a read-only investigation and planning workflow.
110
+ The setup prompt on the website's **Get started** page adds a login code
111
+ (`dvb agent-init --login-code <code>`) so the CLI signs in without a separate
112
+ browser sign-in. The command gives the agent a read-only investigation and
113
+ planning workflow, and `dvb agent-init accounts` opens a browser page where
114
+ the user connects Codex or Claude Code before launch.
103
115
  The agent prepares a manifest with you, checks it, and asks for explicit
104
116
  approval before `dvb agent-init run` uploads files or creates a Template box.
105
117
  The current version-3 manifest also lets the agent design startup and teardown
@@ -185,27 +197,10 @@ dvb connect <devbox> -n server
185
197
  dvb connect <devbox> --command "npm test"
186
198
  ```
187
199
 
188
- Managed CLI attachments replay prior output when you reconnect.
200
+ CLI attachments replay prior output when you reconnect.
189
201
 
190
202
  Use `dvb sessions` to list, rename, or kill persistent terminal sessions.
191
203
 
192
- For the lowest connection latency, use:
193
-
194
- ```bash
195
- dvb connect <devbox> --transport direct
196
- ```
197
-
198
- Direct mode attaches an interactive terminal session using Mosh's encrypted UDP
199
- transport after negotiating a direct network path. It does not use SSH. Direct
200
- and Managed attach the same persistent terminal sessions, so names such as
201
- `<devbox>/server` or `-n server` work in either mode and a session created in
202
- one can be reattached through the other. Closing the Direct client detaches
203
- without ending the underlying session. Direct remains interactive-only, so
204
- one-off commands and detached-session creation use Managed. It reports an error
205
- when the installed CLI lacks its matching native component or the machine needs
206
- an update; it never uses a system Mosh installation or silently falls back to
207
- Managed.
208
-
209
204
  For a noninteractive exact-argv command, use:
210
205
 
211
206
  ```bash
@@ -290,6 +290,14 @@ threads, new-devbox placeholders, and automation views all use the same detail
290
290
  area. A Codex or Claude thread can switch between GUI and the CLI from its
291
291
  header without becoming a different thread.
292
292
 
293
+ Agent replies can include blue pills pointing to controls or settings. Hover
294
+ one to see its location, then click to reveal and highlight the item. A
295
+ reference can open a settings section or menu, but does not activate the
296
+ highlighted action or change a setting. After a detail-page detour, **Back to
297
+ thread** returns to the conversation at its bottom. On mobile, tapping a
298
+ reference explains where to find it on desktop. See `ui-references.md` for
299
+ authoring guidance and supported destinations.
300
+
293
301
  Mermaid code blocks in Codex and Claude replies appear as diagrams. Use the
294
302
  diagram's controls to copy its source, expand it for zooming, or download an
295
303
  SVG. A diagram loads after the agent finishes its code block; if it cannot be
@@ -543,6 +551,10 @@ On macOS, the app clears recognized leftover update downloads and installation
543
551
  files from older releases when it starts. Files for the current release or a
544
552
  pending newer update remain available until the updater finishes with them.
545
553
 
554
+ If a downloaded update fails to install, the app does not download that same
555
+ version again in the background. Choose **Check for Updates…** in the app menu
556
+ to try it again; newer versions still download automatically.
557
+
546
558
  Use the Help button next to your account identity at the bottom of the left pane
547
559
  for quick troubleshooting tips and to send product feedback, when the button is
548
560
  shown.
@@ -66,6 +66,8 @@ Use this terminology consistently:
66
66
  - `desktop-workbench.md`: the desktop app layout, thread list, transcript pane,
67
67
  Template box page, terminal pane, files, ports, runtime controls, and settings
68
68
  entry points.
69
+ - `ui-references.md`: supported inline references for showing users where
70
+ desktop controls, settings, and other threads live while explaining them.
69
71
  - `files-git-and-review.md`: file viewer, diffs, media/download handling,
70
72
  upload/download transfers, review comments, git status, staging, commits,
71
73
  amend, history, branches, and multi-repo behavior.
@@ -313,10 +313,10 @@ Mobile settings include:
313
313
  in the browser.
314
314
 
315
315
  Someone opening your invite link can sign up with Google in their phone
316
- browser. After signing up on a phone, they will see that setup happens on
317
- their Mac, where to find the setup steps in their email, and a link to install
318
- the mobile app. Signing up on a computer continues straight to first-project
319
- setup in the web app.
316
+ browser. After signing up on a phone, they will see that their coding agent
317
+ will set up the project on the computer where their code lives, with actions
318
+ to email, copy, or share a link to the setup page. Signing up on a computer
319
+ continues straight to the web app's **Get started** page.
320
320
 
321
321
  Thread text size defaults to **Medium** for transcript and message text on this
322
322
  device. Choose **Compact**, **Medium**, or **Large** in **Settings → Appearance**.
@@ -51,6 +51,8 @@ Common terminal actions:
51
51
 
52
52
  Closing a terminal tab ends that terminal session. Closing the desktop app
53
53
  preserves open terminal sessions and restores their tabs when you reopen it.
54
+ Opening a session in another window or device replaces only that session's
55
+ current attachment.
54
56
 
55
57
  ### Command History
56
58
 
@@ -76,16 +78,7 @@ a terminal. Without Project storage, Bash will continue using local history.
76
78
  Anyone with access to the project's storage can read its history, so avoid
77
79
  recording secrets in commands.
78
80
 
79
- ### Connections And Terminal Input
80
-
81
- **Desktop app settings > Connection** includes a Terminal Connection choice.
82
- Managed is the default attachment transport. Direct (Mosh) negotiates an
83
- encrypted UDP path for the lowest latency and repairs that path if connectivity
84
- changes. Both choices use the same persistent terminal sessions: tabs created
85
- in either mode are restored after reopening the app and can be attached through
86
- the other mode. Opening one session elsewhere replaces only that session's
87
- current attachment. Direct reports an error rather than falling back to Managed
88
- when its native component or the required remote support is unavailable.
81
+ ### Terminal Input
89
82
 
90
83
  Terminal tabs can show unread-output or attention indicators, including bell
91
84
  alerts when terminal notification settings allow them.
@@ -95,7 +88,7 @@ Paste a clipboard image into a desktop terminal with **Cmd+V** on macOS,
95
88
  (**Ctrl+V** on macOS/Linux, **Alt+V** on Windows) also works. boxes.dev will
96
89
  upload the image to the selected machine and paste its file path. Claude Code
97
90
  will recognize that path as an image attachment; a shell will receive the path
98
- without running a command. This works with Managed and Direct connections.
91
+ without running a command.
99
92
  PNG and JPEG images are supported, up to 20 MiB per image and 50 MiB per paste.
100
93
  If an upload fails, paste again before resubmitting your prompt.
101
94