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

{git_cai_cli-0.13.5 → git_cai_cli-0.14.1}/.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.13.5 → git_cai_cli-0.14.1}/.linters/.pylintrc

@@ -66,18 +66,18 @@ check-protected-access-in-special-methods=no
                                            # Don’t warn about protected attr access in dunder methods
 
 [DESIGN]
-max-args=20                                # Max arguments per function
+max-args=25                                # Max arguments per function
 max-attributes=12                          # Max attributes per class
 max-branches=30                            # Max branches per function
-max-locals=60                              # Max locals per function
+max-locals=70                              # Max locals per function
 max-returns=10                             # Max return statements per function
-max-statements=100                         # Max total statements per function
+max-statements=120                         # Max total statements per function
 max-public-methods=20                      # Max public methods per class
 min-public-methods=1                       # Min public methods per class
 max-nested-blocks=15                       # Max nesting depth
 max-bool-expr=15                           # Max boolean subexpressions in a condition
 max-parents=7                              # Max base classes per class
-max-positional-arguments=20                # Max positional arguments per function
+max-positional-arguments=25                # Max positional arguments per function
 
 [EXCEPTIONS]
 overgeneral-exceptions=builtins.BaseException,builtins.Exception

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: git-cai-cli
-Version: 0.13.5
+Version: 0.14.1
 Summary: Use LLM to create git commit messages
 Author-email: Thorsten Foltz <thorsten.foltz@live.com>
 License-Expression: MIT
@@ -77,9 +77,12 @@ Currently supported providers:
 - Seamless integration with Git
 - Supports multiple LLM providers and models
 - Global configuration with per-repository overrides
+- Interactive `--init` wizard for first-time setup (provider, token, language, style)
 - Repository-specific language, style, and model selection
 - Amend the last commit message with a regenerated one
 - Conventional Commits format support
+- `Signed-off-by:` (DCO) trailer support via `--signoff`
+- `--print` mode that emits the generated message to stdout for scripting
 - Change configuration from the command line
 - Optional commit squashing with automatic summary generation (all, last N, or up to a specific commit)
 - Pull Request description generator (`--PR`) that summarizes the commits between the current branch and its base
@@ -87,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
@@ -144,6 +149,19 @@ The syntax is identical to `.gitignore`.
 
 ## Configuration
 
+The fastest way to get started is the interactive wizard:
+
+```sh
+git cai --init     # or: git cai -I
+```
+
+It asks for a default provider, language, style, and emoji preference,
+then collects the API key (input is hidden while you type). The wizard
+writes `~/.config/cai/cai_config.yml` and, for providers that need one,
+`~/.config/cai/tokens.yml` with mode `0600`. Existing entries for other
+providers in `tokens.yml` are preserved. `--init` only writes home-scope
+files — use `-g` / `--generate-config` to bootstrap a repo-level config.
+
 On first execution, cai automatically creates the base configuration in your home directory.
 
 - Global configuration:  
@@ -231,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
@@ -241,6 +260,7 @@ git cai -g
 - `pr_prompt_file` – optional path to a custom Markdown prompt for `--PR` (falls back to `~/.config/cai/pr_prompt.md`, then a built-in default)
 - `stats` – opt in to local-only usage analytics (per-run row in a SQLite DB at `~/.local/share/git-cai/stats.db`); default `false`.
 No diff content, commit messages, or file paths are stored — only metadata (provider, model, kind, repo name, token counts, latency, settings)
+- `signoff` – append a `Signed-off-by:` trailer (built from git `user.name` / `user.email`) to every commit message; default `false`
 
 ---
 
@@ -254,16 +274,20 @@ 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
 - `-H`, `--set-home` – set a config value in home config (`key=value`), always targets `~/.config/cai/`
 - `-h`, `--help` – show help and available commands
+- `-I`, `--init` – interactive setup wizard (writes home config and tokens.yml)
 - `-i`, `--install-completion` – install shell completion for bash, zsh, or fish
 - `-l`, `--list` – list available information. Valid types: `config`, `editor`, `language`, `model`, `path`, `provider`, `style`
 - `-m`, `--model` – override the model for this invocation (requires `-P`)
+- `-o`, `--signoff` / `--no-signoff` – append a `Signed-off-by:` trailer (uses git `user.name` / `user.email`); applies to commit, amend, and squash modes
 - `-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)
+- `--print` – print the generated commit message to stdout and exit without committing (commit/amend modes only; mutually exclusive with `-c`)
 - `-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
