Metadata-Version: 2.4
Name: macrocycle
Version: 0.1.1
Summary: Ritualized AI agent workflows - multi-pass prompt pipelines for Cursor and beyond
Author: Milan Pecov
License: MIT
Project-URL: Homepage, https://github.com/MilanPecov/macrocycle
Project-URL: Repository, https://github.com/MilanPecov/macrocycle
Keywords: ai,agent,cursor,workflow,automation,llm
Classifier: Development Status :: 3 - Alpha
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 :: Libraries
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: typer>=0.12.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: rich>=13.0.0
Provides-Extra: test
Requires-Dist: pytest>=8.0.0; extra == "test"
Provides-Extra: dev
Requires-Dist: pytest>=8.0.0; extra == "dev"
Requires-Dist: commitizen>=4.0.0; extra == "dev"
Dynamic: license-file

# macrocycle

> Your StarCraft macro loop for code.

Ritualized AI agent workflows - multi-pass prompt pipelines for Cursor and beyond.

## ⚡ Why Macros?

- **Burn tokens, not time.** Let AI iterate through analysis, planning, and implementation while you context-switch.
- **Scale horizontally.** Run 10 agents on 10 Sentry errors. Review the PRs over lunch.
- **Artifacts you can audit.** Every cycle saves outputs to disk. Review before merging.

## 📦 Installation

```bash
pipx install macrocycle
```

Or: `pip install macrocycle` / `uv tool install macrocycle`

## 🚀 Quick Start

```bash
cd your-project
macrocycle init

git checkout -b fix/your-issue
macrocycle run fix "Paste your error context here"
```

## 🔁 Run at Scale

Loop through problems and let agents work in parallel:

```bash
# Fix all Sentry errors from today
for error in $(sentry-cli issues list --status unresolved); do
  git checkout -b fix/$error
  macrocycle run fix "$(sentry-cli issues get $error)" &
done
```

Each agent runs the full ritual: impact → plan → review → implement → PR.

## 🛠 CLI Commands

```bash
macrocycle init                      # Initialize .macrocycle folder
macrocycle list                      # List available macros
macrocycle run <macro> <input>       # Run a macro
macrocycle run fix "..." --yes       # Skip gate approvals
macrocycle run fix "..." --until impact  # Stop after specific step
```

## 📁 Artifacts

```
.macrocycle/
  macros/fix.json           # Workflow definitions
  cycles/                   # Execution history
    2026-01-15_fix_abc123/
      input.txt
      steps/01-impact.md
      steps/02-plan.md
      ...
```

## 🧑‍💻 Development

```bash
git clone https://github.com/MilanPecov/macrocycle.git
cd macrocycle

# Using uv (recommended)
uv venv && source .venv/bin/activate
uv pip install -e .[dev]

# Or using standard venv
python -m venv .venv && source .venv/bin/activate
pip install -e .[dev]
```

## 🧪 Test

```bash
pytest
```

## 🚀 Release

```bash
make release            # Auto-bump based on commits
make release-patch      # 0.1.0 → 0.1.1
make release-minor      # 0.1.0 → 0.2.0
make release-major      # 0.1.0 → 1.0.0
```

Pushing a tag triggers CI → tests → PyPI publish → GitHub release.

## License

MIT
