Skip to content

council review

DO NOT EDIT — this file is auto-generated from the Council CLI’s Commander definitions by pnpm --filter @council-ai/site docs:generate:commands. Run that command to regenerate it, and pnpm --filter @council-ai/site docs:check:commands to verify it is in sync.

Run the built-in code-review expert panel over a diff and print the review. The diff is SENT to the configured AI engine (e.g. Copilot) and, by default, STORED locally at rest in council.db. Use –engine mock to run offline; use –no-store to review without saving the diff.

council review [options]
Option Description Default
--diff-file <path> Read the unified diff from a file, or `-` to read stdin. When omitted, Council reviews `git diff <base>` (your local changes). —
--base <ref> Git ref to diff the working tree against when –diff-file is omitted HEAD
--engine <kind> Engine to use (default: from config) (choices: copilot, mock, openai, anthropic) —
--format <kind> Output format (choices: auto, json, plain) auto
--max-rounds <n> Max debate rounds (default: the code-review panel’s own default) —
--max-words <n> Soft per-response word budget (opening-phase anchor; structured mode scales the other phases) 250
--no-store Ephemeral review: do NOT persist the diff/debate to the local council.db. By default the reviewed diff is stored at rest in council.db (under COUNCIL_HOME). —
--ephemeral Alias for –no-store: run the review without saving the diff/debate to council.db. —