Orgo - Cloud computers for AI agents

The Orgo CLI gives you complete control over your cloud computers from the terminal: launch and manage workspaces and computers, open an interactive shell, run multi-turn AI agent sessions, and pipe machine-readable output into any other tool.

Install

curl -fsSL https://orgo.ai/install.sh | bash

npm install -g orgo

Requires Node 20 or later. The install script will install Node for you if it’s missing. No sudo needed.

orgo login

Opens your browser, completes a device-code flow, and saves a credential under ~/.orgo/credentials.json (mode 0600). To use a separate identity in dev, set ORGO_PROFILE=dev.

Commands

orgo                          Show account, workspace, and recent computers
orgo login / logout / whoami  Account management
orgo workspaces (ws)          list · create · use · current · rename · delete
orgo computers  (c)           list · create · start · stop · restart · resize · delete
                              bash · exec · clone · rename · wait · screenshot · view · vnc-password
orgo ssh <name>               Interactive shell on a computer
orgo templates                list · show · run · build · validate · publish · schema · delete
orgo files                    list · upload · download · export · delete
orgo secrets                  list · set · delete
orgo agent                    Multi-turn AI agent TUI (resumable sessions)
orgo run "<prompt>"           One-shot agent run
orgo resume [id] / sessions   Resume or list agent sessions
orgo api-keys                 Manage API keys
orgo billing                  balance · topup · history · portal

Every command accepts --json for machine-readable output and --help for details. Pipe-friendly by default: TTY detection switches to plain text + JSON when stdout isn’t a terminal.

Create a computer

orgo computers create

Interactive by default. It prompts for workspace, name, RAM, and CPU with input validation. For scripts and CI, pass everything as flags:

orgo computers create \
  --workspace my-workspace \
  --name agent-1 \
  --ram 4 \
  --cpu 1

Flag	Values
`--ram <gb>`	4, 8, 16, 32, 64
`--cpu <cores>`	0.5, 1, 2, 4, 8, 16
`--disk <gb>`	Any size (grows only on resize)
`--os <os>`	linux (default), windows, macos, android
`--gpu <profile>`	2q (2 GB) or 4q (4 GB), Linux-only. Falls back to CPU (with a warning) if no GPU host is free
`--region <codes>`	Region hint, comma-separated
`--resolution <WxHxD>`	Defaults to `1280x720x24`. Change it and your agent’s coordinate space changes with it
`--snapshot <id>`	Boot from a snapshot or custom image
`--template <ref>`	Launch from a template, e.g. `claude-code` or `system/claude-code@1.0.0`

Resize a running computer with orgo computers resize <name> --ram 8 --cpu 4 --disk 64 (disk grows only; live RAM resize caps at 32 GB).

SSH

orgo ssh computer-name

Opens an interactive terminal session over WebSocket. Lands you in /root/Desktop by default (override with --cwd). Standard SSH disconnect sequences:

Sequence	Action
`~.` (at start of line)	OpenSSH-style disconnect
`Ctrl+C` `Ctrl+C` (within 800ms)	Discoverable disconnect
`Ctrl+D` or `exit`	Standard shell exit
Single `Ctrl+C`	Forwarded to remote (interrupts process)

Agent TUI

orgo agent

Multi-turn agent session with full conversation history, tool-call visibility, and persistent sessions. Inside the TUI:

Slash command	Action
`/help`	List slash commands
`/computer`	Switch the agent to a different computer (picker)
`/model`	Switch model: Sonnet 5 (default) or Opus 5
`/sessions`	List saved sessions
`/resume`	Resume a prior session (picker)
`/compact`	Summarize older turns to shrink context
`/usage`	Token usage for this session
`/screenshot`	Save the live screenshot and open it
`/save <name>`	Set the session title

Sessions auto-persist to ~/.orgo/sessions/ after every turn. Ctrl+C loses nothing.

Resume a session

orgo resume            # interactive picker
orgo resume <id>       # direct
orgo sessions          # list saved sessions

One-shot run

For scripts and CI:

orgo run "open chrome and search for hermes" --computer agent-1

Streams text, tool calls, and tool results to stdout. Add --json to get a single structured object at the end:

{
  "text": "Chrome is open on the Google homepage…",
  "tool_calls":   [{ "id": "toolu_…", "name": "computer", "input": { … } }],
  "tool_results": [{ "tool_use_id": "toolu_…", "display": "[screenshot]" }],
  "usage": { "prompt_tokens": 1420, "completion_tokens": 312, "total_tokens": 1732 },
  "computer": { "id": "…", "name": "agent-1" }
}

Run commands on a computer

One-shot actions for scripts and CI:

orgo computers bash agent-1 -c "ls -la"          # shell command (or pipe via stdin)
orgo computers exec agent-1 --code "print(2+2)"  # Python (--file or stdin also work)
orgo computers screenshot agent-1 -o shot.png    # save a PNG
orgo computers view agent-1                      # show the screen in your terminal
orgo computers clone agent-1                     # duplicate, preserving disk state
orgo computers rename agent-1 --to agent-2
orgo computers vnc-password agent-1              # print the VNC / terminal password

Templates

Reproducible computer definitions: build once, launch anywhere. See the Templates guide for the full schema.

orgo templates list                    # your templates plus curated ones
orgo templates show claude-code        # inspect a template
orgo templates run claude-code         # launch a computer from a template
orgo templates build ./template.yaml   # build it (streams the log live)
orgo templates validate ./template.yaml
orgo templates publish ./template.yaml
orgo templates schema                  # print the template JSON Schema

Or launch straight from a template at create time: orgo computers create --template claude-code.

Files and secrets

# Files - upload caps at 10 MB; for larger data, pull it in from inside the VM
orgo files list
orgo files upload ./data.csv
orgo files download <id>
orgo files export
orgo files delete <id>

# Secrets - stored securely and available to the computer
orgo secrets list
orgo secrets set OPENAI_API_KEY
orgo secrets delete OPENAI_API_KEY

API keys

orgo api-keys list
orgo api-keys create --name ci --workspace my-workspace
orgo api-keys delete <id>

Keys can be scoped to a single workspace, which is useful for CI tokens that should only see one project’s resources.

Environment

Variable	Purpose
`ORGO_API_KEY`	Use this key directly (skips `~/.orgo/credentials.json`)
`ORGO_API_BASE_URL`	Point at a different API host
`ORGO_PROFILE`	Credential profile (default: `default`)
`ORGO_JSON=1`	Force JSON output everywhere
`ORGO_NO_COLOR=1`	Disable ANSI colors (also respects `NO_COLOR`)

Shell completion

The CLI ships with bash, zsh, and fish completion scripts. orgo completion <shell> prints the script. Source it from your shell config to enable it:

# zsh (use `bash` or `fish` for your shell)
echo 'source <(orgo completion zsh)' >> ~/.zshrc

Completion is dynamic. It queries your live workspaces and computers, so orgo ssh <Tab> shows your actual computers.

License

MIT.

Get Started

Guides

Migrations

Templates

Model integrations

CLI

Install

Commands

Create a computer

SSH

Agent TUI

Resume a session

One-shot run

Run commands on a computer

Templates

Files and secrets

API keys

Environment

Shell completion

License

​Install

​Sign in

​Commands

​Create a computer

​SSH

​Agent TUI

​Resume a session

​One-shot run

​Run commands on a computer

​Templates

​Files and secrets

​API keys

​Environment

​Shell completion

​License

Install

Sign in

Commands

Create a computer

SSH

Agent TUI

Resume a session

One-shot run

Run commands on a computer

Templates

Files and secrets

API keys

Environment

Shell completion

License