# cloudrouter

> CLI skill for Claude Code and Codex to spin up cloud VMs and GPUs with browser automation capabilities.

cloudrouter provides AI coding agents like Claude Code, Codex, and Cursor with the ability to spin up cloud sandboxes, run commands, transfer files, and automate browsers directly from the command line. It connects to sandbox providers that provision VMs and GPUs, enabling agents to create and manage remote development environments seamlessly.

- **Instant Cloud Sandboxes** - Spin up remote VMs from a local directory, git repo, or template with built-in Docker support and automatic file syncing. Supports multiple size presets from small (2 vCPU, 8GB RAM) to xlarge (16 vCPU, 64GB RAM).

- **GPU Support** - Access a wide range of GPU instances including T4, L4, A10G, L40S, A100, H100, H200, and B200 with VRAM ranging from 16GB to 192GB. Multi-GPU configurations are supported via flags like `--gpu H100:2`.

- **Browser Automation** - Full Chrome CDP integration for navigating, clicking, typing, taking screenshots, and reading accessibility trees. Use element refs from snapshots or CSS selectors to interact with page elements.

- **Multiple Access Methods** - Open VS Code in browser, VNC desktop, Jupyter Lab, interactive terminal sessions, or execute one-off commands via SSH. Choose the access method that fits your workflow.

- **File Transfer** - Upload and download files between local machine and sandbox with watch mode for auto re-upload on changes. Supports exclude patterns and dry-run previews.

- **AI Agent Skill Installation** - Install as a skill for Claude Code, Cursor, and other coding agents using `npx skills add manaflow-ai/cloudrouter`. Agents gain the power to create sandboxes, run code, and automate browsers.

- **Multiple Providers** - Currently supports E2B (default, with Docker support) and Modal (with GPU support). Additional providers including Vercel, Daytona, Morph, and Freestyle are in development.

- **Open Source** - MIT licensed and built in Go, distributed as npm packages for macOS, Linux, and Windows. Both `cloudrouter` and `cr` work as CLI aliases.

To get started, install cloudrouter globally with `npm install -g @manaflow-ai/cloudrouter`, then authenticate with `cloudrouter login`. Create a sandbox from your current directory with `cloudrouter start .` and access it via VS Code with `cloudrouter code <sandbox-id>`.

## Features
- Instant cloud sandbox creation from local directories or git repos
- GPU instance support (T4, L4, A10G, L40S, A100, H100, H200, B200)
- Multi-GPU configurations
- Chrome CDP browser automation
- VS Code in browser access
- VNC desktop access
- Jupyter Lab integration
- Interactive terminal sessions (PTY)
- SSH command execution
- File upload and download with watch mode
- Docker support via E2B provider
- Multiple sandbox providers (E2B, Modal)
- Accessibility tree snapshots for browser automation
- Screenshot capture
- Cookie and storage management
- Network interception and request blocking
- Sandbox state management (pause/resume)
- Custom container images
- Configurable sandbox sizes and resources

## Integrations
Claude Code, Codex, Cursor, E2B, Modal, VS Code, Jupyter Lab, Chrome DevTools Protocol

## Platforms
WINDOWS, MACOS, LINUX, IOS, WEB, API, VSC_EXTENSION

## Pricing
Open Source

## Links
- Website: https://cloudrouter.dev
- Documentation: https://cloudrouter.dev
- Repository: https://github.com/manaflow-ai/manaflow
- EveryDev.ai: https://www.everydev.ai/tools/cloudrouter