Merge pull request #26096 from dvdksn/codex/sbx-agent-shorthand-troubleshooting

docs: move sbx v0.42 agent caveats to troubleshooting
This commit is contained in:
David Karlsson authored and GitHub committed 2026-09-15 16:09:26 +02:00
commit af1b88d7d3
4 files changed
+16 -12

No files matched your search

@@ -14,10 +14,6 @@ Official documentation: [GitHub Copilot CLI](https://docs.github.com/en/copilot/
## Quick start
> [!NOTE]
> In Docker Sandboxes v0.42, use `sbx run docker.io/sbx/copilot-kit:latest`.
> The `copilot` shorthand is unavailable in this release.
Create a sandbox and run Copilot for a project directory:
```console
@@ -13,10 +13,6 @@ Official documentation: [Droid](https://docs.factory.ai/)
## Quick start
> [!NOTE]
> In Docker Sandboxes v0.42, use `sbx run docker.io/sbx/droid-kit:latest`.
> The `droid` shorthand is unavailable in this release.
Create a sandbox and run Droid for a project directory:
```console
@@ -14,10 +14,6 @@ Official documentation: [Kiro CLI](https://kiro.dev/docs/cli/)
## Quick start
> [!NOTE]
> In Docker Sandboxes v0.42, use `sbx run docker.io/sbx/kiro-kit:latest`.
> The `kiro` shorthand is unavailable in this release.
Create a sandbox and run Kiro for a project directory:
```console
@@ -73,6 +73,22 @@ $ sbx run --name <sandbox-name> <agent>
See [Choose a workspace](usage.md#choose-a-workspace) for mountless, direct,
and clone-mode behavior.
## Kiro, Copilot, or Droid shorthand fails
In Docker Sandboxes v0.42, `sbx run kiro`, `sbx run copilot`, and
`sbx run droid` fail because these agents moved from built-in agents to
public kits and their shorthand names aren't resolved in this release.
[Upgrade Docker Sandboxes](install.md) to v0.43.0 or later to launch
these agents by name again. If you need to stay on v0.42, use the full kit
reference for your agent:
```console
$ sbx run docker.io/sbx/kiro-kit:latest
$ sbx run docker.io/sbx/copilot-kit:latest
$ sbx run docker.io/sbx/droid-kit:latest
```
## Agent can't install packages or reach an API
Sandboxes use [network access rules](governance/access-controls/network.md) to