Crossfeed Orchestrator routes AI coding work among configured providers and models, then supervises each worker.

Your local console controls which models agents may use and how freely they spend each plan. Routing reads those settings before every job.

Install

The core runs on macOS and Linux; native Windows is unsupported. You need Python 3.9+, bash, jq and your chosen vendor CLIs, installed and signed in. No extra Python packages.

git clone https://github.com/ABCastor/crossfeed-orchestrator ~/crossfeed-orchestrator
cd ~/crossfeed-orchestrator
mkdir -p ~/.config/orchestrator
cp examples/access-overlay.example.json ~/.config/orchestrator/access-overlay.json
python3 scripts/fleetctl.py doctor
python3 scripts/fleetctl.py console

The overlay is your machine's roster of plans, models and roles. Replace the example settings with your own. Keep only signed-in, tested lanes verified; mark the others unverified. doctor reports setup gaps and exits nonzero until you fix them. Before dispatch, verify the example thinking-level settings and record their evidence dates. Installation details, agent skill setup and Linux setup.

ChatGPT relay integration is optional and needs a separately installed Crossfeed Chat service. That service is currently private; adapter configuration and limits are documented here.

Give it work

python3 scripts/fleetctl.py brief
python3 scripts/fleetctl.py select --role implementation --json
python3 scripts/fleetctl.py dispatch --role review --mode read-only \
  --prompt "Review the retry paths and report concrete defects." --dir "$PWD" \
  --last /tmp/review.txt

A lane is a model on a tool, funded by a quota pool. Crossfeed selects a lane and thinking level, reserves its capacity and runs it under an idle watchdog. Each run records the selected model; provider identity is confirmed only when the provider supplies it.

Documentation

• Usage guide: routing, wrappers, parallel jobs, spend levels, model switches, providers and quota sources.
• Selector, thinking levels and adapter contracts.
• ChatGPT relay setup and limits and API client setup.
• Agent operating manual: briefs, isolation, supervision and verification.

Adapters are provided for Claude Code, Codex, Antigravity, OpenCode, Copilot CLI and OpenRouter. Pi supports admitted API and partner-plan routes.

Limits and tests

Missing quota measurements stay unknown. The Copilot wrapper runs one read-only Auto observer at a time; Antigravity requires write mode. ChatGPT relay lanes need dated acceptance of account risk, and their underlying model identity remains unconfirmed. Full status and limits.

bash tests/run-all.sh

The suite uses fake CLIs and synthetic data. It does not prove live provider access or the correctness of an agent's answer.

Upstream credit

Credit to upstream contributor: Rocco Angelella's PiLink introduced the ChatGPT gateway approach. Crossfeed Chat implements it separately.

Licence

The code is Apache 2.0. The artwork and bundled fonts have separate terms in NOTICE.