@boxes-dev/dvb-runtime 1.0.1103 → 1.0.1105
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 +34 -0
- package/dist/agent-init-guides/app.md +6 -5
- package/dist/agent-init-guides/flow.md +72 -12
- package/dist/agent-init-guides/git-ssh.md +9 -4
- package/dist/agent-init-guides/manifest.md +6 -0
- package/dist/agent-init-guides/recovery.md +22 -0
- package/dist/agent-init-guides/running.md +12 -0
- package/dist/agent-init-guides/untracked.md +2 -1
- package/dist/bin/dvb.mjs +1228 -1758
- package/dist/bin/dvbd.mjs +6 -6
- package/dist/product-docs/references/agent-tools.md +32 -5
- package/dist/product-docs/references/automations.md +18 -3
- package/dist/product-docs/references/cli.md +6 -4
- package/dist/product-docs/references/core-concepts.md +1 -1
- package/dist/product-docs/references/desktop-workbench.md +28 -3
- package/dist/product-docs/references/environment-setup-validation.md +22 -0
- package/dist/product-docs/references/files-git-and-review.md +32 -18
- package/dist/product-docs/references/fork-workflows.md +6 -3
- package/dist/product-docs/references/getting-started.md +2 -1
- package/dist/product-docs/references/index.md +2 -1
- package/dist/product-docs/references/linear.md +15 -0
- package/dist/product-docs/references/member-managed-files.md +2 -1
- package/dist/product-docs/references/mobile.md +63 -17
- package/dist/product-docs/references/onbox-agent-tools.md +224 -66
- package/dist/product-docs/references/ports-terminal-and-runtime.md +5 -3
- package/dist/product-docs/references/project-setup.md +67 -17
- package/dist/product-docs/references/security-and-data.md +3 -2
- package/dist/product-docs/references/slack.md +8 -5
- package/dist/product-docs/references/threads-and-agents.md +25 -8
- package/dist/product-docs/references/troubleshooting.md +7 -5
- package/dist/product-docs/references/unattended-work.md +5 -0
- package/dist/prompts/local-services-scan.md +3 -4
- package/package.json +2 -2
|
@@ -72,8 +72,9 @@ temporary storage that only the user's account can use. boxes.dev deletes it
|
|
|
72
72
|
once the Template box has copied the threads, or when the import fails or the
|
|
73
73
|
upload goes unused.
|
|
74
74
|
|
|
75
|
-
Untracked
|
|
76
|
-
`.
|
|
75
|
+
Untracked Git worktrees inside a repository, including disposable agent
|
|
76
|
+
checkouts under `.claude/worktrees` and `.codex/worktrees`, are unchecked by
|
|
77
|
+
default in the setup bundle review. Users
|
|
77
78
|
can explicitly include all or selected worktrees when they need them; adjacent
|
|
78
79
|
agent settings and unrelated project directories remain included.
|
|
79
80
|
|
|
@@ -91,11 +91,14 @@ You can link by:
|
|
|
91
91
|
Until your Slack identity is linked, the app answers any mention or app DM from
|
|
92
92
|
you, including `help`, with a DM containing a connect link, the next setup
|
|
93
93
|
steps, and links to the Slack help article and support. The connect link works
|
|
94
|
-
whatever email your Slack profile uses
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
94
|
+
whatever email your Slack profile uses.
|
|
95
|
+
|
|
96
|
+
**Link your account**, **Connect Slack**, and **Find my Slack account** look
|
|
97
|
+
for a Slack account with your verified boxes.dev email and link it. When none
|
|
98
|
+
matches, Slack opens and asks you to sign in to the team's workspace, and
|
|
99
|
+
boxes.dev links the account you sign in with. The sign-in can't link a bot, a
|
|
100
|
+
guest, a member of another workspace, or an account that is already linked to
|
|
101
|
+
another boxes.dev user. Verify your boxes.dev email before linking.
|
|
99
102
|
|
|
100
103
|
## Create And Activate Your Default Slack Receiver
|
|
101
104
|
|
|
@@ -293,10 +293,13 @@ Supported remote HTTP commands are another entry point to the same list. Running
|
|
|
293
293
|
a command such as `codex mcp add <name> --url <url>` or `claude mcp add
|
|
294
294
|
--transport http <name> <url>` in a Template box or devbox creates the central
|
|
295
295
|
current-project connection. It does not create a separate machine-only copy.
|
|
296
|
-
When the server uses OAuth, the command will
|
|
297
|
-
|
|
298
|
-
|
|
299
|
-
|
|
296
|
+
When the server uses OAuth, the command will print a boxes.dev sign-in link
|
|
297
|
+
and a `dvb mcp authorize` command, and it will try to open the link in your
|
|
298
|
+
browser. If the browser doesn't open, open the link yourself, or run that
|
|
299
|
+
command in a terminal on your own computer, not on the box. An agent that runs
|
|
300
|
+
the command for you will give you the link. To enable both agents, run each
|
|
301
|
+
agent's setup command with the same name, URL, and authentication details,
|
|
302
|
+
including any API-key headers.
|
|
300
303
|
The second command will add its agent to the existing project connection;
|
|
301
304
|
repeating either command will keep the existing connection and sign-in. OAuth
|
|
302
305
|
still requires authorization for each agent. For an **All projects** connection
|
|
@@ -1097,6 +1100,16 @@ to finish or use the runtime controls if the whole runtime is stuck.
|
|
|
1097
1100
|
The desktop thread list groups work by devboxes, automations, and, when the
|
|
1098
1101
|
project has one, Template-box threads.
|
|
1099
1102
|
|
|
1103
|
+
On desktop, a devbox folder is a row with an open or closed folder icon, the
|
|
1104
|
+
folder's name, and its devbox count. A closed folder also shows the most
|
|
1105
|
+
urgent state among its threads, such as running, needs input, or unread. While
|
|
1106
|
+
the user scrolls through an open folder, its row stays pinned below the
|
|
1107
|
+
**Devboxes** heading until the next folder or the unfiled devboxes reach it.
|
|
1108
|
+
**Sidebar density**, under **Appearance and layout** in **Settings > General**,
|
|
1109
|
+
sets the thread list's spacing to **Comfortable** (the default), **Cozy**, or
|
|
1110
|
+
**Compact**. It is saved on that computer only, and **Restore appearance and
|
|
1111
|
+
layout defaults** returns it to Comfortable.
|
|
1112
|
+
|
|
1100
1113
|
Thread sections include pinned and recent chats. On desktop, drag pinned
|
|
1101
1114
|
threads or devboxes to rearrange them within their **Pinned** section. The order
|
|
1102
1115
|
will sync across devices. A grouped devbox moves with its threads. Template
|
|
@@ -1210,10 +1223,14 @@ section. The thread's permanent `/thread/` link is different: it identifies
|
|
|
1210
1223
|
the thread for Team work, Git history, and the CLI, but does not grant access
|
|
1211
1224
|
or save the thread by itself.
|
|
1212
1225
|
It always applies the current team policy, privacy setting, and share access.
|
|
1213
|
-
On a shared-thread browser page, choose **Open in app** to open
|
|
1214
|
-
|
|
1215
|
-
|
|
1216
|
-
|
|
1226
|
+
On a shared-thread or `/thread/` browser page, choose **Open in app** to open
|
|
1227
|
+
the thread in the desktop app, or in the mobile app when viewed on a phone or
|
|
1228
|
+
tablet. The owner's own thread opens as their ordinary thread. A teammate's
|
|
1229
|
+
`/thread/` page offers the button only in a desktop browser, because the mobile
|
|
1230
|
+
app cannot open a teammate's thread from a link. If the viewer has never signed
|
|
1231
|
+
in to that app, the button opens a page with a download option instead. Inside
|
|
1232
|
+
the desktop app, clicking a boxes.dev `/thread/` link or share link opens the
|
|
1233
|
+
thread in the app rather than in the browser.
|
|
1217
1234
|
|
|
1218
1235
|
To save an ordinary Team work thread, choose **Pin to my workbench**. A
|
|
1219
1236
|
teammate's thread has a `…` menu in its header and on its **Shared with me**
|
|
@@ -423,8 +423,9 @@ project that uses that separate access method.
|
|
|
423
423
|
|
|
424
424
|
If a repository or API request is still rejected while `gh` is enabled, use
|
|
425
425
|
**Manage repository access** to check App access, and reconnect GitHub if the
|
|
426
|
-
page requests it. If your organization cannot approve the App, choose
|
|
427
|
-
personal access**
|
|
426
|
+
page requests it. If your organization cannot approve the App, choose
|
|
427
|
+
**Connect personal access** under **GitHub CLI access** and authorize the
|
|
428
|
+
official GitHub CLI. Personal access is
|
|
428
429
|
also available when App repository access works but a command needs broader
|
|
429
430
|
permissions. Without personal access, boxes.dev checks that the App can reach
|
|
430
431
|
every known project repository before issuing its credential. With personal
|
|
@@ -459,7 +460,7 @@ its original error if the command is denied.
|
|
|
459
460
|
|
|
460
461
|
For issue changes or publishing check results, ask the installation owner to
|
|
461
462
|
approve Issues and Checks read and write, then retry. The App also requests
|
|
462
|
-
read-only access to deployments
|
|
463
|
+
read-only access to deployments. Reading the user's
|
|
463
464
|
account email addresses requires that user's approval of the updated GitHub
|
|
464
465
|
authorization. Choose **Update connection** in **Account** or **Integrations →
|
|
465
466
|
GitHub** to review and approve it.
|
|
@@ -472,8 +473,9 @@ optional personal access may provide the required permission. Do not change
|
|
|
472
473
|
credentials automatically after a command fails.
|
|
473
474
|
|
|
474
475
|
To let `gh` use the user's own GitHub permissions, connect optional personal
|
|
475
|
-
access. In **
|
|
476
|
-
|
|
476
|
+
access. In **Integrations → GitHub**, choose **Connect personal access** under
|
|
477
|
+
**GitHub CLI access**; in **Account** settings, choose **Connect** under
|
|
478
|
+
**Personal GitHub CLI access (optional)**. Alternatively, run `gh auth login`
|
|
477
479
|
on the Template box or devbox. It will print a one-time code and a GitHub
|
|
478
480
|
approval URL, then wait until the user approves with the GitHub account
|
|
479
481
|
connected to boxes.dev. An agent that runs it should give the user the code and
|
|
@@ -63,6 +63,11 @@ keeps its original deadline. Cancel with the returned request ID when the
|
|
|
63
63
|
work finishes. A hold keeps the box and its agent available; it does not
|
|
64
64
|
launch, supervise or restart a command.
|
|
65
65
|
|
|
66
|
+
After 24 hours of continuous running, a box pauses briefly. When activity or
|
|
67
|
+
a live hold still keeps it awake, boxes.dev usually resumes it within seconds,
|
|
68
|
+
subject to the usual billing and awake devbox limits. Commands continue where
|
|
69
|
+
they left off, but network connections may need to reconnect.
|
|
70
|
+
|
|
66
71
|
An awake box uses box-hours even while waiting, and agent responses may use
|
|
67
72
|
model allowance. The response estimates box-hours for the requested interval
|
|
68
73
|
at the current box size. It is not an additional charge or a total spending
|
|
@@ -29,7 +29,7 @@ Important requirements (read carefully):
|
|
|
29
29
|
What to find:
|
|
30
30
|
|
|
31
31
|
- `appEntrypoints`: the primary command(s) a developer runs from the project root to start the app locally (long-running dev servers, watchers, "run the app" commands). If local dev requires multiple terminals (e.g. "backend" + "frontend"), include each as a separate entry with a clear description.
|
|
32
|
-
- `backgroundServices`: supporting services expected to be running for local dev (database, cache, queue, search, object storage emulator, auth emulator, etc). Prefer the repo's canonical way to start them (compose, just, make, scripts). `httpPort` is
|
|
32
|
+
- `backgroundServices`: supporting services expected to be running for local dev (database, cache, queue, search, object storage emulator, auth emulator, etc). Prefer the repo's canonical way to start them (compose, just, make, scripts). `httpPort` is the port an HTTP service listens on; for non-HTTP services (Postgres/Redis/etc), use `null` even if they expose other ports.
|
|
33
33
|
|
|
34
34
|
Minimum evidence to gather (run these, plus anything else you need):
|
|
35
35
|
|
|
@@ -80,8 +80,7 @@ How to decide what to output (avoid noise):
|
|
|
80
80
|
- Example: if `npm run dev` already starts the backend process, do not also list that backend command as a background service.
|
|
81
81
|
- Every background-service `name` must be a unique machine identifier matching `^[A-Za-z0-9._-]+$`. Use names such as `postgres`, `atlas-local`, or `pubsub_emulator`; do not use spaces, parentheses, or human-readable annotations.
|
|
82
82
|
- Every `command` must contain only the exact executable shell command. Never append explanations or parenthetical notes to the command string.
|
|
83
|
-
- For compose-defined background dependencies,
|
|
84
|
-
- `docker compose up -d <service>` (or `docker-compose up -d <service>` if that's what's documented)
|
|
83
|
+
- For compose-defined background dependencies, use the compose command the repo documents for starting them.
|
|
85
84
|
- Do not invent service names; use names found in compose files / docs.
|
|
86
85
|
- For background services started via just/make/task, use those commands (for example: `just db`, `make redis`, `task up`), but only if present and documented in the repo.
|
|
87
86
|
|
|
@@ -99,6 +98,6 @@ Return JSON with this shape:
|
|
|
99
98
|
- backgroundServices: [{ name, command, httpPort }]
|
|
100
99
|
- name must be a unique machine identifier matching `^[A-Za-z0-9._-]+$` (e.g. "postgres" or "atlas-local")
|
|
101
100
|
- command must be the exact executable command string to start the service, without commentary
|
|
102
|
-
- httpPort is the HTTP port
|
|
101
|
+
- httpPort is the service's HTTP port, or null if not applicable/unknown
|
|
103
102
|
|
|
104
103
|
Return only JSON that matches the provided schema.
|
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.1105",
|
|
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-26T23:50:05Z"
|
|
81
81
|
}
|