git-cai-cli 0.8.1__tar.gz → 0.9.0__tar.gz

{git_cai_cli-0.8.1 → git_cai_cli-0.9.0}/.linters/.pylintrc

@@ -68,8 +68,8 @@ check-protected-access-in-special-methods=no
 [DESIGN]
 max-args=15                                # Max arguments per function
 max-attributes=7                           # Max attributes per class
-max-branches=20                            # Max branches per function
-max-locals=30                              # Max locals per function
+max-branches=30                            # Max branches per function
+max-locals=50                              # Max locals per function
 max-returns=10                             # Max return statements per function
 max-statements=100                         # Max total statements per function
 max-public-methods=20                      # Max public methods per class

{git_cai_cli-0.8.1/src/git_cai_cli.egg-info → git_cai_cli-0.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: git-cai-cli
-Version: 0.8.1
+Version: 0.9.0
 Summary: Use LLM to create git commit messages
 Author-email: Thorsten Foltz <thorsten.foltz@live.com>
 License-Expression: MIT
@@ -75,9 +75,13 @@ Currently supported providers:
 - Generates meaningful, context-aware commit messages using an LLM
 - Seamless integration with Git
 - Supports multiple LLM providers and models
+- Override provider and model per invocation (`-P`, `-m`)
 - Global configuration with per-repository overrides
 - Repository-specific language, style, and model selection
 - Optional commit squashing with automatic summary generation
+- Token usage logging for API calls
+- Generation time measurement (`-t`)
+- Shell completion for bash, zsh, and fish (`-i`)
 
 ---
 
@@ -210,6 +214,8 @@ git cai -g
 - `load_tokens_from` – path to the file where API tokens are stored
 - `prompt_file` - path to the file where the prompt for the commit is stored
 - `squash_prompt_file` - path to the file where the prompt for the squash is stored
+- `token_logging` – log token usage after each LLM call (default: `true` for new installs)
+- `measure_time` – log generation time (default: `false`)
 
 ---
 
@@ -217,14 +223,18 @@ git cai -g
 
 In addition to `git cai`, the following options are available:
 
-- `-h` `--help` – show help and available commands
 - `-a`, `--all` – stage all tracked modified and deleted files
 - `-c`, `--crazy` – Trust the LLM and commit without checking
 - `-d`, `--debug` – enable debug logging
 - `-g`, `--generate-config` – generate the default `cai_config.yml` in the current directory
+- `-h`, `--help` – show help and available commands
+- `-i`, `--install-completion` – install shell completion for bash, zsh, or fish
 - `-l`, `--list` – list available languages, styles, and supported editors
+- `-m`, `--model` – override the model for this invocation (requires `-P`)
 - `-p`, `--generate-prompts` – generate default `commit_prompt.md` and `squash_prompt.md` in the current directory (for customization)
+- `-P`, `--provider` – override the LLM provider for this invocation
 - `-s`, `--squash` – squash commits on the current branch and summarize them
+- `-t`, `--time` – measure and log commit message generation time
 - `-u`, `--update` – check for updates
 - `-v`, `--version` – show the installed version
 

{git_cai_cli-0.8.1 → git_cai_cli-0.9.0}/README.md

@@ -46,9 +46,13 @@ Currently supported providers:
 - Generates meaningful, context-aware commit messages using an LLM
 - Seamless integration with Git
 - Supports multiple LLM providers and models
+- Override provider and model per invocation (`-P`, `-m`)
 - Global configuration with per-repository overrides
 - Repository-specific language, style, and model selection
 - Optional commit squashing with automatic summary generation
+- Token usage logging for API calls
+- Generation time measurement (`-t`)
+- Shell completion for bash, zsh, and fish (`-i`)
 
 ---
 
@@ -181,6 +185,8 @@ git cai -g
 - `load_tokens_from` – path to the file where API tokens are stored
 - `prompt_file` - path to the file where the prompt for the commit is stored
 - `squash_prompt_file` - path to the file where the prompt for the squash is stored
+- `token_logging` – log token usage after each LLM call (default: `true` for new installs)
+- `measure_time` – log generation time (default: `false`)
 
 ---
 
@@ -188,14 +194,18 @@ git cai -g
 
 In addition to `git cai`, the following options are available:
 
-- `-h` `--help` – show help and available commands
 - `-a`, `--all` – stage all tracked modified and deleted files
 - `-c`, `--crazy` – Trust the LLM and commit without checking
 - `-d`, `--debug` – enable debug logging
 - `-g`, `--generate-config` – generate the default `cai_config.yml` in the current directory
+- `-h`, `--help` – show help and available commands
+- `-i`, `--install-completion` – install shell completion for bash, zsh, or fish
 - `-l`, `--list` – list available languages, styles, and supported editors
+- `-m`, `--model` – override the model for this invocation (requires `-P`)
 - `-p`, `--generate-prompts` – generate default `commit_prompt.md` and `squash_prompt.md` in the current directory (for customization)
+- `-P`, `--provider` – override the LLM provider for this invocation
 - `-s`, `--squash` – squash commits on the current branch and summarize them
+- `-t`, `--time` – measure and log commit message generation time
 - `-u`, `--update` – check for updates
 - `-v`, `--version` – show the installed version
 

{git_cai_cli-0.8.1 → git_cai_cli-0.9.0}/docs/git-cai.txt

@@ -11,8 +11,11 @@ SYNOPSIS
 --------
 [verse]
 `git cai` [-a | --all] [-c | --crazy] [-d | --debug] [-g | --generate-config]
+        [-i | --install-completion]
         [-l [editor|language|style] | --list [editor|language|style]]
-        [-p | --generate-prompts] [-s | --squash] [-u | --update] [-v | --version]
+        [-m MODEL | --model MODEL] [-p | --generate-prompts]
+        [-P PROVIDER | --provider PROVIDER]
+        [-s | --squash] [-t | --time] [-u | --update] [-v | --version]
 
 
 DESCRIPTION
@@ -73,16 +76,38 @@ Enable debug logging.
 -g, --generate-config::
 Generate default cai_config.yml in the current directory.
 
+-i, --install-completion::
+Install shell completion for `git cai`. Supports bash, zsh, and fish.
+After installation, restart your terminal or source your shell configuration.
+Completions include all flags and provider names for `--provider`.
+
 -l, --list::
 List information. Provide one of `editor`, `language`, or `style` as the next argument.
 
+-m, --model MODEL::
+Override the model for this invocation. Must be used together with `--provider`.
+The model name is passed directly to the provider's API.
+Example: `git cai -P openai -m gpt-4o`
+
 -p, --generate-prompts::
 Generate default commit_prompt.md and squash_prompt.md in the current directory.
 Use these as a starting point for custom prompts.
 
+-P, --provider PROVIDER::
+Override the LLM provider for this invocation. The model from the configuration
+for that provider is used unless `--model` is also specified.
+Available providers: `anthropic`, `deepseek`, `gemini`, `groq`,
+`mistral`, `ollama`, `openai`, `xai`.
+Example: `git cai -P anthropic`
+
 -s, --squash::
 Squash commits on the current branch and summarize them.
 
+-t, --time::
+Measure and log the time taken to generate the commit message.
+Can also be permanently enabled via `measure_time: true` in
+`cai_config.yml`.
+
 -u, --update::
 Check for updates.
 
@@ -193,6 +218,30 @@ git cai -l language
 git cai -l editor
 ----
 
+Override the provider for a single invocation:
+
+----
+git cai -P anthropic
+----
+
+Override both provider and model:
+
+----
+git cai -P openai -m gpt-4o
+----
+
+Measure generation time:
+
+----
+git cai -t
+----
+
+Install shell completion:
+
+----
+git cai -i
+----
+
 SEE ALSO
 --------
 git(1)

{git_cai_cli-0.8.1 → git_cai_cli-0.9.0}/docs/man/git-cai.1

@@ -2,12 +2,12 @@
 .\"     Title: git-cai
 .\"    Author: Thorsten Foltz
 .\" Generator: Asciidoctor 2.0.26
-.\"      Date: 2026-02-14
+.\"      Date: 2026-03-16
 .\"    Manual: \ \&
 .\"    Source: \ \&
 .\"  Language: English
 .\"
-.TH "GIT\-CAI" "1" "2026-02-14" "\ \&" "\ \&"
+.TH "GIT\-CAI" "1" "2026-03-16" "\ \&" "\ \&"
 .ie \n(.g .ds Aq \(aq
 .el       .ds Aq '
 .ss \n[.ss] 0
@@ -33,8 +33,11 @@ git-cai \- AI\-powered commit message generator
 .sp
 .nf
 \f(CRgit cai\fP [\-a | \-\-all] [\-c | \-\-crazy] [\-d | \-\-debug] [\-g | \-\-generate\-config]
+        [\-i | \-\-install\-completion]
         [\-l [editor|language|style] | \-\-list [editor|language|style]]
-        [\-p | \-\-generate\-prompts] [\-s | \-\-squash] [\-u | \-\-update] [\-v | \-\-version]
+        [\-m MODEL | \-\-model MODEL] [\-p | \-\-generate\-prompts]
+        [\-P PROVIDER | \-\-provider PROVIDER]
+        [\-s | \-\-squash] [\-t | \-\-time] [\-u | \-\-update] [\-v | \-\-version]
 .fi
 .br
 .SH "DESCRIPTION"
@@ -199,22 +202,52 @@ Enable debug logging.
 Generate default cai_config.yml in the current directory.
 .RE
 .sp
+\-i, \-\-install\-completion
+.RS 4
+Install shell completion for \f(CRgit cai\fP. Supports bash, zsh, and fish.
+After installation, restart your terminal or source your shell configuration.
+Completions include all flags and provider names for \f(CR\-\-provider\fP.
+.RE
+.sp
 \-l, \-\-list
 .RS 4
 List information. Provide one of \f(CReditor\fP, \f(CRlanguage\fP, or \f(CRstyle\fP as the next argument.
 .RE
 .sp
+\-m, \-\-model MODEL
+.RS 4
+Override the model for this invocation. Must be used together with \f(CR\-\-provider\fP.
+The model name is passed directly to the provider\(cqs API.
+Example: \f(CRgit cai \-P openai \-m gpt\-4o\fP
+.RE
+.sp
 \-p, \-\-generate\-prompts
 .RS 4
 Generate default commit_prompt.md and squash_prompt.md in the current directory.
 Use these as a starting point for custom prompts.
 .RE
 .sp
+\-P, \-\-provider PROVIDER
+.RS 4
+Override the LLM provider for this invocation. The model from the configuration
+for that provider is used unless \f(CR\-\-model\fP is also specified.
+Available providers: \f(CRanthropic\fP, \f(CRdeepseek\fP, \f(CRgemini\fP, \f(CRgroq\fP,
+\f(CRmistral\fP, \f(CRollama\fP, \f(CRopenai\fP, \f(CRxai\fP.
+Example: \f(CRgit cai \-P anthropic\fP
+.RE
+.sp
 \-s, \-\-squash
 .RS 4
 Squash commits on the current branch and summarize them.
 .RE
 .sp
+\-t, \-\-time
+.RS 4
+Measure and log the time taken to generate the commit message.
+Can also be permanently enabled via \f(CRmeasure_time: true\fP in
+\f(CRcai_config.yml\fP.
+.RE
+.sp
 \-u, \-\-update
 .RS 4
 Check for updates.
@@ -413,6 +446,46 @@ git cai \-l editor
 .fam
 .fi
 .if n .RE
+.sp
+Override the provider for a single invocation:
+.sp
+.if n .RS 4
+.nf
+.fam C
+git cai \-P anthropic
+.fam
+.fi
+.if n .RE
+.sp
+Override both provider and model:
+.sp
+.if n .RS 4
+.nf
+.fam C
+git cai \-P openai \-m gpt\-4o
+.fam
+.fi
+.if n .RE
+.sp
+Measure generation time:
+.sp
+.if n .RS 4
+.nf
+.fam C
+git cai \-t
+.fam
+.fi
+.if n .RE
+.sp
+Install shell completion:
+.sp
+.if n .RS 4
+.nf
+.fam C
+git cai \-i
+.fam
+.fi
+.if n .RE
 .SH "SEE ALSO"
 .sp
 git(1)

{git_cai_cli-0.8.1 → git_cai_cli-0.9.0}/pyproject.toml

@@ -47,6 +47,9 @@ git_cai_cli = ["defaults/*.md"]
 [tool.setuptools.data-files]
 "share/man/man1" = ["docs/man/git-cai.1"]
 
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
 [tool.setuptools_scm]
 version_scheme = "guess-next-dev"
 local_scheme = "no-local-version"

{git_cai_cli-0.8.1 → git_cai_cli-0.9.0}/src/git_cai_cli/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '0.8.1'
-__version_tuple__ = version_tuple = (0, 8, 1)
+__version__ = version = '0.9.0'
+__version_tuple__ = version_tuple = (0, 9, 0)
 
-__commit_id__ = commit_id = 'g1830345d9'
+__commit_id__ = commit_id = 'g836915852'

{git_cai_cli-0.8.1 → git_cai_cli-0.9.0}/src/git_cai_cli/cli/cli.py

@@ -7,7 +7,7 @@ from git_cai_cli.cli.helptext import print_help_and_exit
 from git_cai_cli.cli.modes import resolve_mode, validate_options
 from git_cai_cli.main import run
 
-app = typer.Typer(add_completion=True, help=None, no_args_is_help=False)
+app = typer.Typer(add_completion=False, help=None, no_args_is_help=False)
 
 
 @app.callback(invoke_without_command=True)
@@ -18,6 +18,13 @@ def callback(
     help_flag: bool = typer.Option(
         False, "-h", "--help", help="Show help", is_eager=True
     ),
+    install_completion: bool = typer.Option(
+        False,
+        "--install-completion",
+        "-i",
+        help="Install shell completion for git-cai",
+        is_eager=True,
+    ),
     crazy: bool = typer.Option(
         False, "-c", "--crazy", help="Commit immediately without opening editor"
     ),
@@ -49,6 +56,15 @@ def callback(
         False, "--squash", "-s", help="Squash commits on this branch"
     ),
     update: bool = typer.Option(False, "--update", "-u", help="Check for updates"),
+    provider: str = typer.Option(
+        None, "--provider", "-P", help="Override LLM provider for this invocation"
+    ),
+    model: str = typer.Option(
+        None, "--model", "-m", help="Override model (requires --provider)"
+    ),
+    time_flag: bool = typer.Option(
+        False, "--time", "-t", help="Measure and log generation time"
+    ),
 ):
     """
     CLI entry point for git-cai-cli.
@@ -62,6 +78,12 @@ def callback(
         typer.echo(f"cai version: {__version__}")
         raise typer.Exit()
 
+    if install_completion:
+        from git_cai_cli.core.completion import install_completion as do_install
+
+        do_install()
+        raise typer.Exit()
+
     mode = resolve_mode(list_flag=list_flag, squash=squash, update=update)
 
     validate_options(
@@ -70,6 +92,9 @@ def callback(
         enable_debug=enable_debug,
         help_flag=help_flag,
         version_flag=version,
+        provider_override=provider,
+        model_override=model,
+        time_flag=time_flag,
     )
 
     if generate_config:
@@ -108,6 +133,9 @@ def callback(
         list_arg=list_arg,
         stage_tracked=stage_tracked,
         crazy=crazy,
+        provider_override=provider,
+        model_override=model,
+        time_flag=time_flag,
     )
 
 

git_cai_cli-0.9.0/src/git_cai_cli/cli/helptext.py

@@ -0,0 +1,45 @@
+"""
+Help text for git-cai-cli.
+"""
+
+from pathlib import Path
+
+import typer
+
+HOME = Path.home()
+
+HELP_TEXT = f"""
+Git CAI - AI-powered commit message generator
+
+Usage:
+  git cai        Generate commit message from staged changes
+
+Flags:
+  -a, --all                Stage all modified and deleted files that are already tracked by Git
+  -c, --crazy              Commit immediately without opening editor (trust LLM output)
+  -d, --debug              Enable debug logging
+  -g, --generate-config    Generate default cai_config.yml in the current directory
+  -h, --help               Show this help message or opens manual
+  -i, --install-completion Install shell completion for git-cai
+  -l, --list               List information about available languages, styles, and editors
+  -m, --model NAME         Override model for this invocation (requires --provider)
+  -p, --generate-prompts   Generate default commit_prompt.md and squash_prompt.md
+  -P, --provider NAME      Override LLM provider for this invocation
+  -s, --squash             Squash commits on this branch and summarize them
+  -t, --time               Measure and log commit message generation time
+  -u, --update             Check for updates
+  -v, --version            Show installed version
+
+Configuration:
+  Tokens are loaded from {HOME}/.config/cai/tokens.yml
+  Reset to default config by deleting {HOME}/.config/cai/cai_config.yml
+  and executing 'git cai' again.
+"""
+
+
+def print_help_and_exit() -> None:
+    """
+    Print help text and exit.
+    """
+    typer.echo(HELP_TEXT)
+    raise typer.Exit()

{git_cai_cli-0.8.1 → git_cai_cli-0.9.0}/src/git_cai_cli/cli/modes.py

@@ -47,6 +47,9 @@ def validate_options(
     enable_debug: bool,
     help_flag: bool,
     version_flag: bool,
+    provider_override: str | None = None,
+    model_override: str | None = None,
+    time_flag: bool = False,
 ) -> None:
     """
     Validates the combination of command-line options provided by the user.
@@ -64,3 +67,17 @@ def validate_options(
             err=True,
         )
         raise typer.Exit(code=1)
+
+    if (provider_override or model_override) and mode in (Mode.LIST, Mode.UPDATE):
+        typer.echo(
+            "Error: --provider/--model cannot be used with --list or --update.",
+            err=True,
+        )
+        raise typer.Exit(code=1)
+
+    if time_flag and mode in (Mode.LIST, Mode.UPDATE):
+        typer.echo(
+            "Error: --time cannot be used with --list or --update.",
+            err=True,
+        )
+        raise typer.Exit(code=1)

git_cai_cli-0.9.0/src/git_cai_cli/core/completion.py

@@ -0,0 +1,186 @@
+"""
+Shell completion for git-cai.
+
+Generates and installs completion scripts that work for both
+`git-cai` (direct) and `git cai` (as a git subcommand).
+"""
+
+import logging
+import os
+from pathlib import Path
+
+import typer
+
+log = logging.getLogger(__name__)
+
+# Zsh completion script.
+# Placed in fpath as _git-cai, zsh's git completion auto-discovers it
+# for `git cai <TAB>`. Also registers via compdef for `git-cai <TAB>`.
+_ZSH_SCRIPT = """\
+#compdef git-cai
+
+_git-cai() {
+  local -a options
+  options=(
+    '(-h --help)'{-h,--help}'[Show help]'
+    '(-v --version)'{-v,--version}'[Show version]'
+    '(-a --all)'{-a,--all}'[Stage all tracked files]'
+    '(-c --crazy)'{-c,--crazy}'[Commit immediately without editor]'
+    '(-d --debug)'{-d,--debug}'[Enable debug logging]'
+    '(-g --generate-config)'{-g,--generate-config}'[Generate default config]'
+    '(-i --install-completion)'{-i,--install-completion}'[Install shell completion]'
+    '(-l --list)'{-l,--list}'[List information]'
+    '(-m --model)'{-m,--model}'[Override model (requires --provider)]:model:'
+    '(-p --generate-prompts)'{-p,--generate-prompts}'[Generate default prompts]'
+    '(-s --squash)'{-s,--squash}'[Squash commits on this branch]'
+    '(-t --time)'{-t,--time}'[Measure generation time]'
+    '(-u --update)'{-u,--update}'[Check for updates]'
+    '(-P --provider)'{-P,--provider}'[Override LLM provider]:provider:(anthropic deepseek gemini groq mistral ollama openai xai)'
+  )
+  _arguments -s -S $options
+}
+
+_git-cai "$@"
+"""
+
+# Bash completion script.
+_BASH_SCRIPT = """\
+_git_cai_completion() {
+    local cur opts
+    COMPREPLY=()
+    cur="${COMP_WORDS[COMP_CWORD]}"
+    opts="-h --help -v --version -a --all -c --crazy -d --debug \\
+          -g --generate-config -i --install-completion -l --list \\
+          -m --model -p --generate-prompts -s --squash -t --time \\
+          -u --update -P --provider"
+
+    if [[ "${COMP_WORDS[COMP_CWORD-1]}" == "--provider" || \\
+          "${COMP_WORDS[COMP_CWORD-1]}" == "-P" ]]; then
+        local providers="anthropic deepseek gemini groq mistral ollama openai xai"
+        COMPREPLY=( $(compgen -W "$providers" -- "$cur") )
+        return 0
+    fi
+
+    COMPREPLY=( $(compgen -W "$opts" -- "$cur") )
+    return 0
+}
+
+complete -o default -F _git_cai_completion git-cai
+
+# Also register for 'git cai' via git's bash completion mechanism
+__git_cai() {
+    _git_cai_completion
+}
+"""
+
+# Fish completion script.
+_FISH_SCRIPT = """\
+# Completions for git-cai / git cai
+complete -c git-cai -s h -l help -d 'Show help'
+complete -c git-cai -s v -l version -d 'Show version'
+complete -c git-cai -s a -l all -d 'Stage all tracked files'
+complete -c git-cai -s c -l crazy -d 'Commit immediately without editor'
+complete -c git-cai -s d -l debug -d 'Enable debug logging'
+complete -c git-cai -s g -l generate-config -d 'Generate default config'
+complete -c git-cai -s i -l install-completion -d 'Install shell completion'
+complete -c git-cai -s l -l list -d 'List information'
+complete -c git-cai -s m -l model -d 'Override model' -r
+complete -c git-cai -s p -l generate-prompts -d 'Generate default prompts'
+complete -c git-cai -s s -l squash -d 'Squash commits on this branch'
+complete -c git-cai -s t -l time -d 'Measure generation time'
+complete -c git-cai -s u -l update -d 'Check for updates'
+complete -c git-cai -s P -l provider -d 'Override LLM provider' -r -a 'anthropic deepseek gemini groq mistral ollama openai xai'
+"""
+
+
+def _detect_shell() -> str:
+    """Detect the current shell."""
+    shell = os.environ.get("SHELL", "")
+    return os.path.basename(shell) if shell else "bash"
+
+
+def install_completion() -> None:
+    """Install shell completion for git-cai."""
+    shell = _detect_shell()
+
+    if shell == "zsh":
+        _install_zsh()
+    elif shell == "bash":
+        _install_bash()
+    elif shell == "fish":
+        _install_fish()
+    else:
+        typer.echo(
+            f"Unsupported shell '{shell}'. Supported: bash, zsh, fish.", err=True
+        )
+        raise typer.Exit(code=1)
+
+
+def _install_zsh() -> None:
+    """Install zsh completion."""
+    # Determine the target directory
+    zfunc_dir = Path.home() / ".zfunc"
+    zfunc_dir.mkdir(parents=True, exist_ok=True)
+
+    target = zfunc_dir / "_git-cai"
+    target.write_text(_ZSH_SCRIPT, encoding="utf-8")
+
+    # Check if ~/.zfunc is in fpath via .zshrc
+    zshrc = Path.home() / ".zshrc"
+    fpath_line = "fpath=(~/.zfunc $fpath)"
+
+    needs_fpath = True
+    if zshrc.exists():
+        content = zshrc.read_text(encoding="utf-8")
+        if ".zfunc" in content:
+            needs_fpath = False
+
+    if needs_fpath:
+        with zshrc.open("a", encoding="utf-8") as f:
+            f.write(
+                f"\n# git-cai completion\n{fpath_line}\nautoload -Uz compinit && compinit\n"
+            )
+        typer.echo(f"Added {fpath_line} to {zshrc}")
+
+    typer.echo(f"zsh completion installed in {target}.")
+    typer.echo("Restart your terminal or run: source ~/.zshrc")
+
+
+def _install_bash() -> None:
+    """Install bash completion."""
+    # Try system completions dir first, fall back to user dir
+    comp_dir = Path.home() / ".local" / "share" / "bash-completion" / "completions"
+    comp_dir.mkdir(parents=True, exist_ok=True)
+
+    target = comp_dir / "git-cai"
+    target.write_text(_BASH_SCRIPT, encoding="utf-8")
+
+    # Check if the completion dir is sourced
+    bashrc = Path.home() / ".bashrc"
+    source_line = f"[ -f {target} ] && source {target}"
+
+    needs_source = True
+    if bashrc.exists():
+        content = bashrc.read_text(encoding="utf-8")
+        if "git-cai" in content or str(comp_dir) in content:
+            needs_source = False
+
+    if needs_source:
+        with bashrc.open("a", encoding="utf-8") as f:
+            f.write(f"\n# git-cai completion\n{source_line}\n")
+        typer.echo(f"Added sourcing line to {bashrc}")
+
+    typer.echo(f"bash completion installed in {target}.")
+    typer.echo("Restart your terminal or run: source ~/.bashrc")
+
+
+def _install_fish() -> None:
+    """Install fish completion."""
+    comp_dir = Path.home() / ".config" / "fish" / "completions"
+    comp_dir.mkdir(parents=True, exist_ok=True)
+
+    target = comp_dir / "git-cai.fish"
+    target.write_text(_FISH_SCRIPT, encoding="utf-8")
+
+    typer.echo(f"fish completion installed in {target}.")
+    typer.echo("Restart your terminal for completions to take effect.")