DrZero Configuration

View, validate, initialize, and edit shared DrZero settings. Codex uses the same drzero.yml file shape as the Claude DrZero plugin so projects can switch between Claude and Codex without rewriting configuration.

Codex Plugin Setup

When the drzero Codex plugin is installed, initialize it from chat:

@drzero run drzero-config init for this repo

Then confirm the shared configuration and plugin health:

@drzero drzero-config show
@drzero drzero-config validate
@drzero drzero-ping

This creates ./drzero.yml only when it is missing and installs DrZero support scripts plus bundled agent templates under .codex/otc-awesome-llm. It does not activate templates into .codex/agents by default, so @drzero remains the primary plugin mention. It does not create a Codex-only JSON config; Codex and Claude keep sharing the same DrZero YAML format.

Installation Prerequisite

Install the DrZero Codex bundle before using this skill:

make codex-install-drzero SCOPE=repo

Configurable Settings

• dr_zero.max_iterations: Autonomous loop iteration count. Codex init default: 3.
• dr_zero.tasks_per_iteration: WorkItems generated per iteration. Codex init default: 3.
• dr_zero.target_success_rate: HRPO curriculum target.
• dr_zero.proposer: Proposer type and persona.
• dr_zero.solver: Solver backend and generation temperature.
• dr_zero.production_features: Checkpoint, audit, telemetry, CAT defense, and rate-limit toggles.
• dr_zero.terminal: Tests, lint, coverage, and diff-size terminal conditions.
• agent_swarm.domains: orchestration plus the 16 canonical domain specialists.
• agent_swarm.orchestrator: Coordinator, quality reviewer, and definition of done.
• agent_swarm.turns: Feedback-loop bounds.
• agent_swarm.prompts: Shared prompt templates.
• github: Optional GitHub issue/PR integration settings.
• observability: Audit, metrics, log-level, and export-format settings.

Configuration File

Settings are stored in drzero.yml at the repository root. The global fallback is ~/.claude/drzero.yml, matching the Claude runtime.

Config precedence:

1. ./drzero.yml
2. ~/.claude/drzero.yml
3. built-in defaults

version: "1.0"
dr_zero:
  max_iterations: 3
  tasks_per_iteration: 3
  solver:
    backend: codex
agent_swarm:
  domains:
    - orchestration
    - architecture
    - backend
    - testing

Usage

• drzero-config init: Create drzero.yml if missing.
• drzero-config init --install-assets: Install support scripts and bundled templates without adding mentionable specialist agents.
• drzero-config init --install-assets --install-agents: Advanced mode that also writes dr0-* aliases to .codex/agents, adding direct specialist mentions without competing with @drzero.
• drzero-config show: Show active config source and key values.
• drzero-config validate: Validate the active shared config.
• drzero-config edit: Open the active config in $EDITOR; if unset, print the path.

Support script:

python3 scripts/codex/drzero-config.py init
python3 scripts/codex/drzero-config.py validate
python3 scripts/codex/drzero-config.py show