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

{git_cai_cli-0.13.4 → git_cai_cli-0.14.0}/.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=65                              # 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.4 → git_cai_cli-0.14.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: git-cai-cli
-Version: 0.13.4
+Version: 0.14.0
 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
@@ -144,6 +147,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:  
@@ -241,6 +257,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`
 
 ---
 
@@ -259,11 +276,14 @@ In addition to `git cai`, the following options are available:
 - `-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
@@ -383,6 +403,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.4 → git_cai_cli-0.14.0}/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
@@ -114,6 +117,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:  
@@ -211,6 +227,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`
 
 ---
 
@@ -229,11 +246,14 @@ In addition to `git cai`, the following options are available:
 - `-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
@@ -353,6 +373,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.4 → git_cai_cli-0.14.0}/docs/git-cai.txt

@@ -15,11 +15,14 @@ SYNOPSIS
         [-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]]
@@ -46,7 +49,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:
@@ -248,6 +260,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 +320,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 +371,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

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

@@ -2,12 +2,12 @@
 .\"     Title: git-cai
 .\"    Author: Thorsten Foltz
 .\" Generator: Asciidoctor 2.0.26
-.\"      Date: 2026-05-12
+.\"      Date: 2026-05-25
 .\"    Manual: \ \&
 .\"    Source: \ \&
 .\"  Language: English
 .\"
