From 0933b4dfca6245860e4e4125b555801794191588 Mon Sep 17 00:00:00 2001 From: David Karlsson <35727626+dvdksn@users.noreply.github.com> Date: Tue, 15 Sep 2026 09:48:40 +0000 Subject: [PATCH] docs: move sbx v0.42 agent caveats to troubleshooting The v0.42 shorthand limitation interrupts the quick start for Kiro, Copilot, and Droid even though v0.43.0 restores launching them by name. Remove the three callouts and preserve the affected-version guidance and full kit workarounds in troubleshooting. --- content/manuals/ai/sandboxes/agents/copilot.md | 4 ---- content/manuals/ai/sandboxes/agents/droid.md | 4 ---- content/manuals/ai/sandboxes/agents/kiro.md | 4 ---- content/manuals/ai/sandboxes/troubleshooting.md | 16 ++++++++++++++++ 4 files changed, 16 insertions(+), 12 deletions(-) diff --git a/content/manuals/ai/sandboxes/agents/copilot.md b/content/manuals/ai/sandboxes/agents/copilot.md index 08e9bbd224..feb5b68b92 100644 --- a/content/manuals/ai/sandboxes/agents/copilot.md +++ b/content/manuals/ai/sandboxes/agents/copilot.md @@ -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 diff --git a/content/manuals/ai/sandboxes/agents/droid.md b/content/manuals/ai/sandboxes/agents/droid.md index e74e648bce..40bfaddb74 100644 --- a/content/manuals/ai/sandboxes/agents/droid.md +++ b/content/manuals/ai/sandboxes/agents/droid.md @@ -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 diff --git a/content/manuals/ai/sandboxes/agents/kiro.md b/content/manuals/ai/sandboxes/agents/kiro.md index 47932e2a7f..b9d7bc6940 100644 --- a/content/manuals/ai/sandboxes/agents/kiro.md +++ b/content/manuals/ai/sandboxes/agents/kiro.md @@ -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 diff --git a/content/manuals/ai/sandboxes/troubleshooting.md b/content/manuals/ai/sandboxes/troubleshooting.md index 0ecaa572e6..b08d5683dc 100644 --- a/content/manuals/ai/sandboxes/troubleshooting.md +++ b/content/manuals/ai/sandboxes/troubleshooting.md @@ -73,6 +73,22 @@ $ sbx run --name 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