Metadata-Version: 2.4
Name: orchex-cli
Version: 0.1.0
Summary: Multi-provider AI coding agent orchestrator
Project-URL: Homepage, https://github.com/orchex-cli/orchex
Project-URL: Repository, https://github.com/orchex-cli/orchex
Project-URL: Issues, https://github.com/orchex-cli/orchex/issues
Author-email: tech-mentat <tech@mentat.so>
License-Expression: MIT
Keywords: ai,claude,codex,coding,gemini,orchestrator
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.9
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 :: Libraries
Requires-Python: >=3.9
Requires-Dist: click>=8.0
Requires-Dist: rich>=13.0
Requires-Dist: tomli-w>=1.0
Requires-Dist: tomli>=2.0; python_version < '3.11'
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Description-Content-Type: text/markdown

# orchex

Multi-provider AI coding agent orchestrator. An intelligent coding tool that runs in the terminal — Claude Code, Codex CLI, and Gemini CLI collaborate on every request, cross-review each other's work, and deliver a unified team answer.

## Installation

```bash
# via npm (recommended)
npm install -g orchex

# or via pipx
pipx install orchex-cli

# or via pip
pip install orchex-cli
```

## Requirements

- Python 3.9+
- Node.js 16+ (for npm installation only)
- At least one of: Claude Code, Codex CLI, Gemini CLI

## Quick Start

```bash
# Launch interactive mode
orchex

# Ask a question directly
orchex ask "Explain the authentication flow in this codebase"

# Check agent status
orchex agents
```

## How It Works

1. **You ask a question** — type anything in the interactive prompt
2. **All agents research independently** — Claude, Codex, and Gemini work in parallel
3. **Cross-review** — each agent reviews the others' responses
4. **Unified answer** — a consolidated team document is delivered

## Interactive Commands

| Command | Action |
|---------|--------|
| `/agents` | Show agent status |
| `/verbose` | Toggle detailed output (show individual responses + reviews) |
| `/help` | Show help |
| `/quit` | Exit |

## Configuration

Create `.orchex/config.toml` in your project:

```toml
[ideation]
max_rounds = 5
discussion_mode = "free"

[routing.defaults]
architecture = "claude"
implementation = "codex"
research = "gemini"

[notify.telegram]
enabled = false
bot_token = "env:ORCHEX_TG_TOKEN"
chat_id = "env:ORCHEX_TG_CHAT_ID"

[notify.discord]
enabled = false
webhook_url = "env:ORCHEX_DISCORD_WEBHOOK"
```

## License

MIT
