CLI Overview

The Islo CLI provides commands for managing secure sandboxes, authenticating, and configuring your development environment.

Command Groups

Group	Description
Authentication	Login, logout, and integrations
API Keys	Programmatic auth for CI and scripts
Project Setup	`islo init` and `islo add`
Sandbox Operations	Use, pause, stop, remove, and list sandboxes
Agent Integration	Run AI agents in sandboxes
Automations	factory lines, jobs, schedules, and triggers
Snapshots	Save and restore sandbox state
Gateways	Network policies and credential injection
Sharing	Share sandbox ports with others
Utilities	`doctor`, `switch`, `update`, `completions`, `schema`
Configuration	Project configuration with `islo.yaml`
Troubleshooting	Common problems and fixes

Global Options

These options are available for all commands:

Option	Description
`--help`, `-h`	Show help for any command
`--version`, `-V`	Show Islo version
`-o, --output`	Output format: `table` (default) or `json`
`--no-color`	Disable colored output

Quick Reference

Authentication

islo login                         # OAuth login via browser
islo logout                        # Clear stored tokens
islo switch                        # Switch between tenants/organizations
islo login --tool github           # Connect GitHub integration

API Keys

islo api-key create my-key         # Create API key (copied to clipboard)
islo api-key create my-key --expires 90  # Expires in 90 days
islo api-key list                  # List all API keys
islo api-key delete <id>           # Delete an API key
islo api-key deactivate <id>       # Temporarily disable
islo api-key activate <id>         # Re-enable
ISLO_API_KEY=... islo use ...      # Use API key for auth

Sandbox Operations

islo use [name]                    # Use sandbox (create if needed, open shell)
islo use [name] -- <cmd>           # Use sandbox and run command
islo use --source github://o/r     # Clone repo into sandbox
islo use --snapshot my-snap        # Create sandbox from snapshot
islo use --gateway-profile prod    # Use with gateway profile
islo use --environment prod        # Apply a named reusable environment
islo use --list-sessions           # List active sessions in sandbox
islo use --new-session             # Start a new session
islo use -s mysession              # Connect to specific session
islo stop <name> [-f]              # Stop sandbox (keeps in list)
islo pause <name>                  # Pause running sandbox (snapshot state, free resources)
islo resume <name>                 # Resume paused sandbox
islo rm <name> [-f]                # Remove sandbox completely
islo ls                            # List all sandboxes
islo ls --all                      # List all sandboxes in team
islo ls --status deleted           # Filter by status

Environments

islo environment list
islo environment get production
islo environment create --name production --variable PUBLIC_FLAG=enabled
islo environment patch production --secret OPENAI_API_KEY="$OPENAI_API_KEY"
islo environment remove production

Use environment names with islo use --environment <name> and environment: in islo.yaml.

Agent Integration

islo use --agent claude            # Run Claude Code in sandbox
islo use --agent cursor            # Run Cursor agent
islo use --agent claude --task "prompt"  # Background task
islo login --tool claude           # Connect Anthropic integration

For agent-authored islo automations, point the agent at islo-labs/skills (factory-lines + platform).

Automations

islo schema factory --short        # line.toml schema
islo schema job --short            # job.toml schema
islo job init <name>               # Scaffold a stage (or standalone) job
islo factory line deploy line.toml
islo factory line run <name> --param KEY=VALUE
islo factory line-run status <run-id>

Use Automations for factory lines. Put schedules on the line [trigger]. Standalone job.toml [schedule] is only for single-stage jobs with no routing.

islo share <name> [port]           # Create shareable URL
islo share <name> [port] --ttl 1h  # Share with expiration
islo shares <name>                 # List active shares
islo unshare <name> <slug>         # Revoke a share

SSH Access

islo ssh --setup             # Configure SSH for sandbox access
ssh my-sandbox.islo          # Connect via SSH (after setup)

Logs & Debugging

islo logs <name>                   # View agent sessions (default)
islo logs <name> --type exec       # View exec command logs
islo logs <name> --type interactive # View interactive sessions
islo logs <name> --follow          # Stream logs live
islo logs <name> --tail 100        # Show last 100 entries
islo logs <name> --since 2h        # Logs from last 2 hours
islo logs <name> <session-id>      # View specific session

Port Forwarding

islo port-forward <name> 8080      # Forward local 8080 to sandbox 8080
islo port-forward <name> 3000:8080 # Forward local 3000 to sandbox 8080
islo pf <name> 5432                # Alias for port-forward

Snapshots

islo snapshot save <name>           # Save snapshot of running sandbox
islo snapshot save <name> --name x  # Save with custom name
islo snapshot ls                    # List all snapshots
islo snapshot rm <name>             # Delete snapshot

Configuration & Setup

islo init                # Scaffold islo.yaml (interactive or --template)
islo add                 # Detect project signals and add setup scripts
islo add <tool> [ver]    # Append a setup_scripts entry from a built-in recipe
islo status              # Show auth, integrations, project config, and your sandboxes
islo status <name>       # Get sandbox details

Utilities

islo update                  # Update CLI to latest version
islo update --check          # Check for updates without installing
islo doctor                  # Check system health and config
islo schema                  # Machine-readable CLI schema (for AI agents)
islo schema <command>        # Schema for specific command
islo completions install     # Setup shell completions