Plain-English guide to Sol Advisor
Frequently asked questions
Quick answers about what Sol Advisor is, how the lanes differ, and where to find the real docs.
What is Sol Advisor?
Sol Advisor is a Codex-native workflow that keeps architecture, verification, and acceptance in a primary Sol session while a Terra implementer (native lane) or an opt-in Luna task does the bounded implementation work.
What is the difference between the native lane and the Luna lane?
The native lane uses a separately installed Terra / High custom-agent subagent plus a fresh Sol reviewer, and needs no app-task tools. The Luna lane creates user-visible GPT-5.6 Luna / Max tasks through Codex app-task tools, and only runs when you explicitly opt in. Sol owns acceptance in both.
Which models does Sol Advisor use?
The primary session uses GPT-5.6 Sol / High. The native implementation lane uses GPT-5.6 Terra / High, and the optional Luna lane uses GPT-5.6 Luna / Max.
Does it fall back to a weaker model if something is missing?
No. If the expected role, model, or reasoning effort cannot be observed, the affected lane stops with an actionable error. There is no silent model, reasoning, or agent-type fallback.
How do I verify the companion agents installed correctly?
Run the installer's
--check mode: sh "$plugin_dir/scripts/install-agents.sh" --check. It is non-mutating and fails until both current role files match exactly and the retired Luna role is absent.Do I need Codex to use Sol Advisor?
Yes. Sol Advisor is a Codex plugin that runs in the Codex CLI or the ChatGPT desktop app with plugins enabled. It is not a standalone application.
Where is the official documentation?
The official, authoritative documentation lives in the project's GitHub repository at github.com/DannyMac180/sol-advisor, including its README and reference files.
Note: answers are an independent summary of the MIT-licensed README.
For anything authoritative, consult the official repository.