cb CLI

cb <COMMAND> [OPTIONS]

cb run [COMMAND]

# Run a task with its oracle solution
cb run ./tasks/hello_file_env
 
# Run a dataset with an agent, four variants at once
cb run cua-bench-basic --agent cua-agent --model anthropic/claude-sonnet-4-20250514 -j 4
 
# List runs
cb run list

cb run task [OPTIONS] <task_path>

# Run variant 0 with the oracle solution
cb run task ./tasks/hello_file_env
 
# Run variant 2 with an agent on this machine
cb run task ./tasks/hello_file_env --variant-id 2 --agent cua-agent --model anthropic/claude-sonnet-4-20250514 --on local
 
# Show what would run without starting a sandbox
cb run ./tasks/hello_file_env --dry-run

cb run dataset [OPTIONS] <dataset_path>

# Run a registry dataset with its oracle solutions
cb run dataset cua-bench-basic
 
# Run one variant of each matching task, eight at once, in the background
cb run ./tasks --task-filter 'click*' --max-variants 1 -j 8 --detach
 
# Run every variant three times and report pass@k
cb run dataset cua-bench-basic --agent cua-agent --attempts 3

cb run list [OPTIONS]

# List runs
cb run list
 
# Include debugging details
cb run list --verbose

cb run info <run_id>

# Show one run
cb run info 30c12572

cb run watch <run_id>

# Follow a detached run
cb run watch 30c12572

cb run stop <run_id>

# Stop a run
cb run stop 30c12572

cb run logs [OPTIONS] <identifier>

# Print a run's logs
cb run logs 30c12572
 
# Print the last 50 lines
cb run logs 30c12572 --tail 50

cb interact [OPTIONS] <env_path>

# Open a task and its display, wait for Enter, then evaluate
cb interact ./tasks/hello_file_env
 
# Run variant 1 with its oracle and save a screenshot
cb interact ./tasks/hello_file_env --variant-id 1 --oracle --screenshot shot.png
 
# Resolve a task from a registry dataset
cb interact click-button --dataset cua-bench-basic

cb task [COMMAND]

# List the tasks in a directory
cb task list ./tasks
 
# Inspect one task
cb task info ./tasks/hello_file_env

cb task info <path>

# Inspect a task's variants and lifecycle functions
cb task info ./tasks/hello_file_env

cb task list [<path>]

# List tasks here
cb task list
 
# List tasks in a directory
cb task list ./tasks

cb task create [<path>]

# Scaffold a task interactively under ./tasks
cb task create ./tasks

cb task generate [OPTIONS] <prompt> [<output>]

# Generate a task
cb task generate '2048 game'
 
# Generate into a directory without prompts
cb task generate 'Sort a spreadsheet column' ./tasks/sort_column --no-interaction

cb dataset [COMMAND]

# List registry datasets
cb dataset list
 
# Build a training dataset from run outputs
cb dataset build ./outputs

cb dataset list

# List registry datasets
cb dataset list

cb dataset build [OPTIONS] <outputs_path> [<max_samples>]

# Build an aguvis-stage-1 dataset from run outputs
cb dataset build ./outputs
 
# Build 100 gui-r1 samples
cb dataset build ./outputs 100 --mode gui-r1
 
# Push a private dataset to the Hugging Face Hub
cb dataset build ./outputs --push-to-hub --repo-id me/cua-clicks --private

cb trace [COMMAND]

# Open a run's trace in the browser
cb trace view 30c12572
 
# Open a run's agent trajectories
cb trace traj 30c12572

cb trace view <identifier>

# Open a run's trace
cb trace view 30c12572
 
# Open one session's trace
cb trace view task-30c12572-click-button-v0

cb trace traj [OPTIONS] <identifier>

# Open a run's trajectories
cb trace traj 30c12572
 
# Serve the files on another port
cb trace traj 30c12572 --port 9000

cb env [COMMAND]

# List local sandboxes
cb env ls

cb env ls [OPTIONS]

# List local sandboxes
cb env ls

cb status

# Show runs, sandboxes and credentials at a glance
cb status

cb prune [OPTIONS]

# Preview what would be removed
cb prune --all --dry-run
 
# Remove run logs without asking
cb prune --runs --force
 
# Keep the 20 newest runs, delete the rest
cb prune --runs --keep 20
 
# Delete runs older than 30 days
cb prune --runs --older-than 30

cb agent [COMMAND]

# Scaffold an agent in ./my-agent
cb agent init my-agent

cb agent init [OPTIONS] <name>

# Scaffold an agent in ./my-agent
cb agent init my-agent
 
# Scaffold it into another directory
cb agent init my-agent --output-dir ./agents/my-agent

cb agent build [OPTIONS] <path>

# Build an agent image (deprecated)
cb agent build ./my-agent --tag my-agent:dev

cb image [COMMAND]

# List the canonical images
cb image
 
# Show one image
cb image info linux

cb image list [OPTIONS]

# List images
cb image list
 
# List one platform's images as JSON
cb image list --platform linux-docker --format json

cb image info <name>

# Show one image
cb image info linux

cb image create [OPTIONS] <platform>

# Create a Linux image (deprecated)
cb image create linux-docker --name my-linux

cb image delete [OPTIONS] <name>

# Delete a stored image (deprecated)
cb image delete my-linux --force

cb image clone [OPTIONS] <source> <target>

# Clone a stored image (deprecated)
cb image clone my-linux my-linux-2

cb image shell [OPTIONS] <name>

# Open a shell in a stored image (deprecated)
cb image shell my-linux

cb platform [COMMAND]

# List platforms
cb platform
 
# Show one platform
cb platform info linux-docker

cb platform list [OPTIONS]

# List platforms
cb platform list
 
# As JSON
cb platform list --format json

cb platform info <platform>

# Show one platform
cb platform info windows-qemu