// reference

CLI reference

Every runcode command, grouped by what it does. The CLI is a static Go binary that downloads itself on first use. The only runtime dependency is an OpenSSH client. New here? Start with the Agent plugin or Connect over SSH guides.

Authentication

Authorize this machine once; the token is saved locally.

runcode login Authorize this machine via the browser and save an API token

runcode logout Remove the saved API token

Workspaces

List, attach, and power workspaces. A successful connect attaches one sticky workspace until you disconnect.

runcode list List your workspaces (running ones are SSH-connectable)

runcode connect <ws> Mint or refresh a session and attach a workspace. --start boots a stopped one, --wait blocks until SSH answers

runcode start <ws> Boot a stopped workspace without attaching (--no-wait returns immediately)

runcode open <ws> Open the workspace browser IDE in your default browser (--print to just print the URL)

runcode current Show the attached workspace (the sticky target for exec)

runcode status List cached sessions

runcode stop [ws] Stop a workspace on the control plane (pauses compute billing)

runcode disconnect Detach and drop the session, so work reverts to your local machine

Run commands

Execute work on the cloud machine instead of your laptop.

runcode ssh <ws> [-- cmd] Open an interactive shell (bare) or run one command (with --) on a workspace by name

runcode exec -- <cmd> Run a command on the attached workspace (no name needed; preferred for agents)

runcode context One-shot digest of cwd, git state, project markers, and tool versions

Files & ports

Move files byte-for-byte and reach a workspace port locally.

runcode put <local> <remote> Upload a local file to the attached workspace

runcode get <remote> Download a file from the attached workspace

runcode write <remote> Write a file on the attached workspace from stdin (or --file)

runcode port-forward <port> Expose a workspace port locally (e.g. a dev server)

Editor integration

Let your own tools and status line reach workspaces.

runcode config-ssh Write ~/.ssh/config entries so VS Code Remote / JetBrains / git reach your workspaces (--remove to undo)

runcode install-statusline Wire the workspace status line into your Claude Code settings.json

runcode statusline Print a one-line segment for the current session

Maintenance

Preflight your setup and clear local state.

runcode doctor Preflight this machine (OpenSSH client, token, API base, reachability)

runcode install-path Put runcode on your own shell PATH

runcode clean Remove cached session material

Run runcode doctor first if a command misbehaves. It checks your OpenSSH client, the saved token, and reachability in one pass.