Sprite Scripts

sprite-scripts

CLI tools for launching and managing coding agents on [sprites.dev](https://sprites.dev) cloud environments.

Spin up a sprite, push your plan, launch [OpenCode](https://opencode.ai) or [Claude Code](https://docs.anthropic.com/en/docs/claude-code), and let it build while you grab coffee. Auto-checkpointing saves your work. Poll progress from your host machine via [beads](https://github.com/steveyegge/beads).

Scripts

Script	Description
sprite-launch	Create a sprite, push files, install agent + beads, and start coding
sprite-push	Push a local file or directory to a sprite
sprite-pull	Pull a file or directory from a sprite
sprite-watch	Monitor a beads tracker task for project progress

Quick Start

# 1. Create a .env with your sprites.dev token
cp .env.example .env
# Edit .env with your SPRITES_TOKEN

# 2. Write a plan
cp example-plan.md plan.md
# Edit plan.md with your project spec

# 3. Launch (uses OpenCode with free models by default)
./sprite-launch my-project plan.md

That's it. No API keys needed for the default setup — OpenCode ships with free models.

Configuring OpenCode with Groq

Add your Groq API key to `.env` for access to fast Llama models:

# .env
GROQ_API_KEY="gsk_your_key_here"

MODEL=groq/llama-3.3-70b-versatile ./sprite-launch my-project plan.md

Configuring OpenCode with Zen

[OpenCode Zen](https://opencode.ai/docs/zen/) is a curated model gateway with tested, benchmarked models optimized for coding. Pay-as-you-go pricing with team/workspace support.

To use Zen models, connect inside the sprite after launch:

./sprite-launch my-project  # opens console (no plan file)
# Inside the sprite:
opencode                    # opens TUI
# Type /connect, select Zen, paste your Zen API key
# Type /models to see available Zen models

Or set it up non-interactively if you have a Zen API key:

# Add to .env
OPEN