-.TH "GIT\-CAI" "1" "2026-05-12" "\ \&" "\ \&"
+.TH "GIT\-CAI" "1" "2026-05-25" "\ \&" "\ \&"
 .ie \n(.g .ds Aq \(aq
 .el       .ds Aq '
 .ss \n[.ss] 0
@@ -37,11 +37,14 @@ git-cai \- AI\-powered commit message generator
         [\-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]]
@@ -96,7 +99,25 @@ It opens your configured Git editor so you can review/edit before committing.
 .RE
 .SH "SETUP"
 .sp
-First run / configuration:
+Guided setup (recommended):
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.  sp -1
+.  IP \(bu 2.3
+.\}
+Run \f(CRgit cai \-\-init\fP (or \f(CR\-I\fP). The interactive wizard asks for a
+default provider, language, style, and emoji preference, then
+collects the API key (hidden input). It writes
+\f(CR~/.config/cai/cai_config.yml\fP and, for providers that need one,
+\f(CR~/.config/cai/tokens.yml\fP with mode \f(CR0600\fP. Existing token entries
+for other providers are preserved.
+.RE
+.sp
+First run / configuration (manual):
 .sp
 .RS 4
 .ie n \{\
@@ -442,6 +463,34 @@ Show a summary of available flags and usage information. When a manual page
 is installed, the full manual is opened instead.
 .RE
 .sp
+\-I, \-\-init
+.RS 4
+Run the interactive setup wizard. Bootstraps the home\-scope
+configuration only: writes \f(CR~/.config/cai/cai_config.yml\fP and (for
+providers that require one) \f(CR~/.config/cai/tokens.yml\fP with mode
+\f(CR0600\fP.
+.sp
+The wizard asks for a default provider, language, commit\-message
+style, whether to use emoji, and — for providers other than \f(CRollama\fP
+— the API key. Input for the API key is hidden while you type.
+.sp
+If \f(CR~/.config/cai/cai_config.yml\fP already exists, the wizard prompts
+before overwriting it. Existing entries in \f(CRtokens.yml\fP for other
+providers are preserved; only the chosen provider\(cqs key is updated.
+.sp
+For repository\-level configuration use \f(CR\-g\fP/\f(CR\-\-generate\-config\fP
+instead — \f(CR\-\-init\fP only writes home\-scope files.
+.sp
+.if n .RS 4
+.nf
+.fam C
+git cai \-\-init
+git cai \-I
+.fam
+.fi
+.if n .RE
+.RE
+.sp
 \-i, \-\-install\-completion
 .RS 4
 Install shell completion for \f(CRgit cai\fP. Supports bash, zsh, and fish.
@@ -498,6 +547,43 @@ git cai \-P ollama \-m mistral
 .if n .RE
 .RE
 .sp
+\-o, \-\-signoff / \-\-no\-signoff
+.RS 4
+Append a \f(CRSigned\-off\-by:\fP trailer to the generated commit message
+using your configured git \f(CRuser.name\fP and \f(CRuser.email\fP. Applies in
+COMMIT, AMEND, and SQUASH modes.
+.sp
+If the message body already ends in a trailer block (e.g. an existing
+\f(CRCo\-authored\-by:\fP or \f(CRSigned\-off\-by:\fP 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
+\f(CR\-\-signoff\fP on a message that already carries one is a no\-op.
+.sp
+Use \f(CR\-\-no\-signoff\fP to explicitly disable for the current run when the
+persisted config has \f(CRsignoff: true\fP. To enable permanently:
+.sp
+.if n .RS 4
+.nf
+.fam C
+git cai \-S signoff=true
+.fam
+.fi
+.if n .RE
+.sp
+Errors out if either git \f(CRuser.name\fP or \f(CRuser.email\fP is empty.
+.sp
+.if n .RS 4
+.nf
+.fam C
+git cai \-\-signoff
+git cai \-o \-c
+git cai \-A \-\-signoff
+git cai \-s \-\-signoff
+.fam
+.fi
+.if n .RE
+.RE
+.sp
 \-P, \-\-provider PROVIDER
 .RS 4
 Override the LLM provider for this invocation. The model and temperature
@@ -534,6 +620,33 @@ git cai \-p
 .if n .RE
 .RE
 .sp
+\-\-print
+.RS 4
+Generate the commit message, print it to stdout, and exit without
+opening the editor and without committing. Useful for scripting:
+.sp
+.if n .RS 4
+.nf
+.fam C
+MSG=$(git cai \-\-print)
+.fam
+.fi
+.if n .RE
+.sp
+Composes with \f(CR\-\-conventional\fP, \f(CR\-\-signoff\fP, \f(CR\-\-branch\fP, \f(CR\-\-context\fP,
+\f(CR\-\-provider\fP, \f(CR\-\-model\fP, and the other modifiers — the printed output
+reflects every modifier as if you were committing.
+.sp
+Limited to COMMIT and AMEND modes. Mutually exclusive with \f(CR\-\-crazy\fP
+(the two flags are contradictory: \f(CR\-\-crazy\fP commits immediately,
+\f(CR\-\-print\fP does not commit at all).
+.sp
+Diagnostic output (the spinner, \f(CR\-\-time\fP measurements, \f(CR\-\-debug\fP logs)
+goes to stderr, so command substitution captures only the message.
+Stats recording is unaffected — generations made with \f(CR\-\-print\fP are
+still recorded when stats are enabled.
+.RE
+.sp
 \-q, \-\-sql VALUE
 .RS 4
 Per\-invocation override for \f(CRstats.enabled\fP. VALUE is \f(CRtrue\fP or \f(CRfalse\fP

{git_cai_cli-0.13.4 → git_cai_cli-0.14.0}/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.4'
-__version_tuple__ = version_tuple = (0, 13, 4)
+__version__ = version = '0.14.0'
+__version_tuple__ = version_tuple = (0, 14, 0)
 
-__commit_id__ = commit_id = 'gfec0ad2bb'
+__commit_id__ = commit_id = 'ge467c3583'

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

@@ -162,6 +162,23 @@ def callback(  # pylint: disable=too-many-arguments,too-many-positional-argument
         "--reset-stats",
         help="Delete all rows from the local stats DB.",
     ),
+    init: bool = typer.Option(
+        False,
+        "--init",
+        "-I",
+        help="Interactive setup wizard: writes ~/.config/cai/cai_config.yml and tokens.yml.",
+    ),
+    signoff: bool | None = typer.Option(
+        None,
+        "--signoff/--no-signoff",
+        "-o",
+        help="Append a `Signed-off-by:` trailer using git user.name/user.email. Use --no-signoff to disable when the persisted config has it enabled.",
+    ),
+    print_only: bool = typer.Option(
+        False,
+        "--print",
+        help="Generate the commit message, print it to stdout, and exit without committing.",
+    ),
 ):
     """
     CLI entry point for git-cai-cli.
@@ -183,6 +200,7 @@ def callback(  # pylint: disable=too-many-arguments,too-many-positional-argument
 
     mode = resolve_mode(
         amend=amend,
+        init=init,
         list_flag=list_flag,
         pr=pr,
         squash=squash,
@@ -212,6 +230,8 @@ def callback(  # pylint: disable=too-many-arguments,too-many-positional-argument
         time_flag=time_flag,
         context=context,
         files=files,
+        print_only=print_only,
+        crazy=crazy,
     )
 
     if generate_config:
@@ -289,6 +309,8 @@ def callback(  # pylint: disable=too-many-arguments,too-many-positional-argument
         stats_since=stats_since,
         stats_json=stats_json,
         stats_reset=stats_reset,
+        signoff=signoff,
+        print_only=print_only,
     )
 
 

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

@@ -26,12 +26,15 @@ Flags:
   -g, --generate-config    Generate default cai_config.yml in the current directory
   -H, --set-home KEY=VALUE Set a config value in home config (~/.config/cai/)
   -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, --list [TYPE]        List information. TYPE: config, editor, language,
                            model, path, provider, style
   -m, --model NAME         Override model for this invocation (requires --provider)
+  -o, --signoff            Append a `Signed-off-by:` trailer (git user.name / user.email)
   -P, --provider NAME      Override LLM provider for this invocation
   -p, --generate-prompts   Generate default commit/squash/full_files/pr prompt files
+      --print              Print the generated commit message to stdout and exit (no commit)
   -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)