CLI Overview
The Islo CLI provides commands for managing secure sandboxes, authenticating, and configuring your development environment.
Command Groups
| Group | Description |
|---|---|
| Authentication | Login, logout, API keys, and integrations |
| Sandbox Operations | Use, stop, remove, and list sandboxes |
| Agent Integration | Run AI agents in sandboxes |
| Snapshots | Save and restore sandbox state |
| Gateways | Network policies and credential injection |
| Sharing | Share sandbox ports with others |
| Configuration | Project configuration with islo.yaml |
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 --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 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
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 --agent claude # Store API key
Sharing
$ 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 # Setup wizard (islo.yaml + tools + hooks) $ islo add # Detect tools interactively $ islo add <tool> [ver] # Add specific tool to islo.yaml $ islo status # Show auth, config, tools overview $ 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
