git-cai-cli 0.13.3__tar.gz → 0.13.5__tar.gz

{git_cai_cli-0.13.3 → git_cai_cli-0.13.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: git-cai-cli
-Version: 0.13.3
+Version: 0.13.5
 Summary: Use LLM to create git commit messages
 Author-email: Thorsten Foltz <thorsten.foltz@live.com>
 License-Expression: MIT
@@ -260,15 +260,15 @@ In addition to `git cai`, the following options are available:
 - `-H`, `--set-home` – set a config value in home config (`key=value`), always targets `~/.config/cai/`
 - `-h`, `--help` – show help and available commands
 - `-i`, `--install-completion` – install shell completion for bash, zsh, or fish
-- `-l`, `--list` – list available information (`config`, `editor`, `language`, `model`, `path`, `provider`, `style`)
+- `-l`, `--list` – list available information. Valid types: `config`, `editor`, `language`, `model`, `path`, `provider`, `style`
 - `-m`, `--model` – override the model for this invocation (requires `-P`)
 - `-P`, `--provider` – override the LLM provider for this invocation
 - `-p`, `--generate-prompts` – generate default `commit_prompt.md` and `squash_prompt.md` in the current directory (for customization)
-- `-Q`, `--stats` – show local-only usage analytics (commits/squashes/PRs per provider, tokens, average latency)
-- `--since YYYY-MM-DD` – filter `--stats` to events on or after this date
-- `--json` – render `--stats` output as JSON
-- `--reset-stats` – delete all rows from the local stats DB
 - `-q`, `--sql true|false` – override stats writing for this run (wins over the persisted `stats` config)
+- `-z`, `--stats` – show local-only usage analytics (commits/squashes/PRs per provider, tokens, average latency)
+  - `--since YYYY-MM-DD` – filter `--stats` to events on or after this date
+  - `--json` – render `--stats` output as JSON
+  - `--reset-stats` – delete all rows from the local stats DB
 - `-r`, `--PR` – generate a Pull Request description from the commits between the current branch and its base (prints to stdout by default; set `pr_to_file=true` to write a Markdown file)
 - `--base` `BRANCH` – explicit base branch for `--PR` (overrides auto-detection: `origin/HEAD` → `main` → `master`)
 - `-S`, `--set` – set a config value (`key=value`) in repo config (requires existing repo config)
@@ -375,10 +375,10 @@ git cai -H stats=true            # or in the home config
 git cai -q true                  # one-off opt-in regardless of config
 git cai -q false                 # one-off opt-out
 
-git cai --stats                  # text summary
-git cai -Q --json                # machine-readable
-git cai -Q --since 2026-01-01    # date filter
-git cai --reset-stats            # wipe all rows
+git cai -z                       # text summary
+git cai -z --json                # machine-readable
+git cai --stats --since 2026-01-01  # date filter
+git cai --stats --reset-stats    # wipe all rows
 ```
 
 Rows are split by `kind` (`commit`, `amend`, `squash`, `pr`) and capture provider, model, repo name, token counts, real LLM latency, and a snapshot of the active settings (language, style, emoji, temperature, prompt file).

{git_cai_cli-0.13.3 → git_cai_cli-0.13.5}/README.md

@@ -230,15 +230,15 @@ In addition to `git cai`, the following options are available:
 - `-H`, `--set-home` – set a config value in home config (`key=value`), always targets `~/.config/cai/`
 - `-h`, `--help` – show help and available commands
 - `-i`, `--install-completion` – install shell completion for bash, zsh, or fish
-- `-l`, `--list` – list available information (`config`, `editor`, `language`, `model`, `path`, `provider`, `style`)
+- `-l`, `--list` – list available information. Valid types: `config`, `editor`, `language`, `model`, `path`, `provider`, `style`
 - `-m`, `--model` – override the model for this invocation (requires `-P`)
 - `-P`, `--provider` – override the LLM provider for this invocation
 - `-p`, `--generate-prompts` – generate default `commit_prompt.md` and `squash_prompt.md` in the current directory (for customization)
-- `-Q`, `--stats` – show local-only usage analytics (commits/squashes/PRs per provider, tokens, average latency)
-- `--since YYYY-MM-DD` – filter `--stats` to events on or after this date
-- `--json` – render `--stats` output as JSON
-- `--reset-stats` – delete all rows from the local stats DB
 - `-q`, `--sql true|false` – override stats writing for this run (wins over the persisted `stats` config)
+- `-z`, `--stats` – show local-only usage analytics (commits/squashes/PRs per provider, tokens, average latency)
+  - `--since YYYY-MM-DD` – filter `--stats` to events on or after this date
+  - `--json` – render `--stats` output as JSON
+  - `--reset-stats` – delete all rows from the local stats DB
 - `-r`, `--PR` – generate a Pull Request description from the commits between the current branch and its base (prints to stdout by default; set `pr_to_file=true` to write a Markdown file)
 - `--base` `BRANCH` – explicit base branch for `--PR` (overrides auto-detection: `origin/HEAD` → `main` → `master`)
 - `-S`, `--set` – set a config value (`key=value`) in repo config (requires existing repo config)
@@ -345,10 +345,10 @@ git cai -H stats=true            # or in the home config
 git cai -q true                  # one-off opt-in regardless of config
 git cai -q false                 # one-off opt-out
 
-git cai --stats                  # text summary
-git cai -Q --json                # machine-readable
-git cai -Q --since 2026-01-01    # date filter
-git cai --reset-stats            # wipe all rows
+git cai -z                       # text summary
+git cai -z --json                # machine-readable
+git cai --stats --since 2026-01-01  # date filter
+git cai --stats --reset-stats    # wipe all rows
 ```
 
 Rows are split by `kind` (`commit`, `amend`, `squash`, `pr`) and capture provider, model, repo name, token counts, real LLM latency, and a snapshot of the active settings (language, style, emoji, temperature, prompt file).

{git_cai_cli-0.13.3 → git_cai_cli-0.13.5}/docs/git-cai.txt

@@ -23,11 +23,11 @@ SYNOPSIS
         [-r | --PR] [--base BRANCH]
         [-S KEY=VALUE | --set KEY=VALUE]
         [-s [N|HASH] | --squash [N|HASH]]
-        [-Q | --stats] [--since YYYY-MM-DD] [--json] [--reset-stats]
         [-q true|false | --sql true|false]
         [-T SECONDS | --timeout SECONDS]
         [-t | --time] [-u | --update] [-v | --version]
         [-x CONTEXT | --context CONTEXT]
+        [-z | --stats] [--since YYYY-MM-DD] [--json] [--reset-stats]
 
 
 DESCRIPTION
@@ -310,73 +310,6 @@ overwrites.
 git cai -p
 ----
 
--Q, --stats::
-Show local-only usage analytics: commits and squashes generated, top
-provider, total token counts, average latency, and per-provider rollups.
-Recording is opt-in via the top-level `stats` config key (a plain
-boolean, default `false`), so this view is empty until you turn writing
-on. No diff content, commit messages, or file paths are stored — only
-metadata.
-+
-Combine with `--since YYYY-MM-DD` to scope the view to recent activity, or
-with `--json` to emit machine-readable output. Use `--reset-stats` to
-clear the local SQLite database.
-+
-The DB lives at `$XDG_DATA_HOME/git-cai/stats.db` (default
-`~/.local/share/git-cai/stats.db`). Override with the top-level
-`stats_db_path` config key.
-+
-At the start of every run, git-cai logs whether stats writing is
-enabled and (when enabled) the path of the SQLite database, so users
-always know where their analytics live.
-+
-If the running Python build was compiled without sqlite3, this command
-prints a clear message explaining how to fix it; commit generation
-continues to work normally in that case.
-+
-The `stats` (and `stats_db_path`) keys are the one configuration
-exception that does not follow the strict repo-replaces-home rule:
-when the repo `cai_config.yml` does not mention them, the values are
-taken from the home `~/.config/cai/cai_config.yml`. If neither file
-defines `stats`, the hardcoded default is `false`. Use `git cai -g` to
-write a fresh config that includes the setting so it is visible.
-+
-----
-git cai --stats
-git cai -Q --since 2026-01-01
-git cai -Q --json
-git cai --reset-stats
-----
-
---since YYYY-MM-DD::
-Restrict `--stats` (`-Q`) output to events recorded on or after this UTC
-date. Has no effect outside of `--stats`. The date format is strict
-ISO-8601 (e.g. `2026-01-15`).
-+
-----
-git cai -Q --since 2026-01-01
-----
-
---json::
-Emit `--stats` (`-Q`) output as a JSON document instead of the text
-summary. Suitable for piping into `jq` or other tooling. Has no effect
-outside of `--stats`.
-+
-----
-git cai -Q --json
-git cai -Q --json --since 2026-01-01 | jq '.per_provider'
-----
-
---reset-stats::
-Delete every row from the local stats SQLite DB and exit. Prints the
-number of rows removed. The schema and DB file are preserved (so the
-next opt-in run records into the same file). No-op when the DB does
-not yet exist.
-+
-----
-git cai --reset-stats
-----
-
 -q, --sql VALUE::
 Per-invocation override for `stats.enabled`. VALUE is `true` or `false`
 (also accepts `yes/no`, `on/off`, `1/0`). Wins over the persisted config
@@ -546,6 +479,61 @@ git cai --squash -x "Resolves JIRA-99"
 git cai -r -x "Closes JIRA-1234"
 ----
 
+-z, --stats::
+Show local-only usage analytics: commits and squashes generated, top
+provider, total token counts, average latency, and per-provider rollups.
+Recording is opt-in via the top-level `stats` config key (a plain
+boolean, default `false`), so this view is empty until you turn writing
+on. No diff content, commit messages, or file paths are stored — only
+metadata.
++
+The DB lives at `$XDG_DATA_HOME/git-cai/stats.db` (default
+`~/.local/share/git-cai/stats.db`). Override with the top-level
+`stats_db_path` config key.
++
+At the start of every run, git-cai logs whether stats writing is
+enabled and (when enabled) the path of the SQLite database, so users
+always know where their analytics live.
++
+If the running Python build was compiled without sqlite3, this command
+prints a clear message explaining how to fix it; commit generation
+continues to work normally in that case.
++
+The `stats` (and `stats_db_path`) keys are the one configuration
+exception that does not follow the strict repo-replaces-home rule:
+when the repo `cai_config.yml` does not mention them, the values are
+taken from the home `~/.config/cai/cai_config.yml`. If neither file
+defines `stats`, the hardcoded default is `false`. Use `git cai -g` to
+write a fresh config that includes the setting so it is visible.
++
+Cannot be combined with `--amend`, `--list`, `--PR`, `--squash`, or
+`--update`.
++
+Modifiers for `--stats`:
++
+`--since YYYY-MM-DD`;;
+Restrict output to events recorded on or after this UTC date. The date
+format is strict ISO-8601 (e.g. `2026-01-15`).
++
+`--json`;;
+Emit output as a JSON document instead of the text summary. Suitable
+for piping into `jq` or other tooling.
++
+`--reset-stats`;;
+Delete every row from the local stats SQLite DB and exit. Prints the
+number of rows removed. The schema and DB file are preserved (so the
+next opt-in run records into the same file). No-op when the DB does
+not yet exist.
++
+----
+git cai -z
+git cai --stats
+git cai -z --since 2026-01-01
+git cai -z --json
+git cai -z --json --since 2026-01-01 | jq '.per_provider'
+git cai --stats --reset-stats
+----
+
 LIST TYPES
 ----------
 The argument to `--list` must be one of the following:
@@ -776,7 +764,7 @@ Available configuration keys:
   model, token counts, real LLM latency, and a snapshot of the active
   settings (language, style, emoji, temperature, prompt file). No diff
   content, commit messages, or file paths are stored. View the rollup
-  with `git cai --stats` (`-Q`).
+  with `git cai -z` (`--stats`).
 
 FILES
 -----

{git_cai_cli-0.13.3 → git_cai_cli-0.13.5}/docs/man/git-cai.1

@@ -2,12 +2,12 @@
 .\"     Title: git-cai
 .\"    Author: Thorsten Foltz
 .\" Generator: Asciidoctor 2.0.26
-.\"      Date: 2026-05-09
+.\"      Date: 2026-05-12
 .\"    Manual: \ \&
 .\"    Source: \ \&
 .\"  Language: English
 .\"
-.TH "GIT\-CAI" "1" "2026-05-09" "\ \&" "\ \&"
+.TH "GIT\-CAI" "1" "2026-05-12" "\ \&" "\ \&"
 .ie \n(.g .ds Aq \(aq
 .el       .ds Aq '
 .ss \n[.ss] 0
@@ -45,11 +45,11 @@ git-cai \- AI\-powered commit message generator
         [\-r | \-\-PR] [\-\-base BRANCH]
         [\-S KEY=VALUE | \-\-set KEY=VALUE]
         [\-s [N|HASH] | \-\-squash [N|HASH]]
-        [\-Q | \-\-stats] [\-\-since YYYY\-MM\-DD] [\-\-json] [\-\-reset\-stats]
         [\-q true|false | \-\-sql true|false]
         [\-T SECONDS | \-\-timeout SECONDS]
         [\-t | \-\-time] [\-u | \-\-update] [\-v | \-\-version]
         [\-x CONTEXT | \-\-context CONTEXT]
+        [\-z | \-\-stats] [\-\-since YYYY\-MM\-DD] [\-\-json] [\-\-reset\-stats]
 .fi
 .br
 .SH "DESCRIPTION"
@@ -534,97 +534,6 @@ git cai \-p
 .if n .RE
 .RE
 .sp
-\-Q, \-\-stats
-.RS 4
-Show local\-only usage analytics: commits and squashes generated, top
-provider, total token counts, average latency, and per\-provider rollups.
-Recording is opt\-in via the top\-level \f(CRstats\fP config key (a plain
-boolean, default \f(CRfalse\fP), so this view is empty until you turn writing
-on. No diff content, commit messages, or file paths are stored — only
-metadata.
-.sp
-Combine with \f(CR\-\-since YYYY\-MM\-DD\fP to scope the view to recent activity, or
-with \f(CR\-\-json\fP to emit machine\-readable output. Use \f(CR\-\-reset\-stats\fP to
-clear the local SQLite database.
-.sp
-The DB lives at \f(CR$XDG_DATA_HOME/git\-cai/stats.db\fP (default
-\f(CR~/.local/share/git\-cai/stats.db\fP). Override with the top\-level
-\f(CRstats_db_path\fP config key.
-.sp
-At the start of every run, git\-cai logs whether stats writing is
-enabled and (when enabled) the path of the SQLite database, so users
-always know where their analytics live.
-.sp
-If the running Python build was compiled without sqlite3, this command
-prints a clear message explaining how to fix it; commit generation
-continues to work normally in that case.
-.sp
-The \f(CRstats\fP (and \f(CRstats_db_path\fP) keys are the one configuration
-exception that does not follow the strict repo\-replaces\-home rule:
-when the repo \f(CRcai_config.yml\fP does not mention them, the values are
-taken from the home \f(CR~/.config/cai/cai_config.yml\fP. If neither file
-defines \f(CRstats\fP, the hardcoded default is \f(CRfalse\fP. Use \f(CRgit cai \-g\fP to
-write a fresh config that includes the setting so it is visible.
-.sp
-.if n .RS 4
-.nf
-.fam C
-git cai \-\-stats
-git cai \-Q \-\-since 2026\-01\-01
-git cai \-Q \-\-json
-git cai \-\-reset\-stats
-.fam
-.fi
-.if n .RE
-.RE
-.sp
-\-\-since YYYY\-MM\-DD
-.RS 4
-Restrict \f(CR\-\-stats\fP (\f(CR\-Q\fP) output to events recorded on or after this UTC
-date. Has no effect outside of \f(CR\-\-stats\fP. The date format is strict
-ISO\-8601 (e.g. \f(CR2026\-01\-15\fP).
-.sp
-.if n .RS 4
-.nf
-.fam C
-git cai \-Q \-\-since 2026\-01\-01
-.fam
-.fi
-.if n .RE
-.RE
-.sp
-\-\-json
-.RS 4
-Emit \f(CR\-\-stats\fP (\f(CR\-Q\fP) output as a JSON document instead of the text
-summary. Suitable for piping into \f(CRjq\fP or other tooling. Has no effect
-outside of \f(CR\-\-stats\fP.
-.sp
-.if n .RS 4
-.nf
-.fam C
-git cai \-Q \-\-json
-git cai \-Q \-\-json \-\-since 2026\-01\-01 | jq \*(Aq.per_provider\*(Aq
-.fam
-.fi
-.if n .RE
-.RE
-.sp
-\-\-reset\-stats
-.RS 4
-Delete every row from the local stats SQLite DB and exit. Prints the
-number of rows removed. The schema and DB file are preserved (so the
-next opt\-in run records into the same file). No\-op when the DB does
-not yet exist.
-.sp
-.if n .RS 4
-.nf
-.fam C
-git cai \-\-reset\-stats
-.fam
-.fi
-.if n .RE
-.RE
-.sp
 \-q, \-\-sql VALUE
 .RS 4
 Per\-invocation override for \f(CRstats.enabled\fP. VALUE is \f(CRtrue\fP or \f(CRfalse\fP
@@ -861,6 +770,73 @@ git cai \-r \-x "Closes JIRA\-1234"
 .fi
 .if n .RE
 .RE
+.sp
+\-z, \-\-stats
+.RS 4
+Show local\-only usage analytics: commits and squashes generated, top
+provider, total token counts, average latency, and per\-provider rollups.
+Recording is opt\-in via the top\-level \f(CRstats\fP config key (a plain
+boolean, default \f(CRfalse\fP), so this view is empty until you turn writing
+on. No diff content, commit messages, or file paths are stored — only
+metadata.
+.sp
+The DB lives at \f(CR$XDG_DATA_HOME/git\-cai/stats.db\fP (default
+\f(CR~/.local/share/git\-cai/stats.db\fP). Override with the top\-level
+\f(CRstats_db_path\fP config key.
+.sp
+At the start of every run, git\-cai logs whether stats writing is
+enabled and (when enabled) the path of the SQLite database, so users
+always know where their analytics live.
+.sp
+If the running Python build was compiled without sqlite3, this command
+prints a clear message explaining how to fix it; commit generation
+continues to work normally in that case.
+.sp
+The \f(CRstats\fP (and \f(CRstats_db_path\fP) keys are the one configuration
+exception that does not follow the strict repo\-replaces\-home rule:
+when the repo \f(CRcai_config.yml\fP does not mention them, the values are
+taken from the home \f(CR~/.config/cai/cai_config.yml\fP. If neither file
+defines \f(CRstats\fP, the hardcoded default is \f(CRfalse\fP. Use \f(CRgit cai \-g\fP to
+write a fresh config that includes the setting so it is visible.
+.sp
+Cannot be combined with \f(CR\-\-amend\fP, \f(CR\-\-list\fP, \f(CR\-\-PR\fP, \f(CR\-\-squash\fP, or
+\f(CR\-\-update\fP.
+.sp
+Modifiers for \f(CR\-\-stats\fP:
+.sp
+\f(CR\-\-since YYYY\-MM\-DD\fP
+.RS 4
+Restrict output to events recorded on or after this UTC date. The date
+format is strict ISO\-8601 (e.g. \f(CR2026\-01\-15\fP).
+.RE
+.sp
+\f(CR\-\-json\fP
+.RS 4
+Emit output as a JSON document instead of the text summary. Suitable
+for piping into \f(CRjq\fP or other tooling.
+.RE
+.sp
+\f(CR\-\-reset\-stats\fP
+.RS 4
+Delete every row from the local stats SQLite DB and exit. Prints the
+number of rows removed. The schema and DB file are preserved (so the
+next opt\-in run records into the same file). No\-op when the DB does
+not yet exist.
+.sp
+.if n .RS 4
+.nf
+.fam C
+git cai \-z
+git cai \-\-stats
+git cai \-z \-\-since 2026\-01\-01
+git cai \-z \-\-json
+git cai \-z \-\-json \-\-since 2026\-01\-01 | jq \*(Aq.per_provider\*(Aq
+git cai \-\-stats \-\-reset\-stats
+.fam
+.fi
+.if n .RE
+.RE
+.RE
 .SH "LIST TYPES"
 .sp
 The argument to \f(CR\-\-list\fP must be one of the following:
@@ -1397,7 +1373,7 @@ default \f(CRfalse\fP). When enabled, every generation appends one row to
 model, token counts, real LLM latency, and a snapshot of the active
 settings (language, style, emoji, temperature, prompt file). No diff
 content, commit messages, or file paths are stored. View the rollup
-with \f(CRgit cai \-\-stats\fP (\f(CR\-Q\fP).
+with \f(CRgit cai \-z\fP (\f(CR\-\-stats\fP).
 .RE
 .SH "FILES"
 .sp

{git_cai_cli-0.13.3 → git_cai_cli-0.13.5}/src/git_cai_cli/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.13.3'
-__version_tuple__ = version_tuple = (0, 13, 3)
+__version__ = version = '0.13.5'
+__version_tuple__ = version_tuple = (0, 13, 5)
 
-__commit_id__ = commit_id = 'gfc5853e7e'
+__commit_id__ = commit_id = 'g310dca5e3'

{git_cai_cli-0.13.3 → git_cai_cli-0.13.5}/src/git_cai_cli/cli/cli.py

@@ -144,7 +144,7 @@ def callback(  # pylint: disable=too-many-arguments,too-many-positional-argument
     stats: bool = typer.Option(
         False,
         "--stats",
-        "-Q",
+        "-z",
         help="Show local-only usage analytics (commits per provider, token totals, latency).",
     ),
     stats_since: str = typer.Option(

{git_cai_cli-0.13.3 → git_cai_cli-0.13.5}/src/git_cai_cli/cli/helptext.py

@@ -27,14 +27,11 @@ Flags:
   -H, --set-home KEY=VALUE Set a config value in home config (~/.config/cai/)
   -h, --help               Show this help message or opens manual
   -i, --install-completion Install shell completion for git-cai
-  -l, --list               List information (e.g. languages, styles, providers, config)
+  -l, --list [TYPE]        List information. TYPE: config, editor, language,
+                           model, path, provider, style
   -m, --model NAME         Override model for this invocation (requires --provider)
   -P, --provider NAME      Override LLM provider for this invocation
   -p, --generate-prompts   Generate default commit/squash/full_files/pr prompt files
-  -Q, --stats              Show local-only usage analytics (commits, tokens, latency)
-      --since YYYY-MM-DD   Filter --stats to events on or after this date
-      --json               Render --stats output as JSON instead of text
-      --reset-stats        Delete all rows from the local stats DB
   -q, --sql true|false     Override stats writing for this run (wins over config)
   -r, --PR                 Generate a Pull Request description from the commits on this branch
       --base BRANCH        Base branch for --PR (overrides auto-detection)
@@ -48,6 +45,10 @@ Flags:
   -u, --update             Check for updates
   -v, --version            Show installed version
   -x, --context TEXT       Provide extra context for the LLM (e.g. ticket number, reason)
+  -z, --stats              Show local-only usage analytics (commits, tokens, latency)
+      --since YYYY-MM-DD   Filter --stats to events on or after this date
+      --json               Render --stats output as JSON instead of text
+      --reset-stats        Delete all rows from the local stats DB
 
 Configuration:
   Tokens are loaded from {HOME}/.config/cai/tokens.yml

{git_cai_cli-0.13.3 → git_cai_cli-0.13.5}/src/git_cai_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: git-cai-cli
-Version: 0.13.3
+Version: 0.13.5
 Summary: Use LLM to create git commit messages
 Author-email: Thorsten Foltz <thorsten.foltz@live.com>
 License-Expression: MIT
@@ -260,15 +260,15 @@ In addition to `git cai`, the following options are available:
 - `-H`, `--set-home` – set a config value in home config (`key=value`), always targets `~/.config/cai/`
 - `-h`, `--help` – show help and available commands
 - `-i`, `--install-completion` – install shell completion for bash, zsh, or fish
-- `-l`, `--list` – list available information (`config`, `editor`, `language`, `model`, `path`, `provider`, `style`)
+- `-l`, `--list` – list available information. Valid types: `config`, `editor`, `language`, `model`, `path`, `provider`, `style`
 - `-m`, `--model` – override the model for this invocation (requires `-P`)
 - `-P`, `--provider` – override the LLM provider for this invocation
 - `-p`, `--generate-prompts` – generate default `commit_prompt.md` and `squash_prompt.md` in the current directory (for customization)
-- `-Q`, `--stats` – show local-only usage analytics (commits/squashes/PRs per provider, tokens, average latency)
-- `--since YYYY-MM-DD` – filter `--stats` to events on or after this date
-- `--json` – render `--stats` output as JSON
-- `--reset-stats` – delete all rows from the local stats DB
 - `-q`, `--sql true|false` – override stats writing for this run (wins over the persisted `stats` config)
+- `-z`, `--stats` – show local-only usage analytics (commits/squashes/PRs per provider, tokens, average latency)
+  - `--since YYYY-MM-DD` – filter `--stats` to events on or after this date
+  - `--json` – render `--stats` output as JSON
+  - `--reset-stats` – delete all rows from the local stats DB
 - `-r`, `--PR` – generate a Pull Request description from the commits between the current branch and its base (prints to stdout by default; set `pr_to_file=true` to write a Markdown file)
 - `--base` `BRANCH` – explicit base branch for `--PR` (overrides auto-detection: `origin/HEAD` → `main` → `master`)
 - `-S`, `--set` – set a config value (`key=value`) in repo config (requires existing repo config)
@@ -375,10 +375,10 @@ git cai -H stats=true            # or in the home config
 git cai -q true                  # one-off opt-in regardless of config
 git cai -q false                 # one-off opt-out
 
-git cai --stats                  # text summary
-git cai -Q --json                # machine-readable
-git cai -Q --since 2026-01-01    # date filter
-git cai --reset-stats            # wipe all rows
+git cai -z                       # text summary
+git cai -z --json                # machine-readable
+git cai --stats --since 2026-01-01  # date filter
+git cai --stats --reset-stats    # wipe all rows
 ```
 
 Rows are split by `kind` (`commit`, `amend`, `squash`, `pr`) and capture provider, model, repo name, token counts, real LLM latency, and a snapshot of the active settings (language, style, emoji, temperature, prompt file).