Metadata-Version: 2.4
Name: autoclaude-cli
Version: 1.1.0
Summary: Local runner for AutoClaude. Executes orchestration plans with your Claude Max/Pro subscription.
Project-URL: Homepage, https://github.com/grezy-software/autoclaude-cli
Project-URL: Issues, https://github.com/grezy-software/autoclaude-cli/issues
Author: Grezy Software
License: MIT
License-File: LICENSE
Keywords: autoclaude,automation,claude,cli,saas
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.11
Requires-Dist: httpx>=0.27.0
Requires-Dist: platformdirs>=4.0.0
Requires-Dist: rich>=13.0.0
Requires-Dist: tomli-w>=1.0.0
Requires-Dist: tomli>=2.0.0; python_version < '3.11'
Requires-Dist: typer>=0.12.0
Description-Content-Type: text/markdown

# autoclaude-cli

Local runner for [AutoClaude](https://github.com/grezy-software/grezy). Executes orchestration plans handed down from the server using **your own Claude Max/Pro subscription**. The server never pays for tokens.

## Requirements

- Python 3.11+
- [Claude Code](https://claude.com/claude-code) CLI on `$PATH` (`claude --version` works) and a Max or Pro subscription signed in.
- [`gh`](https://cli.github.com) CLI signed in with access to the target repo.
- Git.

## Install

With [`uv`](https://docs.astral.sh/uv/) (recommended):

```bash
uv tool install autoclaude-cli
```

Or with [`pipx`](https://pipx.pypa.io):

```bash
pipx install autoclaude-cli
```

Don't have `uv` yet? Install it first:

```bash
curl -LsSf https://astral.sh/uv/install.sh | sh          # macOS / Linux
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"   # Windows
```

During development, install from source:

```bash
uv tool install --force .      # or: pipx install --force ./
```

## Quickstart

```bash
# 1. Authenticate once. The CLI opens the API-key page in your browser.
autoclaude login                      # picks the prod profile
autoclaude --profile local login      # point at http://localhost:8000

# 2. Verify everything is wired up.
autoclaude diag

# 3. Install the Claude Code plugins your team's jobs require.
autoclaude skills install

# 4. Fire a tick. The server picks the next Job and plan.
autoclaude tick
```

## Profiles

`autoclaude` supports multiple named profiles (stored in `~/.config/autoclaude/config.toml`). Useful for switching between the hosted product and your local backend.

```bash
autoclaude --profile prod  tick    # https://app.grezy.com
autoclaude --profile local tick    # http://localhost:8000
AUTOCLAUDE_PROFILE=local autoclaude tick
```

Each profile stores its own `api_base`, `api_key`, and `repo_checkout`.

## How it works

1. CLI fetches the current plan from `GET /api/ac/runner/context/`.
2. For each step in the plan:
   - Ensures required Claude Code plugins are installed (`claude plugin install ...`).
   - Spawns `claude -p "<prompt>"` in the repo checkout.
   - Forwards tool callbacks to the server via `/api/ac/tool/<slug>/<action>/`.
3. Closes the tick with the outcome and cost report.

## License

MIT. See `LICENSE`.
