CLI
The CLI command is computer. This page keeps the command reference grouped, tight, and easy to scan.
Install and update
Install with npm for the fastest setup. Use Nix when you want the CLI pinned in your environment.
npm install -g aicomputerInstall the published CLI globally.
nix profile install 'path:/Users/you/src/agentcomputer/apps/cli#default'Install the CLI from a local checkout with Nix.
computer helpRead the live command tree on your machine before you rely on an older example.
Auth commands
Use these commands to sign in, inspect the current account, and install local agent credentials onto a machine.
computer loginOpen the browser login flow and store a local API key.
computer login --api-key ac_live_...Sign in directly when you already have an API key.
computer whoamiPrint the current authenticated account.
computer logoutRemove the locally stored API key.
computer claude-login --machine my-machineRun the Claude login flow and install the resulting auth on a target machine.
computer codex-login --machine my-machineCopy your local Codex auth state onto a target machine.
Machine commands
Use these commands to create, inspect, list, and delete machines.
computer create my-machineCreate a managed worker with the default settings.
computer create my-machine --use-platform-defaultCreate a managed worker and force the platform default image.
computer lsList your machines.
computer get my-machineInspect one machine in detail.
computer rm my-machineDelete one machine.
Image commands
Use image commands to manage saved machine sources and your default managed-worker image.
computer image lsList saved image sources and the current default.
computer image save --kind oci-image --requested-ref ghcr.io/acme/app@sha256:...Save an OCI image source.
computer image default <source-id>Use a ready source as the default for new managed workers.
computer image default platformReset the default back to the platform image.
computer image rebuild <source-id>Start a fresh build or resolution for one source.
computer image rm <source-id>Delete one saved source.
Access commands
Use access commands to open browser surfaces, connect through SSH, and publish ports.
computer open my-machineOpen the primary app surface in the browser.
computer open my-machine --terminalOpen the managed terminal surface in the browser.
computer open my-machine --vncOpen the managed desktop surface in the browser.
computer ssh my-machineConnect over SSH.
computer ssh --setupInstall a stable SSH alias for standard ssh workflows.
computer ports ls my-machineList the published ports on a machine.
computer ports publish my-machine 8000 --subdomain apiPublish one port over HTTPS.
computer ports rm my-machine 8000Remove one published port.
Agent commands
Use agent commands to inspect installed agents and manage remote sessions on one machine.
computer agent agents my-machineList the agents installed on a machine.
computer agent sessions list my-machineList the sessions on one machine.
computer agent sessions new my-machine --agent codex --name reviewCreate or resume a named session.
computer agent prompt my-machine "inspect /workspace-my-machine" --agent codex --name reviewSend one prompt into a session scope.
computer agent watch my-machine --session <session-id>Stream live session events.
computer agent status my-machine --session <session-id>Read the current session state.
computer agent cancel my-machine --session <session-id>Cancel the active prompt on a session.
computer agent interrupt my-machine --session <session-id>Interrupt a running session without closing it.
computer agent close my-machine --session <session-id>Close one session.
ACP and tooling
Use ACP when you want to expose a remote agent session through a local ACP bridge.
computer acp serve my-machine --agent codex --name reviewBridge one remote agent session into a local ACP client.
computer completionPrint shell completion scripts.