spawn/fly
A 262d081756
refactor: move fly TS into cli/src/fly/, add build-clouds.sh (#1604)
Move all fly TypeScript files from fly/lib/*.ts and fly/main.ts into
cli/src/fly/. This gives them access to cli/node_modules (@clack/prompts),
biome linting, and the existing bun:test infrastructure — no symlinks or
NODE_PATH hacks needed.

The org picker now uses @clack/prompts select() directly (static import,
bundled at build time).

New: cli/build-clouds.sh — auto-discovers cli/src/*/main.ts and bundles
each into {cloud}.js. Scalable to future cloud TS migrations:
  bash cli/build-clouds.sh        # build all
  bash cli/build-clouds.sh fly    # build one

Shims now check for cli/src/fly/main.ts (local) or download fly.js from
GitHub releases (remote curl|bash).

Co-authored-by: lab <6723574+louisgv@users.noreply.github.com>
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-02-21 12:34:09 -08:00
..
claude.sh refactor: move fly TS into cli/src/fly/, add build-clouds.sh (#1604) 2026-02-21 12:34:09 -08:00
codex.sh refactor: move fly TS into cli/src/fly/, add build-clouds.sh (#1604) 2026-02-21 12:34:09 -08:00
kilocode.sh refactor: move fly TS into cli/src/fly/, add build-clouds.sh (#1604) 2026-02-21 12:34:09 -08:00
openclaw.sh refactor: move fly TS into cli/src/fly/, add build-clouds.sh (#1604) 2026-02-21 12:34:09 -08:00
opencode.sh refactor: move fly TS into cli/src/fly/, add build-clouds.sh (#1604) 2026-02-21 12:34:09 -08:00
README.md refactor: convert fly/ cloud provider from bash to TypeScript (#1601) (#1602) 2026-02-21 10:41:34 -08:00
zeroclaw.sh refactor: move fly TS into cli/src/fly/, add build-clouds.sh (#1604) 2026-02-21 12:34:09 -08:00

Fly.io

Fly.io Machines via REST API and flyctl CLI. Fly.io

Architecture

The Fly.io provider is implemented in TypeScript (Bun runtime). Each .sh agent script is a thin shim that ensures bun is installed, downloads the TS sources if running via bash <(curl ...), and delegates to main.ts.

fly/
  main.ts               # Orchestrator: auth → provision → install → launch
  lib/
    fly.ts              # Core provider: API client, auth, orgs, provisioning
    agents.ts           # Agent configs (all 6) + shared install/config helpers
    oauth.ts            # OpenRouter OAuth flow (Bun.serve), key validation
    ui.ts               # Logging (ANSI), prompts (readline), browser open
  {agent}.sh            # Thin bash shim → bun run main.ts {agent}

No external dependencies — all modules use built-in Bun/Node APIs only. The fly/ directory has no package.json.

Agents

Claude Code

bash <(curl -fsSL https://openrouter.ai/labs/spawn/fly/claude.sh)

OpenClaw

bash <(curl -fsSL https://openrouter.ai/labs/spawn/fly/openclaw.sh)

ZeroClaw

bash <(curl -fsSL https://openrouter.ai/labs/spawn/fly/zeroclaw.sh)

Codex CLI

bash <(curl -fsSL https://openrouter.ai/labs/spawn/fly/codex.sh)

OpenCode

bash <(curl -fsSL https://openrouter.ai/labs/spawn/fly/opencode.sh)

Kilo Code

bash <(curl -fsSL https://openrouter.ai/labs/spawn/fly/kilocode.sh)

Non-Interactive Mode

FLY_APP_NAME=dev-mk1 \
FLY_API_TOKEN=your-token \
OPENROUTER_API_KEY=sk-or-v1-xxxxx \
  bash <(curl -fsSL https://openrouter.ai/labs/spawn/fly/claude.sh)

Environment Variables

Variable Description Default
FLY_API_TOKEN Fly.io API token (prompted or from flyctl auth)
FLY_APP_NAME App name (prompted)
FLY_REGION Deployment region iad
FLY_VM_SIZE VM size shared-cpu-1x
FLY_VM_MEMORY VM memory (MB) 1024
FLY_ORG Organization slug personal
OPENROUTER_API_KEY OpenRouter API key (OAuth or prompted)