@boxes-dev/dvb-runtime 1.0.1107 → 1.0.1109
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 +46 -9
- package/dist/bin/dvbd.mjs +4 -4
- package/dist/product-docs/references/desktop-workbench.md +2 -1
- package/dist/product-docs/references/files-git-and-review.md +11 -2
- package/dist/product-docs/references/fork-workflows.md +8 -0
- package/dist/product-docs/references/mobile.md +13 -3
- package/dist/product-docs/references/ports-terminal-and-runtime.md +10 -6
- package/dist/product-docs/references/threads-and-agents.md +62 -19
- package/dist/product-docs/references/troubleshooting.md +17 -5
- package/package.json +2 -2
package/dist/bin/dvb.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]="978460d9-199a-590d-8ec9-93f70fc1cb62")}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";
|
|
@@ -70400,9 +70400,9 @@ var init_sentry = __esm({
|
|
|
70400
70400
|
uncaughtExceptionMonitorInstalled = false;
|
|
70401
70401
|
currentDevboxSentryUser = null;
|
|
70402
70402
|
readBuildMetadata = () => {
|
|
70403
|
-
const rawPackageVersion = "1.0.
|
|
70404
|
-
const rawGitSha = "
|
|
70405
|
-
const rawSentryRelease = "boxes-dev-dvb@1.0.
|
|
70403
|
+
const rawPackageVersion = "1.0.1109";
|
|
70404
|
+
const rawGitSha = "7444b83f1846d03a8b6ae40cc96fcd9586b12ff4";
|
|
70405
|
+
const rawSentryRelease = "boxes-dev-dvb@1.0.1109+7444b83f1846d03a8b6ae40cc96fcd9586b12ff4";
|
|
70406
70406
|
const packageVersion = typeof rawPackageVersion === "string" ? rawPackageVersion : void 0;
|
|
70407
70407
|
const gitSha = typeof rawGitSha === "string" ? rawGitSha : void 0;
|
|
70408
70408
|
const sentryRelease = typeof rawSentryRelease === "string" ? rawSentryRelease : void 0;
|
|
@@ -76046,7 +76046,7 @@ var init_packageVersion = __esm({
|
|
|
76046
76046
|
return path18.join(process.cwd(), "dvb");
|
|
76047
76047
|
};
|
|
76048
76048
|
readEmbeddedPackageVersion = () => {
|
|
76049
|
-
const raw = "1.0.
|
|
76049
|
+
const raw = "1.0.1109";
|
|
76050
76050
|
return trimVersion(raw);
|
|
76051
76051
|
};
|
|
76052
76052
|
readNearestPackageMetadata = (basePath) => {
|
|
@@ -141544,12 +141544,14 @@ var init_threadInventoryBuilder = __esm({
|
|
|
141544
141544
|
devboxFolderId: null,
|
|
141545
141545
|
devboxFolderRevision: 0,
|
|
141546
141546
|
devboxName: null,
|
|
141547
|
+
startedByExecutionInstanceId: null,
|
|
141547
141548
|
ownsForkPlacement: false,
|
|
141548
141549
|
forkOperationId: null,
|
|
141549
141550
|
isFork: false,
|
|
141550
141551
|
forkState: null,
|
|
141551
141552
|
forkPlacementArchived: false,
|
|
141552
141553
|
forkProgressStage: null,
|
|
141554
|
+
forkSlowStartReason: null,
|
|
141553
141555
|
forkExecutionStatusTone: null,
|
|
141554
141556
|
forkBaseCommitSha: null,
|
|
141555
141557
|
forkRepoChangedFileCount: null,
|
|
@@ -141676,12 +141678,16 @@ var init_threadInventoryBuilder = __esm({
|
|
|
141676
141678
|
placement.devboxFolderRevision
|
|
141677
141679
|
);
|
|
141678
141680
|
row.devboxName = normalizeText2(placement.devboxName);
|
|
141681
|
+
row.startedByExecutionInstanceId = normalizeText2(
|
|
141682
|
+
placement.startedByExecutionInstanceId
|
|
141683
|
+
);
|
|
141679
141684
|
row.ownsForkPlacement = ownsForkPlacement;
|
|
141680
141685
|
row.forkOperationId = placement.operationId;
|
|
141681
141686
|
row.isFork = true;
|
|
141682
141687
|
row.forkState = placement.state;
|
|
141683
141688
|
row.forkPlacementArchived = placement.archivedAt !== null;
|
|
141684
141689
|
row.forkProgressStage = placement.progressStage;
|
|
141690
|
+
row.forkSlowStartReason = placement.slowStartReason;
|
|
141685
141691
|
row.forkMode = placement.mode;
|
|
141686
141692
|
row.forkBaseCommitSha = normalizeText2(placement.forkBaseCommitSha);
|
|
141687
141693
|
row.forkRepoChangedFileCount = placement.repoChangedFileCount ?? null;
|
|
@@ -142642,12 +142648,39 @@ var init_threadCreateActions = __esm({
|
|
|
142642
142648
|
}
|
|
142643
142649
|
});
|
|
142644
142650
|
|
|
142651
|
+
// ../../../../shared/threadRuntime/threadSlowStartReason.ts
|
|
142652
|
+
var formatThreadSlowStartReason;
|
|
142653
|
+
var init_threadSlowStartReason = __esm({
|
|
142654
|
+
"../../../../shared/threadRuntime/threadSlowStartReason.ts"() {
|
|
142655
|
+
"use strict";
|
|
142656
|
+
formatThreadSlowStartReason = (reason) => {
|
|
142657
|
+
switch (reason) {
|
|
142658
|
+
case "fresh_snapshot":
|
|
142659
|
+
return "Slower start: fresh snapshot";
|
|
142660
|
+
case "prepared_devbox_failed":
|
|
142661
|
+
return "Slower start: a prepared devbox failed";
|
|
142662
|
+
case "prepared_devboxes_in_use":
|
|
142663
|
+
return "Slower start: prepared devboxes in use";
|
|
142664
|
+
case "prepared_devboxes_updating":
|
|
142665
|
+
return "Slower start: updating prepared devboxes";
|
|
142666
|
+
case "new_snapshot":
|
|
142667
|
+
return "Slower start: very recent snapshot";
|
|
142668
|
+
case "new_team_template_version":
|
|
142669
|
+
return "Slower start: very recent saved version";
|
|
142670
|
+
case "prepared_devboxes_not_ready":
|
|
142671
|
+
return "Slower start: no prepared devbox ready";
|
|
142672
|
+
}
|
|
142673
|
+
};
|
|
142674
|
+
}
|
|
142675
|
+
});
|
|
142676
|
+
|
|
142645
142677
|
// ../../../../shared/threadRuntime/threadStartProgress.ts
|
|
142646
142678
|
var TOTAL_STEPS, resolveConnectingLabel, resolveProgressStage, getForkThreadStartProgress;
|
|
142647
142679
|
var init_threadStartProgress = __esm({
|
|
142648
142680
|
"../../../../shared/threadRuntime/threadStartProgress.ts"() {
|
|
142649
142681
|
"use strict";
|
|
142650
142682
|
init_threadBackendLabels();
|
|
142683
|
+
init_threadSlowStartReason();
|
|
142651
142684
|
TOTAL_STEPS = 6;
|
|
142652
142685
|
resolveConnectingLabel = (backend) => formatThreadBackendConnectingLabel(backend);
|
|
142653
142686
|
resolveProgressStage = ({
|
|
@@ -142666,7 +142699,7 @@ var init_threadStartProgress = __esm({
|
|
|
142666
142699
|
backend,
|
|
142667
142700
|
placementStage,
|
|
142668
142701
|
localStage,
|
|
142669
|
-
|
|
142702
|
+
slowStartReason
|
|
142670
142703
|
}) => {
|
|
142671
142704
|
const stage = resolveProgressStage({ placementStage, localStage });
|
|
142672
142705
|
if (!stage) {
|
|
@@ -142697,7 +142730,7 @@ var init_threadStartProgress = __esm({
|
|
|
142697
142730
|
case "copying_state":
|
|
142698
142731
|
return {
|
|
142699
142732
|
stage,
|
|
142700
|
-
label:
|
|
142733
|
+
label: slowStartReason ? formatThreadSlowStartReason(slowStartReason) : "Copying box state",
|
|
142701
142734
|
currentStep: 2,
|
|
142702
142735
|
totalSteps: TOTAL_STEPS
|
|
142703
142736
|
};
|
|
@@ -143851,7 +143884,9 @@ var init_creationPresentation = __esm({
|
|
|
143851
143884
|
const progress = getForkThreadStartProgress({
|
|
143852
143885
|
backend: status.backend,
|
|
143853
143886
|
placementStage: status.placementProgressStage,
|
|
143854
|
-
localStage
|
|
143887
|
+
localStage,
|
|
143888
|
+
// The agent view status does not carry the reason yet.
|
|
143889
|
+
slowStartReason: null
|
|
143855
143890
|
});
|
|
143856
143891
|
if (status.backend === "claude" && (status.attempt?.phase === "starting_thread" || status.attempt?.phase === "awaiting_durability")) {
|
|
143857
143892
|
return {
|
|
@@ -166873,6 +166908,8 @@ var init_managedClaudeThreadCommands = __esm({
|
|
|
166873
166908
|
"/cd": "/cd is unavailable in this CLI because it moves this thread's Claude transcript. Use /add-dir to give Claude access to another directory.",
|
|
166874
166909
|
"/clear": "/clear is unavailable in this CLI because it switches Claude to a new session. Start a new boxes.dev thread instead.",
|
|
166875
166910
|
"/continue": "/continue is unavailable in this CLI because it switches Claude to a different session. Open that Claude session in its own boxes.dev thread instead.",
|
|
166911
|
+
"/new": "/new is unavailable in this CLI because it switches Claude to a new session. Start a new boxes.dev thread instead.",
|
|
166912
|
+
"/reset": "/reset is unavailable in this CLI because it switches Claude to a new session. Start a new boxes.dev thread instead.",
|
|
166876
166913
|
"/resume": "/resume is unavailable in this CLI because it switches Claude to a different session. Open that Claude session in its own boxes.dev thread instead.",
|
|
166877
166914
|
"/teleport": "/teleport is unavailable in this CLI because it moves work into a different Claude session. Open or create that work in its own boxes.dev thread instead.",
|
|
166878
166915
|
"/tp": "/tp is unavailable in this CLI because it moves work into a different Claude session. Open or create that work in its own boxes.dev thread instead."
|
|
@@ -300909,4 +300946,4 @@ react/cjs/react-jsx-runtime.development.js:
|
|
|
300909
300946
|
*)
|
|
300910
300947
|
*/
|
|
300911
300948
|
|
|
300912
|
-
//# debugId=
|
|
300949
|
+
//# debugId=978460d9-199a-590d-8ec9-93f70fc1cb62
|
package/dist/bin/dvbd.mjs
CHANGED
|
@@ -64679,9 +64679,9 @@ var init_sentry = __esm({
|
|
|
64679
64679
|
uncaughtExceptionMonitorInstalled = false;
|
|
64680
64680
|
currentDevboxSentryUser = null;
|
|
64681
64681
|
readBuildMetadata = () => {
|
|
64682
|
-
const rawPackageVersion = "1.0.
|
|
64683
|
-
const rawGitSha = "
|
|
64684
|
-
const rawSentryRelease = "boxes-dev-dvb@1.0.
|
|
64682
|
+
const rawPackageVersion = "1.0.1109";
|
|
64683
|
+
const rawGitSha = "7444b83f1846d03a8b6ae40cc96fcd9586b12ff4";
|
|
64684
|
+
const rawSentryRelease = "boxes-dev-dvb@1.0.1109+7444b83f1846d03a8b6ae40cc96fcd9586b12ff4";
|
|
64685
64685
|
const packageVersion = typeof rawPackageVersion === "string" ? rawPackageVersion : void 0;
|
|
64686
64686
|
const gitSha = typeof rawGitSha === "string" ? rawGitSha : void 0;
|
|
64687
64687
|
const sentryRelease = typeof rawSentryRelease === "string" ? rawSentryRelease : void 0;
|
|
@@ -67203,7 +67203,7 @@ var init_packageVersion = __esm({
|
|
|
67203
67203
|
return path8.join(process.cwd(), "dvb");
|
|
67204
67204
|
};
|
|
67205
67205
|
readEmbeddedPackageVersion = () => {
|
|
67206
|
-
const raw = "1.0.
|
|
67206
|
+
const raw = "1.0.1109";
|
|
67207
67207
|
return trimVersion(raw);
|
|
67208
67208
|
};
|
|
67209
67209
|
readNearestPackageMetadata = (basePath) => {
|
|
@@ -507,7 +507,8 @@ The same menu, including the thread header's menu, offers **Mute
|
|
|
507
507
|
notifications**. A muted thread shows a bell-off icon after its title, and its
|
|
508
508
|
finished turns don't notify you or mark it unread; requests for input still
|
|
509
509
|
do. **Mark unread** on a muted thread lasts until you open it or its next turn
|
|
510
|
-
finishes. **Unmute notifications** turns them back on.
|
|
510
|
+
finishes. **Unmute notifications** turns them back on. A devbox collapses two or
|
|
511
|
+
more muted threads into a slim row below its other threads.
|
|
511
512
|
|
|
512
513
|
Desktop completion notifications are controlled in **Settings > Notifications**:
|
|
513
514
|
|
|
@@ -129,8 +129,8 @@ explains that an update is needed while file-name search keeps working.
|
|
|
129
129
|
|
|
130
130
|
## Uploading Files
|
|
131
131
|
|
|
132
|
-
Drag files from your computer into the file tree to upload them to
|
|
133
|
-
directory. While you drag, Files names the effective destination and highlights
|
|
132
|
+
Drag files or folders from your computer into the file tree to upload them to
|
|
133
|
+
the selected directory. While you drag, Files names the effective destination and highlights
|
|
134
134
|
the destination folder. Hovering a file means the upload will land beside that
|
|
135
135
|
file in its parent folder; hovering a folder means it will land inside that
|
|
136
136
|
folder; hovering a root-level file or empty tree space targets the current tree
|
|
@@ -146,6 +146,15 @@ before copying each file onto the box. Free up space or choose fewer files
|
|
|
146
146
|
if an upload is blocked. A box awaiting an update may still have the previous
|
|
147
147
|
1 GiB file limit; retry after its normal automatic update.
|
|
148
148
|
|
|
149
|
+
A folder is compressed on your computer, and the box unpacks it at the
|
|
150
|
+
destination. Its row shows Preparing while it compresses. The 5 GiB limit
|
|
151
|
+
applies to the compressed folder, and the box's disk check sees only that
|
|
152
|
+
compressed size. Everything in the folder is included except `.DS_Store` and
|
|
153
|
+
`._*` files, and symbolic links stay as links. If a file or folder with that
|
|
154
|
+
name already exists at the destination, the upload fails and the existing one
|
|
155
|
+
stays as it was. A box awaiting an update keeps the upload as a `.tar.gz` file
|
|
156
|
+
that you or your agent can unpack.
|
|
157
|
+
|
|
149
158
|
## Diffs From Files
|
|
150
159
|
|
|
151
160
|
Files is a plain file viewer. It can show Git decorations for changed text
|
|
@@ -38,6 +38,14 @@ snapshot and then create the devbox.
|
|
|
38
38
|
If an independent project's Template box has changed in a way future devboxes should inherit, take a
|
|
39
39
|
new snapshot before starting the devbox.
|
|
40
40
|
|
|
41
|
+
boxes.dev usually keeps a few devboxes prepared from the current snapshot or
|
|
42
|
+
saved version, so a new thread can start without waiting for a restore. When
|
|
43
|
+
none is ready, the new devbox is restored from the snapshot instead, which can
|
|
44
|
+
take a minute or more. While that happens, the thread shows why: a fresh or
|
|
45
|
+
very recent snapshot or saved version, other new threads already using the
|
|
46
|
+
prepared devboxes, prepared devboxes being updated, a prepared devbox that
|
|
47
|
+
couldn't be used, or none being ready yet.
|
|
48
|
+
|
|
41
49
|
### Choose starting branches
|
|
42
50
|
|
|
43
51
|
In a new desktop draft, the **Branch** menu below the composer selects the branch
|
|
@@ -86,6 +86,11 @@ Open a project to see its threads. The list can include:
|
|
|
86
86
|
desktop app, and a pinned devbox lists under pinned threads instead of its
|
|
87
87
|
folder;
|
|
88
88
|
- recent threads;
|
|
89
|
+
- with **Group devboxes started by agents** on in Settings, each devbox an
|
|
90
|
+
agent started, under the devbox that started it. A slim row labeled
|
|
91
|
+
**Devboxes it started** shows their status; tap it to open them. It shows no
|
|
92
|
+
count because the phone may not have loaded all of them, and a devbox whose
|
|
93
|
+
parent has not loaded lists on its own until it does;
|
|
89
94
|
- devbox groups, with child threads under the devbox and, when the devbox has
|
|
90
95
|
archived threads, an **Archived threads** list at the end of the group;
|
|
91
96
|
- an **Archived threads** list at the end of the project for the Template
|
|
@@ -138,7 +143,8 @@ The thread-list menu also offers **Mute notifications**. A muted thread shows
|
|
|
138
143
|
a bell-off icon on its row, and its finished turns don't send a push
|
|
139
144
|
notification or mark it unread; requests for input still do. **Mark unread**
|
|
140
145
|
on a muted thread lasts until you open it or its next turn finishes. **Unmute
|
|
141
|
-
notifications** turns them back on.
|
|
146
|
+
notifications** turns them back on. A devbox collapses two or more muted threads
|
|
147
|
+
into a **Muted threads** row below its other threads.
|
|
142
148
|
|
|
143
149
|
## Session View
|
|
144
150
|
|
|
@@ -528,6 +534,9 @@ include:
|
|
|
528
534
|
- theme, monospace font, and thread text size;
|
|
529
535
|
- **Sort threads**, the thread list order shared with desktop (see
|
|
530
536
|
`threads-and-agents.md`, Thread List Organization);
|
|
537
|
+
- **Group devboxes started by agents**, which lists each devbox an agent
|
|
538
|
+
started under the devbox that started it, shared with desktop (see
|
|
539
|
+
`threads-and-agents.md`, Thread List Organization);
|
|
531
540
|
- **Project view**: **Recent** (the default) lists a project's devboxes by
|
|
532
541
|
date, and **Folders** groups them into the user's desktop folders. It is
|
|
533
542
|
saved on the account and applies only to the mobile app; desktop always
|
|
@@ -634,8 +643,9 @@ you approve access, the window will close and the agent will show
|
|
|
634
643
|
**Connected**; boxes.dev applies the sign-in to all of the project's
|
|
635
644
|
devboxes, including sleeping ones when they wake. If the app can't receive the
|
|
636
645
|
sign-in directly, it opens the page in your browser instead. After you
|
|
637
|
-
approve, the browser will show a
|
|
638
|
-
address, paste it into the app, and
|
|
646
|
+
approve, the browser will show a connection error at a local address. That's
|
|
647
|
+
expected: copy the full address from the address bar, paste it into the app, and
|
|
648
|
+
tap **Finish sign-in**.
|
|
639
649
|
|
|
640
650
|
The MCPs screen requires an updated mobile app; an older installed app needs an
|
|
641
651
|
app-store update.
|
|
@@ -324,12 +324,16 @@ you close the editor; reopen it to apply or discard them.
|
|
|
324
324
|
If a remote port cannot be bound locally, the Ports button shows a warning. A
|
|
325
325
|
row can say that the port is in use locally or is not forwarded.
|
|
326
326
|
|
|
327
|
-
|
|
328
|
-
|
|
329
|
-
|
|
330
|
-
|
|
331
|
-
|
|
332
|
-
|
|
327
|
+
On macOS, the desktop app forwards a localhost port below 1024, such as 80 or
|
|
328
|
+
443, only when a project rule covers that single port or sets the local port. A
|
|
329
|
+
range rule with **Same locally** does not count. Without such a rule, the port
|
|
330
|
+
stays free for local servers. Linux normally reserves those ports for root, so
|
|
331
|
+
the desktop app cannot forward to them there.
|
|
332
|
+
|
|
333
|
+
A row says **privileged port** when the desktop app cannot open a local port
|
|
334
|
+
below 1024. For these rows, **Use next available** searches from 8000 ports
|
|
335
|
+
higher, such as 8080 for 80 or 8443 for 443. A project rule that maps the port
|
|
336
|
+
to a higher local port avoids the prompt.
|
|
333
337
|
|
|
334
338
|
When available, choose **Use next available** to approve forwarding that remote
|
|
335
339
|
port to a different local port. The chosen local port stays pinned for the
|
|
@@ -346,24 +346,28 @@ from any browser. Choose a project; the page offers the same
|
|
|
346
346
|
list, **Add MCP**, agent chips, and row menus, but not **Template-managed
|
|
347
347
|
MCPs**. To sign in to an OAuth MCP there, choose **Open sign-in page** in the
|
|
348
348
|
sign-in dialog and approve access in the new tab. The provider will then send
|
|
349
|
-
that tab to an address starting with `http://127.0.0.1
|
|
350
|
-
that tab's full address, paste it into
|
|
351
|
-
sign-in**. Each sign-in needs to be finished
|
|
352
|
-
works only once. The dialog also shows the
|
|
353
|
-
people who prefer to sign in from a terminal on
|
|
354
|
-
only a private network can reach can't be signed
|
|
355
|
-
desktop app or `dvb mcp authorize` for it.
|
|
356
|
-
|
|
357
|
-
|
|
349
|
+
that tab to an address starting with `http://127.0.0.1:`, which will show a
|
|
350
|
+
connection error. That's expected. Copy that tab's full address, paste it into
|
|
351
|
+
the dialog, and choose **Finish sign-in**. Each sign-in needs to be finished
|
|
352
|
+
within 10 minutes, and its address works only once. The dialog also shows the
|
|
353
|
+
`dvb mcp authorize` command for people who prefer to sign in from a terminal on
|
|
354
|
+
their own computer. An MCP that only a private network can reach can't be signed
|
|
355
|
+
in from the website; use the desktop app or `dvb mcp authorize` for it.
|
|
356
|
+
|
|
357
|
+
Sign-in links from a Template box or devbox, for example after `codex mcp add`,
|
|
358
|
+
will open this page in a normal browser with that connection's sign-in ready.
|
|
359
|
+
When you open one from a thread or terminal in the desktop app, it will open
|
|
360
|
+
**Integrations → MCPs** in that connection's project instead. After you approve
|
|
361
|
+
access, the app will finish signing in automatically, with no address to paste.
|
|
358
362
|
|
|
359
363
|
Supported remote HTTP commands are another entry point to the same list. Running
|
|
360
364
|
a command such as `codex mcp add <name> --url <url>` or `claude mcp add
|
|
361
365
|
--transport http <name> <url>` in a Template box or devbox creates the central
|
|
362
366
|
current-project connection. It does not create a separate machine-only copy.
|
|
363
367
|
When the server uses OAuth, the command will print a boxes.dev sign-in link
|
|
364
|
-
and a `dvb mcp authorize` command, and it will try to open the link
|
|
365
|
-
|
|
366
|
-
|
|
368
|
+
and a `dvb mcp authorize` command, and it will try to open the link. If nothing
|
|
369
|
+
opens, open the link yourself, or run that command in a terminal on your own
|
|
370
|
+
computer, not on the box. An agent that runs
|
|
367
371
|
the command for you will give you the link. To enable both agents, run each
|
|
368
372
|
agent's setup command with the same name, URL, and authentication details,
|
|
369
373
|
including any API-key headers.
|
|
@@ -678,10 +682,11 @@ the thread may show a start-over path.
|
|
|
678
682
|
## Composer Basics
|
|
679
683
|
|
|
680
684
|
Type a prompt and send it from the composer. The desktop composer supports text
|
|
681
|
-
plus file or image attachments when the selected agent and thread
|
|
682
|
-
attachments; add files from the attachment menu or by
|
|
683
|
-
images directly into the composer. The composer can
|
|
684
|
-
the project when the agent surface supports file
|
|
685
|
+
plus file, folder, or image attachments when the selected agent and thread
|
|
686
|
+
state allow attachments; add files or folders from the attachment menu or by
|
|
687
|
+
drag-and-drop, and paste images directly into the composer. The composer can
|
|
688
|
+
also reference files from the project when the agent surface supports file
|
|
689
|
+
search.
|
|
685
690
|
|
|
686
691
|
On mobile, managed Codex and Claude Code conversations support both photos and
|
|
687
692
|
general files, including ZIP archives, from the composer attachment menu.
|
|
@@ -697,6 +702,13 @@ Desktop file attachments are staged into the selected box and can be up to
|
|
|
697
702
|
5 GiB each, with up to 10 GiB of active uploads per user at a time. Image
|
|
698
703
|
attachments still follow the selected agent's image input limits.
|
|
699
704
|
|
|
705
|
+
Desktop folder attachments are compressed on the user's computer and unpacked
|
|
706
|
+
into a folder on the selected box, so the agent receives a folder path. A folder
|
|
707
|
+
can be up to 5 GiB after compression. Everything in the folder is included
|
|
708
|
+
except `.DS_Store` and `._*` files, and symbolic links stay links. A box that
|
|
709
|
+
hasn't updated yet receives a `.tar.gz` file instead, which the agent can
|
|
710
|
+
unpack.
|
|
711
|
+
|
|
700
712
|
For a connected box, boxes.dev checks free disk space before accepting new
|
|
701
713
|
attachments. Files for a new or sleeping devbox can upload while the box
|
|
702
714
|
prepares. Free space is checked again before the files are copied onto the
|
|
@@ -932,6 +944,13 @@ list leaves out `/model` and `/fast`, which the model menu covers. On desktop, `
|
|
|
932
944
|
`/model <model>` switches directly to a known model. Older supported model generations appear
|
|
933
945
|
under **More models** in the picker.
|
|
934
946
|
|
|
947
|
+
`/clear`, `/new`, and `/reset` are unavailable in a Claude thread. The command
|
|
948
|
+
list leaves them out, and desktop, mobile, the CLI, and other agents can't send
|
|
949
|
+
them. Start a new thread to clear Claude's context. A message is refused only
|
|
950
|
+
when one of these names is its first word, so text that mentions them sends
|
|
951
|
+
normally. A custom skill named `clear`, `new`, or `reset` can't run in a thread
|
|
952
|
+
either.
|
|
953
|
+
|
|
935
954
|
Claude Code's own `/goal` command sets a condition that Claude keeps working
|
|
936
955
|
toward across turns until it judges the condition met. `/goal <condition>`
|
|
937
956
|
sets or replaces it, bare `/goal` shows it, and `/goal clear` (or `stop`,
|
|
@@ -1140,9 +1159,9 @@ stop the turn first.
|
|
|
1140
1159
|
|
|
1141
1160
|
A managed Claude Code CLI stays bound to the boxes.dev thread and working
|
|
1142
1161
|
directory it opened. Claude's Agent View and Remote Control are unavailable in
|
|
1143
|
-
that CLI. Commands that would replace or move its session—`/clear`,
|
|
1144
|
-
`/resume`, `/continue`, `/branch`, `/teleport`, `/tp`, and `/cd`—are
|
|
1145
|
-
open or create the intended boxes.dev thread instead. Use `/add-dir` when Claude
|
|
1162
|
+
that CLI. Commands that would replace or move its session—`/clear`, `/new`,
|
|
1163
|
+
`/reset`, `/resume`, `/continue`, `/branch`, `/teleport`, `/tp`, and `/cd`—are
|
|
1164
|
+
rejected; open or create the intended boxes.dev thread instead. Use `/add-dir` when Claude
|
|
1146
1165
|
only needs access to another directory. Session-preserving controls such as
|
|
1147
1166
|
`/compact`, rewind/checkpoint controls, ordinary subagents, and `/fork` remain
|
|
1148
1167
|
available. An ordinary `claude` started in a separate machine shell keeps its
|
|
@@ -1252,6 +1271,23 @@ The order applies to recent threads, folders, devbox groups, the Template box
|
|
|
1252
1271
|
section, and archived threads. Pinned threads keep their own order. In the
|
|
1253
1272
|
activity orders, each row's time and date group show its last activity.
|
|
1254
1273
|
|
|
1274
|
+
**Group devboxes started by agents**, below **Sort threads**, lists each devbox
|
|
1275
|
+
an agent started under the devbox that started it. It is off by default and
|
|
1276
|
+
saved on the account, so every computer and phone follows it. A slim row under
|
|
1277
|
+
the parent shows whether any of those devboxes are working, unread, or need the
|
|
1278
|
+
user, and selecting the row opens them. On desktop the row also counts them.
|
|
1279
|
+
When a devbox started only one, that devbox shows directly under its parent
|
|
1280
|
+
without the row.
|
|
1281
|
+
Devboxes nest under the devbox that started them at every level, and in the
|
|
1282
|
+
main list a group moves up with its newest thread.
|
|
1283
|
+
|
|
1284
|
+
A pinned devbox stays under **Pinned**, and a devbox in a different folder from
|
|
1285
|
+
its parent stays in its folder. A devbox in the same folder as its parent nests
|
|
1286
|
+
under it there. Threads an agent starts on an existing devbox stay on that
|
|
1287
|
+
devbox. If the parent is destroyed, the devboxes it started return to the main
|
|
1288
|
+
list and keep running. Devboxes started from the Template box stay in the main
|
|
1289
|
+
list, as do those started by a coordinator or an automation on desktop.
|
|
1290
|
+
|
|
1255
1291
|
Rows show status indicators for draft, starting, active, unread, idle, archived,
|
|
1256
1292
|
and cold-storage states. Devbox rows also show devbox context and devbox runtime
|
|
1257
1293
|
status where relevant.
|
|
@@ -1510,3 +1546,10 @@ pending request for input stays until it is answered. **Mark unread** on a
|
|
|
1510
1546
|
muted thread lasts until the thread is opened or its next turn finishes.
|
|
1511
1547
|
**Unmute notifications** restores normal behavior. The setting belongs to the thread, so desktop,
|
|
1512
1548
|
mobile, `dvb`, and `dvb-onbox` all show and change the same value.
|
|
1549
|
+
|
|
1550
|
+
When a devbox has two or more muted threads besides its first thread, they
|
|
1551
|
+
collapse into a slim row below its other threads, closed by default. The row
|
|
1552
|
+
shows whether any of them are working, and selecting it opens them. On desktop
|
|
1553
|
+
the row also counts them. A muted thread stays in the main list while it needs
|
|
1554
|
+
input or is unread, and on desktop so does the open thread. The row applies to
|
|
1555
|
+
devboxes in the thread list. The Template box lists its muted threads normally.
|
|
@@ -356,9 +356,12 @@ If a visible port is not forwarded because the local port is already in use,
|
|
|
356
356
|
use **Use next available** when offered, or stop the local process that is
|
|
357
357
|
holding the port.
|
|
358
358
|
|
|
359
|
-
If the row says **privileged port**, the
|
|
360
|
-
|
|
361
|
-
|
|
359
|
+
If the row says **privileged port**, the desktop app could not open a local port
|
|
360
|
+
below 1024. On macOS, add a project rule for that single port, such as 443, to
|
|
361
|
+
use the same local port. Linux normally reserves these ports for root, so that
|
|
362
|
+
rule will not work there. On either system, use **Use next available** to
|
|
363
|
+
forward it 8000 ports higher, or add a project rule that maps it to a higher
|
|
364
|
+
local port.
|
|
362
365
|
|
|
363
366
|
If there are no forwarded ports, make sure the app or service is actually
|
|
364
367
|
running inside the selected box.
|
|
@@ -373,8 +376,13 @@ box is the one that contains the work. Devbox files and Template box files
|
|
|
373
376
|
are separate after the devbox is created.
|
|
374
377
|
|
|
375
378
|
If Git can inspect local files but an automatic GitHub fetch, pull, or push is
|
|
376
|
-
rejected, use its recovery message.
|
|
377
|
-
|
|
379
|
+
rejected, use its recovery message. For a GitHub API rate limit, wait for the
|
|
380
|
+
time shown before retrying the command. If no wait time is available, try
|
|
381
|
+
again later.
|
|
382
|
+
|
|
383
|
+
For an account or repository access error, reconnect the original GitHub
|
|
384
|
+
account, restore the user's write access, or grant the App access to that
|
|
385
|
+
repository.
|
|
378
386
|
If only a push that changes `.github/workflows` is rejected, use **Update
|
|
379
387
|
GitHub access** for every affected installation and return to boxes.dev to
|
|
380
388
|
check again, or use SSH. Ordinary automatic fetch, pull, and push can still
|
|
@@ -408,6 +416,10 @@ setup with a valid file.
|
|
|
408
416
|
|
|
409
417
|
## GitHub CLI Will Not Authenticate
|
|
410
418
|
|
|
419
|
+
If managed `gh` says GitHub's API rate limit was reached, wait for the time
|
|
420
|
+
shown before retrying the command. If no wait time is available, try again
|
|
421
|
+
later.
|
|
422
|
+
|
|
411
423
|
First confirm that the selected Template box or devbox is awake and ready.
|
|
412
424
|
First-run desktop setup may already have connected GitHub while leaving its
|
|
413
425
|
separate CLI checkbox cleared in **Finalize Bundle → GitHub access**. Open
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@boxes-dev/dvb-runtime",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.1109",
|
|
4
4
|
"description": "Runtime for the boxes.dev CLI. Install @boxes-dev/dvb to use the CLI.",
|
|
5
5
|
"homepage": "https://boxes.dev",
|
|
6
6
|
"type": "module",
|
|
@@ -77,5 +77,5 @@
|
|
|
77
77
|
"e2b": "^2.18.0",
|
|
78
78
|
"ink-testing-library": "^4.0.0"
|
|
79
79
|
},
|
|
80
|
-
"devboxReleasedAt": "2026-10-
|
|
80
|
+
"devboxReleasedAt": "2026-10-31T08:09:38Z"
|
|
81
81
|
}
|