vrr/spawn
2
0
Fork 0
mirror of https://github.com/OpenRouterTeam/spawn.git synced 2026-05-22 03:14:57 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 10
mirror of https://github.com/OpenRouterTeam/spawn , link from https://openrouter.ai/spawn and https://discord.com/channels/1091220969173028894/1092729520181739581/1483604863098028273 https://openrouter.ai/spawn
3 commits 46 branches 20 tags 26 MiB
Find a file
Sprite 640af6260c Refactor spawn scripts with shared library and OAuth fallback 
Major refactoring to improve code maintainability and reliability:

## Shared Library Architecture
- Created sprite/lib/common.sh with reusable bash functions
- Reduced openclaw.sh from 258 to 93 lines (-64%)
- Reduced claude.sh from 272 to 101 lines (-63%)
- Eliminated ~330 lines of duplicate code

## OAuth Fallback Mechanism
- Added automatic fallback to manual API key entry
- Handles missing netcat (nc) gracefully
- Handles port conflicts and timeouts
- Validates API key format with override option
- Works in headless and minimal environments

## Dual Execution Support
- Local: bash sprite/openclaw.sh
- Remote: curl URL | bash
- Auto-detects context and sources library appropriately

## New Shared Functions
- Logging: log_info(), log_warn(), log_error()
- Sprite setup: ensure_sprite_installed/authenticated/exists()
- Environment: setup_shell_environment()
- OAuth: get_openrouter_api_key_oauth() with fallback
- Utilities: run_sprite(), verify_sprite_connectivity()

## Documentation
- REFACTORING.md - Architecture and benefits
- OAUTH_FALLBACK.md - Fallback mechanism guide
- CURL_BASH_SOLUTION.md - Execution mode details
- EXAMPLES.md - Usage scenarios
- CHANGELOG.md - Complete change history

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-07 04:06:11 +00:00
sprite Refactor spawn scripts with shared library and OAuth fallback 2026-02-07 04:06:11 +00:00
CHANGELOG.md Refactor spawn scripts with shared library and OAuth fallback 2026-02-07 04:06:11 +00:00
CURL_BASH_SOLUTION.md Refactor spawn scripts with shared library and OAuth fallback 2026-02-07 04:06:11 +00:00
EXAMPLES.md Refactor spawn scripts with shared library and OAuth fallback 2026-02-07 04:06:11 +00:00
OAUTH_FALLBACK.md Refactor spawn scripts with shared library and OAuth fallback 2026-02-07 04:06:11 +00:00
README.md Refactor spawn scripts with shared library and OAuth fallback 2026-02-07 04:06:11 +00:00
REFACTORING.md Refactor spawn scripts with shared library and OAuth fallback 2026-02-07 04:06:11 +00:00
test_oauth_fallback.sh Refactor spawn scripts with shared library and OAuth fallback 2026-02-07 04:06:11 +00:00

README.md

Spawn

Conjure your agents!

Features

  • 🔐 Automatic OAuth - Seamless authentication with OpenRouter
  • 🔄 Smart Fallback - Manual API key entry if OAuth fails
  • 🚀 One Command Setup - Get running in minutes
  • 🔧 Environment Ready - Pre-configured shell and dependencies

Usage

Claude Code Setup

Setup a sprite with Claude Code pre-configured (via OpenRouter):

curl https://openrouter.ai/lab/spawn/sprite/claude.sh | bash

OpenClaw Setup

Setup a sprite with openclaw pre-configured:

curl https://openrouter.ai/lab/spawn/sprite/openclaw.sh | bash