← Back to Quoruns
Quoruns CLI

Run the council from your terminal.

The same multi-model pipeline behind the web app, as a local command-line tool — and as native MCP tools your coding agent can call. Local-first, your own API keys, and a free offline mode so you can prove the wiring before spending a cent.

Local-first Your API keys Free offline demo Source-available

Install

Requires Python 3.11+ and git.

1 · Clone
git clone https://github.com/adta7/ai-orchestrator.git && cd ai-orchestrator
2 · Create a virtualenv
python3 -m venv .venv && source .venv/bin/activate
3 · Install (add ,mcp for the Claude Code tools)
pip install -e ".[providers]"

Try it free — offline, no keys

The fake council runs the whole pipeline with deterministic stand-in models, so you can confirm everything works for zero cost.

Offline demo run
orchestrate relay "design a URL shortener" --council fake

Everyday commands

Ask · brainstorm · debate · plan · review
orchestrate ask "Monolith or microservices for our MVP?"
orchestrate brainstorm "names for a developer-tools startup" --fanout 8
orchestrate rhetoric "Should we rewrite the monolith?" --agents 3 --rounds 4
orchestrate relay "design a rate limiter" --council orchestra
orchestrate review --artifact-file plan.md --council cli --json

Add --council lite for a faster, cheaper run, or --json for machine-readable output. Full transcripts are saved locally under the project.

Give your coding agent the council (MCP)

Install with the mcp extra, then register the server so Claude Code (or any MCP-capable agent) can call the council as native tools.

Install the MCP extra
pip install -e ".[providers,mcp]"
Register the server (absolute venv path)
claude mcp add -s user -t stdio orchestrator -- "$(pwd)/.venv/bin/orchestrate-mcp"
plan_with_orchestra

Design or plan something — research → architecture → plan → independent review → synthesis. Returns a plan; never edits files.

review_with_orchestra

Independently critique a draft or plan with multiple models. Returns a verdict + prioritized fixes.

answer_with_orchestra

Answer a high-stakes question by synthesizing several models, preserving disagreement.

Turn on real models

The fake council is free; for real models, add the keys you have to a local .env (git-ignored) in the repo:

.env
ANTHROPIC_API_KEY=...
OPENAI_API_KEY=...
GOOGLE_API_KEY=...

Your keys stay on your machine — prompts go only to the model providers you configure. Don't paste keys into chat.

What it won't do