@@ -273,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
+- `--style` `STYLE` – override the commit message style for this invocation (e.g. `funny`, `neutral`, `none`); validated against the supported styles
+- `--language` `CODE` – override the commit message language for this invocation (e.g. `de`, `fr`, `none`); validated against supported codes
+- `--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
@@ -383,6 +410,40 @@ 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).
 
+### DCO sign-off
+
+Projects that require Developer Certificate of Origin sign-off (Linux
+kernel, many CNCF projects) can have cai append the trailer
+automatically:
+
+```sh
+git cai --signoff                # one-off
+git cai -o -A                    # short flag, with amend
+git cai -S signoff=true          # enable persistently in the repo config
+```
+
+The trailer is built from your git `user.name` and `user.email`. When
+the message already ends in a trailer block (e.g. an existing
+`Co-authored-by:` or another `Signed-off-by:` line), the new sign-off
+is appended to that block without an extra blank line. Re-running with
+`--signoff` on a message that already carries the same trailer is a
+no-op.
+
+### Print-only output (no commit)
+
+`--print` generates the commit message and writes it to stdout instead
+of opening the editor or committing. Useful for scripting:
+
+```sh
+MSG=$(git cai --print)
+git cai --print --conventional --signoff
+```
+
+Diagnostic output (spinner, `--time`, `--debug`) goes to stderr, so the
+command substitution above captures only the message. Limited to commit
+and amend modes. Mutually exclusive with `-c` / `--crazy` (which
+commits immediately).
+
 ### Changing configuration from the CLI
 
 Instead of editing YAML files manually, use `--set` or `--set-home` to update config values.

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

@@ -47,9 +47,12 @@ Currently supported providers:
 - Seamless integration with Git
 - Supports multiple LLM providers and models
 - Global configuration with per-repository overrides
+- Interactive `--init` wizard for first-time setup (provider, token, language, style)
 - Repository-specific language, style, and model selection
 - Amend the last commit message with a regenerated one
 - Conventional Commits format support
+- `Signed-off-by:` (DCO) trailer support via `--signoff`
+- `--print` mode that emits the generated message to stdout for scripting
 - Change configuration from the command line
 - Optional commit squashing with automatic summary generation (all, last N, or up to a specific commit)
 - Pull Request description generator (`--PR`) that summarizes the commits between the current branch and its base
@@ -57,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
@@ -114,6 +119,19 @@ The syntax is identical to `.gitignore`.
 
 ## Configuration
 
+The fastest way to get started is the interactive wizard:
+
+```sh
+git cai --init     # or: git cai -I
+```
+
+It asks for a default provider, language, style, and emoji preference,
+then collects the API key (input is hidden while you type). The wizard
+writes `~/.config/cai/cai_config.yml` and, for providers that need one,
+`~/.config/cai/tokens.yml` with mode `0600`. Existing entries for other
+providers in `tokens.yml` are preserved. `--init` only writes home-scope
+files — use `-g` / `--generate-config` to bootstrap a repo-level config.
+
 On first execution, cai automatically creates the base configuration in your home directory.
 
 - Global configuration:  
@@ -201,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
@@ -211,6 +230,7 @@ git cai -g
 - `pr_prompt_file` – optional path to a custom Markdown prompt for `--PR` (falls back to `~/.config/cai/pr_prompt.md`, then a built-in default)
 - `stats` – opt in to local-only usage analytics (per-run row in a SQLite DB at `~/.local/share/git-cai/stats.db`); default `false`.
 No diff content, commit messages, or file paths are stored — only metadata (provider, model, kind, repo name, token counts, latency, settings)
+- `signoff` – append a `Signed-off-by:` trailer (built from git `user.name` / `user.email`) to every commit message; default `false`
 
 ---
 
@@ -224,16 +244,20 @@ 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
 - `-H`, `--set-home` – set a config value in home config (`key=value`), always targets `~/.config/cai/`
 - `-h`, `--help` – show help and available commands
+- `-I`, `--init` – interactive setup wizard (writes home config and tokens.yml)
 - `-i`, `--install-completion` – install shell completion for bash, zsh, or fish
 - `-l`, `--list` – list available information. Valid types: `config`, `editor`, `language`, `model`, `path`, `provider`, `style`
 - `-m`, `--model` – override the model for this invocation (requires `-P`)
+- `-o`, `--signoff` / `--no-signoff` – append a `Signed-off-by:` trailer (uses git `user.name` / `user.email`); applies to commit, amend, and squash modes
 - `-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)
+- `--print` – print the generated commit message to stdout and exit without committing (commit/amend modes only; mutually exclusive with `-c`)
 - `-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
@@ -243,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
+- `--style` `STYLE` – override the commit message style for this invocation (e.g. `funny`, `neutral`, `none`); validated against the supported styles
+- `--language` `CODE` – override the commit message language for this invocation (e.g. `de`, `fr`, `none`); validated against supported codes
+- `--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
@@ -353,6 +380,40 @@ 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).
 
+### DCO sign-off
+
+Projects that require Developer Certificate of Origin sign-off (Linux
+kernel, many CNCF projects) can have cai append the trailer
+automatically:
+
+```sh
+git cai --signoff                # one-off
+git cai -o -A                    # short flag, with amend
+git cai -S signoff=true          # enable persistently in the repo config
+```
+
+The trailer is built from your git `user.name` and `user.email`. When
+the message already ends in a trailer block (e.g. an existing
+`Co-authored-by:` or another `Signed-off-by:` line), the new sign-off
+is appended to that block without an extra blank line. Re-running with
+`--signoff` on a message that already carries the same trailer is a
+no-op.
+
+### Print-only output (no commit)
+
+`--print` generates the commit message and writes it to stdout instead
+of opening the editor or committing. Useful for scripting:
+
+```sh
+MSG=$(git cai --print)
+git cai --print --conventional --signoff
+```
+
+Diagnostic output (spinner, `--time`, `--debug`) goes to stderr, so the
+command substitution above captures only the message. Limited to commit
+and amend modes. Mutually exclusive with `-c` / `--crazy` (which
+commits immediately).
+
 ### Changing configuration from the CLI
 
 Instead of editing YAML files manually, use `--set` or `--set-home` to update config values.

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

