git-cai-cli 0.14.0__tar.gz → 0.14.2__tar.gz

{git_cai_cli-0.14.0 → git_cai_cli-0.14.2}/.linters/.proselintrc

@@ -48,7 +48,7 @@
         , "misc.whence": true
         , "mixed_metaphors.misc": true
         , "mondegreens.misc": true
-        , "needless_variants.misc": true
+        , "needless_variants.misc": false
         , "nonwords.misc": true
         , "oxymorons.misc": true
         , "psychology.misc": true

{git_cai_cli-0.14.0 → git_cai_cli-0.14.2}/.linters/.pylintrc

@@ -69,7 +69,7 @@ check-protected-access-in-special-methods=no
 max-args=25                                # Max arguments per function
 max-attributes=12                          # Max attributes per class
 max-branches=30                            # Max branches per function
-max-locals=65                              # Max locals per function
+max-locals=70                              # Max locals per function
 max-returns=10                             # Max return statements per function
 max-statements=120                         # Max total statements per function
 max-public-methods=20                      # Max public methods per class

{git_cai_cli-0.14.0 → git_cai_cli-0.14.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: git-cai-cli
-Version: 0.14.0
+Version: 0.14.2
 Summary: Use LLM to create git commit messages
 Author-email: Thorsten Foltz <thorsten.foltz@live.com>
 License-Expression: MIT
@@ -90,6 +90,8 @@ Currently supported providers:
 - Token usage logging for API calls
 - Branch name as LLM context
 - Extra context for the LLM
+- Per-invocation overrides for temperature, style, language, and emoji
+- Optional large-diff guard (`max_diff_bytes`) that truncates oversized diffs before sending
 - Generation time measurement
 - Local-only usage analytics (per-provider commits, tokens, latency) with opt-in SQLite storage
 - Shell completion for bash, zsh, and fish
@@ -247,6 +249,7 @@ git cai -g
 - `squash_prompt_file` - path to the file where the prompt for the squash is stored
 - `full_files_prompt_file` - path to the prompt used when `-F` / `--full-files` attaches full file contents
 - `full_files` – attach always the full working-tree contents of affected files alongside the diff
+- `max_diff_bytes` – maximum size (in UTF-8 bytes) of the diff/commit-log sent to the LLM; oversized input is truncated with a marker. `0` (default) means no limit
 - `timeout` – HTTP timeout for LLM calls in seconds
 - `branch_context` – include current branch name as LLM context
 - `conventional` – use Conventional Commits format
@@ -271,6 +274,7 @@ In addition to `git cai`, the following options are available:
 - `-C`, `--conventional` – use Conventional Commits format (`type(scope): description`)
 - `-c`, `--crazy` – Trust the LLM and commit without checking
 - `-d`, `--debug` – enable debug logging
+- `-E`, `--temperature` `TEMPERATURE` – override the active provider's sampling temperature for this invocation (provider scoped, like `-m`)
 - `-F`, `--full-files` – attach the full contents of affected files alongside the diff (uses `full_files_prompt.md`)
 - `-f`, `--files` `PATH` – limit the diff (and full-file content, if enabled) to PATH; repeat for multiple files
 - `-g`, `--generate-config` – generate the default `cai_config.yml` in the current directory
@@ -293,6 +297,9 @@ In addition to `git cai`, the following options are available:
 - `--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)
 - `-s`, `--squash` `[N|HASH]` – squash commits on the current branch and summarize them. Without argument: squash all since branch checkout. With a number: squash the last N commits. With a commit hash: squash up to and including that commit
+- `-y`, `--style` `STYLE` – override the commit message style for this invocation (e.g. `funny`, `neutral`, `none`); validated against the supported styles
+- `-L`, `--language` `CODE` – override the commit message language for this invocation (e.g. `de`, `fr`, `none`); validated against supported codes
+- `-e`, `--emoji` / `--no-emoji` – override emoji usage for this invocation (use `--no-emoji` to disable when config enables it)
 - `-T`, `--timeout` `SECONDS` – HTTP timeout for this invocation (overrides config)
 - `-t`, `--time` – measure and log commit message generation time
 - `-u`, `--update` – check for updates

{git_cai_cli-0.14.0 → git_cai_cli-0.14.2}/README.md

@@ -60,6 +60,8 @@ Currently supported providers:
 - Token usage logging for API calls
 - Branch name as LLM context
 - Extra context for the LLM
+- Per-invocation overrides for temperature, style, language, and emoji
+- Optional large-diff guard (`max_diff_bytes`) that truncates oversized diffs before sending
 - Generation time measurement
 - Local-only usage analytics (per-provider commits, tokens, latency) with opt-in SQLite storage
 - Shell completion for bash, zsh, and fish
@@ -217,6 +219,7 @@ git cai -g
 - `squash_prompt_file` - path to the file where the prompt for the squash is stored
 - `full_files_prompt_file` - path to the prompt used when `-F` / `--full-files` attaches full file contents
 - `full_files` – attach always the full working-tree contents of affected files alongside the diff
+- `max_diff_bytes` – maximum size (in UTF-8 bytes) of the diff/commit-log sent to the LLM; oversized input is truncated with a marker. `0` (default) means no limit
 - `timeout` – HTTP timeout for LLM calls in seconds
 - `branch_context` – include current branch name as LLM context
 - `conventional` – use Conventional Commits format
@@ -241,6 +244,7 @@ In addition to `git cai`, the following options are available:
 - `-C`, `--conventional` – use Conventional Commits format (`type(scope): description`)
 - `-c`, `--crazy` – Trust the LLM and commit without checking
 - `-d`, `--debug` – enable debug logging
+- `-E`, `--temperature` `TEMPERATURE` – override the active provider's sampling temperature for this invocation (provider scoped, like `-m`)
 - `-F`, `--full-files` – attach the full contents of affected files alongside the diff (uses `full_files_prompt.md`)
 - `-f`, `--files` `PATH` – limit the diff (and full-file content, if enabled) to PATH; repeat for multiple files
 - `-g`, `--generate-config` – generate the default `cai_config.yml` in the current directory
@@ -263,6 +267,9 @@ In addition to `git cai`, the following options are available:
 - `--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)
 - `-s`, `--squash` `[N|HASH]` – squash commits on the current branch and summarize them. Without argument: squash all since branch checkout. With a number: squash the last N commits. With a commit hash: squash up to and including that commit
