From efba360a39a03214b5c07e8d2845f22687dbabc7 Mon Sep 17 00:00:00 2001
From: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Date: Tue, 3 Feb 2026 15:26:54 +0000
Subject: [PATCH] docs: add SSH access section to sandbox documentation

- Add new 'SSH Access to Sandboxes' section explaining how to SSH into sandboxes
- Include callout warning about SSH key requirement before connecting
- Document how to generate SSH keys and add them to Agentuity account
- Link to SSH Key Management section in getting-started for more details

This addresses user confusion about 'Permission denied (publickey)' errors
when trying to SSH into sandboxes without first setting up SSH keys.

Co-Authored-By: Rick Blalock <rickblalock@mac.com>
---
 content/Reference/CLI/sandbox.mdx | 42 +++++++++++++++++++++++++++++++
 1 file changed, 42 insertions(+)

diff --git a/content/Reference/CLI/sandbox.mdx b/content/Reference/CLI/sandbox.mdx
index 575f4fd8..a97b74ff 100644
--- a/content/Reference/CLI/sandbox.mdx
+++ b/content/Reference/CLI/sandbox.mdx
@@ -35,6 +35,48 @@ All sandbox commands require the `cloud` prefix. For example: `agentuity cloud s
 
 **Alias:** `sb` (e.g., `agentuity cloud sb list`)
 
+## SSH Access to Sandboxes
+
+You can SSH directly into a running sandbox for interactive debugging:
+
+```bash
+# SSH into a sandbox
+agentuity cloud ssh sbx_abc123xyz
+
+# Run a command and exit
+agentuity cloud ssh sbx_abc123xyz 'ls -la /workspace'
+
+# Show SSH command without executing
+agentuity cloud ssh sbx_abc123xyz --show
+```
+
+<Callout type="warning" title="SSH Key Required">
+Before you can SSH into a sandbox, you must add your SSH public key to your Agentuity account:
+
+```bash
+# Add your SSH key (interactive - discovers keys in ~/.ssh/)
+agentuity auth ssh add
+
+# Or specify a key file directly
+agentuity auth ssh add --file ~/.ssh/id_ed25519.pub
+```
+
+If you don't have an SSH key, generate one first:
+
+```bash
+ssh-keygen -t ed25519 -C "your_email@example.com"
+```
+
+See [SSH Key Management](/Reference/CLI/getting-started#ssh-key-management) for more details.
+</Callout>
+
+Once connected, you have full shell access to the sandbox environment. This is useful for:
+
+- Debugging running processes
+- Inspecting file system state
+- Testing commands interactively
+- Viewing logs in real-time
+
 ## One-shot Execution
 
 Run a single command in a new sandbox that's automatically destroyed afterward.