SSH and connect

Once a sandbox is running, you have a few ways to get inside it:

SSH (works on hosted sandboxes) — for interactive shells, one-off commands, or for handing the destination to your own SSH client.
sandbox connect (CLI-only, local sandboxes) — drops you into the Docker container’s shell directly.
sandbox code (CLI-only) — opens the sandbox in Cursor over SSH.

Prerequisites

A sandbox in the active / running / started state. See Create a sandbox.

Open an interactive SSH session

amika sandbox ssh dev-box

// The SDK doesn't shell out — it returns SSH connection info you
// hand to your own SSH client.
const ssh = await amika.getSSH("dev-box");
console.log(ssh.sshDestination); // e.g. "user@host:2222"
console.log(ssh.token);          // bearer for the proxy
console.log(ssh.expiresAt);      // ISO timestamp
console.log(ssh.repoName);       // repo subdir inside the sandbox

Run a one-off command

The CLI passes anything after -- straight to the remote shell. Use -t to allocate a TTY when the remote command needs one.

# Non-interactive command
amika sandbox ssh dev-box -- ls -la

# Interactive program (force TTY)
amika sandbox ssh -t dev-box -- top

Local-Docker shell (CLI only)

amika sandbox connect opens the Docker container’s shell directly. It only applies to local sandboxes (--local).

amika sandbox connect dev-box                # default zsh
amika sandbox connect dev-box --shell bash

Open in Cursor (CLI only)

amika sandbox code opens the sandbox in Cursor over SSH.

amika sandbox code dev-box
amika sandbox code dev-box --editor cursor   # currently the only supported editor

Revoke an SSH token

The SSH credential issued by ssh/getSSH is time-bounded. You can revoke it on demand.

amika sandbox ssh dev-box --revoke

await amika.revokeSSH("dev-box", ssh.token);

Get started

Sandboxes

Agents and sessions

Code validation

Credentials

Advanced

SSH and connect

Prerequisites

Open an interactive SSH session

Run a one-off command

Local-Docker shell (CLI only)

Open in Cursor (CLI only)

Revoke an SSH token

Next steps

Programmatic walkthrough

Sandbox lifecycle

CLI reference

​Prerequisites

​Open an interactive SSH session

​Run a one-off command

​Local-Docker shell (CLI only)

​Open in Cursor (CLI only)

​Revoke an SSH token

​Next steps

Programmatic walkthrough

Sandbox lifecycle

CLI reference

Prerequisites

Open an interactive SSH session

Run a one-off command

Local-Docker shell (CLI only)

Open in Cursor (CLI only)

Revoke an SSH token

Next steps