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.

Forge

Use Codex Forge to design a bounded implementation proposal.
Return convergence, dissent, safety notes, and next Council prompt.

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

# Preview the opt-in router. Hard-risk flags still force full coverage.
python3 scripts/codex_council.py estimate --topic "Docs cleanup" --router auto --panel auto --json

# Forge a creative proposal first, then send it to Council for judgment.
python3 scripts/codex_council.py estimate --topic "Forge a Release Workflow" --mode standard --type forge --token-budget compact
python3 scripts/codex_council.py init --topic "Forge a Release Workflow" --root . --mode standard --type forge --confirm-estimate

# Compile repeated context, then inspect health and local metrics.
python3 scripts/codex_council.py compile-context --topic "Review handoff" --constraint "No public links" --json
python3 scripts/codex_council.py doctor --session <session-dir>
python3 scripts/codex_council.py dashboard

# Validate and write local estimate 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.

Experimental Decision Runtime

Project a shadow. Keep the verdict untouched.

The 1.0 Decision Runtime is opt-in and legacy-authoritative. Start a shadow only when you want the extra view; it never changes the Council verdict.

python3 scripts/codex_council.py cells project --help
python3 scripts/codex_council.py cells doctor --help

See what Decision Runtime adds Open the full technical reference →

Upgrade to 1.0

Stay current without force-migrating a session.

# Pull 1.0 and reload Codex.
npx codex-marketplace add ercoledevs/codex-council --plugin --global -y

# Validate the installed plugin and check release status.
python3 scripts/codex_council.py validate --plugin-root . --strict
python3 scripts/codex_council.py check-update

No forced conversion Existing profiles, alters, history, sessions, and legacy verdicts remain usable from the stable plugin state root. Decision Cells appear only when you opt in.