@@ -12,18 +12,23 @@ 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]
+        [-I | --init]
         [-i | --install-completion]
         [-l [config|editor|language|model|path|provider|style] |
          --list [config|editor|language|model|path|provider|style]]
         [-m MODEL | --model MODEL]
+        [-o | --signoff | --no-signoff]
         [-P PROVIDER | --provider PROVIDER] [-p | --generate-prompts]
+        [--print]
         [-r | --PR] [--base BRANCH]
         [-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]
@@ -46,7 +51,16 @@ git-cai behaves like `git commit`, but with the commit message pre-filled:
 
 SETUP
 -----
-First run / configuration:
+Guided setup (recommended):
+
+- Run `git cai --init` (or `-I`). The interactive wizard asks for a
+  default provider, language, style, and emoji preference, then
+  collects the API key (hidden input). It writes
+  `~/.config/cai/cai_config.yml` and, for providers that need one,
+  `~/.config/cai/tokens.yml` with mode `0600`. Existing token entries
+  for other providers are preserved.
+
+First run / configuration (manual):
 
 - Run `git cai` once. If no config exists yet, git-cai creates:
   `~/.config/cai/cai_config.yml` (global config) and ensures default prompt files exist:
@@ -169,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
@@ -248,6 +273,28 @@ git cai -H groq.model=llama-3.3-70b
 Show a summary of available flags and usage information. When a manual page
 is installed, the full manual is opened instead.
 
+-I, --init::
+Run the interactive setup wizard. Bootstraps the home-scope
+configuration only: writes `~/.config/cai/cai_config.yml` and (for
+providers that require one) `~/.config/cai/tokens.yml` with mode
+`0600`.
++
+The wizard asks for a default provider, language, commit-message
+style, whether to use emoji, and — for providers other than `ollama`
+— the API key. Input for the API key is hidden while you type.
++
+If `~/.config/cai/cai_config.yml` already exists, the wizard prompts
+before overwriting it. Existing entries in `tokens.yml` for other
+providers are preserved; only the chosen provider's key is updated.
++
+For repository-level configuration use `-g`/`--generate-config`
+instead — `--init` only writes home-scope files.
++
+----
+git cai --init
+git cai -I
+----
+
 -i, --install-completion::
 Install shell completion for `git cai`. Supports bash, zsh, and fish.
 Completions cover all flags and provider names for `--provider`.
@@ -286,6 +333,33 @@ git cai -P anthropic -m claude-haiku-4-5
 git cai -P ollama -m mistral
 ----
 
+-o, --signoff / --no-signoff::
+Append a `Signed-off-by:` trailer to the generated commit message
+using your configured git `user.name` and `user.email`. Applies in
+COMMIT, AMEND, and SQUASH modes.
++
+If the message body already ends in a trailer block (e.g. an existing
+`Co-authored-by:` or `Signed-off-by:` line) the new sign-off is added
+to that block without an extra blank line. A duplicate trailer for the
+same identity is detected and skipped, so re-running with
+`--signoff` on a message that already carries one is a no-op.
++
+Use `--no-signoff` to explicitly disable for the current run when the
+persisted config has `signoff: true`. To enable permanently:
++
+----
+git cai -S signoff=true
+----
++
+Errors out if either git `user.name` or `user.email` is empty.
++
+----
+git cai --signoff
+git cai -o -c
+git cai -A --signoff
+git cai -s --signoff
+----
+
 -P, --provider PROVIDER::
 Override the LLM provider for this invocation. The model and temperature
 from the configuration for that provider are used unless `--model` is also
@@ -310,6 +384,27 @@ overwrites.
 git cai -p
 ----
 
+--print::
+Generate the commit message, print it to stdout, and exit without
+opening the editor and without committing. Useful for scripting:
++
+----
+MSG=$(git cai --print)
+----
++
+Composes with `--conventional`, `--signoff`, `--branch`, `--context`,
+`--provider`, `--model`, and the other modifiers — the printed output
+reflects every modifier as if you were committing.
++
+Limited to COMMIT and AMEND modes. Mutually exclusive with `--crazy`
+(the two flags are contradictory: `--crazy` commits immediately,
+`--print` does not commit at all).
++
+Diagnostic output (the spinner, `--time` measurements, `--debug` logs)
+goes to stderr, so command substitution captures only the message.
+Stats recording is unaffected — generations made with `--print` are
+still recorded when stats are enabled.
+
 -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
@@ -406,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
@@ -742,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`)