Install a Codex profile with GPT-6 Astra, GPT-6.1 Sol, or GPT-6 Luna as the orchestrator, GPT-6 Luna execution subagents, and an independent reviewer.

The Sol profiles use gpt-6.1-sol for both the orchestrator and reviewer.

The diagram shows the Astra (Pro) and Sol orchestrators. Plus uses a Luna root, as shown in the profile table below. Execution roles use GPT-6 Luna; the reviewer uses Astra for Pro/Plus and Sol for Sol profiles.

           GPT-6 Astra / GPT-6.1 Sol
             root / orchestrator
                      |
      +---------------+---------------+
      |               |               |
   explorer          worker         researcher
  GPT-6 Luna       GPT-6 Luna       GPT-6 Luna
      |               |
      +-------+-------+
              |
           tester
         GPT-6 Luna
              |
          reviewer
      GPT-6 Astra / GPT-6.1 Sol
              |
              v
           root agent
      integrate + verify

1. Clone this repository and enter it:

   git clone https://github.com/donvito/codex-astra-luna-orchestrator.git
   cd codex-astra-luna-orchestrator

2. Run the installer for your platform:

   macOS/Linux:

   ./setup.sh

   Windows PowerShell:

   powershell -ExecutionPolicy Bypass -File .\setup.ps1

   PowerShell 7:

   pwsh -File .\setup.ps1

3. When prompted, enter an existing target repository other than this one, choose a profile by number or name (Enter selects Pro), and confirm which components to install. For example:

   Target repository path: ../my-project
   Select Profile [1-6] (default 1): 5
   

The installer copies the selected configuration to .codex/, its skill to .agents/, and project instructions to AGENTS.md. Existing component files are updated only after confirmation; existing AGENTS.md content is preserved. Codex loads project-scoped configuration only for trusted projects.

If you install all three components into ../my-project, the installer adds these paths alongside the project's existing files:

my-project/
├── .codex/
│   ├── config.toml
│   └── agents/
│       ├── explorer.toml
│       ├── researcher.toml
│       ├── reviewer.toml
│       ├── tester.toml
│       └── worker.toml
├── .agents/
│   └── skills/
│       └── astra-orchestrator/
│           └── SKILL.md
└── AGENTS.md

profiles/<profile>/codex/ becomes .codex/, and profiles/<profile>/agents/ becomes .agents/. The root AGENTS.md is copied to the target, or its instructions are appended if that file exists.

From the target repository, launch Codex CLI. For the example above:

cd ../my-project
codex

For complex work, Codex may select the skill automatically, or you can invoke it explicitly:

$astra-orchestrator
Implement the invoice export endpoint. Use the explorer to map the path,
a worker to implement it, and the tester and reviewer to verify it.

The skill keeps the astra-orchestrator name in every profile so the shared AGENTS.md works; the Sol profiles use Sol according to their configuration.

All models above are GPT-6. Execution roles are explorer, worker, tester, and researcher; named roles pin their models and reasoning levels independently of the default subagent settings. Each ready-to-copy profile lives under profiles/<profile>/.

For manual project setup, copy the selected profile's codex/ and agents/ to the target repository as .codex/ and .agents/, and add this repository's AGENTS.md. For personal/global setup, copy its codex/agents/ into ~/.codex/agents/, its agents/skills/astra-orchestrator/ into ~/.agents/skills/, and merge, rather than replace, its codex/config.toml settings into ~/.codex/config.toml. Do not overwrite other existing Codex settings.

.
├── profiles/
│   ├── pro/
│   ├── plus/
│   ├── pro-max-2-subagents/
│   ├── plus-max-2-subagents/
│   ├── GPT6-SolMax-LunaMax/
│   └── GPT6-SolMedium-LunaMax/
├── guides/
├── scripts/
│   └── token_usage.py
├── tests/
│   ├── test_profiles.py
│   └── test_token_usage.py
├── AGENTS.md
├── setup.sh
├── setup.ps1
├── README.md
└── LICENSE

Each profile contains codex/config.toml, codex/agents/*.toml, and agents/skills/astra-orchestrator/SKILL.md.

• Pro orchestration and manual configuration
• Plus profile and global setup
• Fast iteration and routine coding
• Complex repository work
• Token usage and measurement

Licensed under the Apache License 2.0.