Metadata-Version: 2.4
Name: agor
Version: 0.2.0
Summary: AgentOrchestrator - Multi-Agent Development Coordination Platform
Author-email: "Jeremiah K." <jeremiahk@gmx.com>
Project-URL: Bug Tracker, https://github.com/jeremiah-k/agor/issues
Project-URL: Repository, https://github.com/jeremiah-k/agor
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 4 - Beta
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Intended Audience :: Developers
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: httpx
Requires-Dist: plumbum
Requires-Dist: pyperclip
Requires-Dist: tqdm
Requires-Dist: typer
Requires-Dist: platformdirs<5.0.0,>=4.3.7
Requires-Dist: structlog>=24.1
Requires-Dist: pydantic-settings>=2.0
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Requires-Dist: pytest-cov; extra == "dev"
Requires-Dist: pytest-asyncio; extra == "dev"
Requires-Dist: pytest-tmp-git; extra == "dev"
Requires-Dist: ruff; extra == "dev"
Requires-Dist: mypy; extra == "dev"
Requires-Dist: pre-commit; extra == "dev"
Requires-Dist: build; extra == "dev"
Requires-Dist: twine; extra == "dev"
Dynamic: license-file

# 🎼 AgentOrchestrator (AGOR)

**Multi-Agent Development Coordination Platform**

Transform AI assistants into sophisticated development coordinators. Plan complex projects, design specialized agent teams, and orchestrate coordinated development workflows.

**Supports**: Linux, macOS, Windows | **Free Option**: Google AI Studio Pro | **Subscription**: ChatGPT

> **🔬 Alpha Protocol**: AGOR coordination strategies are actively evolving based on real-world usage. [Contribute feedback](https://github.com/jeremiah-k/agor/issues) to help shape AI coordination patterns.

## 🚀 Quick Start

### Bundle Mode (Upload to AI Platform)

**For Google AI Studio, ChatGPT, and other upload-based platforms:**

```bash
# Install AGOR locally
pipx install agor

# Bundle your project
agor bundle /path/to/your/project -f zip    # For Google AI Studio
agor bundle /path/to/your/project           # For ChatGPT (.tar.gz)

# Upload bundle to your AI platform and follow embedded instructions
```

### Agent Mode (Direct Git Access)

**For Augment Code, Jules by Google, and other git-capable agents:**

```bash
# Clone AGOR to temporary location
cd /tmp && git clone https://github.com/jeremiah-k/agor.git && cd agor

# Load protocol and return to your project
cat src/agor/tools/AGOR_INSTRUCTIONS.md && cat src/agor/tools/README_ai.md
```

## 🎯 Core Capabilities

**Role-Based Initialization**

- **PROJECT COORDINATOR**: Strategic planning and team coordination
- **ANALYST/SOLO DEV**: Deep codebase analysis and implementation
- **AGENT WORKER**: Task execution and coordination handoffs

**Multi-Agent Strategies**

- **Parallel Divergent**: Independent exploration → peer review → synthesis
- **Pipeline**: Sequential handoffs with specialization
- **Swarm**: Dynamic task assignment for maximum parallelism
- **Red Team**: Adversarial build/break cycles for robustness
- **Mob Programming**: Collaborative coding with rotating roles

**Development Tools**

- **Git integration** with portable binary (works in any environment)
- **Codebase analysis** with language-specific exploration
- **Memory persistence** and communication protocols
- **Quality gates** and validation checkpoints

## 📊 Hotkey Interface

**Strategic Planning**: `sp` strategic plan | `bp` break down project | `ar` architecture review
**Strategy Selection**: `ss` strategy selection | `pd` parallel divergent | `pl` pipeline | `sw` swarm
**Team Management**: `ct` create team | `tm` team manifest | `hp` handoff prompts
**Analysis**: `a` analyze codebase | `f` full files | `co` changes only | `da` detailed handoff
**Coordination**: `init` initialize | `status` check state | `sync` update | `meta` provide feedback

## 🏢 Platform Support

**✅ Successfully Tested Platforms**

- **Google AI Studio Pro** (Function Calling enabled, use `.zip` format)
- **ChatGPT** (requires subscription, use `.tar.gz` format)
- **Augment Code Remote Agents** (direct git access)
- **Jules by Google** (direct git access)

**Bundle Formats**

- `.zip` - Optimized for Google AI Studio
- `.tar.gz` - Standard format for ChatGPT and other platforms
- `.tar.bz2` - High compression option

## 🏗️ Use Cases

**Large-Scale Refactoring** - Coordinate specialized agents for database, API, frontend, and testing
**Feature Development** - Break down complex features with clear handoff points
**System Integration** - Plan integration with specialized validation procedures
**Code Quality Initiatives** - Coordinate security, performance, and maintainability improvements
**Technical Debt Reduction** - Systematic planning and execution across components

## 🔧 Installation

```bash
# Install AGOR
pipx install agor

# Verify installation
agor --version

# Bundle a project
agor bundle /path/to/project
```

**Requirements**: Python 3.10+ | **Platforms**: Linux, macOS, Windows

---

## 📚 Documentation

**[📋 Documentation Index](docs/index.md)** - Token-efficient lookup for AI models
**[AGOR_INSTRUCTIONS.md](src/agor/tools/AGOR_INSTRUCTIONS.md)** - Agent Mode setup
**[BUNDLE_INSTRUCTIONS.md](src/agor/tools/BUNDLE_INSTRUCTIONS.md)** - Bundle Mode setup
**[src/agor/tools/README_ai.md](src/agor/tools/README_ai.md)** - Complete AI protocol
**[src/agor/tools/agor-meta.md](src/agor/tools/agor-meta.md)** - Feedback system

## 🙏 Attribution

Enhanced fork of [AgentGrunt](https://github.com/nikvdp/agentgrunt) by [@nikvdp](https://github.com/nikvdp) | MIT License
