Metadata-Version: 2.4
Name: autonomous-claude
Version: 0.2.2
Summary: Build apps autonomously with Claude Code CLI
Project-URL: Homepage, https://github.com/ferdousbhai/autonomous-claude
Project-URL: Repository, https://github.com/ferdousbhai/autonomous-claude
Author: Ferdous Bhai
License-Expression: MIT
License-File: LICENSE
Keywords: ai,autonomous,claude,cli,coding
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development
Requires-Python: >=3.10
Requires-Dist: rich>=13.0.0
Requires-Dist: typer>=0.9.0
Description-Content-Type: text/markdown

# autonomous-claude

Build apps autonomously with Claude Code CLI. Uses your existing Claude subscription - no API key required.

Based on [Anthropic's long-running agents guide](https://www.anthropic.com/engineering/effective-harnesses-for-long-running-agents).

## Installation

```bash
# Install uv if you haven't
curl -LsSf https://astral.sh/uv/install.sh | sh

# Install autonomous-claude
uv tool install autonomous-claude
```

Or install from source:
```bash
git clone https://github.com/ferdousbhai/autonomous-claude.git
cd autonomous-claude
uv tool install .
```

### Prerequisites

Claude Code CLI must be installed and authenticated:

```bash
npm install -g @anthropic-ai/claude-code
claude login
```

## Usage

### Build a new app

```bash
# From a description
autonomous-claude build "A todo app with React and SQLite"

# From a spec file
autonomous-claude build ./my-app-spec.txt -o ./my-app

# With options
autonomous-claude build "Blog with markdown" -o ./blog -n 5
```

### Resume an existing project

```bash
autonomous-claude resume ./my-app
```

### Options

| Option | Short | Description | Default |
|--------|-------|-------------|---------|
| `--output` | `-o` | Output directory | auto-generated |
| `--model` | `-m` | Claude model | Claude Code default |
| `--max-iterations` | `-n` | Max iterations | unlimited |
| `--timeout` | `-t` | Timeout per session (seconds) | 1800 |

## How It Works

1. **Session 1 (Initializer)**: Creates `feature_list.json` with testable features
2. **Sessions 2+ (Coding Agent)**: Implements features one by one, marking them as passing

Progress is persisted via `feature_list.json` and git commits. Press `Ctrl+C` to stop, then `resume` to continue.

## Example

```bash
$ autonomous-claude build "A simple notes app with tags and search"

======================================================================
  AUTONOMOUS CLAUDE
======================================================================

Project: /home/user/output
Model: claude-sonnet-4-5-20250929
Max iterations: unlimited

Starting new project - initializer agent will run first
...
```

## Security Note

This tool uses `--dangerously-skip-permissions` for autonomous operation. Only run in trusted environments.

## License

MIT - Based on [Anthropic's claude-quickstarts](https://github.com/anthropics/claude-quickstarts)
