vrr/spawn

mirror of https://github.com/OpenRouterTeam/spawn.git synced 2026-05-14 08:30:36 +00:00

History

A b84adfb74e refactor: move all shell scripts to /sh directory (#1843 ) Reorganizes the project so all shell scripts live under a dedicated /sh directory, enabling the OpenRouter rewrite URL to point at /sh/ instead of the repository root. Moves: - cli/install.sh → sh/cli/install.sh - shared/.sh → sh/shared/.sh - {cloud}/{agent}.sh → sh/{cloud}/{agent}.sh (48 scripts) - {cloud}/README.md → sh/{cloud}/README.md - e2e/.sh → sh/e2e/.sh - test/macos-compat.sh → sh/test/macos-compat.sh - test/fixtures/*/.sh → sh/test/fixtures/*/.sh Updates all references: - RAW_BASE path construction in commands.ts, update-check.ts - GitHub auth URL in agent-setup.ts - Self-referencing URLs in install.sh, github-auth.sh - CI workflow paths in lint.yml, cli-release.yml - Test file paths in install-script-validation, manifest-integrity - Documentation in README.md, cli/README.md, CLAUDE.md - QA scripts in .claude/skills/ Co-authored-by: lab <6723574+louisgv@users.noreply.github.com> Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>		2026-02-23 21:14:54 -08:00
..
docker	refactor: move all shell scripts to /sh directory (#1843 )	2026-02-23 21:14:54 -08:00
claude.sh	refactor: move all shell scripts to /sh directory (#1843 )	2026-02-23 21:14:54 -08:00
codex.sh	refactor: move all shell scripts to /sh directory (#1843 )	2026-02-23 21:14:54 -08:00
kilocode.sh	refactor: move all shell scripts to /sh directory (#1843 )	2026-02-23 21:14:54 -08:00
openclaw.sh	refactor: move all shell scripts to /sh directory (#1843 )	2026-02-23 21:14:54 -08:00
opencode.sh	refactor: move all shell scripts to /sh directory (#1843 )	2026-02-23 21:14:54 -08:00
README.md	refactor: move all shell scripts to /sh directory (#1843 )	2026-02-23 21:14:54 -08:00
zeroclaw.sh	refactor: move all shell scripts to /sh directory (#1843 )	2026-02-23 21:14:54 -08:00

README.md

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)