spawn/render/README.md
A 7f49b234c4
feat: Add render/codex implementation (#235)
- Create render/codex.sh with Render CLI provisioning
- Install Codex CLI via npm on Render service
- Inject OpenRouter credentials via OPENAI_BASE_URL override
- Update manifest.json matrix entry to "implemented"
- Update render/README.md with Codex usage instructions

Agent: gap-filler

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

2.4 KiB

Render

Render is a modern cloud platform for deploying full-stack applications, APIs, and websites. It offers a developer-first experience with automatic deployments, built-in SSL, and managed infrastructure.

Features

  • Free Hobby Plan: Free tier for development and small projects
  • Docker Support: Native Docker container support
  • CLI & SSH Access: Full CLI tooling with SSH access via render ssh
  • REST API: Comprehensive API for programmatic provisioning
  • Auto Deployments: Automatic deployments from Git repositories
  • Managed Services: PostgreSQL, Redis, and other managed services

Authentication

Render scripts require a RENDER_API_KEY. Get yours at: https://dashboard.render.com/u/settings/api-keys

The scripts will:

  1. Check for RENDER_API_KEY environment variable
  2. Fall back to saved key at ~/.config/spawn/render.json
  3. Prompt for the key if neither is available

Available Agents

Claude Code

bash <(curl -fsSL https://raw.githubusercontent.com/OpenRouterTeam/spawn/main/render/claude.sh)

Deploys Claude Code with OpenRouter integration. Configures:

  • Automatic OpenRouter API base URL
  • Bypass permissions mode for autonomous operation
  • Dark theme and vim editor settings

Aider

bash <(curl -fsSL https://raw.githubusercontent.com/OpenRouterTeam/spawn/main/render/aider.sh)

Deploys Aider with OpenRouter model routing. Prompts for model selection (default: openrouter/auto).

Codex CLI

bash <(curl -fsSL https://raw.githubusercontent.com/OpenRouterTeam/spawn/main/render/codex.sh)

Deploys Codex CLI with OpenRouter integration via OPENAI_BASE_URL override.

Service Details

  • Plan: Starter (can be configured)
  • Region: Oregon (default)
  • Runtime: Docker
  • Base Image: render-examples/docker-hello-world (minimal Ubuntu with SSH)

Environment Variables

All scripts support:

  • RENDER_API_KEY: Your Render API token
  • OPENROUTER_API_KEY: Your OpenRouter API key (or OAuth flow)

Cleanup

Services are automatically cleaned up on exit. Manual cleanup:

render services:delete <service-id>

Limitations

  • Render's free Hobby plan has resource limits (512MB RAM, 0.1 CPU)
  • Services spin down after 15 minutes of inactivity
  • Cold starts take 30-60 seconds