@boxes-dev/dvb-runtime 1.0.1073 → 1.0.1075
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/agent-init-guides/agent-config.md +10 -2
- package/dist/agent-init-guides/flow.md +52 -14
- package/dist/agent-init-guides/manifest.md +7 -2
- package/dist/bin/dvb.mjs +3608 -2988
- package/dist/bin/dvbd.mjs +6 -6
- package/dist/product-docs/references/agent-tools.md +9 -0
- package/dist/product-docs/references/automations.md +3 -2
- package/dist/product-docs/references/cli.md +16 -0
- package/dist/product-docs/references/desktop-workbench.md +24 -4
- package/dist/product-docs/references/files-git-and-review.md +11 -2
- package/dist/product-docs/references/fork-workflows.md +3 -2
- package/dist/product-docs/references/index.md +2 -1
- package/dist/product-docs/references/managed-environment-files.md +10 -10
- package/dist/product-docs/references/member-managed-files.md +13 -12
- package/dist/product-docs/references/mobile.md +42 -4
- package/dist/product-docs/references/onbox-agent-tools.md +172 -17
- package/dist/product-docs/references/project-setup.md +35 -13
- package/dist/product-docs/references/remote-assistants.md +3 -3
- package/dist/product-docs/references/security-and-data.md +6 -0
- package/dist/product-docs/references/team-template.md +3 -2
- package/dist/product-docs/references/threads-and-agents.md +66 -1
- package/package.json +2 -2
|
@@ -198,9 +198,14 @@ adapted for Linux without replacing the Template box's managed shell setup.
|
|
|
198
198
|
Removing a file entry removes that explicit copy, but repository copying or
|
|
199
199
|
the separate untracked-file selection may still include the file.
|
|
200
200
|
|
|
201
|
-
|
|
202
|
-
repositories
|
|
203
|
-
|
|
201
|
+
By default, agent setup creates a single-repository project. The coding agent
|
|
202
|
+
suggests including other repositories only when it finds evidence that the
|
|
203
|
+
user develops them together, such as one repository depending on another by
|
|
204
|
+
relative path, and it asks the user first. When the agent starts in a folder
|
|
205
|
+
of unrelated repositories, it asks which one to set up. For a folder
|
|
206
|
+
containing several repositories, agent setup can select those repositories
|
|
207
|
+
separately from ordinary files and folders alongside them. Automatic GitHub
|
|
208
|
+
access remains the default for GitHub repositories. SSH setup
|
|
204
209
|
uses one key for the selected repositories that need it, including child
|
|
205
210
|
repositories and repositories on other hosts; the key needs access on each
|
|
206
211
|
host. Automatic GitHub access and SSH for another host can be used together.
|
|
@@ -212,7 +217,8 @@ these with the coding agent before approving the launch.
|
|
|
212
217
|
Conversation discovery initially lists the selected repositories and their
|
|
213
218
|
Git worktrees. Use `dvb agent-init detect agent-threads --all` to find and
|
|
214
219
|
optionally select conversations from other projects as well. Import remains
|
|
215
|
-
optional and starts with no conversations selected.
|
|
220
|
+
optional and starts with no conversations selected. Conversations can also be
|
|
221
|
+
imported after setup with `dvb threads import` (see Threads And Agents).
|
|
216
222
|
|
|
217
223
|
`dvb agent-init github cli status` shows the existing account setting for
|
|
218
224
|
signing the `gh` command into your connected GitHub account on your boxes.
|
|
@@ -360,12 +366,17 @@ GitHub and Slack. Codex and Claude Code use their normal browser sign-in in
|
|
|
360
366
|
the same tab, which returns to the page through the CLI on the user's
|
|
361
367
|
computer; neither agent needs to be installed there. **Use an API key** saves
|
|
362
368
|
a key instead. **Done** becomes available once a coding agent is connected,
|
|
363
|
-
and the command waits until the user chooses it.
|
|
369
|
+
and the command waits until the user chooses it. If an agent is already
|
|
370
|
+
connected to boxes.dev, no new sign-in is needed; choose **Done** to continue
|
|
371
|
+
setup with that account. Over SSH, the command prints
|
|
364
372
|
a link for the user to open and exits: on that page, Codex shows a one-time
|
|
365
373
|
code to enter on ChatGPT, Claude Code asks for the code Claude shows, and the
|
|
366
374
|
user tells the agent when they're done. **Use a code instead** switches a
|
|
367
375
|
local page to the same code flows for setups where browser sign-in can't
|
|
368
|
-
reach the CLI, such as a container.
|
|
376
|
+
reach the CLI, such as a container. Choosing **Done** there also finishes the
|
|
377
|
+
waiting command. With an older CLI, tell the agent you clicked Done if it
|
|
378
|
+
keeps waiting; it can stop the command and check setup status.
|
|
379
|
+
`dvb agent-init check` requires at least
|
|
369
380
|
one connected coding agent.
|
|
370
381
|
|
|
371
382
|
Once the setup thread starts on the Template box, `dvb agent-init run` tells
|
|
@@ -404,13 +415,14 @@ user selects the key to switch to it.
|
|
|
404
415
|
**Log in with Claude** saves a claude.ai login, the same kind of sign-in
|
|
405
416
|
Claude Code gets from `/login` on a computer. Claude on Template boxes and
|
|
406
417
|
devboxes then has the account's claude.ai features: skills and plugins synced
|
|
407
|
-
from claude.ai
|
|
418
|
+
from claude.ai, the connectors the user added there, such as Gmail, and fast
|
|
419
|
+
mode.
|
|
408
420
|
boxes.dev keeps the sign-in current, but Claude requires a new sign-in about
|
|
409
421
|
every four weeks; Claude sets the exact date at each sign-in. Three days
|
|
410
422
|
before that deadline, the account's row shows **Sign in again by** a date and
|
|
411
423
|
the mobile app shows a reminder banner; after it passes, Claude reports that
|
|
412
424
|
the sign-in expired until the user signs in again. Accounts connected before claude.ai logins were available show
|
|
413
|
-
**Setup token**. They keep working without claude.ai features, and the row's
|
|
425
|
+
**Setup token**. They keep working without claude.ai features or fast mode, and the row's
|
|
414
426
|
**Switch to claude.ai login** action signs in again and converts that saved
|
|
415
427
|
account to a claude.ai login. An older account saved without a Claude account
|
|
416
428
|
ID gets a new row for the login instead, which becomes active; the user can
|
|
@@ -440,7 +452,9 @@ subscription radio chooses the **Default** account while automatic selection
|
|
|
440
452
|
is enabled; **Default** appears only while an automatic option is on, and
|
|
441
453
|
**Active** marks the account currently in use. boxes.dev prefers
|
|
442
454
|
the default whenever its usage is available, switches to another subscription
|
|
443
|
-
when it is exhausted, and returns after quota resets
|
|
455
|
+
when it is exhausted, and returns after quota resets; for Codex, only once a
|
|
456
|
+
fresh reading of the default confirms it (an account that cannot be read is
|
|
457
|
+
assumed reset). A saved API key also
|
|
444
458
|
exposes **Automatically switch to API when all subscriptions are exhausted**,
|
|
445
459
|
which requires a separate opt-in and incurs the API provider's charges. Unknown
|
|
446
460
|
quota and authentication failures alone do not authorize API switching.
|
|
@@ -449,9 +463,16 @@ on either automatic option while an API key is selected moves the agent to a
|
|
|
449
463
|
subscription unless every subscription is exhausted and API switching is on.
|
|
450
464
|
Codex and Claude settings are independent, global, and affect conversations started from either desktop or mobile. Mobile can
|
|
451
465
|
still select accounts manually; these automatic controls are configured on
|
|
452
|
-
desktop. Account changes retain conversation history
|
|
453
|
-
|
|
454
|
-
|
|
466
|
+
desktop. Account changes retain conversation history. A Codex turn that is
|
|
467
|
+
running when its account changes stops, and boxes.dev continues it on the new
|
|
468
|
+
account with an empty turn about five seconds later; its failure card says so.
|
|
469
|
+
If the new account is out of usage too, a turn that hits its limit waits up to
|
|
470
|
+
a minute and continues on the next account rotation selects. A Codex turn that
|
|
471
|
+
stopped at a usage limit before the switch still needs a follow-up. When Claude hits a usage limit and automatic selection finds another
|
|
472
|
+
account, boxes.dev resumes the same conversation and continues the unfinished
|
|
473
|
+
request before queued follow-ups. Stop cancels this recovery. With no available
|
|
474
|
+
account, or with background work or pending steering that cannot be safely
|
|
475
|
+
resumed, the turn stays stopped.
|
|
455
476
|
|
|
456
477
|
Configure agents manages the Codex and Claude accounts that run coding-agent
|
|
457
478
|
threads. Remote MCP connections are managed separately from **Integrations →
|
|
@@ -798,7 +819,8 @@ The Agent threads row is off by default. Users can leave it out or use
|
|
|
798
819
|
Customize to select specific Codex and Claude threads. Thread history import
|
|
799
820
|
copies transcript history only; it does not copy agent account auth or
|
|
800
821
|
guarantee that an old thread can resume without connected agent credentials and
|
|
801
|
-
compatible project state.
|
|
822
|
+
compatible project state. Threads left out here can be imported after setup
|
|
823
|
+
with `dvb threads import` (see Threads And Agents).
|
|
802
824
|
|
|
803
825
|
Desktop setup can also offer supported Codex and Claude configuration such as
|
|
804
826
|
memory files, skills, commands, subagents, settings, and MCP definitions. It
|
|
@@ -41,9 +41,9 @@ devbox. Archived conversations need to be unarchived in boxes.dev first;
|
|
|
41
41
|
conversations in storage need to be restored. A history-only conversation
|
|
42
42
|
cannot continue. These recovery actions are not performed automatically.
|
|
43
43
|
|
|
44
|
-
A new task uses the agent's saved model
|
|
45
|
-
|
|
46
|
-
|
|
44
|
+
A new task uses the agent's saved model, reasoning effort and speed for the
|
|
45
|
+
project, unless the user asks for a specific model, reasoning effort or speed.
|
|
46
|
+
Claude's fast speed is fast mode. The assistant can choose from the models the
|
|
47
47
|
boxes.dev model picker lists for the account, and the start receipt reports
|
|
48
48
|
what the agent was launched with.
|
|
49
49
|
|
|
@@ -66,6 +66,12 @@ selected project repos and their Git worktrees. A user can choose to show all
|
|
|
66
66
|
local threads when they want to include history from another project or from a
|
|
67
67
|
session whose project could not be identified.
|
|
68
68
|
|
|
69
|
+
After setup, `dvb threads import` copies the local Codex and Claude history a
|
|
70
|
+
user selects to a project's Template box. The CLI uploads a compressed copy to
|
|
71
|
+
temporary storage that only the user's account can use. boxes.dev deletes it
|
|
72
|
+
once the Template box has copied the threads, or when the import fails or the
|
|
73
|
+
upload goes unused.
|
|
74
|
+
|
|
69
75
|
Untracked disposable agent checkouts under `.claude/worktrees` and
|
|
70
76
|
`.codex/worktrees` are unchecked by default in the setup bundle review. Users
|
|
71
77
|
can explicitly include all or selected worktrees when they need them; adjacent
|
|
@@ -196,8 +196,9 @@ For a managed template the startup sequence is:
|
|
|
196
196
|
1. Start from the saved template and prepare the member's durable environment.
|
|
197
197
|
2. The prepared devbox may wait until that member starts typing a first prompt
|
|
198
198
|
for a new devbox. Steps 3 to 5 can then run before the member sends it.
|
|
199
|
-
|
|
200
|
-
member
|
|
199
|
+
Steps 4 and 5 still run when a required member file or value is missing,
|
|
200
|
+
and the desktop app warns the member until they add it. A member file that
|
|
201
|
+
cannot be written safely stops them.
|
|
201
202
|
3. boxes.dev checks the member's configured connections and files.
|
|
202
203
|
4. **Team startup script** (optional, team-owned). It runs with the same member
|
|
203
204
|
environment as the member startup script, immediately before it. Saving
|
|
@@ -756,6 +756,19 @@ enabled. On desktop, `/model` opens the model picker, and `/model <model>`
|
|
|
756
756
|
switches directly to a known model. Older supported model generations appear
|
|
757
757
|
under **More models** in the picker.
|
|
758
758
|
|
|
759
|
+
Fast mode runs Claude faster at a higher usage rate on models that support it,
|
|
760
|
+
such as Opus 5.5. On desktop, the model menu has an **Enable fast mode** switch
|
|
761
|
+
and shows a lightning icon beside the model name while fast mode is on; `/fast`
|
|
762
|
+
toggles it, and `/fast on` or `/fast off` sets it. Mobile lists it as **Fast**
|
|
763
|
+
under **Speed**. The CLI agent view, automations, delegated threads, and remote
|
|
764
|
+
assistants accept it as the `fast` speed. Fast mode needs extra usage turned on
|
|
765
|
+
in the Claude account and a Claude account connected as a claude.ai login; an
|
|
766
|
+
account labeled **Setup token** needs **Switch to claude.ai login** first. When
|
|
767
|
+
Claude reports fast mode as unavailable, for example because extra usage is off,
|
|
768
|
+
the account uses a setup token, the organization has turned it off, or a fast
|
|
769
|
+
mode rate limit is in effect, the menu shows the reason and Claude runs at
|
|
770
|
+
standard speed.
|
|
771
|
+
|
|
759
772
|
An idle Claude chat can continue in a separate chat. Use exact `/fork` to
|
|
760
773
|
continue from the current tip on the current Template box or devbox. Or use the
|
|
761
774
|
Split icon beneath a completed desktop response to keep history only through
|
|
@@ -770,7 +783,7 @@ for managed Claude chats that support chat forking. Desktop remembers confirmed
|
|
|
770
783
|
support for each Template box and devbox and keeps the controls available while
|
|
771
784
|
reconnecting; choosing a fork action will connect to the source first.
|
|
772
785
|
|
|
773
|
-
Model and
|
|
786
|
+
Model, reasoning, and fast mode selections belong to the Claude thread. A new
|
|
774
787
|
selection remains associated with that thread while it is applied, and the
|
|
775
788
|
confirmed settings follow the thread when it is reopened or resumed on desktop
|
|
776
789
|
or mobile. Changing one thread does not change another existing thread; the
|
|
@@ -1139,6 +1152,58 @@ Devbox threads are the normal place to do coding work. A devbox can contain more
|
|
|
1139
1152
|
than one thread, but finished work still needs to be saved intentionally with
|
|
1140
1153
|
git or file transfer before the devbox is destroyed.
|
|
1141
1154
|
|
|
1155
|
+
## Import Threads From Your Computer
|
|
1156
|
+
|
|
1157
|
+
Codex and Claude threads that ran on a user's computer can be copied to a
|
|
1158
|
+
project's Template box after setup as well as during it. Imported threads
|
|
1159
|
+
appear in the project's thread list under the Template box, and they can be
|
|
1160
|
+
opened and continued like other threads once that agent is connected. Only the
|
|
1161
|
+
conversation history is copied. Agent sign-ins, settings, and plugins are not.
|
|
1162
|
+
|
|
1163
|
+
The import runs on the user's computer, because that's where the history is.
|
|
1164
|
+
An agent on a Template box or devbox can't read it. If a user asks an on-box
|
|
1165
|
+
agent to import their local threads, the agent should ask them to run
|
|
1166
|
+
`dvb threads import` on their computer, or to ask a coding agent there to run
|
|
1167
|
+
it. If `dvb` isn't installed on that computer, see the CLI doc's Install
|
|
1168
|
+
section.
|
|
1169
|
+
|
|
1170
|
+
From the project's folder on the computer, list the threads that would be
|
|
1171
|
+
imported, then import them:
|
|
1172
|
+
|
|
1173
|
+
```bash
|
|
1174
|
+
dvb threads import --project <project> --dry-run
|
|
1175
|
+
dvb threads import --project <project>
|
|
1176
|
+
```
|
|
1177
|
+
|
|
1178
|
+
By default, the command imports every unarchived Codex and Claude thread that
|
|
1179
|
+
ran in that folder or its Git worktrees. Pass `--path <folder>` to use a
|
|
1180
|
+
different folder. These options change the selection:
|
|
1181
|
+
|
|
1182
|
+
- `--agent codex` or `--agent claude` imports one agent's threads.
|
|
1183
|
+
- `--since 2026-09-01` or `--since 30d` keeps threads updated on or after a
|
|
1184
|
+
date, or within a number of days.
|
|
1185
|
+
- `--limit <n>` keeps the `n` most recently updated threads.
|
|
1186
|
+
- `--include-archived` adds archived Codex threads.
|
|
1187
|
+
- `--all-local` includes threads from any folder on the computer.
|
|
1188
|
+
- `--thread <id>,<id>` imports exactly the listed threads, using IDs from
|
|
1189
|
+
`--dry-run`, and ignores the other options.
|
|
1190
|
+
|
|
1191
|
+
To help a user choose specific threads, a coding agent on their computer should
|
|
1192
|
+
run the dry run with `--json`, show the user the matching threads with their
|
|
1193
|
+
agent, title, last update, and size, ask which ones to import, and then pass
|
|
1194
|
+
the chosen IDs with `--thread`.
|
|
1195
|
+
|
|
1196
|
+
Running the import again is safe, because threads already on the Template box
|
|
1197
|
+
are skipped. If a thread has changed on either side since an earlier import
|
|
1198
|
+
(for example, it was continued on the Template box), it's skipped and reported,
|
|
1199
|
+
and the other threads are still imported. boxes.dev will wake a sleeping
|
|
1200
|
+
Template box for the import. Large selections upload in several batches; if
|
|
1201
|
+
the command stops partway, run it again to import the rest. A single thread
|
|
1202
|
+
whose compressed copy is over 1 GB is reported as too large and skipped.
|
|
1203
|
+
|
|
1204
|
+
Projects created from a Team Template don't have a Template box of their own,
|
|
1205
|
+
so threads can't be imported into them.
|
|
1206
|
+
|
|
1142
1207
|
## Notifications And Unread State
|
|
1143
1208
|
|
|
1144
1209
|
Thread rows can show unread and active indicators so users can see which
|
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.1075",
|
|
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-15T02:35:58Z"
|
|
81
81
|
}
|