vrr/spawn

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

History

A 3030b1d036 fix: revert .profile writes, use explicit PATH in launch commands (#1260 ) Stop writing env vars to ~/.profile and ~/.bash_profile — only write to .bashrc and .zshrc. The .profile approach caused issues because login shells source it inconsistently across distros, and creating .bash_profile makes bash -l skip .profile entirely. Replace `bash -lc claude` launch commands with explicit PATH export + source pattern across all cloud providers. This ensures claude is found regardless of shell initialization quirks. Co-authored-by: lab <6723574+louisgv@users.noreply.github.com> Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>		2026-02-16 00:43:49 -08:00
..
lib	feat: Add local cloud provider for running agents on local machine (#381 )	2026-02-11 00:50:05 -08:00
aider.sh	fix: add actionable guidance to agent installation failures across 126 scripts (#966 )	2026-02-13 10:14:03 -08:00
amazonq.sh	fix: add actionable guidance to agent installation failures across 126 scripts (#966 )	2026-02-13 10:14:03 -08:00
claude.sh	fix: revert .profile writes, use explicit PATH in launch commands (#1260 )	2026-02-16 00:43:49 -08:00
cline.sh	fix: add actionable guidance to agent installation failures across 126 scripts (#966 )	2026-02-13 10:14:03 -08:00
codex.sh	fix: add actionable guidance to agent installation failures across 126 scripts (#966 )	2026-02-13 10:14:03 -08:00
continue.sh	fix: add actionable guidance to agent installation failures across 126 scripts (#966 )	2026-02-13 10:14:03 -08:00
gemini.sh	fix: add actionable guidance to agent installation failures across 126 scripts (#966 )	2026-02-13 10:14:03 -08:00
goose.sh	fix: add actionable guidance to agent installation failures across 126 scripts (#966 )	2026-02-13 10:14:03 -08:00
gptme.sh	fix: add actionable guidance to agent installation failures across 126 scripts (#966 )	2026-02-13 10:14:03 -08:00
interpreter.sh	fix: add actionable guidance to agent installation failures across 126 scripts (#966 )	2026-02-13 10:14:03 -08:00
kilocode.sh	fix: add actionable guidance to agent installation failures across 126 scripts (#966 )	2026-02-13 10:14:03 -08:00
nanoclaw.sh	fix: use consistent progress message in local/ scripts (#924 )	2026-02-13 05:19:48 -08:00
openclaw.sh	fix: use consistent progress message in local/ scripts (#924 )	2026-02-13 05:19:48 -08:00
plandex.sh	fix: add actionable guidance to agent installation failures across 126 scripts (#966 )	2026-02-13 10:14:03 -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