Autonomous AI-driven software development.
ClaudeSprint orchestrates Claude Code to build complete features end-to-end.
PyPI | Documentation | GitHub
Alpha Software - APIs and behavior may change. Report issues
Inspired by Agile sprints and Extreme Programming practices (test-first, continuous integration, small iterations), ClaudeSprint brings disciplined software development to AI agents.
AI coding assistants lose context between sessions. ClaudeSprint solves this with:
- Fresh sessions per step - Clean context prevents hallucination accumulation
- Structured handoffs - JSON artifacts pass verified state between sessions
- Validation gates - Tests and code review before any commit
- Recovery built-in - Automatic backup/restore handles failures
pip install claudesprintOr install with pipx for isolated environment:
pipx install claudesprintRequirements: Python 3.10+ and Claude Code CLI (authenticated)
claudesprint doctorclaudesprint demoWatch ClaudeSprint build a complete URL shortener app autonomously.
claudesprint quickstart
Each step runs in a fresh Claude session with focused context. State is passed via JSON artifacts, not conversation history.
View detailed architecture
Full architecture documentation →
claudesprint quickstart # Interactive project setup
claudesprint demo # Try with sample project
claudesprint doctor # Check environment
claudesprint run # Execute workflow
claudesprint run -n 5 # Limit iterations
claudesprint status # View current state
claudesprint reset # Clear issue stateClaudeSprint runs autonomous loops that consume API tokens. Control costs with:
# Limit iterations (recommended for testing)
claudesprint run -n 5
# Use cheaper models for all steps
CLAUDESPRINT_MODEL_OVERRIDE=sonnet claudesprint runSee CONTRIBUTING.md for guidelines.
MIT - see LICENSE