cloudrouter

Cloud VMs/GPUs for Claude Code/Codex

The missing primitive — giving Claude Code and Codex the ability to start up VMs and run experiments with GPUs. Agents start up VMs from your local directory, run commands, transfer files, control browsers, and run GPUs directly from the command line.

Install

Install cloudrouter as a skill for Claude Code, Codex, or other coding agents.

npx skills add manaflow-ai/cloudrouter

Manual installation

You can also install cloudrouter as a standalone CLI.

npm install -g @manaflow-ai/cloudrouter

Then authenticate:

cloudrouter login

Both cloudrouter and cr work as aliases.

Quick start

# Create a sandbox from the current directory
cloudrouter start .

# Open VS Code in the browser
cloudrouter code cr_abc123

# Or get a terminal
cloudrouter pty cr_abc123

# Run a command
cloudrouter exec cr_abc123 "npm install && npm run dev"

# Open VNC desktop
cloudrouter vnc cr_abc123

Browser automation

Every sandbox includes Chrome CDP integration. Navigate, interact with elements using accessibility tree refs, take screenshots, and scrape data.

# Open a URL in the sandbox browser
cloudrouter computer open cr_abc123 "https://example.com"

# Get the accessibility tree with element refs
cloudrouter computer snapshot cr_abc123
# → @e1 [input] Email  @e2 [input] Password  @e3 [button] Sign In

# Interact with elements
cloudrouter computer fill cr_abc123 @e1 "user@example.com"
cloudrouter computer fill cr_abc123 @e2 "password123"
cloudrouter computer click cr_abc123 @e3

# Take a screenshot
cloudrouter computer screenshot cr_abc123 result.png

Features

Instant cloud sandboxes

Spin up a remote VM from a local directory, git repo, or template. Built-in Docker support and automatic file syncing.

AI agent skill

Install as a skill for Claude Code, Cursor, and other agents. Give them the power to create sandboxes, run code, and automate browsers.

Browser automation

Full Chrome CDP integration. Navigate, click, type, take screenshots, and read accessibility trees — all from the CLI.

Multiple access methods

VS Code in browser, VNC desktop, interactive terminal, or one-off command execution. Pick what fits your workflow.

File transfer

Upload and download files between local and sandbox. Watch mode for auto re-upload on changes with exclude patterns.

Open source

MIT licensed. Built in Go, distributed as npm packages for macOS, Linux, and Windows.

File transfer

# Upload files to sandbox
cloudrouter upload cr_abc123 ./src /home/user/project/src

# Download from sandbox
cloudrouter download cr_abc123 /home/user/project/dist ./dist

# Watch mode — auto re-upload on changes
cloudrouter upload cr_abc123 ./src /home/user/project/src --watch

Sandbox management

# List running sandboxes
cloudrouter ls

# Check status
cloudrouter status cr_abc123

# Stop a sandbox
cloudrouter stop cr_abc123

# Delete a sandbox
cloudrouter delete cr_abc123