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

67 lines
1.8 KiB
Markdown

# GitHub Codespaces
GitHub Codespaces development environments via gh CLI. [GitHub Codespaces](https://github.com/features/codespaces)
## Agents
#### Claude Code
```bash
bash <(curl -fsSL https://openrouter.ai/lab/spawn/github-codespaces/claude.sh)
```
#### Aider
```bash
bash <(curl -fsSL https://openrouter.ai/lab/spawn/github-codespaces/aider.sh)
```
#### gptme
```bash
bash <(curl -fsSL https://openrouter.ai/lab/spawn/github-codespaces/gptme.sh)
```
## Non-Interactive Mode
```bash
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](https://docs.github.com/en/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces) 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.