vrr/spawn

mirror of https://github.com/OpenRouterTeam/spawn.git synced 2026-04-28 11:59:29 +00:00

Simplify README: focus on CLI, drop per-cloud inline docs (#34 )

530 lines → 97 lines. The README now documents:
- One-liner install
- CLI commands (spawn, spawn <agent> <cloud>, spawn list, etc.)
- Agent and cloud reference tables
- Link to per-cloud READMEs for detailed docs

Per-cloud details (env vars, non-interactive mode) live in each
cloud's own README.md file.

Co-authored-by: Sprite <noreply@sprite.dev>
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2026-02-07 20:05:24 -08:00

2.6 KiB

Raw Blame History

Spawn

Launch any AI coding agent on any cloud, pre-configured with OpenRouter.

Install

curl -fsSL https://raw.githubusercontent.com/OpenRouterTeam/spawn/main/cli/install.sh | bash

Usage

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

Examples

spawn claude sprite           # Claude Code on Sprite
spawn aider hetzner           # Aider on Hetzner Cloud
spawn goose digitalocean      # Goose on DigitalOcean
spawn codex vultr             # Codex CLI on Vultr

Commands

Command	Description
`spawn`	Interactive agent + cloud picker
`spawn <agent> <cloud>`	Launch agent on cloud directly
`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

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.

Agents

Agent	Description
Claude Code	Anthropic's CLI coding agent
OpenClaw	OpenRouter's agent framework
NanoClaw	WhatsApp-based AI agent
Aider	AI pair programming in the terminal
Goose	Block's model-agnostic coding agent
Codex CLI	OpenAI's open-source coding agent
Open Interpreter	Natural language computer control
Gemini CLI	Google's coding agent
Amazon Q	AWS's AI coding assistant
Cline	Open-source terminal coding agent
gptme	Personal AI agent with tools

Clouds

Cloud	Type	Auth
Sprite	Managed VM	`sprite login`
Hetzner	REST API	`HCLOUD_TOKEN`
DigitalOcean	REST API	`DO_API_TOKEN`
Vultr	REST API	`VULTR_API_KEY`
Linode	REST API	`LINODE_API_TOKEN`
Lambda	REST API	`LAMBDA_API_KEY`
AWS Lightsail	AWS CLI	`aws configure`
GCP	gcloud CLI	`gcloud auth login`
E2B	SDK	`E2B_API_KEY`
Modal	SDK	`modal setup`
Fly.io	CLI + API	`FLY_API_TOKEN`

Development

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

2.6 KiB Raw Blame History