+- `-y`, `--style` `STYLE` – override the commit message style for this invocation (e.g. `funny`, `neutral`, `none`); validated against the supported styles
+- `-L`, `--language` `CODE` – override the commit message language for this invocation (e.g. `de`, `fr`, `none`); validated against supported codes
+- `-e`, `--emoji` / `--no-emoji` – override emoji usage for this invocation (use `--no-emoji` to disable when config enables it)
 - `-T`, `--timeout` `SECONDS` – HTTP timeout for this invocation (overrides config)
 - `-t`, `--time` – measure and log commit message generation time
 - `-u`, `--update` – check for updates

{git_cai_cli-0.14.0 → git_cai_cli-0.14.2}/docs/git-cai.txt

@@ -12,6 +12,7 @@ SYNOPSIS
 [verse]
 `git cai` [-A | --amend] [-a | --all] [-C | --conventional]
         [-b | --branch] [-c | --crazy] [-d | --debug]
+        [-e TEMPERATURE | --temperature TEMPERATURE]
         [-F | --full-files | --no-full-files] [-f PATH | --files PATH]
         [-g | --generate-config]
         [-H KEY=VALUE | --set-home KEY=VALUE] [-h | --help]
@@ -27,6 +28,7 @@ SYNOPSIS
         [-S KEY=VALUE | --set KEY=VALUE]
         [-s [N|HASH] | --squash [N|HASH]]
         [-q true|false | --sql true|false]
+        [--style STYLE] [--language CODE] [--emoji | --no-emoji]
         [-T SECONDS | --timeout SECONDS]
         [-t | --time] [-u | --update] [-v | --version]
         [-x CONTEXT | --context CONTEXT]
@@ -181,6 +183,17 @@ Cannot be combined with `--help` or `--version`.
 git cai -d
 ----
 
