Sprite Mobile

Sprite Mobile
⚠️ This project is a work in progress and is subject to change at any time. Features, APIs, and behavior may be modified or removed without notice.
Features added to Sprites will likely make some of the hacks described below redundant, and hopefully a lot of this, especially setup, configuration, and orchestration, will be simplified in the near future.
This is a personal project, not an official Fly.io product.

sprite-mobile gives you a progressive web app chat UI for accessing Claude Code running in YOLO mode on a Sprite, an ideal vibe-coding interface on your phone. It allows input by text, voice, and image, persists sessions across clients, and seamlessly networks with your other sprites through Tailscale.

Table of Contents

- Sprite Setup
- Sprite Orchestration
- Prerequisites
- Claude Code Integration
- Features
- Access Model
- Quick Start
- Environment Variables
- Architecture
  - Services
  - Data Storage
  - API Endpoints
  - WebSocket
  - Keepalive
- Session Lifecycle
- Configuration
- Security
- Troubleshooting
- License

Sprite Setup

To set up a fresh Sprite with all dependencies, authentication, and services, download and run the setup script:

The script will:
1. Install Sprites CLI and authenticate
2. Configure hostname, git user, URLs, and repo (auto-detects public URL from sprite metadata)
3. Authenticate Claude CLI
4. Authenticate GitHub CLI
5. Install Fly.io CLI
6. Install and configure Tailscale
7. Set up Tailscale Serve (HTTPS for PWA support)
8. Install and configure claude-hub (WebSocket hub for multi-client sync)
9. Clone and run sprite-mobile
10. Set up Sprite Network credentials (optional - enables automatic discovery of other sprites in your org)
11. Start the Tailnet Gate (public entry point that embeds Tailscale URL via…