vrr/spawn

mirror of https://github.com/OpenRouterTeam/spawn.git synced 2026-05-07 09:10:55 +00:00

History

A f412fb69bc ux: wait for OpenClaw gateway to be ready before launching TUI (#1385 ) Fixes #1354 - users experienced a ~30s delay with "gateway not connected" errors when trying to use OpenClaw immediately after launch. Root cause: gateway takes time to bind to port 18789, but TUI launched after only 2 seconds. Solution: Add wait_for_openclaw_gateway() helper that polls the gateway port (max 30s) before launching TUI, ensuring immediate usability. Changes: - shared/common.sh: Add wait_for_openclaw_gateway() function - All openclaw.sh scripts (10 files): Replace sleep 2 with gateway readiness check Agent: ux-engineer Co-authored-by: B <6723574+louisgv@users.noreply.github.com> Co-authored-by: Claude Sonnet 4.5 <noreply@anthropic.com>		2026-02-17 03:49:53 -05:00
..
lib	feat: add server lifecycle management (reconnect + delete) (#1363 )	2026-02-16 17:06:49 -08:00
aider.sh	refactor: introduce cloud adapter + spawn_agent runner system (#1340 )	2026-02-16 16:25:44 -08:00
amazonq.sh	refactor: introduce cloud adapter + spawn_agent runner system (#1340 )	2026-02-16 16:25:44 -08:00
claude.sh	fix: use ~/.spawnrc for env vars instead of inlining into .bashrc (#1362 )	2026-02-16 17:05:17 -08:00
cline.sh	refactor: introduce cloud adapter + spawn_agent runner system (#1340 )	2026-02-16 16:25:44 -08:00
codex.sh	refactor: introduce cloud adapter + spawn_agent runner system (#1340 )	2026-02-16 16:25:44 -08:00
continue.sh	refactor: introduce cloud adapter + spawn_agent runner system (#1340 )	2026-02-16 16:25:44 -08:00
gemini.sh	refactor: introduce cloud adapter + spawn_agent runner system (#1340 )	2026-02-16 16:25:44 -08:00
goose.sh	refactor: introduce cloud adapter + spawn_agent runner system (#1340 )	2026-02-16 16:25:44 -08:00
gptme.sh	refactor: introduce cloud adapter + spawn_agent runner system (#1340 )	2026-02-16 16:25:44 -08:00
interpreter.sh	refactor: introduce cloud adapter + spawn_agent runner system (#1340 )	2026-02-16 16:25:44 -08:00
kilocode.sh	refactor: introduce cloud adapter + spawn_agent runner system (#1340 )	2026-02-16 16:25:44 -08:00
nanoclaw.sh	refactor: introduce cloud adapter + spawn_agent runner system (#1340 )	2026-02-16 16:25:44 -08:00
openclaw.sh	ux: wait for OpenClaw gateway to be ready before launching TUI (#1385 )	2026-02-17 03:49:53 -05:00
plandex.sh	refactor: introduce cloud adapter + spawn_agent runner system (#1340 )	2026-02-16 16:25:44 -08:00
README.md	feat: Add Amazon Q CLI on local machine (#887 )	2026-02-13 05:47:17 -08:00

README.md

Local Machine

Run agents directly on your local machine without any cloud provisioning.

No server creation or destruction. Installs agents and injects OpenRouter credentials locally. Useful for local development and testing.

Quick Start

If you have the spawn CLI installed:

spawn claude local
spawn openclaw local
spawn nanoclaw local
spawn aider local
spawn goose local
spawn codex local
spawn interpreter local
spawn gemini local
spawn amazonq local
spawn cline local
spawn gptme local
spawn opencode local
spawn plandex local
spawn kilocode local
spawn continue local

Or run directly without the CLI:

bash <(curl -fsSL https://openrouter.ai/labs/spawn/local/claude.sh)
bash <(curl -fsSL https://openrouter.ai/labs/spawn/local/openclaw.sh)
bash <(curl -fsSL https://openrouter.ai/labs/spawn/local/nanoclaw.sh)
bash <(curl -fsSL https://openrouter.ai/labs/spawn/local/aider.sh)
bash <(curl -fsSL https://openrouter.ai/labs/spawn/local/goose.sh)
bash <(curl -fsSL https://openrouter.ai/labs/spawn/local/codex.sh)
bash <(curl -fsSL https://openrouter.ai/labs/spawn/local/interpreter.sh)
bash <(curl -fsSL https://openrouter.ai/labs/spawn/local/gemini.sh)
bash <(curl -fsSL https://openrouter.ai/labs/spawn/local/amazonq.sh)
bash <(curl -fsSL https://openrouter.ai/labs/spawn/local/cline.sh)
bash <(curl -fsSL https://openrouter.ai/labs/spawn/local/gptme.sh)
bash <(curl -fsSL https://openrouter.ai/labs/spawn/local/opencode.sh)
bash <(curl -fsSL https://openrouter.ai/labs/spawn/local/plandex.sh)
bash <(curl -fsSL https://openrouter.ai/labs/spawn/local/kilocode.sh)
bash <(curl -fsSL https://openrouter.ai/labs/spawn/local/continue.sh)

Non-Interactive Mode

OPENROUTER_API_KEY=sk-or-v1-xxxxx \
  bash <(curl -fsSL https://openrouter.ai/labs/spawn/local/claude.sh)

What It Does

Local scripts will:

Install the agent if not already present
Obtain an OpenRouter API key (via OAuth or environment variable)
Append environment variables to ~/.zshrc for the agent to use
Launch the agent

No cloud servers are created or destroyed.

Environment Variables

Variable	Description
`OPENROUTER_API_KEY`	OpenRouter API key (prompted via OAuth if not set)
`SPAWN_PROMPT`	If set, runs the agent non-interactively with this prompt