spawn/README.md

Spawn

Launch any agent on any cloud, powered by OpenRouter.

Install

curl -fsSL https://openrouter.ai/lab/spawn/cli/install.sh | bash

Usage

spawn                         # Interactive picker
spawn <agent> <cloud>         # Launch directly
spawn list                    # Show the full matrix

Examples

spawn                                    # Interactive picker
spawn claude sprite                      # Claude Code on Sprite
spawn aider hetzner                      # Aider on Hetzner Cloud
spawn claude sprite --prompt "Fix bugs"  # Execute with prompt (non-interactive)
spawn aider sprite -p "Add tests"        # Short form of --prompt
spawn claude                             # Show clouds available for Claude

Commands

Command	Description
spawn	Interactive agent + cloud picker
spawn <agent> <cloud>	Launch agent on cloud directly
spawn <agent> <cloud> --prompt "text"	Execute agent with prompt (non-interactive)
spawn <agent> <cloud> --prompt-file file.txt	Execute agent with prompt from file
spawn <agent>	Show available clouds for an agent
spawn list	Full agent x cloud matrix
spawn agents	List all agents
spawn clouds	List all cloud providers
spawn improve	Run improvement system
spawn update	Check for CLI updates
spawn version	Show version

Without the CLI

Every combination also works as a one-liner:

bash <(curl -fsSL https://openrouter.ai/lab/spawn/{cloud}/{agent}.sh)

Non-Interactive

Skip all prompts with environment variables:

OPENROUTER_API_KEY=sk-or-v1-xxxxx \
  spawn claude sprite

Each cloud has its own env vars for auth — see the cloud's README.

Matrix

	Sprite	Hetzner	DigitalOcean	Vultr	Linode	Lambda	Lightsail	GCP	E2B	Modal	Fly.io	Civo	Scaleway	Daytona
Claude Code	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
OpenClaw	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
NanoClaw	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
Aider	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
Goose	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
Codex CLI	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
Interpreter	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
Gemini CLI	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
Amazon Q	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
Cline	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
gptme	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
OpenCode	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓

Development

git clone https://github.com/OpenRouterTeam/spawn.git
cd spawn
git config core.hooksPath .githooks