Manage multiple AI coding agents in parallel, each in their own workspace.
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.
Option A: GitHub Packages (Recommended)
# Install from GitHub Packages
cargo install --registry github --git https://github.com/hotaq/Sprit-mutil.git spriteOption B: Direct from Repository
cargo install --git https://github.com/hotaq/Sprit-mutilOption C: Pre-compiled Binary
# Download latest release
curl -L https://github.com/hotaq/Sprit-mutil/releases/latest/download/sprite-x86_64-unknown-linux-gnu.tar.gz | tar xz
sudo mv sprite /usr/local/bin/cd your-project
sprite init --agents 3This creates 3 AI agent workspaces automatically.
sprite startDone! You now have 3 AI agents ready to work.
sprite start # Start all agents
sprite start --force # Replace existing session
sprite attach # Join the session
sprite kill # Stop all agents
sprite status # Check system healthsprite agents list # See all agents
sprite agents create 4 # Add a 4th agent
sprite agents validate # Check if everything is oksprite update --check # Check for new version
sprite update # Update to latestWhen 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.
Choose how agents are displayed:
sprite start --layout tiled # Grid layout (default)
sprite start --layout vertical # Side by side
sprite start --layout dashboard # 6-panel view"command not found: sprite"
# Restart terminal, or:
export PATH="$HOME/.cargo/bin:$PATH""Not a git repository"
# Make sure you're in a git project:
cd your-project
git init # if needed
sprite init --agents 3"Session already exists"
sprite start --force # Quick: Kill old + start new
# OR
sprite kill sprite-session # Stop the old one
sprite start # Start fresh- Git - for version control
- Tmux - for session management
- Rust - for installation
Install on macOS:
brew install git tmux rustInstall on Ubuntu:
sudo apt install git tmux cargoEdit 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# Agent 1: Frontend
# Agent 2: Backend
# Agent 3: Tests
sprite init --agents 3
sprite start
# Each agent works independently# Agent 1: Find bugs
# Agent 2: Suggest improvements
# Agent 3: Refactor code
sprite init --agents 3
# Review code from 3 perspectives✅ 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
Sprite is available on GitHub Packages:
# Installation
cargo install --registry github --git https://github.com/hotaq/Sprit-mutil.git sprite
# Add to project
[dependencies]
sprite = { version = "0.2.3", registry = "github" }- Issues: https://github.com/hotaq/Sprit-mutil/issues
- Documentation: See
docs/folder - GitHub Packages: Installation Guide
- Updates: https://github.com/hotaq/Sprit-mutil/releases
| 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. 🎯