Install

Add it from the Codex Marketplace CLI.

Install globally to use the council in any project:

npx codex-marketplace add ercoledevs/codex-council --plugin --global -y

Or scope it to a single project:

npx codex-marketplace add ercoledevs/codex-council --plugin --project -y

Reload Codex after installing or updating.

Ask well

Give the council a decision, not a vibe.

Architecture

Use Codex Council to review this architecture decision.
Focus on blockers, rollback, and verification.

Implementation

Council review this diff.
Focus on regressions, missing tests, and performance impact.

Frontend

Frontend Council: review this modal flow with Leonardo and Bob.
Don't claim verified without browser evidence.

CLI workflow

When you want artifacts to keep.

# Set the local profile used for estimates.
python3 scripts/codex_council.py profile --plan Pro --model gpt-5.5 --reasoning xhigh

# Estimate first.
python3 scripts/codex_council.py estimate --topic "Architecture Review" --mode standard --token-budget compact

# Start a session once you've accepted the estimate.
python3 scripts/codex_council.py init --topic "Architecture Review" --root . --mode standard --token-budget compact --confirm-estimate

# Validate and write stats at the end.
python3 scripts/codex_council.py validate-session --session <session-dir>
python3 scripts/codex_council.py stats --session <session-dir> --write

On spending Saying "use Codex Council" asks for a review. It isn't a blank cheque. Standard, deep, and expanded all show you the estimate first, and expanded won't run until you confirm.

Update

Stay current.

Re-run the install command to pull the latest version:

npx codex-marketplace add ercoledevs/codex-council --plugin --global -y

Or check for a newer GitHub release from the helper script:

python3 scripts/codex_council.py check-update