sbx: add diagnose command (#24758)

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>

---------

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: dvdksn

content/manuals/ai/sandboxes/troubleshooting.md

@@ -6,6 +6,23 @@ description: Resolve common issues when using Docker Sandboxes.
 
 {{< summary-bar feature_name="Docker Sandboxes sbx" >}}
 
+## Run diagnostics
+
+Before digging into a specific issue, run
+[`sbx diagnose`](/reference/cli/sbx/diagnose/) to check for common problems
+with your installation, such as a missing CLI binary, an unresponsive daemon,
+a CLI/daemon version mismatch, missing storage directories, or broken
+authentication.
+
+```console
+$ sbx diagnose
+```
+
+The command prints a summary of checks that passed, warned, or failed, along
+with suggested fixes. Use `--output json` to get machine-readable output, or
+`--output github-issue` to generate a Markdown snippet suitable for pasting
+into a GitHub issue.
+
 ## Resetting sandboxes
 
 If you hit persistent issues or corrupted state, run
@@ -155,3 +172,15 @@ Windows:
 
 If you've exhausted the steps above and the problem persists, file a GitHub
 issue at [github.com/docker/sbx-releases/issues](https://github.com/docker/sbx-releases/issues).
+
+To help the Docker team investigate, generate a diagnostics bundle and share
+it when reporting the issue:
+
+```console
+$ sbx diagnose --upload
+```
+
+The bundle contains daemon logs, diagnostic check results, and basic system
+information. When `--upload` is confirmed, the bundle is uploaded to Docker
+support and the command prints a diagnostics ID. Include this ID in your
+issue so the team can correlate it with the uploaded bundle.

data/sbx_cli/sbx.yaml

@@ -17,6 +17,7 @@ options:
 see_also:
     - sbx completion - Generate the autocompletion script for the specified shell
     - sbx create - Create a sandbox for an agent
+    - sbx diagnose - Diagnose common issues with your sbx installation
     - sbx exec - Execute a command inside a sandbox
     - sbx login - Sign in to Docker
     - sbx logout - Sign out of Docker

data/sbx_cli/sbx_diagnose.yaml

@@ -0,0 +1,21 @@
+name: sbx diagnose
+synopsis: Diagnose common issues with your sbx installation
+usage: sbx diagnose
+options:
+    - name: help
+      shorthand: h
+      default_value: "false"
+      usage: help for diagnose
+    - name: output
+      shorthand: o
+      usage: 'Output format: "json" or "github-issue"'
+    - name: upload
+      default_value: "false"
+      usage: Upload diagnostics to Docker support
+inherited_options:
+    - name: debug
+      shorthand: D
+      default_value: "false"
+      usage: Enable debug logging
+see_also:
+    - sbx - Manage AI coding agent sandboxes.