Codex Subagents: Astra Orchestrator + Luna Workers, and How to Swap Models
Melvin Vivas · X post · 2026-09-08 · Open on X
Topics: AI Agents, Tool Use & MCP, AI Dev Tools & Productivity · Level: intermediate
Summary
Melvin Vivas explains that his Astra Orchestrator + Luna subagents setup for OpenAI Codex doesn't lock you into Luna as the subagent model. He picked Luna to make his usage limits last longer on the Plus plan. On Pro you can switch subagents to Sol, or to Astra on Pro 20x, by changing the standard Codex config and the skill instructions. He suggests setting this up per project rather than globally, because projects differ in complexity.
Key points
- The repo is a starter setup: Astra (or Sol) is the orchestrator and Luna runs the subagents in Codex. Without it, you'd write the subagent config by hand.
- He chose Luna for subagents because it's the most cost-efficient model, so usage limits last longer on ChatGPT Plus.
- On Pro you can use Sol for subagents, and on Pro 20x even Astra. To switch models, change both the config and the skill instructions that name Luna.
- It's standard Codex config, so you can tweak it, for example by setting a different reasoning level for each subagent model.
- From the quoted post: Luna does cheap work well on simple 'do A, B and C' tasks but sometimes struggles as a subagent when the work needs more reasoning.
- Set the subagent configuration per project, not globally. A global setup forces the same workflow onto every project.
- Planned next step: profiles, meaning preset configs for different subagent/model/reasoning combinations.
- Fork the repo and adapt it. Use the official Codex subagents docs as your reference.
Resources mentioned
- donvito/codex-astra-luna-orchestrator · repo · github.com · free
The creator's Codex skill for an orchestrator-plus-subagents setup (Astra orchestrator, Luna subagents), configured through config.toml.
Also in: Codex Orchestrator Pattern: Astra/Sol Orchestrator with Luna Subagents (Melvin Vivas on X · notes), Open-source Codex skill: Astra/Sol orchestrator with Luna subagents (Melvin Vivas on X · notes), Cost-Efficient Codex Subagents: Astra/Sol Orchestrator + Luna Workers (Melvin Vivas on X · notes), Codex Orchestrator v0.2.1: GPT-6 Sol orchestrator with Luna subagents (Melvin Vivas on X · notes) and 27 more - Codex Subagents documentation (Agent Configuration) · docs · learn.chatgpt.com · free
Official docs on how to configure subagents in Codex. - OpenAI Codex · tool · openai.com · paid
OpenAI's coding agent. In the diagram it writes code, fixes review findings and drives the build loop. The creator also used it to make this video.
Also in: An agent bot that installs and drives Codex on its own (Melvin Vivas on X · notes), Asking a Coder bot to install Codex (Melvin Vivas on X · notes), Sign in with ChatGPT: Setting Usage Limits for Each App (Melvin Vivas on X · notes), Codex Cloud Environments Must Be Saved & Published Before Use (Melvin Vivas on X · notes) and 240 more - Luna · tool · openai.com · paid
The other model/agent the classifier routes tasks to; the post doesn't describe it further.
Also in: GPT-6.1 Sol May Beat Luna for Subagents (Melvin Vivas on X · notes), Picking models for orchestrator and subagent roles in Codex (Melvin Vivas on X · notes), GPT-6 Sol Ultra Subagents Use Up Limits Fast (Melvin Vivas on X · notes), GPT-6 Sol vs Opus 5.5 in a Livestream Comparison (Melvin Vivas on X · notes) and 14 more - GPT-6 Astra · tool · openai.com · paid
The model announced in the quoted launch post, pitched as the developer's most capable model for work, coding, science and cybersecurity, and able to operate a computer.
Also in: Customizing Your Coding Setup with Pi Coding Agent Extensions (Melvin Vivas on X · notes), Pi Agent Council: Ask Multiple LLMs in Parallel and Compare Their Advice (Melvin Vivas on X · notes), Use GPT-6.1 Sol by Default, Save Astra for Emergencies (Melvin Vivas on X · notes), Dots in ChatGPT: always-on AI agents that you hand responsibilities to (Melvin Vivas on X · notes) and 49 more
Try this
- Fork the codex-astra-luna-orchestrator repo and adapt it to your project.
- To use a different subagent model (Sol, or Astra on Pro 20x), change both the Codex config and the skill instructions.
- Adjust the reasoning level for each subagent model if the defaults don't fit your project.
- Set up the subagent configuration at the project level, not globally.
- Read the official Codex subagents docs.
- Build preset Codex profiles for different subagent/model/reasoning combinations and pick one based on how complex the project is.
More in AI Agents, Tool Use & MCP
- Codex Orchestrator/Subagent Setup: Astra (medium) + Luna (max)
- codex-astra-luna-orchestrator: Astra/Sol Orchestrator + Luna Subagents
- Codex Subagents: Attaching Skills and MCP Servers per Subagent
- Codex: Orchestrating Big Tasks with a Skill and Subagents
- Luna Subagents Save Usage Limits in Codex Pro
- Measuring Codex Pro Runtime: Astra(low) + Luna(max) Subagents