ccs - Claude Code + Sprites

Run Claude Code in persistent cloud environments. Your laptop can sleep, you can disconnect, and everything keeps running. I made this as a simple wrapper around Sprites and Claude Code for myself to use when vibecoding.

Install

curl -fsSL https://raw.githubusercontent.com/a-leut/ccs/master/install.sh | sh

Then restart your terminal (or source ~/.zshrc).

Prerequisites

1. Sprites CLI - Install

   curl -fsSL https://sprites.dev/install.sh | sh
   sprite org auth

2. GitHub PAT - Create one with repo scope

Quick Start

# 1. Set up Git (one time)
cc-git-setup YOUR_GITHUB_USER ghp_xxxxxxxxxxxx

# 2. Start a sprite
ccs my-project

# 3. Inside the sprite
yolo "build me a web app"

Commands

Command	Description
ccs [name]	Start sprite with Claude Code
ccq [name]	Quick console (no setup)
cc-git-setup <user> <token>	Configure Git PAT
ccs-upgrade	Update to latest version
ccs-help	Show help

Inside the Sprite

Alias	Command
yolo	claude --dangerously-skip-permissions
cc	claude
gs	git status
gp	git push
gl	git pull

Multiple Projects

Each sprite name is a separate isolated environment:

ccs project-a    # Work on project A
ccs project-b    # Different environment  
ccs project-a    # Back to A, everything preserved

Checkpoints

Save state before risky changes:

# Inside the sprite
sprite checkpoint create --comment "before refactor"

# Do stuff...

# Restore if needed
sprite checkpoint list
sprite restore <id>

Troubleshooting

Git not working?

cc-git-setup YOUR_USER YOUR_NEW_TOKEN

How It Works

Your Laptop                         Sprites Cloud
┌──────────────┐                   ┌─────────────────────┐
│ ~/.git-creds │──── uploads ────▶ │    Sprite VM        │
└──────────────┘                   │                     │
                                   │  Claude Code runs   │
      ccs ─────── connects ──────▶ │  with your git      │
                                   │  credentials        │
                                   │                     │
                                   │  Persistent files,  │
                                   │  packages, configs  │
                                   └─────────────────────┘

• Persistent: Files and packages survive between sessions
• Isolated: Each sprite is a separate microVM
• Sleeps: Auto-hibernates after 30s idle (free when sleeping)
• Wakes: Instantly wakes on next command

Uninstall

rm -rf ~/.ccs
# Remove the source line from ~/.zshrc or ~/.bashrc

License

MIT