Sprite - Multi-Agent Workflow Tool 🚀
Manage multiple AI coding agents in parallel, each in their own workspace.
What is Sprite?
Sprite lets you run multiple AI agents at once, each working in isolation. Think of it as having 3+ AI assistants working on different tasks simultaneously.
Quick Start (3 Steps)
1. Install
Option A: GitHub Packages (Recommended)
# Install from GitHub Packages
Option B: Direct from Repository
Option C: Pre-compiled Binary
# Download latest release
|
2. Setup Your Project
This creates 3 AI agent workspaces automatically.
3. Start Working
Done! You now have 3 AI agents ready to work.
Common Commands
Daily Use
Managing Agents
Updates
How It Works
When you run sprite init --agents 3, Sprite creates:
your-project/
├── agents/
│ ├── 1/ ← Agent 1 workspace
│ ├── 2/ ← Agent 2 workspace
│ ├── 3/ ← Agent 3 workspace
│ └── agents.yaml ← Configuration
└── (your files)
Each agent works in their own folder, with their own git branch.
Layouts
Choose how agents are displayed:
Troubleshooting
"command not found: sprite"
# Restart terminal, or:
"Not a git repository"
# Make sure you're in a git project:
"Session already exists"
# OR
Requirements
- Git - for version control
- Tmux - for session management
- Rust - for installation
Install on macOS:
Install on Ubuntu:
Configuration
Edit agents/agents.yaml to customize:
agents:
- id: '1'
model: claude-sonnet-4
description: Frontend development
resource_limits:
max_memory_mb: 1024
max_cpu_percent: 80
session_name: sprite-session
Example Workflows
Scenario 1: Parallel Development
# Agent 1: Frontend
# Agent 2: Backend
# Agent 3: Tests
# Each agent works independently
Scenario 2: Code Review
# Agent 1: Find bugs
# Agent 2: Suggest improvements
# Agent 3: Refactor code
# Review code from 3 perspectives
Tips
✅ Start small - Use 2-3 agents first
✅ Name agents - Add descriptions in config
✅ Check status - Run sprite status regularly
✅ Clean up - Always sprite kill when done
✅ Stay updated - Run sprite update monthly
GitHub Packages
Sprite is available on GitHub Packages:
# Installation
# Add to project
Getting Help
- Issues: https://github.com/hotaq/Sprit-mutil/issues
- Documentation: See
docs/folder - GitHub Packages: Installation Guide
- Updates: https://github.com/hotaq/Sprit-mutil/releases
Quick Reference Card
| Command | What it does |
|---|---|
sprite init --agents 3 |
Setup 3 agents |
sprite start |
Start session |
sprite attach |
Join session |
sprite status |
Check health |
sprite kill |
Stop session |
sprite agents list |
Show agents |
sprite update |
Update Sprite |
That's it! Start simple, learn as you go. 🎯
License
MIT License - See LICENSE file