claudesprint 0.2.1

ClaudeSprint - Autonomous workflow orchestration for AI-driven development

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

Why ClaudeSprint?

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

Quick Start

1. Install

pip install claudesprint

Or install with pipx for isolated environment:

pipx install claudesprint

Requirements: Python 3.10+ and Claude Code CLI (authenticated)

2. Verify Setup

claudesprint doctor

3. Try the Demo

claudesprint demo

Watch ClaudeSprint build a complete URL shortener app autonomously.

4. Start Your Own Project

claudesprint quickstart

How It Works

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 →

Commands

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 state

Full CLI reference →

Cost Awareness

ClaudeSprint 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 run

Cost management guide →

Documentation

• Installation
• Quickstart Guide
• Writing Specifications
• Configuration
• Troubleshooting

Contributing

See CONTRIBUTING.md for guidelines.

License

MIT - see LICENSE