@agent-sandbox/cli

Command-line interface for Agent Sandbox.

Install

Install or upgrade the CLI:

npm install -g @agent-sandbox/cli

Install the agent skill:

npx skills add https://github.com/usamaasfar/agent-sandbox/tree/main/skills/agent-sandbox-cli

Requirements

• Docker running locally

Quick Start

agent-sandbox create
agent-sandbox write <sandboxId|name> "printf 'hello\n' > /proc/1/fd/1"
agent-sandbox read <sandboxId|name>
agent-sandbox delete <sandboxId|name>

Command Reference

--version

agent-sandbox --version
agent-sandbox -v

create

agent-sandbox create [--name <name>] [--image <image>] [--clone <sandboxId|name>]

Prints the sandboxId.

delete

agent-sandbox delete <sandboxId|name>

list

agent-sandbox list

Prints a JSON array of managed sandboxes.

read

agent-sandbox read <sandboxId|name> [--tail <n>]

Returns container logs. --tail limits to the last N lines.

write

agent-sandbox write <sandboxId|name> <input> [--detach]

Runs the command and returns its output and exit code. Use --detach to fire-and-forget (returns immediately with no output, useful for starting background processes).

upload

agent-sandbox upload <sandboxId|name> <localPath> <remotePath>

Both paths must be absolute.

download

agent-sandbox download <sandboxId|name> <remotePath> <localPath>

remotePath may be a file or directory. Both paths must be absolute.

License

MIT