A Rust CLI tool that lets you delegate development tasks to AI agents running in sandboxed Docker environments. Get back git branches for human review.
TSK enables a "lead engineer + AI team" workflow:
- Assign tasks to AI agents with natural language descriptions and task type templates to automate prompt boilerplate
- Agents work autonomously in isolated Docker containers
- Get git branches back with their changes for review
- Review and merge using your normal git workflow
Think of it as having a team of engineers who work independently and submit pull requests for review.
- Rust - Rust toolchain and Cargo
- Docker - Container runtime
- Git - Version control system
- Claude Code - AI agent (help us support more agents!)
# Install using cargo
cargo install tsk-ai
# Build Docker images (required)
tsk docker build# Add a task using the "feat" task template
tsk add --type "feat" --name "greeting" --description "Add a warm greeting to all CLI commands"
# Run all queued tasks
tsk run
# Check results
tsk list
# Review the changes
git checkout tsk/a1b2c3d4
git diff main...HEAD
# Merge if it looks good
git checkout main && git merge tsk/a1b2c3d4For continuous task processing across multiple repositories:
# Start server
tsk server run
# Add tasks from any repo
cd ~/project-a && tsk add --type "fix" --name "task1" --description "..."
cd ~/project-b && tsk add --type "feat" --name "task2" --description "..."
# Stop server
tsk server stopTSK supports parallel task execution for improved throughput:
# Run up to 4 tasks in parallel
tsk run --workers 4
# Server mode also supports parallel execution
tsk server run --workers 4Each task runs in its own isolated Docker container, so parallel execution is safe and efficient.
tsk add- Queue a tasktsk run- Execute queued taskstsk list- View task status and branchestsk quick- Execute a task immediatelytsk debug- Start an interactive docker containertsk clean- Clean up completed taskstsk delete <task-id>- Delete a specific tasktsk retry <task-id>- Retry a previous task
tsk server run- Start the TSK server daemontsk server stop- Stop the running TSK server
tsk docker build- Build required docker imagestsk proxy stop- Stop the TSK proxy containertsk template list- View available task type templates
Run tsk help or tsk help <command> for detailed options.
- Docker Builds Guide - Comprehensive guide to TSK's Docker infrastructure, customization, and debugging
This project uses:
cargo testfor running testsjust precommitfor full CI checks- See CLAUDE.md for development guidelines
MIT License - see LICENSE file for details.