Quick install
Install from GitHub in two commands.
Astral Orchestrator v3.13.0 installs directly from its GitHub marketplace source. It keeps the current Sol, Luna, or Astra session as primary and uses native MultiAgentsV2 workers with explicit model and effort controls.
Copy this into a terminal
codex plugin marketplace add Demonbane18/astral-orchestrator --ref main
codex plugin add astral-orchestrator@astral-orchestratorOptional TypeSafe and Adaptive routing: codex plugin add typesafe-session@astral-orchestrator. Trust its hooks, then use Adaptive on typesafe or Adaptive on openrouter to select a Jev provider for each task; see routing setup.
- Add the GitHub marketplace source at its
mainref. - Install the
astral-orchestratorplugin. - Use native workers when named profiles are absent or customized; reserve the bundled exact-process launcher for a compatible legacy host.
- Start a new Codex task afterwards, so Codex discovers the plugin.
Want native named profiles too?
Optional native-profile setup is faster and more ergonomic, but is not required for exact routing. Clone the repository and paste this into Codex or a terminal:
git clone https://github.com/Demonbane18/astral-orchestrator.git && cd astral-orchestrator && sh scripts/setup.sh --dry-run && sh scripts/setup.sh
What you need
- Codex with access to the Sol, Luna, and Astra models.
- Python 3.11 or newer.
- A fresh Codex task after installing.
Something off?
The canonical documentation covers the full install flow, modes, maintenance, and troubleshooting. The issue tracker is open for reproducible bugs.
Getting started Maintenance and troubleshooting Support guidance