spawn/github-codespaces/README.md
A cde9f586d8
feat: Add GitHub Codespaces cloud provider with claude, aider, gptme (#248)
Add GitHub Codespaces as a new cloud provider via gh CLI:
- github-codespaces/lib/common.sh - provisioning primitives via gh CLI
- github-codespaces/claude.sh - Claude Code implementation
- github-codespaces/aider.sh - Aider implementation
- github-codespaces/gptme.sh - gptme implementation
- github-codespaces/README.md - usage documentation
- manifest.json - added cloud entry and matrix entries

Pricing: Pay-as-you-go starting at $0.18/hr (2 core, 4GB RAM)
Free tier available for personal accounts.

Agent: cloud-scout

Co-authored-by: B <6723574+louisgv@users.noreply.github.com>
Co-authored-by: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-10 12:58:33 -08:00

1.8 KiB

GitHub Codespaces

GitHub Codespaces development environments via gh CLI. GitHub Codespaces

Agents

Claude Code

bash <(curl -fsSL https://openrouter.ai/lab/spawn/github-codespaces/claude.sh)

Aider

bash <(curl -fsSL https://openrouter.ai/lab/spawn/github-codespaces/aider.sh)

gptme

bash <(curl -fsSL https://openrouter.ai/lab/spawn/github-codespaces/gptme.sh)

Non-Interactive Mode

GITHUB_REPO=OpenRouterTeam/spawn \
OPENROUTER_API_KEY=sk-or-v1-xxxxx \
  bash <(curl -fsSL https://openrouter.ai/lab/spawn/github-codespaces/claude.sh)

Environment Variables

Variable Description Default
GITHUB_REPO Repository for codespace OpenRouterTeam/spawn
CODESPACE_MACHINE Machine type basicLinux32gb
CODESPACE_IDLE_TIMEOUT Idle timeout 30m
OPENROUTER_API_KEY OpenRouter API key (OAuth or prompted)

Pricing

GitHub Codespaces uses pay-as-you-go pricing:

  • Compute: Starting at $0.18/hr for basicLinux32gb (2 core, 4GB RAM)
  • Storage: $0.07/GB per month
  • Free tier: Available for personal accounts (limited hours/month)

See GitHub Codespaces pricing for details.

Prerequisites

  • GitHub CLI (gh) installed and authenticated
  • Active GitHub account
  • Repository access (default: OpenRouterTeam/spawn)

Machine Types

Machine Cores RAM Price/hr
basicLinux32gb 2 4GB $0.18
standardLinux32gb 4 8GB $0.36
premiumLinux 8 16GB $0.72
largePremiumLinux 16 32GB $1.44

Set via CODESPACE_MACHINE environment variable.