Install

Install the complete Codex Council workflow.

Install globally to use Forge, Council, Mind, Hyper, Alters, and Decision Runtime 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.

Included workflows Forge creates proposals, Council reviews them, Mind controls the gates, and Hyper implements authorized changes under its own preflight. Alters and the opt-in Decision Runtime are included; Decision Runtime remains experimental and non-authoritative.

Ask well

Give the workflow a clear decision or change.

Copy the structure and replace the placeholders. These are prompt examples, not recorded outcomes.

Forge

Prompt example 
Use $codex-council:codex-forge to design a bounded implementation proposal.
Return convergence, dissent, safety notes, and next Council prompt.

Architecture

Prompt example 
Use $codex-council:codex-council to review this architecture decision.
Focus on blockers, rollback, and verification.

Implementation review

Prompt example 
Use $codex-council:codex-council to review this diff.
Focus on regressions, missing tests, and performance impact.

Frontend

Prompt example 
Use $codex-council:codex-council with frontend review.
Review this modal with Leonardo and Bob.
Don't claim verified without browser evidence.

Mind

Prompt example 
Use $codex-council:codex-mind to turn this idea into a proposal and review it.
If the verdict is build with no blockers, offer Hyper and ask before editing.

Hyper

Prompt example 
Use $codex-council:codex-hyper to implement this authorized change.
Define the contract and close only on evidence.

CLI workflow

Scaffold artifacts before dispatch.

# Set the local profile used for estimates.
python3 scripts/codex_council.py profile --plan Pro --model "<model-id>" --reasoning high

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

# Scaffold session artifacts once you've accepted the estimate.
# init only writes artifacts; it does not dispatch agents or run a review.
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

# Scaffold a Forge session. The CLI only prepares artifacts;
# invoking the Codex skill separately dispatches creators.
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
Local planning only Modes (fast, standard, deep) choose the deliberation topology. Budgets (compact, balanced, expanded) choose the context and output allowance. Estimates are local heuristics, not billing telemetry. Standard and Deep require an accepted estimate; expanded also requires explicit confirmation.

Experimental Decision Runtime

Inspect saved artifacts without changing the verdict.

Decision Runtime is experimental, opt-in, and non-authoritative. It projects a local view from saved artifacts; the original session and Council verdict remain the source of truth. 

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 →

Stay current

Update without force-migrating a session.

# Install the current public release 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.