Skip to content

branchbrief CLI reference

Command

Terminal window
branchbrief [options]

Generates a branch brief from local git state.

Options

OptionPurpose
--base <branch>Sets the base branch for comparison.
--output <path>Writes the brief to a file instead of stdout.
--jsonRenders JSON instead of Markdown.
--copilotAdds Copilot-compatible review context.
--fail-on <level>Exits non-zero when risk is at or above low, medium, or high.
--repo-root <path>Runs against a specific repository root.
--quietReduces non-essential output.
--no-colorDisables terminal color output.

Examples

Terminal window
branchbrief --base main
branchbrief --base main --output BRANCH_BRIEF.md
branchbrief --base main --json --output branch-brief.json
branchbrief --base main --copilot --fail-on high
branchbrief --repo-root . --base origin/main --no-color