CLI

Manage sandboxes from your terminal

The oc CLI lets you manage OpenComputer sandboxes directly from your terminal — create sandboxes, run commands, open interactive shells, manage checkpoints, and more.

Installation

macOS (Apple Silicon)

curl -fsSL https://github.com/diggerhq/opencomputer/releases/latest/download/oc-darwin-arm64 -o /usr/local/bin/oc
chmod +x /usr/local/bin/oc

Configuration

oc config set api-key your-api-key
oc config show

Resolution Order

Priority	Source	Example
1 (highest)	CLI flags	--api-key=xxx
2	Environment variables	OPENCOMPUTER_API_KEY
3	Config file	~/.oc/config.json
4 (lowest)	Defaults	https://app.opencomputer.dev

Global Flags

Flag	Environment Variable	Description
--api-key	OPENCOMPUTER_API_KEY	API key for authentication
--api-url	OPENCOMPUTER_API_URL	Control plane URL
--json	—	Output as JSON instead of tables

Key Workflows

Quick Start

# Create a sandbox
oc create

# Run a command and wait for the result
oc exec sb-abc123 --wait -- echo "Hello from the cloud"

# Open an interactive shell
oc shell sb-abc123

# Clean up
oc sandbox kill sb-abc123

JSON Output & Scripting

All commands support --json for machine-readable output:

# Get a sandbox ID programmatically
ID=$(oc create --json | jq -r '.sandboxID')

# List all running sandbox IDs
oc ls --json | jq -r '.[].sandboxID'

# Run a command and capture the result
RESULT=$(oc exec $ID --json --wait -- npm test)
echo $RESULT | jq '.exitCode'

Top-level Shortcuts

Shortcut	Expands to
oc create	oc sandbox create
oc ls	oc sandbox list
oc cp	oc checkpoint

Create and Shell In

oc shell $(oc create --json | jq -r '.sandboxID')

Hibernate for Cost Savings

oc sandbox hibernate sb-abc123
# ... hours later ...
oc sandbox wake sb-abc123
oc shell sb-abc123

Checkpoint and Fork

oc cp create sb-abc --name ready-state
ID1=$(oc cp spawn cp-xyz --json | jq -r '.sandboxID')
ID2=$(oc cp spawn cp-xyz --json | jq -r '.sandboxID')
oc exec $ID1 --wait -- ./test-a.sh
oc exec $ID2 --wait -- ./test-b.sh

Command Reference

Command	Description
oc sandbox	Create, list, kill, hibernate, wake
oc exec	Run commands, manage exec sessions
oc shell	Interactive PTY terminal
oc checkpoint	Snapshot, fork, restore
oc patch	Checkpoint-attached scripts
oc preview	Expose ports to the internet
oc config	Configure API key and API URL

Full flag reference for every command: CLI Reference.