Commands and flags for gitaiflow.
branch’s upstream, then GITAIFLOW_REMOTE, then origin, then the only remote) and base branch (defaults to the remote’s detected default branch, falling back to main). The base ref is recorded as metadata and used by --changelog; summaries themselves compare your working tree against HEAD.*.svg) from the diff.change-summary output (default change-summary/); reuse the same value with --changelog.JSON artifact.commit title + body to stdout (pipeable into git commit -F).change-summary straight from disk — no git diff, no AI call, no new run.--change-summary, also print the model’s raw reasoning that preceded its answer (debugging).free-model pricing guard and proceed even if the configured model may be billed.CHANGELOG.md entry for a date range, grouped by conventional-commit type.RELEASE_NOTES.md from the current version’s CHANGELOG.md entry (run --changelog first if it doesn’t exist yet).| Flag | Description |
|---|---|
| --path PATH | File or directory to summarize (default: current directory). |
| --remote / --base-branch | Override the remote (defaults to the branch’s upstream, then GITAIFLOW_REMOTE, then origin, then the only remote) and base branch (defaults to the remote’s detected default branch, falling back to main). The base ref is recorded as metadata and used by --changelog; summaries themselves compare your working tree against HEAD. |
| --skip [paths...] | Exclude directories, exact file paths, or file-type patterns (e.g. *.svg) from the diff. |
| -o, --output-dir DIR | Custom root for change-summary output (default change-summary/); reuse the same value with --changelog. |
| --markdown | Also render a human-facing Markdown view alongside the JSON artifact. |
| --no-chunk | Send the whole diff as a single AI request instead of per-directory chunks. |
| --change-summary | Print just the generated commit title + body to stdout (pipeable into git commit -F). |
| --last-summary | Print the most recently generated change-summary straight from disk — no git diff, no AI call, no new run. |
| --regenerate-summary | Force a fresh AI summary for every group, even if an identical diff was already summarized on a previous day. |
| --show-analysis | With --change-summary, also print the model’s raw reasoning that preceded its answer (debugging). |
| --allow-billing | Skip the free-model pricing guard and proceed even if the configured model may be billed. |
| --changelog --since ... [--until ...] | Generate/prepend a CHANGELOG.md entry for a date range, grouped by conventional-commit type. |
| --release-notes | Generate or overwrite RELEASE_NOTES.md from the current version’s CHANGELOG.md entry (run --changelog first if it doesn’t exist yet). |
| --list-models [--free-only] [--json] | List OpenRouter’s live model catalog; no API key required. |
| --usage [version | --since --until] | Query the local usage log for the last run, a specific version, or a custom date range. |
| --telemetry enable|disable|status|history | Set or inspect the durable, locally saved telemetry consent, independent of the current session. |
| --version / --help | Print the installed version, or the full flag reference generated from the binary itself (the source of truth if anything here drifts). |
| --uninstall | Completely remove the gitaiflow binary and local state files. |