@boxes-dev/dvb-runtime 1.0.969 → 1.0.971
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 +17 -17
- package/dist/bin/dvbd.mjs +6 -6
- package/dist/product-docs/references/core-concepts.md +1 -1
- package/dist/product-docs/references/desktop-workbench.md +1 -1
- package/dist/product-docs/references/glossary.md +1 -1
- package/dist/product-docs/references/index.md +5 -2
- package/dist/product-docs/references/managed-environment-files.md +149 -0
- package/dist/product-docs/references/ports-terminal-and-runtime.md +12 -7
- package/dist/product-docs/references/shared-storage.md +26 -22
- package/dist/product-docs/references/threads-and-agents.md +60 -28
- 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]="e1551a91-925f-5423-be1b-4fe8159ffc80")}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";
|
|
@@ -101145,8 +101145,8 @@ var init_otel = __esm({
|
|
|
101145
101145
|
return trimmed && trimmed.length > 0 ? trimmed : void 0;
|
|
101146
101146
|
};
|
|
101147
101147
|
readBuildMetadata = () => {
|
|
101148
|
-
const rawPackageVersion = "1.0.
|
|
101149
|
-
const rawGitSha = "
|
|
101148
|
+
const rawPackageVersion = "1.0.971";
|
|
101149
|
+
const rawGitSha = "63cbb0f96bb83af343e80bf19971efbcdb57b1b0";
|
|
101150
101150
|
const packageVersion = typeof rawPackageVersion === "string" ? rawPackageVersion : void 0;
|
|
101151
101151
|
const gitSha = typeof rawGitSha === "string" ? rawGitSha : void 0;
|
|
101152
101152
|
return { packageVersion, gitSha };
|
|
@@ -133552,9 +133552,9 @@ var init_sentry = __esm({
|
|
|
133552
133552
|
uncaughtExceptionMonitorInstalled = false;
|
|
133553
133553
|
currentDevboxSentryUser = null;
|
|
133554
133554
|
readBuildMetadata2 = () => {
|
|
133555
|
-
const rawPackageVersion = "1.0.
|
|
133556
|
-
const rawGitSha = "
|
|
133557
|
-
const rawSentryRelease = "boxes-dev-dvb@1.0.
|
|
133555
|
+
const rawPackageVersion = "1.0.971";
|
|
133556
|
+
const rawGitSha = "63cbb0f96bb83af343e80bf19971efbcdb57b1b0";
|
|
133557
|
+
const rawSentryRelease = "boxes-dev-dvb@1.0.971+63cbb0f96bb83af343e80bf19971efbcdb57b1b0";
|
|
133558
133558
|
const packageVersion = typeof rawPackageVersion === "string" ? rawPackageVersion : void 0;
|
|
133559
133559
|
const gitSha = typeof rawGitSha === "string" ? rawGitSha : void 0;
|
|
133560
133560
|
const sentryRelease = typeof rawSentryRelease === "string" ? rawSentryRelease : void 0;
|
|
@@ -138737,7 +138737,7 @@ var init_packageVersion = __esm({
|
|
|
138737
138737
|
return path17.join(process.cwd(), "dvb");
|
|
138738
138738
|
};
|
|
138739
138739
|
readEmbeddedPackageVersion = () => {
|
|
138740
|
-
const raw = "1.0.
|
|
138740
|
+
const raw = "1.0.971";
|
|
138741
138741
|
return trimVersion(raw);
|
|
138742
138742
|
};
|
|
138743
138743
|
readNearestPackageMetadata = (basePath) => {
|
|
@@ -229326,15 +229326,15 @@ var init_managedClaudeThreadCommands = __esm({
|
|
|
229326
229326
|
"../../../../shared/threadRuntime/dist-inventory/threadRuntime/managedClaudeThreadCommands.js"() {
|
|
229327
229327
|
"use strict";
|
|
229328
229328
|
MANAGED_CLAUDE_THREAD_COMMAND_MESSAGES = {
|
|
229329
|
-
"/branch": "/branch is unavailable in this
|
|
229330
|
-
"/cd": "/cd is unavailable in this
|
|
229331
|
-
"/clear": "/clear is unavailable in this
|
|
229332
|
-
"/continue": "/continue is unavailable in this
|
|
229333
|
-
"/resume": "/resume is unavailable in this
|
|
229334
|
-
"/teleport": "/teleport is unavailable in this
|
|
229335
|
-
"/tp": "/tp is unavailable in this
|
|
229336
|
-
};
|
|
229337
|
-
MANAGED_CLAUDE_COMMAND_MENU_MESSAGE = "Select-by-menu Claude commands are unavailable in this
|
|
229329
|
+
"/branch": "/branch is unavailable in this CLI because it switches Claude to a new session. Create a new boxes.dev thread or devbox instead.",
|
|
229330
|
+
"/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.",
|
|
229331
|
+
"/clear": "/clear is unavailable in this CLI because it switches Claude to a new session. Start a new boxes.dev thread instead.",
|
|
229332
|
+
"/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.",
|
|
229333
|
+
"/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.",
|
|
229334
|
+
"/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.",
|
|
229335
|
+
"/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."
|
|
229336
|
+
};
|
|
229337
|
+
MANAGED_CLAUDE_COMMAND_MENU_MESSAGE = "Select-by-menu Claude commands are unavailable in this CLI because they can switch this boxes.dev thread to another session. Type the full command name instead.";
|
|
229338
229338
|
normalizeClaudePromptLine = (line) => line.replace(/\u00a0/g, " ").replace(/^[\s>❯›]+/u, "").trimStart();
|
|
229339
229339
|
resolveBlockedManagedClaudeThreadCommand = (line) => {
|
|
229340
229340
|
const normalizedLine = normalizeClaudePromptLine(line);
|
|
@@ -357626,4 +357626,4 @@ react/cjs/react-jsx-runtime.development.js:
|
|
|
357626
357626
|
*)
|
|
357627
357627
|
*/
|
|
357628
357628
|
|
|
357629
|
-
//# debugId=
|
|
357629
|
+
//# debugId=e1551a91-925f-5423-be1b-4fe8159ffc80
|
package/dist/bin/dvbd.mjs
CHANGED
|
@@ -96328,8 +96328,8 @@ var init_otel = __esm({
|
|
|
96328
96328
|
return trimmed && trimmed.length > 0 ? trimmed : void 0;
|
|
96329
96329
|
};
|
|
96330
96330
|
readBuildMetadata = () => {
|
|
96331
|
-
const rawPackageVersion = "1.0.
|
|
96332
|
-
const rawGitSha = "
|
|
96331
|
+
const rawPackageVersion = "1.0.971";
|
|
96332
|
+
const rawGitSha = "63cbb0f96bb83af343e80bf19971efbcdb57b1b0";
|
|
96333
96333
|
const packageVersion = typeof rawPackageVersion === "string" ? rawPackageVersion : void 0;
|
|
96334
96334
|
const gitSha = typeof rawGitSha === "string" ? rawGitSha : void 0;
|
|
96335
96335
|
return { packageVersion, gitSha };
|
|
@@ -128624,9 +128624,9 @@ var init_sentry = __esm({
|
|
|
128624
128624
|
uncaughtExceptionMonitorInstalled = false;
|
|
128625
128625
|
currentDevboxSentryUser = null;
|
|
128626
128626
|
readBuildMetadata2 = () => {
|
|
128627
|
-
const rawPackageVersion = "1.0.
|
|
128628
|
-
const rawGitSha = "
|
|
128629
|
-
const rawSentryRelease = "boxes-dev-dvb@1.0.
|
|
128627
|
+
const rawPackageVersion = "1.0.971";
|
|
128628
|
+
const rawGitSha = "63cbb0f96bb83af343e80bf19971efbcdb57b1b0";
|
|
128629
|
+
const rawSentryRelease = "boxes-dev-dvb@1.0.971+63cbb0f96bb83af343e80bf19971efbcdb57b1b0";
|
|
128630
128630
|
const packageVersion = typeof rawPackageVersion === "string" ? rawPackageVersion : void 0;
|
|
128631
128631
|
const gitSha = typeof rawGitSha === "string" ? rawGitSha : void 0;
|
|
128632
128632
|
const sentryRelease = typeof rawSentryRelease === "string" ? rawSentryRelease : void 0;
|
|
@@ -130818,7 +130818,7 @@ var init_packageVersion = __esm({
|
|
|
130818
130818
|
return path8.join(process.cwd(), "dvb");
|
|
130819
130819
|
};
|
|
130820
130820
|
readEmbeddedPackageVersion = () => {
|
|
130821
|
-
const raw = "1.0.
|
|
130821
|
+
const raw = "1.0.971";
|
|
130822
130822
|
return trimVersion(raw);
|
|
130823
130823
|
};
|
|
130824
130824
|
readNearestPackageMetadata = (basePath) => {
|
|
@@ -58,7 +58,7 @@ boxes.dev, threads run on a devbox or, in an ordinary project, on the Template
|
|
|
58
58
|
box.
|
|
59
59
|
|
|
60
60
|
The agent is Codex or Claude, depending on what is enabled and authenticated.
|
|
61
|
-
In the desktop app, GUI and
|
|
61
|
+
In the desktop app, GUI and the CLI are two views of that same conversation,
|
|
62
62
|
not separate thread types. A thread may be user-started, setup-created, or
|
|
63
63
|
spawned by an automation or integration.
|
|
64
64
|
|
|
@@ -227,7 +227,7 @@ but cannot connect to the editing machine.
|
|
|
227
227
|
|
|
228
228
|
Select a thread in the left pane to open it in the detail pane. Codex and Claude
|
|
229
229
|
threads, new-devbox placeholders, and automation views all use the same detail
|
|
230
|
-
area. A Codex or Claude thread can switch between GUI and
|
|
230
|
+
area. A Codex or Claude thread can switch between GUI and the CLI from its
|
|
231
231
|
header without becoming a different thread.
|
|
232
232
|
|
|
233
233
|
To distinguish Claude and Codex threads at a glance, turn on **Show agent
|
|
@@ -26,7 +26,7 @@ Use this terminology consistently:
|
|
|
26
26
|
Template's saved version for a task, thread, automation run, or an
|
|
27
27
|
integration-triggered run.
|
|
28
28
|
- Thread: a Codex or Claude conversation connected to a runtime. In the
|
|
29
|
-
desktop app, the same thread can use GUI or
|
|
29
|
+
desktop app, the same thread can use GUI or CLI view.
|
|
30
30
|
- Snapshot: a saved filesystem state used to create future devboxes.
|
|
31
31
|
- Selected runtime: the Template box or devbox currently selected in the app;
|
|
32
32
|
terminals, ports, files, and runtime controls follow that selection.
|
|
@@ -43,13 +43,16 @@ Use this terminology consistently:
|
|
|
43
43
|
copied-data boundaries.
|
|
44
44
|
- `template-box-environment.md`: the Template box machine environment, baseline
|
|
45
45
|
development tools, setup constraints, local-run verification, and snapshots.
|
|
46
|
+
- `managed-environment-files.md`: centrally managed dotenv files, initial
|
|
47
|
+
import, managed-prefix ownership, Team Template Team/member values,
|
|
48
|
+
reveal/export, outages, snapshots, security boundaries, and limits.
|
|
46
49
|
- `shared-storage.md`: the shared `/project` folder, recommended uses and
|
|
47
50
|
limitations, Claude project memory, persistence, access, and turning it off.
|
|
48
51
|
- `core-concepts.md`: short definitions for projects, Template boxes, devboxes,
|
|
49
52
|
Team Templates, threads, snapshots, wake/sleep, and selected runtime
|
|
50
53
|
behavior.
|
|
51
54
|
- `threads-and-agents.md`: creating and continuing Codex or Claude threads,
|
|
52
|
-
choosing GUI or
|
|
55
|
+
choosing GUI or the CLI on desktop, safely draining remaining legacy Claude
|
|
53
56
|
CLI threads, Template box versus devbox starts, goals, follow-ups, interrupts,
|
|
54
57
|
retries, model controls, thread actions, and notifications.
|
|
55
58
|
- `fork-workflows.md`: when to use a devbox, how devbox work starts, file
|
|
@@ -0,0 +1,149 @@
|
|
|
1
|
+
# Managed Environment Files
|
|
2
|
+
|
|
3
|
+
Use this doc for questions about centrally managed `.env` files, project
|
|
4
|
+
values, Team Template value requirements, imports, reveal/export, or sync
|
|
5
|
+
behavior.
|
|
6
|
+
|
|
7
|
+
## What boxes.dev Manages
|
|
8
|
+
|
|
9
|
+
A project owner can register a project-relative dotenv file such as
|
|
10
|
+
`.env.local` in **Project settings → Environment files**. Each registered file
|
|
11
|
+
has its own list of names, values, optional inline comments, and descriptions.
|
|
12
|
+
The saved values are the source of truth: Template boxes and devboxes receive
|
|
13
|
+
updates, but changes made on a box never update the central copy.
|
|
14
|
+
|
|
15
|
+
boxes.dev writes a managed section at the start of the file and ends it with:
|
|
16
|
+
|
|
17
|
+
```dotenv
|
|
18
|
+
# >>> BOXES_MANAGED_ENV_v1 <<<
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
The section above and including that marker is replaced during sync. Everything
|
|
22
|
+
after it is local machine content and is preserved byte for byte. Do not edit
|
|
23
|
+
the managed section directly; use Project settings. A local value below the
|
|
24
|
+
marker may duplicate a managed name, but boxes.dev does not parse that tail or
|
|
25
|
+
treat duplicate names as a supported override mechanism.
|
|
26
|
+
|
|
27
|
+
New files are created with owner-only permissions. Existing regular files keep
|
|
28
|
+
their current owner, group, mode, and content below the marker. Unsafe paths,
|
|
29
|
+
symbolic-link traversal, and non-file destinations are refused.
|
|
30
|
+
|
|
31
|
+
## Adding An Existing File
|
|
32
|
+
|
|
33
|
+
When a project owner first registers a path, boxes.dev checks that path on the
|
|
34
|
+
project's Template box. If an ordinary dotenv file exists, the editor recognizes
|
|
35
|
+
conservative single-line assignments and lets the owner choose for each one:
|
|
36
|
+
|
|
37
|
+
- **Manage**: save the value centrally and move the assignment into the managed
|
|
38
|
+
section;
|
|
39
|
+
- **Keep local**: leave the assignment in the file's local tail; or
|
|
40
|
+
- **Remove**: remove that recognized assignment when management starts.
|
|
41
|
+
|
|
42
|
+
Comments, blank lines, shell expressions, multiline constructs, and anything
|
|
43
|
+
else the importer does not recognize stay local. The file must still match the
|
|
44
|
+
version that was reviewed when the import is applied. If it changed, boxes.dev
|
|
45
|
+
leaves it alone and asks the owner to review it again. Import is a one-time
|
|
46
|
+
setup step; boxes.dev never imports later edits from an already managed file.
|
|
47
|
+
|
|
48
|
+
If the file does not exist, boxes.dev creates it. If it is too large or is not
|
|
49
|
+
valid UTF-8, automatic import is skipped and the complete existing file is
|
|
50
|
+
preserved below the new managed section.
|
|
51
|
+
|
|
52
|
+
When a team admin adds a file to a Team Template, boxes.dev checks the retained
|
|
53
|
+
source box for the latest saved release. Before the first release, it checks
|
|
54
|
+
that admin's current Team Template editing session. The admin must explicitly
|
|
55
|
+
classify every imported assignment as a Team value, a Member value, local
|
|
56
|
+
content, or removed content before saving.
|
|
57
|
+
|
|
58
|
+
Each derived or team-managed project applies that import decision once. If its
|
|
59
|
+
file still matches the reviewed source, boxes.dev moves or removes the selected
|
|
60
|
+
assignments. If the file has changed, boxes.dev adds the managed section but
|
|
61
|
+
preserves the complete existing file below it. This may leave a duplicate name
|
|
62
|
+
for the project owner to resolve, but does not discard local content.
|
|
63
|
+
|
|
64
|
+
## Team Template Values
|
|
65
|
+
|
|
66
|
+
A team admin can add environment-file defaults to a Team Template. Each row is
|
|
67
|
+
either:
|
|
68
|
+
|
|
69
|
+
- **Team**: the admin supplies the shared value; or
|
|
70
|
+
- **Member**: each member supplies their own value during project creation.
|
|
71
|
+
|
|
72
|
+
A Member row can be required or optional and can include a description and
|
|
73
|
+
instructions for obtaining the value. Required values block creation of that
|
|
74
|
+
new project until they are entered; they do not block unrelated existing
|
|
75
|
+
devboxes or agent startup. Optional or otherwise missing values are omitted
|
|
76
|
+
from the file.
|
|
77
|
+
|
|
78
|
+
A normal project created from a Team Template receives an independent copy of
|
|
79
|
+
the definitions and the Team/member values entered for that project. Later Team
|
|
80
|
+
Template changes do not update it, and another project created from the same
|
|
81
|
+
template does not share its value objects.
|
|
82
|
+
|
|
83
|
+
A Team Template-managed project follows the current Team Template definitions
|
|
84
|
+
and Team values. Each member's values belong only to that member's exact
|
|
85
|
+
project. Members can replace, remove, reveal, copy, or export their own project
|
|
86
|
+
values, but cannot add centrally managed files or rows in this first version.
|
|
87
|
+
Team admins cannot read member values.
|
|
88
|
+
|
|
89
|
+
If an admin changes where a Member value will be written by renaming it or
|
|
90
|
+
moving its file, boxes.dev omits the old saved value. The member must review the
|
|
91
|
+
new destination and choose **Use saved value here**, or enter a replacement.
|
|
92
|
+
Other managed values continue syncing while that one is unresolved.
|
|
93
|
+
|
|
94
|
+
## Sync And Outages
|
|
95
|
+
|
|
96
|
+
Managed files reconcile when a Template box or devbox starts or wakes, when a
|
|
97
|
+
change is observed, and during periodic retry. Changing a value does not wake a
|
|
98
|
+
paused machine. A failure in one file does not stop other files from updating.
|
|
99
|
+
|
|
100
|
+
If boxes.dev, its key service, or the network is temporarily unavailable, an
|
|
101
|
+
existing file remains unchanged and the machine continues starting. The daemon
|
|
102
|
+
retries later. A newly restored machine may therefore use the copy already in
|
|
103
|
+
its snapshot until sync succeeds.
|
|
104
|
+
|
|
105
|
+
## Viewing And Recovering Current Values
|
|
106
|
+
|
|
107
|
+
Values are masked in normal project settings. Revealing values, showing a
|
|
108
|
+
value-bearing file preview, copying the managed file, or exporting it requires
|
|
109
|
+
a fresh confirmation with the Google account linked to the current boxes.dev
|
|
110
|
+
account. That confirmation applies only to the current signed-in session and
|
|
111
|
+
lasts five minutes. Closing the editor, navigating away, switching accounts,
|
|
112
|
+
signing out, or reaching the expiry removes the revealed plaintext from the
|
|
113
|
+
UI.
|
|
114
|
+
|
|
115
|
+
A Team Template admin can use the same confirmation to reveal or export the
|
|
116
|
+
Team values saved on that template. Member values are project-local and are
|
|
117
|
+
never revealed to the Team Template admin. A member can confirm with their own
|
|
118
|
+
Google account to reveal, copy, or export the current managed file for their
|
|
119
|
+
own Team Template-managed project.
|
|
120
|
+
|
|
121
|
+
boxes.dev keeps only the current central value. There is no per-value version
|
|
122
|
+
history, rollback, or recovery window. Replace or delete carefully, and rotate
|
|
123
|
+
credentials through their issuing service when necessary.
|
|
124
|
+
|
|
125
|
+
## Security Boundaries
|
|
126
|
+
|
|
127
|
+
Central values are encrypted before they are stored, using a separate key scope
|
|
128
|
+
for each project or other value owner. The central database stores ciphertext,
|
|
129
|
+
not plaintext values or usable root encryption keys. Authorized boxes.dev
|
|
130
|
+
services can still decrypt current values when they must deliver, reveal, copy,
|
|
131
|
+
or export them; this is not end-to-end or zero-knowledge encryption.
|
|
132
|
+
|
|
133
|
+
Delivered files contain plaintext. A project owner, root user, process, or
|
|
134
|
+
coding agent on that machine can read them. Use development, staging, sandbox,
|
|
135
|
+
or narrowly scoped credentials rather than broad production credentials.
|
|
136
|
+
|
|
137
|
+
Snapshots preserve their filesystem, including managed environment files.
|
|
138
|
+
Replacing or deleting a central value does not erase an older value from an
|
|
139
|
+
existing snapshot, backup, running process, or already delivered machine.
|
|
140
|
+
Rotate or revoke the credential at its provider when that distinction matters.
|
|
141
|
+
|
|
142
|
+
## Limits
|
|
143
|
+
|
|
144
|
+
The protective limits are:
|
|
145
|
+
|
|
146
|
+
- 64 KiB per value;
|
|
147
|
+
- 500 managed rows per file;
|
|
148
|
+
- 1 MiB for the rendered managed section; and
|
|
149
|
+
- 2 MiB for automatic import of an existing file.
|
|
@@ -128,13 +128,18 @@ close the desktop app, and stay in place until you stop sharing them. They do
|
|
|
128
128
|
not wake a sleeping devbox: while the devbox sleeps, visitors see an
|
|
129
129
|
unavailable page and the Ports menu marks the link as paused.
|
|
130
130
|
|
|
131
|
-
The Ports button
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
131
|
+
The Ports button and menu cover only the selected Template box or devbox. The
|
|
132
|
+
button shows that machine's active-link count, each detected port row offers
|
|
133
|
+
copy, open, and stop sharing, and the menu's **Public links** group keeps that
|
|
134
|
+
machine's links whose application is no longer detected visible and
|
|
135
|
+
individually stoppable. Every active link in the project lives in the
|
|
136
|
+
**Public links** sidebar section beside **Project URLs**. That section appears
|
|
137
|
+
while at least one link is active, names the machine that owns each link, and
|
|
138
|
+
lets you open, copy, or stop sharing any link without switching machines; the
|
|
139
|
+
Ports menu's **All public links…** entry jumps there. Choosing **Stop
|
|
140
|
+
sharing** stops that boxes.dev public URL and sharing the port again later
|
|
141
|
+
creates a new URL. It does not stop the application or change another network
|
|
142
|
+
path the application may expose.
|
|
138
143
|
|
|
139
144
|
Inside a managed Template box or devbox, a shell script or coding agent can
|
|
140
145
|
control the same public links for the physical current box:
|
|
@@ -1,9 +1,13 @@
|
|
|
1
1
|
# Shared Project Storage
|
|
2
2
|
|
|
3
|
-
Project storage gives a project one persistent folder shared by its
|
|
4
|
-
It is on by default during open beta and appears at
|
|
5
|
-
|
|
6
|
-
|
|
3
|
+
Project storage gives a project one persistent folder shared by its Template
|
|
4
|
+
box and devboxes. It is on by default during open beta and appears at
|
|
5
|
+
`/project` on each machine.
|
|
6
|
+
|
|
7
|
+
You can snapshot the Template box while `/project` is mounted. The snapshot
|
|
8
|
+
does not copy or replace the stored contents. When boxes.dev creates a devbox
|
|
9
|
+
from that snapshot, it reconnects `/project` for that devbox before the devbox
|
|
10
|
+
is ready.
|
|
7
11
|
|
|
8
12
|
Use project storage for information that should follow work across devboxes,
|
|
9
13
|
such as agent memory, reference files, handoff files, stable project data, and
|
|
@@ -14,14 +18,13 @@ package caches, logs, queues, build trees, or other high-churn workloads.
|
|
|
14
18
|
## Claude project memory
|
|
15
19
|
|
|
16
20
|
When `/project` is mounted normally, boxes.dev directs Claude's automatic
|
|
17
|
-
memory to the shared project storage. A memory Claude writes
|
|
18
|
-
therefore inform Claude
|
|
21
|
+
memory to the shared project storage. A memory Claude writes on the Template
|
|
22
|
+
box or a devbox can therefore inform Claude on the project's other machines.
|
|
19
23
|
|
|
20
24
|
Before broad launch, boxes.dev migrated eligible Claude auto memory from each
|
|
21
25
|
existing project's Template box into `/project/.claude/memory`. It did not
|
|
22
|
-
combine memory that existed only on other devboxes. The Template box
|
|
23
|
-
|
|
24
|
-
`/project`.
|
|
26
|
+
combine memory that existed only on other devboxes. The Template box and
|
|
27
|
+
devboxes now use the shared memory while `/project` is mounted.
|
|
25
28
|
|
|
26
29
|
Claude's own settings still take precedence. `autoMemoryEnabled: false` keeps
|
|
27
30
|
automatic memory off, and an explicitly supplied memory directory remains in
|
|
@@ -32,24 +35,25 @@ boxes.dev does not redirect Codex state or transcripts there.
|
|
|
32
35
|
|
|
33
36
|
## Concurrent access and durability
|
|
34
37
|
|
|
35
|
-
|
|
36
|
-
second to become visible elsewhere, and truly simultaneous
|
|
37
|
-
file can fail or conflict. Avoid workflows that depend on
|
|
38
|
-
strict cache coherence, atomic appends from several
|
|
39
|
-
many processes rewriting the same files.
|
|
38
|
+
The Template box and multiple devboxes can read and write the folder. Updates
|
|
39
|
+
can take about a second to become visible elsewhere, and truly simultaneous
|
|
40
|
+
writes to the same file can fail or conflict. Avoid workflows that depend on
|
|
41
|
+
local-disk latency, strict cache coherence, atomic appends from several
|
|
42
|
+
writers, file locking, or many processes rewriting the same files.
|
|
40
43
|
|
|
41
|
-
Project storage survives
|
|
42
|
-
Deleting the boxes.dev project deletes its
|
|
43
|
-
keep another copy of anything you cannot
|
|
44
|
+
Project storage survives machine sleep and reset, as well as devbox
|
|
45
|
+
destruction and replacement. Deleting the boxes.dev project deletes its
|
|
46
|
+
project storage. During open beta, keep another copy of anything you cannot
|
|
47
|
+
recreate.
|
|
44
48
|
|
|
45
49
|
## Turning project storage off
|
|
46
50
|
|
|
47
51
|
Open **Project settings** for the project and use **Project storage** to turn
|
|
48
52
|
the mount off or back on. Turning it off detaches `/project` from the project's
|
|
49
|
-
devboxes and removes their access, but it does not delete
|
|
50
|
-
Re-enabling it mounts the same storage again.
|
|
53
|
+
Template box and devboxes and removes their access, but it does not delete
|
|
54
|
+
stored files. Re-enabling it mounts the same storage again.
|
|
51
55
|
|
|
52
56
|
Machine access and thread sharing are separate. Anyone who is authorized to
|
|
53
|
-
operate a
|
|
54
|
-
Sharing an agent thread by itself does not grant
|
|
55
|
-
permission, or access to project storage.
|
|
57
|
+
operate a project machine can naturally access the files mounted inside that
|
|
58
|
+
machine. Sharing an agent thread by itself does not grant machine access,
|
|
59
|
+
project-setting permission, or access to project storage.
|
|
@@ -15,7 +15,7 @@ can run on:
|
|
|
15
15
|
exists.
|
|
16
16
|
|
|
17
17
|
The agent is Codex or Claude, depending on what is enabled and authenticated.
|
|
18
|
-
In the desktop app, GUI and
|
|
18
|
+
In the desktop app, GUI and the CLI are two views of the same thread rather
|
|
19
19
|
than separate agent choices.
|
|
20
20
|
|
|
21
21
|
## Starting A Thread
|
|
@@ -115,6 +115,32 @@ directory before the first prompt is sent. The options are the project
|
|
|
115
115
|
directory and the tracked repo directories in that project. Existing threads
|
|
116
116
|
continue in the working directory they were originally started with.
|
|
117
117
|
|
|
118
|
+
## Recorded Agent Activity
|
|
119
|
+
|
|
120
|
+
boxes.dev records compact hourly token measurements from retained Codex and
|
|
121
|
+
Claude transcripts. These measurements describe activity visible in the
|
|
122
|
+
transcripts; they are separate from the provider's rate-limit windows and may
|
|
123
|
+
not match how the provider calculates quota use.
|
|
124
|
+
|
|
125
|
+
The prepared dialog is scoped to the thread that opens it. It shows that
|
|
126
|
+
thread's share of recorded tokens, model-call count, average and largest input
|
|
127
|
+
context, and the balance of new input, cached input, and generated output. Its
|
|
128
|
+
chart compares that thread with one aggregate `Other activity` series; it does
|
|
129
|
+
not name or link to other threads.
|
|
130
|
+
|
|
131
|
+
Activity includes the currently selected saved account when the running agent
|
|
132
|
+
can prove that account binding, plus earlier or transitional activity whose
|
|
133
|
+
thread is known but whose account cannot be matched safely. The dialog discloses
|
|
134
|
+
that uncertain account amount without assigning it to the selected account. A
|
|
135
|
+
known extraction gap is partial history, not zero usage.
|
|
136
|
+
|
|
137
|
+
The prepared usage-details dialog reads a 24-hour or seven-day point-in-time
|
|
138
|
+
snapshot and shows when it was recorded. The 24-hour chart is hourly; the
|
|
139
|
+
seven-day chart can show one-hour or one-day bars. Refreshing requests a new
|
|
140
|
+
snapshot; it does not subscribe to transcript changes. The dialog's production
|
|
141
|
+
entrypoint remains unavailable until the bounded seven-day history backfill and
|
|
142
|
+
release checks are complete.
|
|
143
|
+
|
|
118
144
|
## Continuing In A New Chat
|
|
119
145
|
|
|
120
146
|
On a completed Codex or Claude response, choose **Continue in new chat** and
|
|
@@ -570,39 +596,39 @@ tools stay visible outside the collapsed activity in both styles, before the
|
|
|
570
596
|
final agent reply. Clear **View > Diagnostics > Use Collapsed Transcript
|
|
571
597
|
History** to show older intermediate activity inline instead.
|
|
572
598
|
|
|
573
|
-
## GUI And
|
|
599
|
+
## GUI And CLI Views
|
|
574
600
|
|
|
575
601
|
On desktop, a thread uses Claude or Codex as its agent and can be viewed in GUI
|
|
576
|
-
or
|
|
602
|
+
or the CLI. These are two views of the same conversation, not separate thread
|
|
577
603
|
types. Every new-thread entry point first opens a draft on the location that
|
|
578
604
|
entry point already chose. The prominent selector changes the agent; the quiet
|
|
579
|
-
**Start in
|
|
605
|
+
**Start in the CLI** or **Back to the GUI composer** action changes the draft
|
|
580
606
|
view without asking for the runtime target again.
|
|
581
607
|
|
|
582
|
-
A GUI draft has the normal composer. A
|
|
583
|
-
**Open
|
|
608
|
+
A GUI draft has the normal composer. A CLI draft has no composer and uses
|
|
609
|
+
**Open CLI** to commit the draft to the selected runtime; the first prompt
|
|
584
610
|
is then typed directly into the agent's interactive terminal. Merely selecting
|
|
585
|
-
|
|
586
|
-
returns to GUI. **Open
|
|
611
|
+
the CLI view keeps any GUI draft text and attachments intact in case the user
|
|
612
|
+
returns to GUI. **Open CLI** warns before discarding GUI-only text,
|
|
587
613
|
attachments, or review content that cannot be transferred to the terminal.
|
|
588
614
|
|
|
589
|
-
GUI and
|
|
615
|
+
GUI and the CLI keep independent unsent input. Switching views does not move
|
|
590
616
|
or clear the other view's draft. For Codex, returning to GUI parks the local
|
|
591
|
-
|
|
592
|
-
returns to
|
|
617
|
+
CLI renderer, so its unsent terminal input remains available when the user
|
|
618
|
+
returns to the CLI. For Claude Code, returning to GUI closes the native
|
|
593
619
|
terminal writer; the confirmation warns that unsent terminal input will be
|
|
594
620
|
lost and identifies any saved GUI draft that will reappear.
|
|
595
621
|
|
|
596
|
-
Opening Claude Code in
|
|
622
|
+
Opening Claude Code in the CLI switches directly while its GUI agent is idle.
|
|
597
623
|
It requires confirmation if the GUI agent is working or another client owns
|
|
598
624
|
the terminal attachment. The transition can interrupt the current Claude turn
|
|
599
625
|
or move the attachment to this desktop. A failed transition leaves the current
|
|
600
|
-
view selected rather than claiming the switch succeeded. Codex
|
|
626
|
+
view selected rather than claiming the switch succeeded. The Codex CLI can
|
|
601
627
|
attach to the same active conversation without interrupting the turn.
|
|
602
628
|
|
|
603
|
-
A managed Claude Code
|
|
629
|
+
A managed Claude Code CLI stays bound to the boxes.dev thread and working
|
|
604
630
|
directory it opened. Claude's Agent View and Remote Control are unavailable in
|
|
605
|
-
that
|
|
631
|
+
that CLI. Commands that would replace or move its session—`/clear`,
|
|
606
632
|
`/resume`, `/continue`, `/branch`, `/teleport`, `/tp`, and `/cd`—are rejected;
|
|
607
633
|
open or create the intended boxes.dev thread instead. Use `/add-dir` when Claude
|
|
608
634
|
only needs access to another directory. Session-preserving controls such as
|
|
@@ -610,17 +636,19 @@ only needs access to another directory. Session-preserving controls such as
|
|
|
610
636
|
available. An ordinary `claude` started in a separate machine shell keeps its
|
|
611
637
|
stock behavior.
|
|
612
638
|
|
|
613
|
-
For a started desktop thread, the
|
|
614
|
-
|
|
615
|
-
|
|
616
|
-
|
|
617
|
-
|
|
618
|
-
|
|
639
|
+
For a started desktop thread, the normal thread header shows a small pill
|
|
640
|
+
named for the current view (**GUI** or **CLI**). It opens a **Thread view**
|
|
641
|
+
menu listing both views; choosing the other view switches this thread, and an
|
|
642
|
+
unavailable CLI view stays listed with the reason it cannot open. The same
|
|
643
|
+
header keeps sharing and thread actions available in the CLI. A project's
|
|
644
|
+
default view changes only after a GUI first message is successfully sent or
|
|
645
|
+
**Open CLI** successfully commits a new thread; merely previewing the other
|
|
646
|
+
draft view does not change future drafts.
|
|
619
647
|
|
|
620
648
|
Legacy Claude CLI threads may still appear temporarily while boxes.dev retires
|
|
621
649
|
that older thread type. A running legacy terminal can be attached long enough
|
|
622
650
|
to drain safely, but a missing legacy terminal cannot be restarted. Start a
|
|
623
|
-
Claude thread in
|
|
651
|
+
Claude thread in the CLI view for new work.
|
|
624
652
|
|
|
625
653
|
## Interrupts And Stops
|
|
626
654
|
|
|
@@ -698,7 +726,7 @@ An owner can also share an eligible started Codex or Claude Code transcript
|
|
|
698
726
|
with anyone on their team who has the link. The share includes the live durable
|
|
699
727
|
conversation, status, commands, tool output, diffs, attachments, and images, so
|
|
700
728
|
review the conversation for source, credentials, or other sensitive content
|
|
701
|
-
before sharing it. GUI and
|
|
729
|
+
before sharing it. GUI and CLI views share the same ordinary conversation,
|
|
702
730
|
so the selected view does not change sharing eligibility. Drafts, setup threads,
|
|
703
731
|
and conversations that have not started cannot be shared.
|
|
704
732
|
|
|
@@ -725,11 +753,15 @@ Opening the same active share link or pinning the thread again restores the
|
|
|
725
753
|
row. Read and unread state is personal to each viewer and does not change the
|
|
726
754
|
owner's state.
|
|
727
755
|
|
|
728
|
-
Under **Thread titles**, a teammate can choose **Request access**.
|
|
729
|
-
|
|
730
|
-
|
|
731
|
-
|
|
732
|
-
|
|
756
|
+
Under **Thread titles**, a teammate can choose **Request access**. On desktop,
|
|
757
|
+
the project sidebar's **Shared by me** section appears whenever the selected
|
|
758
|
+
project has an active share or a pending access request. Shared threads are
|
|
759
|
+
listed with copy-link and revoke controls, pending requests appear above them
|
|
760
|
+
with accept and dismiss controls, and selecting any row opens that thread.
|
|
761
|
+
Owners can also review requests on mobile. Accepting a request will make the
|
|
762
|
+
current share link available to that requester in boxes.dev; the requester
|
|
763
|
+
opens it to complete access and add the thread to **Shared with me**. Requests
|
|
764
|
+
do not send email or push notifications.
|
|
733
765
|
|
|
734
766
|
The active share keeps the same URL until the owner revokes it. Revocation
|
|
735
767
|
immediately makes that URL unavailable and removes access that depended on
|
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.971",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"license": "UNLICENSED",
|
|
6
6
|
"imports": {
|
|
@@ -77,5 +77,5 @@
|
|
|
77
77
|
"e2b": "^2.18.0",
|
|
78
78
|
"ink-testing-library": "^4.0.0"
|
|
79
79
|
},
|
|
80
|
-
"devboxReleasedAt": "2026-
|
|
80
|
+
"devboxReleasedAt": "2026-09-01T03:46:51Z"
|
|
81
81
|
}
|