+-e, --temperature TEMPERATURE::
+Override the sampling temperature of the active provider for this invocation
+only. Higher values produce more varied wording; lower values are more
+deterministic. The override is provider-scoped, mirroring `--model`, and does
+not change the persisted `cai_config.yml`.
++
+----
+git cai -e 0.7
+git cai -P anthropic -e 0.2
+----
+
 -F, --full-files::
 Send the full working-tree contents of every staged file alongside the diff.
 By default, git-cai sends only the staged diff to the LLM. With `-F`, the
@@ -488,6 +501,42 @@ git cai -s 3
 git cai -s a1b2c3d
 ----
 
+--style STYLE::
+Override the commit message tone style for this invocation only (e.g.
+`professional`, `neutral`, `friendly`, `funny`, `excited`, `sarcastic`,
+`apologetic`, `academic`, or `none` to let the model choose). Run
+`git cai -l style` to see all styles with examples. An invalid value is
+rejected with an error. To change the style permanently, set `style:` in
+`cai_config.yml`.
++
+----
+git cai --style funny
+git cai --style none
+----
+
+--language CODE::
+Override the commit message language for this invocation only, using a
+supported language code (e.g. `de`, `fr`, `es`), or `none` to omit the
+language instruction. Run `git cai -l language` to list supported codes. An
+unsupported code is rejected with an error. To change it permanently, set
+`language:` in `cai_config.yml`.
++
+----
+git cai --language de
+git cai --language none
+----
+
+--emoji / --no-emoji::
+Override emoji usage for this invocation only. `--emoji` instructs the model
+to use relevant emojis; `--no-emoji` disables them even when the persisted
+config enables emoji. To change the default permanently, set `emoji:` in
+`cai_config.yml`.
++
+----
+git cai --no-emoji
+git cai --emoji
+----
+
 -T, --timeout SECONDS::
 Override the HTTP timeout for the LLM call in this invocation. The default
 is 30 seconds for remote providers and 300 seconds for Ollama (since local
@@ -824,6 +873,10 @@ Available configuration keys:
 - `timeout` -- HTTP timeout in seconds for remote LLM calls (default `30`)
 - `full_files` -- send full working-tree contents of staged files alongside
   the diff (`true`/`false`, default `false`)
+- `max_diff_bytes` -- maximum size (in UTF-8 bytes) of the diff/commit-log
+  sent to the LLM. When the input exceeds this, it is truncated and a marker
+  line is appended so the model knows it was cut. `0` (the default) means no
+  limit. Useful to avoid context-window errors on very large staged changes.
 - `pr_to_file` -- when running `--PR`, write the generated PR description
   to a Markdown file in the repository root instead of printing it to
   stdout (`true`/`false`, default `false`)

{git_cai_cli-0.14.0 → git_cai_cli-0.14.2}/docs/man/git-cai.1

@@ -2,12 +2,12 @@
 .\"     Title: git-cai
 .\"    Author: Thorsten Foltz
 .\" Generator: Asciidoctor 2.0.26
-.\"      Date: 2026-05-25
+.\"      Date: 2026-06-14
 .\"    Manual: \ \&
 .\"    Source: \ \&
 .\"  Language: English
 .\"
-.TH "GIT\-CAI" "1" "2026-05-25" "\ \&" "\ \&"
+.TH "GIT\-CAI" "1" "2026-06-14" "\ \&" "\ \&"
 .ie \n(.g .ds Aq \(aq
 .el       .ds Aq '
 .ss \n[.ss] 0
@@ -34,6 +34,7 @@ git-cai \- AI\-powered commit message generator
 .nf
 \f(CRgit cai\fP [\-A | \-\-amend] [\-a | \-\-all] [\-C | \-\-conventional]
         [\-b | \-\-branch] [\-c | \-\-crazy] [\-d | \-\-debug]
+        [\-e TEMPERATURE | \-\-temperature TEMPERATURE]
         [\-F | \-\-full\-files | \-\-no\-full\-files] [\-f PATH | \-\-files PATH]
         [\-g | \-\-generate\-config]
         [\-H KEY=VALUE | \-\-set\-home KEY=VALUE] [\-h | \-\-help]
@@ -49,6 +50,7 @@ git-cai \- AI\-powered commit message generator
         [\-S KEY=VALUE | \-\-set KEY=VALUE]
         [\-s [N|HASH] | \-\-squash [N|HASH]]
         [\-q true|false | \-\-sql true|false]
+        [\-\-style STYLE] [\-\-language CODE] [\-\-emoji | \-\-no\-emoji]
         [\-T SECONDS | \-\-timeout SECONDS]
         [\-t | \-\-time] [\-u | \-\-update] [\-v | \-\-version]
         [\-x CONTEXT | \-\-context CONTEXT]
@@ -350,6 +352,23 @@ git cai \-d
 .if n .RE
 .RE
 .sp
+\-e, \-\-temperature TEMPERATURE
+.RS 4
+Override the sampling temperature of the active provider for this invocation
+only. Higher values produce more varied wording; lower values are more
+deterministic. The override is provider\-scoped, mirroring \f(CR\-\-model\fP, and does
+not change the persisted \f(CRcai_config.yml\fP.
+.sp
+.if n .RS 4
+.nf
+.fam C
+git cai \-e 0.7
+git cai \-P anthropic \-e 0.2
+.fam
+.fi
+.if n .RE
+.RE
+.sp
 \-F, \-\-full\-files
 .RS 4
 Send the full working\-tree contents of every staged file alongside the diff.
@@ -773,6 +792,60 @@ git cai \-s a1b2c3d
 .if n .RE
 .RE
 .sp
+\-\-style STYLE
+.RS 4
+Override the commit message tone style for this invocation only (e.g.
+\f(CRprofessional\fP, \f(CRneutral\fP, \f(CRfriendly\fP, \f(CRfunny\fP, \f(CRexcited\fP, \f(CRsarcastic\fP,
+\f(CRapologetic\fP, \f(CRacademic\fP, or \f(CRnone\fP to let the model choose). Run
+\f(CRgit cai \-l style\fP to see all styles with examples. An invalid value is
+rejected with an error. To change the style permanently, set \f(CRstyle:\fP in
+\f(CRcai_config.yml\fP.
+.sp
+.if n .RS 4
+.nf
+.fam C
+git cai \-\-style funny
+git cai \-\-style none
+.fam
+.fi
+.if n .RE
+.RE
+.sp
+\-\-language CODE
+.RS 4
+Override the commit message language for this invocation only, using a
+supported language code (e.g. \f(CRde\fP, \f(CRfr\fP, \f(CRes\fP), or \f(CRnone\fP to omit the
+language instruction. Run \f(CRgit cai \-l language\fP to list supported codes. An
+unsupported code is rejected with an error. To change it permanently, set
+\f(CRlanguage:\fP in \f(CRcai_config.yml\fP.
+.sp
+.if n .RS 4
+.nf
+.fam C
+git cai \-\-language de
+git cai \-\-language none
+.fam
+.fi
+.if n .RE
+.RE
+.sp
+\-\-emoji / \-\-no\-emoji
+.RS 4
+Override emoji usage for this invocation only. \f(CR\-\-emoji\fP instructs the model
+to use relevant emojis; \f(CR\-\-no\-emoji\fP disables them even when the persisted
+config enables emoji. To change the default permanently, set \f(CRemoji:\fP in
+\f(CRcai_config.yml\fP.
+.sp
+.if n .RS 4
+.nf
+.fam C
+git cai \-\-no\-emoji
+git cai \-\-emoji
+.fam
+.fi
+.if n .RE
+.RE
+.sp
 \-T, \-\-timeout SECONDS
 .RS 4
 Override the HTTP timeout for the LLM call in this invocation. The default
@@ -1394,6 +1467,20 @@ the diff (\f(CRtrue\fP/\f(CRfalse\fP, default \f(CRfalse\fP)
 .  sp -1
 .  IP \(bu 2.3
 .\}
+\f(CRmax_diff_bytes\fP \(em maximum size (in UTF\-8 bytes) of the diff/commit\-log
+sent to the LLM. When the input exceeds this, it is truncated and a marker
+line is appended so the model knows it was cut. \f(CR0\fP (the default) means no
+limit. Useful to avoid context\-window errors on very large staged changes.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.  sp -1
+.  IP \(bu 2.3
+.\}
 \f(CRpr_to_file\fP \(em when running \f(CR\-\-PR\fP, write the generated PR description
 to a Markdown file in the repository root instead of printing it to
 stdout (\f(CRtrue\fP/\f(CRfalse\fP, default \f(CRfalse\fP)

git_cai_cli-0.14.2/docs/superpowers/specs/2026-06-14-custom-styles-design.md

@@ -0,0 +1,203 @@
+# Custom styles + richer built-in style guidance — Design
+
+**Date:** 2026-06-14
+**Branch:** `fix/style-option`
+**Status:** Approved
+
+## Goal
+
+Extend the commit-message `style` option in two ways:
+
+- **A — User-defined custom styles:** let users define their own styles in
+  `cai_config.yml` via a `custom_styles` map, so individuals and teams can add
+  tones beyond the shipped set without code changes.
+- **C — Richer built-in style guidance:** replace the single generic style
+  instruction with a per-style prompt fragment, so each style (built-in or
+  custom) contributes real tone guidance to the prompt.
+- **E — Single registry (cleanup):** consolidate the built-in style data, which
+  today is split between the allowlist in `validate.py` and the
+  descriptions/examples in `options.py::styles()`, into one source of truth.
+- **F — Override flag ergonomics:** give the invocation-override options short
+  flags and make them visible in `git cai -h`. Today `--style`, `--language`,
+  `--emoji`, and `--temperature` are long-only **and** absent from the
+  hand-maintained help text (`cli/helptext.py`).
+
+## Background (current behaviour)
+
+- `_validate_style()` (`core/validate.py`) checks a hardcoded allowlist:
+  `professional, neutral, friendly, funny, excited, sarcastic, apologetic,
+  academic`, plus `none` (disables the style instruction).
+- `_style_instruction()` (`core/llm.py`) emits one generic line for every
+  style: *"Write the commit message in the following tone style: {style}.
+  Apply this tone to both the headline and the bullet points."*
+- `options.py::styles()` holds per-style `description` and `example` used by
+  `git cai -l style`, hand-synced with the allowlist.
+
+## Decisions
+
+1. **Custom style entry shape (Option 3 — hybrid):** `instruction` is required;
+   `description` and `example` are optional.
+2. **Built-in names are protected (Option 2):** a `custom_styles` key that
+   collides with a built-in name or with `none` is a config validation error.
+3. **Prompt assembly (Option 3):** the style's `instruction` leads, followed by
+   a fixed suffix: `"{instruction} Apply this tone to both the headline and the
+   bullet points."`
+4. **Listing (Option 1 — merged + marker):** `git cai -l style` shows built-in
+   and custom styles in one list; custom entries are tagged `name (custom)`.
+5. **Override short flags (F):** the invocation-override options get short flags
+   and are added to the help text — `-y/--style`, `-e/--emoji`, `-L/--language`,
+   `-E/--temperature`. `--temperature` previously used `-e`; it moves to `-E` so
+   `--emoji` can take the mnemonic `-e`. `-L` and `-E` each differ from an
+   existing flag (`-l/--list`, `-e`) only by case, which Typer/Click handle.
+
+## Components
+
+### 1. `core/styles.py` (new — single registry)
+
+Dependency-free module (same rationale as `prompts_fallback.py`: importable by
+`config`, `validate`, `llm`, `options` without creating import cycles). Single
+source of truth for built-in styles, each carrying all three fields:
+
+```python
+BUILTIN_STYLES: dict[str, dict[str, str]] = {
+    "professional": {
+        "instruction": "Write in a clear, concise, and formal tone.",
+        "description": "Clear, concise, and formal. Default style.",
+        "example": "...",
+    },
+    # neutral, friendly, funny, excited, sarcastic, apologetic, academic
+}
+
+RESERVED_STYLE_NAMES = set(BUILTIN_STYLES) | {"none"}
+```
+
+Replaces the allowlist in `validate.py` and the inline descriptions/examples in
+`options.py::styles()`.
+
+### 2. Config — `custom_styles` key
+
+- New top-level key in `DEFAULT_CONFIG`, default `{}`; documented in
+  `cai_config.yml`.
+- Repo config remains authoritative (per `CLAUDE.md`), so a repo can ship a
+  house style set.
+- Entry shape: `instruction` required; `description`, `example` optional.
+
+Example:
+
+```yaml
+custom_styles:
+  sardonic:
+    instruction: "Use dry, ironic understatement; keep the subject imperative."
+    description: "Dry, ironic tone."   # optional
+    example: "Heroically fixed the bug we wrote yesterday."  # optional
+```
+
+### 3. Validation (`core/validate.py`)
+
+- **`_validate_custom_styles(custom_styles)`** (new): for each entry —
+  - key is a non-empty string and **not** in `RESERVED_STYLE_NAMES`
+    (collision → `ValueError`);
+  - value has a non-empty `instruction`;
+  - `description` / `example`, if present, are strings.
+  Called during config load; fails fast with a message naming the offending key
+  and the problem.
+- **`_validate_style(style, custom_names)`**: signature gains the set of
+  configured custom style names. Accepts built-ins, `none`, or any custom name;
+  otherwise raises with the merged allowed list. Call sites in `config.py`
+  (default load and `--style` override) already have `custom_styles` available
+  and pass the names through.
+
+### 4. Prompt assembly (`core/llm.py::_style_instruction`)
+
+Look up the active style in `BUILTIN_STYLES` merged with config `custom_styles`,
+then:
+
+```python
+return f"{entry['instruction']} Apply this tone to both the headline and the bullet points."
+```
+
+`none` / `None` → `""` (unchanged). The old generic hardcoded line is removed;
+every style now contributes its own flavor plus the fixed suffix.
+
+### 5. Listing (`core/options.py::styles`)
+
+Build the returned dict from `BUILTIN_STYLES` + config `custom_styles`. Custom
+entries are tagged `name (custom)`. When `description` is absent, fall back to
+the `instruction` text; when `example` is absent, omit the example line.
+
+### 6. CLI short flags + help visibility (`cli/cli.py`, `cli/helptext.py`)
+
+- Update the override `typer.Option` definitions in `cli.py`:
+  - `--style` → add `"-y"`
+  - `--emoji` → add `"-e"`
+  - `--language` → add `"-L"`
+  - `--temperature` → change its existing `"-e"` to `"-E"` (freeing `-e` for
+    emoji)
+- Add the four flags to the hand-maintained `HELP_TEXT` in `helptext.py`, in
+  the alphabetical position used by the existing list, e.g.:
+
+  ```text
+  -E, --temperature FLOAT  Override the active provider's sampling temperature for this invocation
+  -e, --emoji              Toggle emoji prefixes (use --no-emoji to disable)
+  -L, --language CODE      Override the commit message language (e.g. de, fr, none)
+  -y, --style NAME         Override the commit message style (e.g. funny, neutral, none)
+  ```
+
+  The `-l, --list` line already documents `style` as a list type and stays as
+  is.
+
+## Data flow
+
+```text
+cai_config.yml (custom_styles)
+        │
+        ▼
+config load ──► _validate_custom_styles()         (structure + collisions)
+        │
+        ├──► _validate_style(style, custom_names)  (default + --style override)
+        │
+        ▼
+config["style"], config["custom_styles"]
+        │
+        ├──► llm._style_instruction()  → "{instruction} <suffix>"  (BUILTIN_STYLES ∪ custom)
+        │
+        └──► options.styles()          → merged list with (custom) markers
+```
+
+## Error handling
+
+An invalid `custom_styles` block fails fast at config load with a clear message
+(which key, what is wrong), consistent with how `_validate_style` already
+reports invalid styles. An unknown `--style` value raises with the merged
+allowed list (built-ins + `none` + configured custom names).
+
+## Testing
+
+All mocked — no real API/HTTP calls (CI has no creds; tokens cost money):
+
+- `_validate_custom_styles`: happy path; missing/empty `instruction`;
+  collision with a built-in name; collision with `none`; non-string optional
+  fields.
+- `_validate_style`: accepts a configured custom name; rejects an unknown name
+  with the merged allowed list in the message.
+- `_style_instruction`: builds `"{instruction} <suffix>"` for a built-in, for a
+  custom style, and returns `""` for `none` / `None`.
+- `options.styles()`: merges built-ins + custom; applies `(custom)` marker;
+  falls back `description → instruction`; omits `example` when absent.
+- CLI short flags: invoking with `-y`, `-e`, `-L`, `-E` is parsed equivalently
+  to the long form (via Typer's `CliRunner`, no network), and `git cai -h`
+  output contains all four override flags.
+
+## Documentation
+
+Update **`docs/git-cai.txt` only** (per standing preference — do not touch
+`docs/man/git-cai.1`, `README.md`, or `CLAUDE.md` unless asked): document the
+`custom_styles` key and entry shape, and the new `-y/-e/-L/-E` override short
+flags.
+
+## Out of scope (YAGNI)
+
+- Overriding/retuning built-in styles via config (built-ins are protected).
+- Free-form passthrough of arbitrary style strings (rejected in favor of an
+  explicit custom registry).
+- `random`/surprise style selection.

{git_cai_cli-0.14.0 → git_cai_cli-0.14.2}/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.14.0'
-__version_tuple__ = version_tuple = (0, 14, 0)
+__version__ = version = '0.14.2'
+__version_tuple__ = version_tuple = (0, 14, 2)
 
-__commit_id__ = commit_id = 'ge467c3583'
+__commit_id__ = commit_id = 'gf575cff14'

{git_cai_cli-0.14.0 → git_cai_cli-0.14.2}/src/git_cai_cli/cli/cli.py

@@ -179,6 +179,30 @@ def callback(  # pylint: disable=too-many-arguments,too-many-positional-argument
         "--print",
         help="Generate the commit message, print it to stdout, and exit without committing.",
     ),
+    temperature: float = typer.Option(
+        None,
+        "-E",
+        "--temperature",
+        help="Override the active provider's sampling temperature for this invocation.",
+    ),
+    style: str = typer.Option(
+        None,
+        "-y",
+        "--style",
+        help="Override the commit message style for this invocation (e.g. funny, neutral, none).",
+    ),
+    language: str = typer.Option(
+        None,
+        "-L",
+        "--language",
+        help="Override the commit message language code for this invocation (e.g. de, fr, none).",
+    ),
+    emoji: bool | None = typer.Option(
+        None,
+        "-e",
+        "--emoji/--no-emoji",
+        help="Override emoji usage for this invocation. Use --no-emoji to disable when config enables it.",
+    ),
 ):
     """
     CLI entry point for git-cai-cli.
@@ -311,6 +335,10 @@ def callback(  # pylint: disable=too-many-arguments,too-many-positional-argument
         stats_reset=stats_reset,
         signoff=signoff,
         print_only=print_only,
+        temperature_override=temperature,
+        style_override=style,
+        language_override=language,
+        emoji_override=emoji,
     )
 
 

{git_cai_cli-0.14.0 → git_cai_cli-0.14.2}/src/git_cai_cli/cli/helptext.py

@@ -21,6 +21,8 @@ Flags:
   -C, --conventional       Use Conventional Commits format (type(scope): description)
   -c, --crazy              Commit immediately without opening editor (trust LLM output)
   -d, --debug              Enable debug logging
+  -E, --temperature FLOAT  Override the active provider's sampling temperature for this invocation
+  -e, --emoji              Toggle emoji prefixes (use --no-emoji to disable)
   -F, --full-files         Send the full contents of affected files alongside the diff
   -f, --files PATH         Limit the diff (and full files) to PATH; repeat the flag for multiple files
   -g, --generate-config    Generate default cai_config.yml in the current directory
@@ -28,6 +30,7 @@ Flags:
   -h, --help               Show this help message or opens manual
   -I, --init               Interactive setup wizard (writes home config and tokens.yml)
   -i, --install-completion Install shell completion for git-cai
+  -L, --language CODE      Override the commit message language (e.g. de, fr, none)
   -l, --list [TYPE]        List information. TYPE: config, editor, language,
                            model, path, provider, style
   -m, --model NAME         Override model for this invocation (requires --provider)
@@ -48,6 +51,7 @@ 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)
+  -y, --style NAME         Override the commit message style (e.g. funny, neutral, none)
   -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