Skip to content

Codex Profiles

Codex roles use generated per-role homes instead of Claude plugin directories. During greatminds setup, greatminds creates one Codex home for each shipped Codex profile:

coordination/
  .codex-home/
    developer/
      config.toml
    tester/
      config.toml
    technical-writer/
      config.toml

Each config.toml is copied from src/greatminds/data/codex/profiles/<role>.config.toml. The generated file contains developer_instructions = """...""" for the role posture and a [profiles.<role>] section with the Codex model, approval policy, and sandbox settings.

When a Codex-backed role starts, start_agent.py points Codex at that role's home:

CODEX_HOME=<project>/coordination/.codex-home/<role> \
  codex --profile <role-lower>

Codex then reads $CODEX_HOME/config.toml and selects the matching [profiles.<role>] section. The older pattern of storing per-role profile files under a user's home directory is not part of the greatminds launch path.

To inspect or customize a project's Codex posture, edit the generated coordination/.codex-home/<role>/config.toml files after setup. To change the defaults for future projects, update the canon templates under src/greatminds/data/codex/profiles/ before running greatminds setup in those projects.