CLI

The CLI is a thin shell over the same public API the website uses.

Install and update

Install from the staging website installer, which proxies the latest CLI release bundle.

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

If you use Nix, run nix run github:AgentComputerAI/computer-cli or install it with nix profile install github:AgentComputerAI/computer-cli.

Command	Description
`curl -fsSL https://agentcomputer.ai/install.sh \| bash`	Install the latest published CLI bundle through the website install route.
`computer help`	Read the live command tree on your computer.
`computer upgrade`	Update the installed CLI.

Use these commands to sign in, inspect the current account, and manage the local credential cache.

Command	Description
`computer login`	Open the browser login flow and store a local API key.
`computer login --api-key ak_...`	Sign in directly when you already have an API key.
`computer whoami`	Print the current authenticated account.
`computer logout`	Remove the locally stored API key.
`computer claude-login`	Install Claude Code credentials onto a computer.
`computer codex-login`	Install Codex credentials onto a computer.

Create, inspect, list, update, and delete computers.

Command	Description
`computer create my-computer`	Create a computer with the default size preset (ram-2g: 2 GiB RAM, 5 GiB storage).
`computer create my-computer --size ram-4g`	Create a computer with a specific size preset.
`computer create my-computer --memory 16 --storage 50`	Create a computer with custom RAM and storage in GiB.
`computer create my-mac --os macos`	Create a macOS computer. macOS boots as a full VM and is accessed through VNC.
`computer create --interactive`	Create a computer with an interactive preset picker.
`computer ls`	List your computers.
`computer get my-computer`	Inspect one computer in detail.
`computer rm my-computer`	Delete one computer.
`computer power-off my-computer`	Stop a computer without deleting its stored state.
`computer power-on my-computer`	Recreate a computer runtime against the same stored state.

List and inspect available computer images.

Command	Description
`computer image ls`	List available computer images.
`computer image get <image-id>`	Inspect one computer image.

Use access commands to open browser surfaces, connect through SSH, sync files, and publish ports.

Command	Description
`computer open my-computer`	Open the primary app surface in the browser.
`computer open my-computer --vnc`	Open the managed desktop surface in the browser.
`computer ssh my-computer`	Connect over SSH.
`computer ssh my-computer --tmux`	Attach or create a persistent tmux session on connect.
`computer sync ./my-project`	Copy a local file or directory into /home/node on a computer over SCP.
`computer ports ls my-computer`	List the published ports on a computer.
`computer ports publish my-computer 8000`	Publish one port with a stable public URL. Public by default — reachable without an access session, suitable for webhooks.
`computer ports publish my-computer 8000 --private`	Publish one port that requires an access session.
`computer ports rm my-computer 8000`	Remove one published port.

Shares and snapshots are first-class CLI primitives.

Command	Description
`computer shares ls my-computer`	List active shares for a computer.
`computer shares create my-computer --email user@example.com`	Create an email share for a computer.
`computer shares create my-computer --expires 24h`	Create a direct share link for a computer.
`computer shares rm my-computer <share-id>`	Remove a share.
`computer snapshot ls my-computer`	List snapshots for a computer.
`computer snapshot create my-computer`	Create a snapshot for a computer.
`computer snapshot rm <snapshot-id>`	Delete a snapshot.
`computer snapshot restore <snapshot-id> restored-computer`	Restore a snapshot into a new computer.