# Orchex

Autopilot AI orchestration — describe your intent, orchex auto-generates a plan, parallelizes it into streams with file ownership enforcement, self-heals failures, and routes across 6 LLM providers. …

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add wundam/orchex

# Browse available tools
npx -y @smithery/cli@latest tool list wundam/orchex

# Get full schema for a tool
npx -y @smithery/cli@latest tool get wundam/orchex init

# Call a tool
npx -y @smithery/cli@latest tool call wundam/orchex init '{}'
```

## Direct MCP Connection

Endpoint: `https://orchex--wundam.run.tools`

**Optional config:**
- `ANTHROPIC_API_KEY` (query) — Override Anthropic API key (auto-detected from shell env)
- `OPENAI_API_KEY` (query) — Override OpenAI API key (auto-detected from shell env)
- `GEMINI_API_KEY` (query) — Override Gemini API key (auto-detected from shell env)
- `DEEPSEEK_API_KEY` (query) — Override DeepSeek API key (auto-detected from shell env)

## Tools (12)

- `init` — Initialize a new orchestration for a feature. Creates .orchex/active/manifest.yaml with streams.
- `add_stream` — Add a new stream to the active orchestration.
- `status` — Get the current orchestration status and progress.
- `execute` — Run the orchestration. Each call executes one wave of streams in parallel via LLM API, applies artifacts to the codebas…
- `complete` — Mark a stream as complete, or archive the entire orchestration.
- `recover` — Recover streams stuck in in_progress state or failed state. Auto-detects stuck streams and resets them to pending for r…
- `learn` — Parse a planning document and generate stream definitions. Returns proposed streams for review before initialization.
- `init-plan` — Generate an annotated markdown plan template that teaches users how to structure documents for orchex learn. Creates a …
- `auto` — Generate a plan from user intent, preview streams, and optionally execute. Flow: gather context → LLM generates plan → …
- `reset-learning` — Reset learning data: thresholds, events, patterns, and/or reports.
- `rollback-stream` — Revert file changes made by a specific stream using git.
- `reload` — Restart the MCP server to pick up rebuilt code. MCP client will reconnect automatically.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get wundam/orchex <tool-name>
```