Plain-English guide to Sol Advisor

Sol runs the show.
You keep the architecture.

Sol Advisor is a Codex-native workflow that splits software delivery into roles: a Sol session owns requirements, architecture, verification, and acceptance, while a Terra implementer (or an opt-in Luna task) does the bounded implementation work. This site is an independent, plain-English walkthrough.

Built for Codex CLI & ChatGPT desktop · GPT-5.6 Sol / High · Source: DannyMac180/sol-advisor

Why people use it

Architecture stays in one head

Instead of one session writing specs, code, and its own review, Sol Advisor separates the thinking from the typing — and makes the handoff verifiable.

Architecture & acceptance in Sol

The primary session keeps requirements, decomposition, verification, and the final ship/no-ship decision.

Verifiable routing

Production work is pinned to a specific model and reasoning effort. The orchestrator stops — it never silently falls back to a weaker lane.

Two modes, one control plane

Use native Terra / High subagents by default, or explicitly opt into user-visible Luna / Max tasks. Sol still owns acceptance either way.

The two delivery lanes

Pick the lane that fits the work

Luna lane explicit opt-in

Worker: user-visible GPT-5.6 Luna / Max task
  • Created only when you explicitly authorize it
  • Sol monitors the task, reads the actual diff, and accepts
  • Great for visible, trackable implementation work
Install

Add it from the Codex marketplace

Two commands in a Codex-enabled environment. (Companion agents are installed separately for the native lane.)

# Add the marketplace and install the plugin codex plugin marketplace add DannyMac180/sol-advisor --ref main codex plugin add sol-advisor@sol-advisor # Native lane only: install the companion roles, then verify sh "$("$plugin_dir/scripts/install-agents.sh")" sh "$("$plugin_dir/scripts/install-agents.sh")" --check
Note: This site summarizes the publicly available, MIT-licensed README. Always confirm commands against the official repository.
Full installation steps →