Metadata-Version: 2.4
Name: claudesprint
Version: 0.2.1
Summary: ClaudeSprint - Autonomous workflow orchestration for AI-driven development
Author: ClaudeSprint Team
License-Expression: MIT
License-File: LICENSE
Keywords: ai,automation,claude,orchestration,workflow
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: System :: Software Distribution
Requires-Python: >=3.10
Requires-Dist: filelock>=3.13.0
Requires-Dist: httpx>=0.28.0
Requires-Dist: isodate>=0.6.0
Requires-Dist: jinja2>=3.1.0
Requires-Dist: nicegui>=2.0.0
Requires-Dist: pydantic-settings>=2.0.0
Requires-Dist: pydantic>=2.10.0
Requires-Dist: rich>=14.0.0
Requires-Dist: tenacity>=8.2.0
Requires-Dist: tomli-w>=1.0.0
Requires-Dist: tomli>=2.0.0; python_version < '3.11'
Requires-Dist: typer>=0.15.0
Provides-Extra: all
Requires-Dist: mkdocs-material>=9.0.0; extra == 'all'
Requires-Dist: mkdocs>=1.6.0; extra == 'all'
Requires-Dist: mypy>=1.0.0; extra == 'all'
Requires-Dist: playwright>=1.40.0; extra == 'all'
Requires-Dist: pymdown-extensions>=10.0.0; extra == 'all'
Requires-Dist: pytest-asyncio>=0.24.0; extra == 'all'
Requires-Dist: pytest-cov>=6.0.0; extra == 'all'
Requires-Dist: pytest>=8.0.0; extra == 'all'
Requires-Dist: ruff>=0.9.0; extra == 'all'
Provides-Extra: browser
Requires-Dist: playwright>=1.40.0; extra == 'browser'
Provides-Extra: dev
Requires-Dist: mypy>=1.0.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.24.0; extra == 'dev'
Requires-Dist: pytest-cov>=6.0.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Requires-Dist: ruff>=0.9.0; extra == 'dev'
Provides-Extra: docs
Requires-Dist: mkdocs-material>=9.0.0; extra == 'docs'
Requires-Dist: mkdocs>=1.6.0; extra == 'docs'
Requires-Dist: pymdown-extensions>=10.0.0; extra == 'docs'
Description-Content-Type: text/markdown

<p align="center">
  <img src="docs/assets/claudesprint_logo.svg" alt="ClaudeSprint" height="70" />
</p>

<p align="center">
  <strong>Autonomous AI-driven software development.</strong><br/><br/>
  ClaudeSprint orchestrates Claude Code to build complete features end-to-end.
</p>

<p align="center">
  <img src="docs/assets/gui-demo.jpg" alt="ClaudeSprint Demo" width="100%" />
</p>

[![PyPI](https://img.shields.io/pypi/v/claudesprint.svg)](https://pypi.org/project/claudesprint/)
[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

**[PyPI](https://pypi.org/project/claudesprint/)** | **[Documentation](https://arc-co.github.io/claudesprint/)** | **[GitHub](https://github.com/arc-co/claudesprint)**

> **Alpha Software** - APIs and behavior may change. [Report issues](https://github.com/arc-co/claudesprint/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

```bash
pip install claudesprint
```

Or install with [pipx](https://pipx.pypa.io/) for isolated environment:

```bash
pipx install claudesprint
```

**Requirements:** Python 3.10+ and [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) (authenticated)

### 2. Verify Setup

```bash
claudesprint doctor
```

### 3. Try the Demo

```bash
claudesprint demo
```

Watch ClaudeSprint build a complete URL shortener app autonomously.

### 4. Start Your Own Project

```bash
claudesprint quickstart
```

## How It Works

<p align="center">
  <img src="docs/assets/high-level-issue-loop.png" alt="ClaudeSprint Issue Loop" width="100%" />
</p>

Each step runs in a fresh Claude session with focused context. State is passed via JSON artifacts, not conversation history.

<details>
<summary><strong>View detailed architecture</strong></summary>
<br/>
<p align="center">
  <img src="docs/assets/loop-detailed.jpg" alt="ClaudeSprint Detailed Loop Architecture" width="100%" />
</p>
</details>

[Full architecture documentation →](https://arc-co.github.io/claudesprint/concepts/architecture/)

## Commands

```bash
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 →](https://arc-co.github.io/claudesprint/reference/cli-commands/)

## Cost Awareness

ClaudeSprint runs autonomous loops that consume API tokens. Control costs with:

```bash
# Limit iterations (recommended for testing)
claudesprint run -n 5

# Use cheaper models for all steps
CLAUDESPRINT_MODEL_OVERRIDE=sonnet claudesprint run
```

[Cost management guide →](https://arc-co.github.io/claudesprint/guides/cost-management/)

## Documentation

- [Installation](https://arc-co.github.io/claudesprint/getting-started/installation/)
- [Quickstart Guide](https://arc-co.github.io/claudesprint/getting-started/quickstart/)
- [Writing Specifications](https://arc-co.github.io/claudesprint/guides/specifications/)
- [Configuration](https://arc-co.github.io/claudesprint/guides/configuration/)
- [Troubleshooting](https://arc-co.github.io/claudesprint/reference/troubleshooting/)

## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.

## License

MIT - see [LICENSE](LICENSE)
