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

{git_cai_cli-0.8.1 → git_cai_cli-0.10.0}/.gitignore

@@ -1,5 +1,6 @@
 # directories
 build/
+.claude/
 dist/
 src/git_cai_cli.egg-info/
 .ipynb_checkpoints/

{git_cai_cli-0.8.1 → git_cai_cli-0.10.0}/.linters/.proselintrc

@@ -18,7 +18,7 @@
         , "lgbtq.offensive_terms": true
         , "lgbtq.terms": true
         , "lexical_illusions.misc": false
-        , "links.broken": true
+        , "links.broken": false
         , "malapropisms.misc": true
         , "misc.apologizing": true
         , "misc.back_formations": true

{git_cai_cli-0.8.1 → git_cai_cli-0.10.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.10.0/CLAUDE.md

@@ -0,0 +1,62 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project
+
+**git-cai** — A Python CLI tool that uses LLMs to generate git commit messages. Installed as `git-cai` (invoked as `git cai`). Supports 8 LLM providers: OpenAI, Anthropic, Gemini, Groq, xAI, Mistral, DeepSeek, and Ollama (local).
+
+## Common Commands
+
+```bash
+make test              # Run all tests (uv run pytest)
+make lint              # Branch name check + MegaLinter
+make lint-fix          # Auto-fix lint issues
+make clean             # Clean uv cache and .venv
+
+# Single test file
+uv run pytest tests/unit/test_llm.py -v
+
+# Single test function
+uv run pytest tests/unit/test_llm.py::test_function_name -v
+```
+
+## Architecture
+
+Entry point: `src/git_cai_cli/cli/cli.py` (Typer app) → `main.py` (dispatcher)
+
+### Modes (cli/modes.py)
+
+- **COMMIT** (default): git diff → LLM → user edits → commit
+- **LIST**: show supported languages/styles/editors
+- **SQUASH**: squash branch commits with generated summary
+- **UPDATE**: check PyPI for updates
+
+### Core Modules (core/)
+
+- **config.py** — Config loading with precedence: repo `cai_config.yml` > home `~/.config/cai/cai_config.yml` > bundled defaults
+- **llm.py** — `CommitMessageGenerator` class with `_dispatch_generate()` routing to provider-specific methods (`generate_openai()`, `generate_anthropic()`, etc.)
+- **gitutils.py** — Git operations (find root, diff with `.caiignore` support, commit)
+- **validate.py** — Config and LLM call validation
+- **squash.py** — Squash commit workflow (stage → generate summary → editor → reset + commit)
+- **options.py** — `CliManager` orchestrating CLI operations
+
+### Prompt Fallback Chain
+
+File (repo-level) → File (user home) → Bundled package (`defaults/*.md`) → Hardcoded string (`prompts_fallback.py`)
+
+### Tokens
+
+API tokens loaded from `~/.config/cai/tokens.yml`. Ollama is in `TOKENLESS_PROVIDERS` (no key needed).
+
+## Testing
+
+- Unit tests in `tests/unit/`, integration tests in `tests/integration/`
+- Uses `requests-mock` for HTTP mocking
+- CI tests against Python 3.10–3.14
+
+## Build & Versioning
+
+- Package manager: **uv**
+- Version: auto-generated from git tags via `setuptools-scm` → `src/git_cai_cli/_version.py`
+- Do not edit `_version.py` manually

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: git-cai-cli
-Version: 0.8.1
+Version: 0.10.0
 Summary: Use LLM to create git commit messages
 Author-email: Thorsten Foltz <thorsten.foltz@live.com>
 License-Expression: MIT
@@ -75,9 +75,16 @@ 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
+- Amend the last commit message with a regenerated one (`-A`)
+- Conventional Commits format support (`-C`)
+- Change configuration from the command line (`-S`, `-H`)
 - 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 +217,9 @@ 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
+- `conventional` – use Conventional Commits format (default: `false`)
+- `token_logging` – log token usage after each LLM call (default: `true` for new installs)
+- `measure_time` – log generation time (default: `false`)
 
 ---
 
@@ -217,17 +227,74 @@ git cai -g
 
 In addition to `git cai`, the following options are available:
 
-- `-h` `--help` – show help and available commands
+- `-A`, `--amend` – regenerate and amend the last commit message
 - `-a`, `--all` – stage all tracked modified and deleted files
+- `-C`, `--conventional` – use Conventional Commits format (`type(scope): description`)
 - `-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`, `--set` – set a config value (`key=value`) in repo config (requires existing repo config)
+- `-H`, `--set-home` – set a config value in home config (`key=value`), always targets `~/.config/cai/`
 - `-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
 
+### Amend
+
+To regenerate the last commit message and amend it:
+
+```sh
+git cai -A
+```
+
+This reads the diff from the most recent commit, sends it to the LLM, and opens the editor for review.
+Use with `-c` to amend immediately without the editor: `git cai -A -c`.
+
+### Conventional Commits
+
+To generate commit messages in [Conventional Commits](https://www.conventionalcommits.org/) format:
+
+```sh
+git cai -C
+```
+
+This enforces the `type(scope): description` structure. Allowed types: `feat`, `fix`, `docs`, `style`, `refactor`, `perf`, `test`, `build`, `ci`, `chore`, `revert`. Use `!` after the type/scope for breaking changes.
+
+To enable it permanently:
+
+```sh
+git cai -S conventional=true
+```
+
+### Changing configuration from the CLI
+
+Instead of editing YAML files manually, use `--set` or `--set-home` to update config values.
+
+`--set` (`-S`) targets the **repo config** (requires an existing `cai_config.yml` in the repo root):
+
+```sh
+git cai -S default=anthropic           # change the default provider
+git cai -S emoji=false                  # disable emojis
+git cai -S groq.model=llama-3.3-70b    # nested key (dot notation)
+git cai -S openai.temperature=0.7      # set temperature as float
+```
+
+If no repo config exists, an error is shown. Use `git cai -g` to create one first.
+
+`--set-home` (`-H`) always targets the **home (default) config** (`~/.config/cai/`):
+
+```sh
+git cai -H language=de
+git cai -H emoji=false
+```
+
 ---
 
 ## License

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

@@ -46,9 +46,16 @@ 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
+- Amend the last commit message with a regenerated one (`-A`)
+- Conventional Commits format support (`-C`)
+- Change configuration from the command line (`-S`, `-H`)
 - 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 +188,9 @@ 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
+- `conventional` – use Conventional Commits format (default: `false`)
+- `token_logging` – log token usage after each LLM call (default: `true` for new installs)
+- `measure_time` – log generation time (default: `false`)
 
 ---
 
@@ -188,17 +198,74 @@ git cai -g
 
 In addition to `git cai`, the following options are available:
 
-- `-h` `--help` – show help and available commands
+- `-A`, `--amend` – regenerate and amend the last commit message
 - `-a`, `--all` – stage all tracked modified and deleted files
+- `-C`, `--conventional` – use Conventional Commits format (`type(scope): description`)
 - `-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`, `--set` – set a config value (`key=value`) in repo config (requires existing repo config)
+- `-H`, `--set-home` – set a config value in home config (`key=value`), always targets `~/.config/cai/`
 - `-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
 
+### Amend
+
+To regenerate the last commit message and amend it:
+
+```sh
+git cai -A
+```
+
+This reads the diff from the most recent commit, sends it to the LLM, and opens the editor for review.
+Use with `-c` to amend immediately without the editor: `git cai -A -c`.
+
+### Conventional Commits
+
+To generate commit messages in [Conventional Commits](https://www.conventionalcommits.org/) format:
+
+```sh
+git cai -C
+```
+
+This enforces the `type(scope): description` structure. Allowed types: `feat`, `fix`, `docs`, `style`, `refactor`, `perf`, `test`, `build`, `ci`, `chore`, `revert`. Use `!` after the type/scope for breaking changes.
+
+To enable it permanently:
+
+```sh
+git cai -S conventional=true
+```
+
+### Changing configuration from the CLI
+
+Instead of editing YAML files manually, use `--set` or `--set-home` to update config values.
+
+`--set` (`-S`) targets the **repo config** (requires an existing `cai_config.yml` in the repo root):
+
+```sh
+git cai -S default=anthropic           # change the default provider
+git cai -S emoji=false                  # disable emojis
+git cai -S groq.model=llama-3.3-70b    # nested key (dot notation)
+git cai -S openai.temperature=0.7      # set temperature as float
+```
+
+If no repo config exists, an error is shown. Use `git cai -g` to create one first.
+
+`--set-home` (`-H`) always targets the **home (default) config** (`~/.config/cai/`):
+
+```sh
+git cai -H language=de
+git cai -H emoji=false
+```
+
 ---
 
 ## License