@boxes-dev/dvb-runtime 1.0.1106 → 1.0.1107
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/dvb.mjs +1689 -1155
- package/dist/bin/dvbd.mjs +25 -21
- package/dist/product-docs/references/automations.md +22 -4
- package/dist/product-docs/references/cli.md +50 -5
- package/dist/product-docs/references/desktop-workbench.md +8 -2
- package/dist/product-docs/references/environment-setup-validation.md +12 -4
- package/dist/product-docs/references/fork-workflows.md +9 -5
- package/dist/product-docs/references/getting-started.md +3 -0
- package/dist/product-docs/references/mobile.md +33 -10
- package/dist/product-docs/references/onbox-agent-tools.md +80 -21
- package/dist/product-docs/references/ports-terminal-and-runtime.md +7 -0
- package/dist/product-docs/references/project-setup.md +35 -5
- package/dist/product-docs/references/remote-assistants.md +9 -0
- package/dist/product-docs/references/template-box-environment.md +7 -0
- package/dist/product-docs/references/threads-and-agents.md +102 -2
- package/dist/product-docs/references/troubleshooting.md +4 -0
- package/package.json +2 -2
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]="
|
|
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]="c3df6e8d-08ba-56d3-b8e3-c7c2f15f6900")}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";
|
|
@@ -4078,7 +4078,7 @@ var init_githubGhCredentials = __esm({
|
|
|
4078
4078
|
|
|
4079
4079
|
// ../../../../shared/devboxCore/dist/loopbackServer.js
|
|
4080
4080
|
import net from "node:net";
|
|
4081
|
-
var MAX_PORT, MAX_LOOPBACK_PORT_SHIFT, nextCandidatePort, isRetryableListenError,
|
|
4081
|
+
var MAX_PORT, MAX_LOOPBACK_PORT_SHIFT, nextCandidatePort, isRetryableListenError, probeIpv6Loopback, listenOnLoopbackPort;
|
|
4082
4082
|
var init_loopbackServer = __esm({
|
|
4083
4083
|
"../../../../shared/devboxCore/dist/loopbackServer.js"() {
|
|
4084
4084
|
"use strict";
|
|
@@ -4088,10 +4088,10 @@ var init_loopbackServer = __esm({
|
|
|
4088
4088
|
isRetryableListenError = (error4) => {
|
|
4089
4089
|
return error4.code === "EADDRINUSE" || error4.code === "EACCES" || error4.code === "EADDRNOTAVAIL";
|
|
4090
4090
|
};
|
|
4091
|
-
|
|
4091
|
+
probeIpv6Loopback = async (port) => await new Promise((resolve2, reject) => {
|
|
4092
4092
|
const server = net.createServer();
|
|
4093
4093
|
let settled = false;
|
|
4094
|
-
const finalize2 = (
|
|
4094
|
+
const finalize2 = (state) => {
|
|
4095
4095
|
if (settled) {
|
|
4096
4096
|
return;
|
|
4097
4097
|
}
|
|
@@ -4101,25 +4101,29 @@ var init_loopbackServer = __esm({
|
|
|
4101
4101
|
} catch {
|
|
4102
4102
|
}
|
|
4103
4103
|
if (!server.listening) {
|
|
4104
|
-
resolve2(
|
|
4104
|
+
resolve2(state);
|
|
4105
4105
|
return;
|
|
4106
4106
|
}
|
|
4107
|
-
server.close(() => resolve2(
|
|
4107
|
+
server.close(() => resolve2(state));
|
|
4108
4108
|
};
|
|
4109
4109
|
server.once("error", (error4) => {
|
|
4110
|
-
if (error4.code === "
|
|
4111
|
-
finalize2(
|
|
4110
|
+
if (error4.code === "EACCES") {
|
|
4111
|
+
finalize2("permission_denied");
|
|
4112
|
+
return;
|
|
4113
|
+
}
|
|
4114
|
+
if (error4.code === "EAFNOSUPPORT" || error4.code === "EADDRNOTAVAIL" || error4.code === "EADDRINUSE") {
|
|
4115
|
+
finalize2("unavailable");
|
|
4112
4116
|
return;
|
|
4113
4117
|
}
|
|
4114
4118
|
reject(error4);
|
|
4115
4119
|
});
|
|
4116
4120
|
server.once("listening", () => {
|
|
4117
|
-
finalize2(
|
|
4121
|
+
finalize2("available");
|
|
4118
4122
|
});
|
|
4119
4123
|
try {
|
|
4120
4124
|
server.listen({ host: "::1", port });
|
|
4121
4125
|
} catch {
|
|
4122
|
-
finalize2(
|
|
4126
|
+
finalize2("unavailable");
|
|
4123
4127
|
}
|
|
4124
4128
|
});
|
|
4125
4129
|
listenOnLoopbackPort = async ({ createServer: createServer2 = () => net.createServer(), onRetryableConflict, port, shiftLimit = MAX_LOOPBACK_PORT_SHIFT, strategy }) => {
|
|
@@ -4145,11 +4149,11 @@ var init_loopbackServer = __esm({
|
|
|
4145
4149
|
let targetPort = port;
|
|
4146
4150
|
let attempts = 0;
|
|
4147
4151
|
while (attempts <= shiftLimit && targetPort <= MAX_PORT) {
|
|
4148
|
-
const
|
|
4149
|
-
if (
|
|
4152
|
+
const ipv6State = await probeIpv6Loopback(targetPort);
|
|
4153
|
+
if (ipv6State !== "available") {
|
|
4150
4154
|
if (strategy === "canonical_only") {
|
|
4151
4155
|
const error5 = new Error(`localhost:${String(targetPort)} is unavailable on ::1.`);
|
|
4152
|
-
error5.code = "EADDRINUSE";
|
|
4156
|
+
error5.code = ipv6State === "permission_denied" ? "EACCES" : "EADDRINUSE";
|
|
4153
4157
|
server.close();
|
|
4154
4158
|
throw error5;
|
|
4155
4159
|
}
|
|
@@ -64675,9 +64679,9 @@ var init_sentry = __esm({
|
|
|
64675
64679
|
uncaughtExceptionMonitorInstalled = false;
|
|
64676
64680
|
currentDevboxSentryUser = null;
|
|
64677
64681
|
readBuildMetadata = () => {
|
|
64678
|
-
const rawPackageVersion = "1.0.
|
|
64679
|
-
const rawGitSha = "
|
|
64680
|
-
const rawSentryRelease = "boxes-dev-dvb@1.0.
|
|
64682
|
+
const rawPackageVersion = "1.0.1107";
|
|
64683
|
+
const rawGitSha = "636b188006eb986b8be609e74b6a73eb93bc3eb4";
|
|
64684
|
+
const rawSentryRelease = "boxes-dev-dvb@1.0.1107+636b188006eb986b8be609e74b6a73eb93bc3eb4";
|
|
64681
64685
|
const packageVersion = typeof rawPackageVersion === "string" ? rawPackageVersion : void 0;
|
|
64682
64686
|
const gitSha = typeof rawGitSha === "string" ? rawGitSha : void 0;
|
|
64683
64687
|
const sentryRelease = typeof rawSentryRelease === "string" ? rawSentryRelease : void 0;
|
|
@@ -67199,7 +67203,7 @@ var init_packageVersion = __esm({
|
|
|
67199
67203
|
return path8.join(process.cwd(), "dvb");
|
|
67200
67204
|
};
|
|
67201
67205
|
readEmbeddedPackageVersion = () => {
|
|
67202
|
-
const raw = "1.0.
|
|
67206
|
+
const raw = "1.0.1107";
|
|
67203
67207
|
return trimVersion(raw);
|
|
67204
67208
|
};
|
|
67205
67209
|
readNearestPackageMetadata = (basePath) => {
|
|
@@ -77642,7 +77646,7 @@ var init_ports2 = __esm({
|
|
|
77642
77646
|
MAX_PORT_SHIFT = 50;
|
|
77643
77647
|
MIN_UNPRIVILEGED_PORT = 1024;
|
|
77644
77648
|
SUBSCRIPTION_RETRY_DELAY_MS = 1e3;
|
|
77645
|
-
SUBSCRIPTION_RETRY_MAX_DELAY_MS =
|
|
77649
|
+
SUBSCRIPTION_RETRY_MAX_DELAY_MS = 12e4;
|
|
77646
77650
|
SUBSCRIPTION_STALE_DISCONNECT_MS = 5e3;
|
|
77647
77651
|
PORT_LEASE_REFRESH_MS = 2e3;
|
|
77648
77652
|
PORT_LEASE_STALE_AFTER_MS = 1e4;
|
|
@@ -78651,6 +78655,7 @@ var init_ports2 = __esm({
|
|
|
78651
78655
|
let subscription = null;
|
|
78652
78656
|
subscription = await this.knownBoxDiscoveryAdapter.subscribe({
|
|
78653
78657
|
onUpdate: (entries) => {
|
|
78658
|
+
this.knownBoxRetryAttempt = 0;
|
|
78654
78659
|
this.syncKnownBoxes(entries);
|
|
78655
78660
|
},
|
|
78656
78661
|
onError: (error4) => {
|
|
@@ -78670,7 +78675,6 @@ var init_ports2 = __esm({
|
|
|
78670
78675
|
clearTimeout(this.knownBoxRetryTimer);
|
|
78671
78676
|
this.knownBoxRetryTimer = null;
|
|
78672
78677
|
}
|
|
78673
|
-
this.knownBoxRetryAttempt = 0;
|
|
78674
78678
|
this.knownBoxSubscription = subscription;
|
|
78675
78679
|
this.maybeEnsureControlPlaneStateSubscription();
|
|
78676
78680
|
const current = subscription.getCurrentValue();
|
|
@@ -78957,6 +78961,7 @@ var init_ports2 = __esm({
|
|
|
78957
78961
|
box,
|
|
78958
78962
|
instanceId: this.getBoxInstanceId(box),
|
|
78959
78963
|
onUpdate: (entries) => {
|
|
78964
|
+
this.subscriptionRetryAttempts.delete(box);
|
|
78960
78965
|
this.syncFromSnapshot(box, entries);
|
|
78961
78966
|
},
|
|
78962
78967
|
onError: (error4) => {
|
|
@@ -78983,7 +78988,6 @@ var init_ports2 = __esm({
|
|
|
78983
78988
|
clearTimeout(retryTimer);
|
|
78984
78989
|
this.subscriptionRetryTimers.delete(box);
|
|
78985
78990
|
}
|
|
78986
|
-
this.subscriptionRetryAttempts.delete(box);
|
|
78987
78991
|
this.subscriptions.set(box, subscription);
|
|
78988
78992
|
this.subscriptionTargetKeys.set(box, subscriptionTargetKey);
|
|
78989
78993
|
this.maybeEnsureControlPlaneStateSubscription();
|
|
@@ -80404,4 +80408,4 @@ smol-toml/dist/index.js:
|
|
|
80404
80408
|
*)
|
|
80405
80409
|
*/
|
|
80406
80410
|
|
|
80407
|
-
//# debugId=
|
|
80411
|
+
//# debugId=c3df6e8d-08ba-56d3-b8e3-c7c2f15f6900
|
|
@@ -44,6 +44,11 @@ API endpoint appears below the prompt.
|
|
|
44
44
|
New automations start with the same agent, model, reasoning, and speed defaults
|
|
45
45
|
that a new project thread would use.
|
|
46
46
|
|
|
47
|
+
For Codex new-thread runs, **Provider** above the prompt selects OpenAI or a
|
|
48
|
+
saved model provider connection. Add keys in **Configure agents**, then choose
|
|
49
|
+
the connection and one of its models here. Reasoning and speed controls appear
|
|
50
|
+
only where supported; a model without a reasoning control needs no effort.
|
|
51
|
+
|
|
47
52
|
For drafts with **Only when I click Run now** or **On a schedule** selected,
|
|
48
53
|
**Thread** lets you keep **New devbox and thread on each run** or select an
|
|
49
54
|
existing conversation you own in this project. Search by title to find a thread.
|
|
@@ -77,6 +82,11 @@ on your device, so they survive a page refresh, and are not shared with other
|
|
|
77
82
|
devices or people. If the automation changed somewhere else while you had
|
|
78
83
|
unsaved edits, boxes.dev warns you before you save over the newer version.
|
|
79
84
|
|
|
85
|
+
Changing a Codex provider applies to future new-thread runs. Earlier runs keep
|
|
86
|
+
their original connection. If a key is disconnected, reconnect it in Configure
|
|
87
|
+
agents before running again, or choose another connection for future runs.
|
|
88
|
+
You can still rename, pause, or edit unrelated settings while disconnected.
|
|
89
|
+
|
|
80
90
|
An automation targeting an existing thread keeps that thread in its current
|
|
81
91
|
location. New-thread placement, model controls, completion preferences, Slack
|
|
82
92
|
outputs, and devbox cleanup do not apply to these runs.
|
|
@@ -189,7 +199,12 @@ spawned thread without renaming the automation. If `execution` is supplied,
|
|
|
189
199
|
it is a complete agent selection rather than a partial merge:
|
|
190
200
|
|
|
191
201
|
- Codex requires `backend`, `model`, and `reasoningEffort`. `serviceTier` is
|
|
192
|
-
optional and defaults to `standard`;
|
|
202
|
+
optional and defaults to `standard`; supported OpenAI models also offer
|
|
203
|
+
`fast` and `ultrafast`. Set `codexProviderConnectionId` to an owned saved
|
|
204
|
+
connection ID to use its model. Within a supplied `execution` object,
|
|
205
|
+
omitting that field or setting it to `null` selects OpenAI, even if the
|
|
206
|
+
automation has a different saved provider. Provider models use standard
|
|
207
|
+
speed, and models without a reasoning control use `reasoningEffort: null`.
|
|
193
208
|
- Claude Code requires `backend`, `model`, and `reasoningEffort`. Models
|
|
194
209
|
without a reasoning control use `null`. `serviceTier` is optional and
|
|
195
210
|
defaults to `standard`; set it to `fast` to use fast mode on a model that
|
|
@@ -197,8 +212,11 @@ it is a complete agent selection rather than a partial merge:
|
|
|
197
212
|
|
|
198
213
|
The values use the same model, reasoning, and speed controls as normal threads
|
|
199
214
|
and automation defaults. Invalid fields, unknown fields, unsupported
|
|
200
|
-
combinations, or incomplete `execution` objects are rejected
|
|
201
|
-
|
|
215
|
+
combinations, or incomplete `execution` objects are rejected. A disconnected
|
|
216
|
+
or unavailable provider connection records an actionable failed run before
|
|
217
|
+
creating a devbox. The API does not accept raw Codex or Claude CLI arguments.
|
|
218
|
+
Copy **Request examples** from the editor to get the selected connection ID
|
|
219
|
+
and model controls without including its API key.
|
|
202
220
|
|
|
203
221
|
Fixed API triggers accept only `{}`. Switching an existing fixed trigger to
|
|
204
222
|
configurable requests rotates its secret because the new secret can submit
|
|
@@ -370,7 +388,7 @@ Expanding a nested automation loads its most recent runs in pages. Choose
|
|
|
370
388
|
cleanup remain openable beneath the automation even when they are older than
|
|
371
389
|
the thread list's currently loaded history.
|
|
372
390
|
|
|
373
|
-
Each run keeps the full prompt, spawned-thread title, agent, model, reasoning,
|
|
391
|
+
Each run keeps the full prompt, spawned-thread title, agent, provider connection, model, reasoning,
|
|
374
392
|
and speed controls it started with. The run detail identifies whether its
|
|
375
393
|
prompt came from the saved automation, an API request, or trigger context.
|
|
376
394
|
Editing the automation later affects future runs, not existing run history.
|
|
@@ -152,6 +152,33 @@ opaque continuation cursor. Add `--all` only for a complete inventory.
|
|
|
152
152
|
|
|
153
153
|
See `dvb agent-docs agent-tools` for the complete safe workflow.
|
|
154
154
|
|
|
155
|
+
### Choose settings for a scripted thread
|
|
156
|
+
|
|
157
|
+
List the available agents, models, and saved provider connections before
|
|
158
|
+
starting a thread:
|
|
159
|
+
|
|
160
|
+
```bash
|
|
161
|
+
dvb threads options --json
|
|
162
|
+
dvb threads start --project <project> --target new-devbox --agent codex \
|
|
163
|
+
--provider <connection-id> --model <model-id> \
|
|
164
|
+
--prompt-file <path> --idempotency-key <key> --json
|
|
165
|
+
```
|
|
166
|
+
|
|
167
|
+
For Codex, `--provider openai` selects OpenAI; a connection ID from
|
|
168
|
+
`codexProviders` selects that saved connection. Its `models` list contains
|
|
169
|
+
the exact model IDs and reasoning choices for that connection. The `codex`
|
|
170
|
+
and `claude` lists contain the ordinary OpenAI and Claude choices.
|
|
171
|
+
|
|
172
|
+
Without selection flags, a start uses the target box's saved settings, or the
|
|
173
|
+
project's source settings for a new devbox. A bare `--model` stays within that
|
|
174
|
+
saved provider. Changing the model uses its default reasoning and Standard
|
|
175
|
+
speed; naming the already selected model preserves its settings. Use
|
|
176
|
+
`--reasoning-effort` or `--speed` only for supported choices. An explicit
|
|
177
|
+
`--provider` starts from that provider's default model and reasoning, with
|
|
178
|
+
Standard speed, before applying the other flags. Omit `--reasoning-effort`
|
|
179
|
+
for models with no effort choices. Provider selection is Codex-only, and a
|
|
180
|
+
started thread keeps its provider connection.
|
|
181
|
+
|
|
155
182
|
## Configure Devbox Lifecycle And Template Maintenance
|
|
156
183
|
|
|
157
184
|
A signed-in coding agent on your computer can inspect and edit a project's
|
|
@@ -345,15 +372,28 @@ border and the current agent settings on one status line. Press `Tab` (or
|
|
|
345
372
|
`Shift+Tab`) to move focus across those settings like form fields: arrow keys
|
|
346
373
|
change the focused value, typing jumps to a matching option by name, and `Esc`
|
|
347
374
|
returns to the prompt. Typing `/` as the first character of the prompt opens a
|
|
348
|
-
command menu (`/agent`, `/model`, `/reasoning`, `/speed`,
|
|
349
|
-
jumps to the same controls: arrows choose a command, `Tab`
|
|
350
|
-
Enter runs it. Press `?` from an empty prompt for all
|
|
375
|
+
command menu (`/agent`, `/provider`, `/model`, `/reasoning`, `/speed`,
|
|
376
|
+
`/shortcuts`) that jumps to the same controls: arrows choose a command, `Tab`
|
|
377
|
+
completes it, and Enter runs it. Press `?` from an empty prompt for all
|
|
378
|
+
composer shortcuts.
|
|
379
|
+
|
|
380
|
+
For a Codex draft, `/provider` chooses OpenAI or a connection saved in
|
|
381
|
+
**Configure agents**. It appears when a provider choice is available. Model
|
|
382
|
+
and reasoning choices belong to the selected connection; unsupported
|
|
383
|
+
reasoning and speed controls are omitted. Reselecting the current provider
|
|
384
|
+
or model keeps the current settings. Choosing a different provider selects
|
|
385
|
+
its default model and reasoning; choosing a different model within the same
|
|
386
|
+
provider selects that model's default reasoning. Either change uses Standard
|
|
387
|
+
speed. Once the thread starts, its provider connection is fixed; supported
|
|
388
|
+
model and reasoning changes stay within that connection. An unavailable
|
|
389
|
+
connection remains selected until you reconnect it or choose another provider
|
|
390
|
+
for a new draft.
|
|
351
391
|
|
|
352
392
|
Enter starts the thread in the background, and `Ctrl+O` starts it and opens the
|
|
353
393
|
terminal interface as soon as it is ready. The Codex or Claude choice is shared
|
|
354
394
|
for the project with desktop and mobile, so a change from any surface becomes
|
|
355
|
-
the default for the next new draft on every surface.
|
|
356
|
-
speed defaults are shared per Template box or devbox. A new-devbox draft uses
|
|
395
|
+
the default for the next new draft on every surface. Provider, model, reasoning,
|
|
396
|
+
and speed defaults are shared per Template box or devbox. A new-devbox draft uses
|
|
357
397
|
the project's source defaults until the devbox exists. Claude CLI remains a
|
|
358
398
|
surface-specific Claude mode. Press `Esc` before submission to discard a blank
|
|
359
399
|
draft or keep a non-blank draft; while waiting for `Ctrl+O`, `Esc` cancels only
|
|
@@ -438,6 +478,11 @@ empty native Codex or Claude interface so you can type and submit the first
|
|
|
438
478
|
message there. If the project is omitted, the CLI auto-selects the only project
|
|
439
479
|
or shows the same project picker as `dvb agents`.
|
|
440
480
|
|
|
481
|
+
New starts use the saved agent settings for the selected box, or the project's
|
|
482
|
+
source settings for a new devbox. For Codex, those settings include its provider
|
|
483
|
+
connection, model, and reasoning. Resuming a thread keeps its existing provider
|
|
484
|
+
connection even if new-thread defaults have changed.
|
|
485
|
+
|
|
441
486
|
When starting a new thread without `--devbox`, the command creates a devbox from
|
|
442
487
|
the project's current reusable source. For an independent project, that is the
|
|
443
488
|
latest completed Template-box snapshot; if none exists, the command asks you to
|
|
@@ -309,7 +309,7 @@ box has no live metrics.
|
|
|
309
309
|
|
|
310
310
|
Choose the gear on the sidebar's **Project** header for
|
|
311
311
|
settings that belong to the project rather than to a particular box. This
|
|
312
|
-
page contains **Project storage**, **Git**, **Agent
|
|
312
|
+
page contains **Project storage**, **Browser**, **Git**, **Agent
|
|
313
313
|
permissions for this project**, **Devbox lifecycle**, and **Agent settings**,
|
|
314
314
|
including the project's preferred Git action, commit thread-link behavior,
|
|
315
315
|
startup script, shared agent guidance, automatic waking of sleeping machines,
|
|
@@ -631,7 +631,13 @@ selected.
|
|
|
631
631
|
|
|
632
632
|
Browser tabs, cookies, local storage, downloads, uploads, and other profile
|
|
633
633
|
state live on that box, so the user and agents can share the same web
|
|
634
|
-
session.
|
|
634
|
+
session. Sites see the Browser coming from a cloud data center IP address, and
|
|
635
|
+
some of them treat sign-ins or traffic from that address as suspicious.
|
|
636
|
+
**Project settings → Browser** has a **Use the Browser** switch, on by default.
|
|
637
|
+
While it's off, the Browser is hidden on every box in the project, agents there
|
|
638
|
+
can't use it (Browser API calls return HTTP 403 `agent_browser_disabled`), and
|
|
639
|
+
each box keeps its tabs and sign-ins. The
|
|
640
|
+
Browser pane supports ordinary page interaction, file chooser
|
|
635
641
|
prompts, downloads into the box, permission prompts, browser dialogs, and
|
|
636
642
|
profile reset. **Restart browser** asks for confirmation, then opens one blank
|
|
637
643
|
tab while preserving sign-ins and saved profile data. Check **Restore open
|
|
@@ -28,10 +28,18 @@ branch, usually `main`, regardless of the Template box's current branch or
|
|
|
28
28
|
files. Use another saved starting branch when the user requests it. Inheriting
|
|
29
29
|
the Template box's saved checkout should be a deliberate user choice.
|
|
30
30
|
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
31
|
+
Checking out `main` on the Template box doesn't configure the defaults. Read
|
|
32
|
+
them back from `settings.defaultBranches` in
|
|
33
|
+
`dvb-onbox project settings get --json`. If they're missing or differ from a
|
|
34
|
+
remote starting branch during setup, save the chosen branch with a
|
|
35
|
+
`default_branches` edit (see
|
|
36
|
+
[Project And Team Template Settings](onbox-agent-tools.md#project-and-team-template-settings)).
|
|
37
|
+
The setup thread doesn't need a permission grant for it; read the defaults
|
|
38
|
+
back afterwards. Leave them unsaved for a local-only branch or when an
|
|
39
|
+
intentional custom startup script switches branches itself. Don't wait for the
|
|
40
|
+
user, and say in the summary what new devboxes will start on. Follow
|
|
41
|
+
[Project setup](project-setup.md) for the setup flow's generated Git
|
|
42
|
+
declaration. Keep dependency,
|
|
35
43
|
environment, and service commands after branch preparation, and remove custom
|
|
36
44
|
commands that switch branches or reset away the selected code.
|
|
37
45
|
|
|
@@ -65,6 +65,11 @@ Devbox lifecycle → Default branch**. Clearing or restoring startup commands
|
|
|
65
65
|
keeps the branch defaults.
|
|
66
66
|
Existing projects without configured defaults can keep the branch saved in
|
|
67
67
|
the Template box snapshot by choosing **From Template box**.
|
|
68
|
+
They can also add defaults in **Project settings → Devbox lifecycle**, which
|
|
69
|
+
shows an empty branch field for each known repository and needs a branch for
|
|
70
|
+
every one. Once saved, new devboxes fetch those branches and match their latest
|
|
71
|
+
commits, discarding the snapshot's uncommitted changes and untracked files that
|
|
72
|
+
Git doesn't ignore.
|
|
68
73
|
|
|
69
74
|
Projects using the generated Git startup commands retain their existing reset
|
|
70
75
|
and clean behavior on the new devbox: tracked files match the fetched branch,
|
|
@@ -419,11 +424,10 @@ information is available. It also names the pull requests whose automatic
|
|
|
419
424
|
follow-ups the devbox's threads handle. Destroying the devbox stops those
|
|
420
425
|
follow-ups, and the pull request shows them as paused until a restored or
|
|
421
426
|
other thread turns them on again. As soon as the destroy starts, the devbox's
|
|
422
|
-
threads move
|
|
423
|
-
**Archived threads** at the end of the project on mobile
|
|
424
|
-
|
|
425
|
-
|
|
426
|
-
threads are grouped there under the destroyed devbox's name.
|
|
427
|
+
threads move under its name in **Devboxes** → **Archived threads** on desktop
|
|
428
|
+
and in **Archived threads** at the end of the project on mobile. The
|
|
429
|
+
cold-storage archive finishes in the background; if it fails, the threads
|
|
430
|
+
return to the active list untouched.
|
|
427
431
|
Archived automation runs stay in their automation's **Archived** group on
|
|
428
432
|
desktop, with their threads directly beneath the run's devbox. `dvb agents`
|
|
429
433
|
shows the threads in its archived section throughout. Preserving the
|
|
@@ -70,6 +70,9 @@ The recommended boxes.dev workflow is:
|
|
|
70
70
|
The desktop app is the main workbench. It is available for macOS
|
|
71
71
|
(`https://boxes.dev/mac`) and Linux (`https://boxes.dev/linux`, with .deb,
|
|
72
72
|
.rpm, and AppImage packages).
|
|
73
|
+
The main Mac download is for Apple Silicon and requires macOS 12 or later.
|
|
74
|
+
The included PostgreSQL tools for copying a local database require macOS 13
|
|
75
|
+
or later.
|
|
73
76
|
|
|
74
77
|
The left side is the thread list. It groups work on devboxes, automations, and,
|
|
75
78
|
when the project has one, the Template box. New-thread controls let you choose
|
|
@@ -359,12 +359,15 @@ directly from the thread. Image previews fit the available
|
|
|
359
359
|
screen and support pinch zoom and panning with inertial flings and elastic edge
|
|
360
360
|
settling.
|
|
361
361
|
|
|
362
|
-
In a devbox thread, tapping the **Devbox** pill in the header opens
|
|
363
|
-
list of
|
|
364
|
-
|
|
365
|
-
|
|
366
|
-
|
|
367
|
-
conflicts
|
|
362
|
+
In a devbox thread, tapping the **Devbox** pill in the header opens the
|
|
363
|
+
devbox's status and a read-only list of its Git changes. The status names the
|
|
364
|
+
state behind the pill's colored dot, such as **Running**, **Sleeping**,
|
|
365
|
+
**Waking**, **Upgrading**, or **Upgrade failed**. A red dot means the latest
|
|
366
|
+
boxes.dev update didn't install on the devbox. The Git list shows each
|
|
367
|
+
repository's branch, merge conflicts, commits that haven't been pushed, and
|
|
368
|
+
changed files with added and removed line counts. Tapping a changed file opens
|
|
369
|
+
its diff in the file viewer. A warning icon in the pill or the thread row means
|
|
370
|
+
a repository has unresolved merge conflicts.
|
|
368
371
|
|
|
369
372
|
Large downloads may open through the browser, and they arrive with the file's
|
|
370
373
|
real name and extension so your phone can open them in the right app. Full
|
|
@@ -389,7 +392,8 @@ Choose **… → Browser** in a thread's header to open Browser on that
|
|
|
389
392
|
thread's devbox or Template box, waking it if it's asleep. It is the same
|
|
390
393
|
Chromium session as the desktop Browser pane, with the same tabs, signed-in
|
|
391
394
|
sites, and profile, and agents on the box use it too. If the box's browser
|
|
392
|
-
isn't running yet, opening Browser starts it.
|
|
395
|
+
isn't running yet, opening Browser starts it. The menu leaves out **Browser**
|
|
396
|
+
while the project's Browser is turned off in Project settings.
|
|
393
397
|
|
|
394
398
|
Opening Browser on a phone resizes that shared browser to the phone's page
|
|
395
399
|
area, so sites use their narrow-screen layout. It is a size change only: sites
|
|
@@ -485,12 +489,14 @@ exceptions listed after this list:
|
|
|
485
489
|
- under **Project**: **Devbox lifecycle** (agent guidance, startup and
|
|
486
490
|
teardown scripts with their timeouts, the first prompt prefix, and the
|
|
487
491
|
default branch new devboxes check out for each repository, each edited on
|
|
488
|
-
its own screen
|
|
492
|
+
its own screen; a project without saved branches sets the first ones for
|
|
493
|
+
every repository on one screen), **Environment files** (set, replace, or remove
|
|
489
494
|
values and variables in files already added; in a Team Template project,
|
|
490
495
|
the member's values, their own variables, and their own replacement for a
|
|
491
496
|
Team value where the team allows one), **Member files** (Team
|
|
492
497
|
Template projects only: upload, replace, approve at a moved destination, or
|
|
493
|
-
remove), **Project storage**,
|
|
498
|
+
remove), **Project storage**, **Browser** (the **Use the Browser** switch
|
|
499
|
+
described in `desktop-workbench.md`), and **Git** (preferred Git action, thread links
|
|
494
500
|
in commits, automatic pull request follow-ups, and the default follow-up
|
|
495
501
|
events);
|
|
496
502
|
- under **Integrations**, which matches the desktop app's Integrations tool:
|
|
@@ -512,7 +518,8 @@ include:
|
|
|
512
518
|
|
|
513
519
|
- account sign-in and sign-out, adding another account, and switching between
|
|
514
520
|
signed-in accounts;
|
|
515
|
-
- **Agent accounts**, for the Codex and Claude accounts
|
|
521
|
+
- **Agent accounts**, for the Codex and Claude accounts and Codex model
|
|
522
|
+
providers your devboxes use;
|
|
516
523
|
- billing usage summary;
|
|
517
524
|
- an invite link and QR code you can share with someone who wants to try
|
|
518
525
|
boxes.dev (the same link is on the Account page in the web app);
|
|
@@ -560,6 +567,22 @@ login is saved, the **Allow claude.ai connectors** switch below the Claude
|
|
|
560
567
|
accounts controls whether Claude can use the connectors added on claude.ai. A
|
|
561
568
|
change takes effect the next time Claude starts.
|
|
562
569
|
|
|
570
|
+
For OpenRouter, Vercel AI Gateway or a custom endpoint, tap **Add** beside Codex,
|
|
571
|
+
then **Model provider**. Tap **Provider** to choose the host, enter the API key
|
|
572
|
+
and an optional connection name, then tap **Save**. **Custom endpoint
|
|
573
|
+
(advanced)** also requires a base URL, model ID and context size; leave its key
|
|
574
|
+
empty only when the endpoint requires no authentication. Saving validates the
|
|
575
|
+
configuration without making an inference request.
|
|
576
|
+
|
|
577
|
+
Model providers appear below the OpenAI accounts, without an account-selection
|
|
578
|
+
checkmark. Tap a provider row for **Rename**, **Replace key**, or **Disconnect**.
|
|
579
|
+
After disconnecting, **Reconnect** will accept a replacement key for the same
|
|
580
|
+
connection. **Remove connection** will delete a disconnected or no-auth
|
|
581
|
+
connection; its existing threads will remain readable, but continuing work
|
|
582
|
+
will need a new thread. Model-provider keys and the selected OpenAI account
|
|
583
|
+
remain available independently. See `threads-and-agents.md`, Codex model
|
|
584
|
+
providers, for supported models, billing and endpoint requirements.
|
|
585
|
+
|
|
563
586
|
To sign in to Codex, tap **Log in with ChatGPT**. The app shows a one-time
|
|
564
587
|
code, and **Open ChatGPT** copies it and opens the ChatGPT device sign-in page.
|
|
565
588
|
Sign in there if asked and paste the code. Codex will connect after you
|