git-cai-cli 0.1.0__tar.gz

git_cai_cli-0.1.0/.caiignore

@@ -0,0 +1,5 @@
+# files
+*.lock
+*.ipynb
+
+# directories

git_cai_cli-0.1.0/.gitignore

@@ -0,0 +1,13 @@
+# directories
+build/
+dist/
+src/git_cai_cli.egg-info/
+.ipynb_checkpoints/
+megalinter-reports/
+__pycache__/
+.ruff_cache/
+.venv/
+
+# files
+
+*.ipynb

git_cai_cli-0.1.0/.linters/.bandit.yml

@@ -0,0 +1,4 @@
+# FILE: bandit.yml
+exclude_dirs: ["venv", "megalinter-reports", "tests"]
+#tests: ['B201', 'B301']
+skips: ["B404", "B603", "B607"]

git_cai_cli-0.1.0/.linters/.checkov.yml

@@ -0,0 +1,2 @@
+skip-path:
+  #- /pipelines/workspaces/

git_cai_cli-0.1.0/.linters/.flake8

@@ -0,0 +1,7 @@
+[flake8]
+#extend-ignore = E501, F821
+exclude =
+    test_copy_files_fsb.py,
+    __pycache__
+max-line-length = 256
+

git_cai_cli-0.1.0/.linters/.ls-lint.yml

@@ -0,0 +1,14 @@
+ls:
+  .py: lowercase | snake_case
+  .sh: lowercase | snake_case
+  .yml: lowercase | snake_case
+  .json: lowercase | snake_case
+  .txt: lowercase | snake_case
+  .toml: lowercase | snake_case
+  .config: lowercase | snake_case
+  .env: lowercase | snake_case
+
+ignore:
+  - .git
+  - .venv
+  - src/git_cai_cli.egg-info

git_cai_cli-0.1.0/.linters/.markdown-link-check.json

@@ -0,0 +1,10 @@
+{
+  "ignorePatterns": [
+    {
+      "pattern": "logo.png"
+    }
+  ],
+  "retryOn429": true,
+  "retryCount": 5,
+  "aliveStatusCodes": [0, 200, 203, 404]
+}

git_cai_cli-0.1.0/.linters/.markdownlint.json

@@ -0,0 +1,18 @@
+{
+  "MD004": true,
+  "MD007": {
+    "indent": 2
+  },
+  "MD013": {
+    "line_length": 256,
+    "code_blocks": false
+  },
+  "MD026": {
+    "punctuation": ".,;:!。，；:"
+  },
+  "MD029": true,
+  "MD033": false,
+  "MD036": true,
+  "MD041": true,
+  "MD051": true
+}

git_cai_cli-0.1.0/.linters/.proselintrc

@@ -0,0 +1,78 @@
+{
+    "checks": {
+        "airlinese.misc": false
+        , "annotations.misc": false
+        , "archaism.misc": false
+        , "cliches.hell": true
+        , "cliches.misc": true
+        , "consistency.spacing": true
+        , "consistency.spelling": true
+        , "corporate_speak.misc": true
+        , "cursing.filth": false
+        , "cursing.nfl": false
+        , "dates_times.am_pm": true
+        , "dates_times.dates": true
+        , "hedging.misc": true
+        , "hyperbole.misc": true
+        , "jargon.misc": false
+        , "lgbtq.offensive_terms": true
+        , "lgbtq.terms": true
+        , "lexical_illusions.misc": false
+        , "links.broken": true
+        , "malapropisms.misc": true
+        , "misc.apologizing": true
+        , "misc.back_formations": true
+        , "misc.bureaucratese": true
+        , "misc.but": true
+        , "misc.capitalization": true
+        , "misc.chatspeak": true
+        , "misc.commercialese": true
+        , "misc.currency": true
+        , "misc.debased": true
+        , "misc.false_plurals": true
+        , "misc.illogic": true
+        , "misc.inferior_superior": true
+        , "misc.latin": true
+        , "misc.many_a": true
+        , "misc.metaconcepts": true
+        , "misc.narcissism": true
+        , "misc.phrasal_adjectives": false
+        , "misc.preferred_forms": true
+        , "misc.pretension": true
+        , "misc.professions":	true 
+        , "misc.punctuation":	true
+        , "misc.scare_quotes": true
+        , "misc.suddenly": true
+        , "misc.tense_present": true
+        , "misc.waxed": true
+        , "misc.whence": true
+        , "mixed_metaphors.misc": true
+        , "mondegreens.misc": true
+        , "needless_variants.misc": true
+        , "nonwords.misc": true
+        , "oxymorons.misc": true
+        , "psychology.misc": true
+        , "redundancy.misc": true
+        , "redundancy.ras_syndrome": true
+        , "skunked_terms.misc": true
+        , "spelling.able_atable": true
+        , "spelling.able_ible": true
+        , "spelling.athletes": false
+        , "spelling.em_im_en_in": true
+        , "spelling.er_or": true
+        , "spelling.in_un": true
+        , "spelling.misc": true
+        , "security.credit_card": true
+        , "security.password": true
+        , "sexism.misc": true
+        , "terms.animal_adjectives": true
+        , "terms.eponymous_adjectives": true
+        , "terms.venery": true
+        , "typography.diacritical_marks": true
+        , "typography.exclamation": true
+        , "typography.symbols": false
+        , "uncomparables.misc": true
+        , "weasel_words.misc": true
+        , "weasel_words.very": true
+    }
+}

git_cai_cli-0.1.0/.linters/.pylintrc

@@ -0,0 +1,112 @@
+[MAIN]
+fail-under=10                   # Require a perfect 10/10 score or exit with error
+analyse-fallback-blocks=no      # Don’t analyze import fallback blocks (legacy Python 2/3 support)
+clear-cache-post-run=no         # Keep caches after linting (faster subsequent runs)
+jobs=0                          # Use all CPU cores (parallel analysis)
+persistent=yes                  # Save data between runs (improves inference caching)
+suggestion-mode=yes             # Provide friendly hints instead of false positives
+unsafe-load-any-extension=no    # Prevent loading arbitrary C extensions for safety
+
+ignore=venv,build,dist,__pycache__         # Ignore common generated/virtual dirs
+ignore-paths=.*[/\\](\.venv|\.mypy_cache|\.pytest_cache|build|dist|docs)[/\\].*
+ignore-patterns=^\.#                       # Ignore editor lockfiles (e.g., Emacs)
+
+extension-pkg-allow-list=                  # List allowed C-extension modules (empty = none)
+fail-on=                                   # Fail immediately if these specific warnings/errors are found
+
+[REPORTS]
+reports=no                                 # Don’t show full summary report (CI-friendly)
+evaluation=max(0, 0 if fatal else 10.0 - ((float(5 * error + warning + refactor + convention) / statement) * 10))
+                                           # Formula for calculating score (out of 10)
+msg-template={path}:{line}:{column}: {msg_id} ({symbol}) {msg}
+                                           # Output format for each message (good for CI/editors)
+output-format=colorized                    # Colorized console output
+
+[BASIC]
+argument-naming-style=snake_case           # Function/method args must be snake_case
+attr-naming-style=snake_case               # Instance attributes must be snake_case
+class-naming-style=PascalCase              # Classes must be PascalCase
+const-naming-style=UPPER_CASE              # Constants must be UPPER_CASE
+function-naming-style=snake_case           # Functions must be snake_case
+method-naming-style=snake_case             # Methods must be snake_case
+module-naming-style=snake_case             # Modules (files) must be snake_case
+variable-naming-style=snake_case           # Local variables must be snake_case
+
+bad-names=foo,bar,baz,toto,tutu,tata,tmp,data1
+                                           # Forbidden names that always fail
+good-names=i,j,k,ex,_,pk,id                # Short names that are acceptable
+include-naming-hint=yes                    # Suggest the expected format when naming is wrong
+
+[FORMAT]
+max-line-length=256                        # Maximum line length
+indent-string='    '                       # Use 4 spaces per indentation level
+indent-after-paren=4                       # Hanging indent size
+max-module-lines=1000                      # Max lines per module before warning
+ignore-long-lines=^\s*(# )?<?https?://\S+>?$
+                                           # Ignore long lines if they’re URLs or comments
+expected-line-ending-format=LF             # Require LF line endings
+single-line-if-stmt=no                     # Disallow single-line ifs
+single-line-class-stmt=no                  # Disallow single-line class definitions
+function-rgx=^([a-z_][a-z0-9_]*|[a-z]+(?:[A-Z][a-z0-9]+)*|[A-Z][a-z0-9]+(?:[A-Z][a-z0-9]+)*)$
+
+[IMPORTS]
+allow-wildcard-with-all=no                 # Don’t allow wildcard imports even with __all__
+allow-reexport-from-package=no             # Don’t allow alias re-exports in __init__.py
+known-third-party=requests,polars
+                                           # Declare 3rd party modules for correct grouping
+
+[CLASSES]
+defining-attr-methods=__init__,__new__,setUp,asyncSetUp,__post_init__
+                                           # Methods where attributes can be defined
+exclude-protected=_asdict,_fields,_replace,_source,_make,os._exit
+                                           # Protected names allowed to be accessed
+valid-classmethod-first-arg=cls            # Class methods must use `cls`
+valid-metaclass-classmethod-first-arg=mcs  # Metaclass methods must use `mcs`
+check-protected-access-in-special-methods=no
+                                           # Don’t warn about protected attr access in dunder methods
+
+[DESIGN]
+max-args=10                                # Max arguments per function
+max-attributes=7                           # Max attributes per class
+max-branches=12                            # Max branches per function
+max-locals=30                              # Max locals per function
+max-returns=6                              # Max return statements per function
+max-statements=50                          # 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=10                 # Max positional arguments per function
+
+[EXCEPTIONS]
+overgeneral-exceptions=builtins.BaseException,builtins.Exception
+                                           # Warn when catching too broad exceptions
+
+[LOGGING]
+logging-format-style=new                   # Enforce `{}`-style logging (not `%s` or f-strings)
+logging-modules=logging                    # Logging library to check against
+
+[MESSAGES CONTROL]
+confidence=HIGH,CONTROL_FLOW,INFERENCE,INFERENCE_FAILURE,UNDEFINED
+                                           # Only show warnings with these confidence levels
+disable=logging-too-many-args,
+        import-error
+                                           # Disable noisy/meta warnings
+
+
+
+[METHOD_ARGS]
+timeout-methods=requests.api.delete,requests.api.get,requests.api.head,requests.api.options,requests.api.patch,requests.api.post,requests.api.put,requests.api.request
+                                           # Enforce timeout param in requests.* calls
+
+[MISCELLANEOUS]
+notes=FIXME,TODO,XXX,BUG,HACK              # Markers that are flagged in comments
+
+[REFACTORING]
+never-returning-functions=sys.exit,argparse.parse_error
+                                           # Functions that always exit the program
+suggest-join-with-non-empty-separator=yes  # Warn if `" - " + " - ".join(items)` could be simplified
+
+[SIMILARITIES]
+min-similarity-lines=8                      # Minimum lines of similarity to report

git_cai_cli-0.1.0/.linters/.yamllint.yml

@@ -0,0 +1,18 @@
+###########################################
+# These are the rules used for            #
+# linting all the yaml files in the stack #
+# NOTE:                                   #
+# You can disable line with:              #
+# # yamllint disable-line                 #
+###########################################
+extends: default
+rules:
+  new-lines:
+    level: warning
+    type: unix
+  line-length:
+    max: 500
+  document-start:
+    present: false
+  comments:
+    min-spaces-from-content: 1 # Used to follow prettier standard: https://github.com/prettier/prettier/pull/10926

git_cai_cli-0.1.0/.linters/check_git_branch_name.sh

@@ -0,0 +1,28 @@
+#!/bin/bash
+
+# Define color codes
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+NC='\033[0m' # No Color
+
+# Unicode symbols
+CHECK_MARK="${GREEN}✔${NC}"
+CROSS_MARK="${RED}✖${NC}"
+
+# Get the current branch name
+BRANCH_NAME=${1:-$(git rev-parse --abbrev-ref HEAD)}
+
+# Define the branch name pattern
+BRANCH_NAME_REGEX="^(master|(feature|fix|hotfix|chore|refactor|test|docs)/[a-z0-9._-]+)$"
+
+# Check the branch name against the pattern
+if [[ ! $BRANCH_NAME =~ $BRANCH_NAME_REGEX && $BRANCH_NAME != "main" ]]; then
+	echo -e "\n\n${CROSS_MARK} ${RED}Error:${NC} Branch name '${BRANCH_NAME}' does not follow the naming convention.\n"
+	echo -e "${RED}Branch names must match the pattern:${NC} $BRANCH_NAME_REGEX"
+	echo -e "${RED}Do you use feature/fix/hotfix/chore/refactor/test/docs as a prefix?${NC}"
+	echo -e "${RED}Do you use only lowercase letters, numbers, dots, and hyphens in the branch name?${NC}"
+	echo -e "${RED}You can rename your branch by running:${NC} git branch -m <new-branch-name>\n\n"
+	exit 1
+fi
+
+echo -e "\n\n${CHECK_MARK} ${GREEN}Branch name '${BRANCH_NAME}' is valid.${NC}\n\n"

git_cai_cli-0.1.0/.linters/lychee.toml

@@ -0,0 +1,18 @@
+# Accepts log level: "error", "warn", "info", "debug", "trace"
+verbose = "info"
+
+# Don't show interactive progress bar while checking links.
+no_progress = true
+
+accept = ["200", "429"]
+
+exclude = [
+    "https://megalinter.io/configuration/",
+    "file:///tmp/lint/dwh/models/logo.png"
+    ]
+
+exclude_path = [
+    "logs",
+    "megalinter-reports",
+    ".venv",
+    ]

git_cai_cli-0.1.0/.linters/pyrightconfig.json

@@ -0,0 +1,5 @@
+{
+  "reportMissingImports": "none",
+  "reportMissingModuleSource": "none",
+  "reportMissingTypeStubs": "none"
+}

git_cai_cli-0.1.0/.mega-linter.yml

@@ -0,0 +1,72 @@
+# Configuration file for MegaLinter
+# See all available variables at https://megalinter.io/configuration/
+# and in linters documentation
+
+APPLY_FIXES: none # all, none, or list of linter keys
+BASH_SHELLCHECK_ARGUMENTS: -e "SC2162"
+CLEAR_REPORT_FOLDER: true
+DISABLE_ERRORS: false
+ENABLE_LINTERS:
+  - BASH_EXEC
+  - BASH_SHELLCHECK
+  - BASH_SHFMT
+  - JSON_JSONLINT
+  - JSON_PRETTIER
+  - JSON_V8R
+  - MAKEFILE_CHECKMAKE
+  - MARKDOWN_MARKDOWNLINT
+  - MARKDOWN_MARKDOWN_LINK_CHECK
+  - MARKDOWN_MARKDOWN_TABLE_FORMATTER
+  - PYTHON_BLACK
+  - PYTHON_BANDIT
+  - PYTHON_FLAKE8
+  - PYTHON_ISORT
+  - PYTHON_MYPY
+  - PYTHON_PYLINT
+  - PYTHON_PYRIGHT
+  - PYTHON_RUFF
+  - PYTHON_RUFF_FORMAT
+  - REPOSITORY_CHECKOV
+  - REPOSITORY_GITLEAKS
+  - REPOSITORY_KICS
+  - REPOSITORY_LS_LINT
+  - REPOSITORY_SECRETLINT
+  - REPOSITORY_SEMGREP
+  - REPOSITORY_TRIVY
+  - REPOSITORY_TRUFFLEHOG
+  - SPELL_LYCHEE
+  - SPELL_PROSELINT
+  - YAML_PRETTIER
+  - YAML_V8R
+  - YAML_YAMLLINT
+FAIL_IF_UPDATED_SOURCES: false
+FILEIO_REPORTER: false
+FILTER_REGEX_EXCLUDE: none
+FLAVOR_SUGGESTIONS: false
+FORMATTERS_DISABLE_ERRORS: false
+IGNORE_GITIGNORED_FILES: true
+LINTER_RULES_PATH: .linters
+LOG_LEVEL: INFO
+MARKDOWN_DEFAULT_STYLE: markdownlint
+MARKDOWN_MARKDOWN_LINK_CHECK_RULES_PATH: .linters
+PARALLEL: true
+PRINT_ALPACA: false
+PYTHON_BANDIT_RULES_PATH: .linters
+PYTHON_BANDIT_CONFIG_FILE: .bandit.yml
+PYTHON_FLAKE8_RULES_PATH: .linters
+REPOSITORY_LS_LINT_RULES_PATH: .linters
+REPOSITORY_SEMGREP_RULESETS:
+  [
+    "p/comment",
+    "p/cwe-top-25",
+    "p/docker-compose",
+    "p/dockerfile",
+    "p/owasp-top-ten",
+    "p/python",
+    "p/r2c-security-audit",
+    "p/secure-defaults",
+  ]
+SHOW_ELAPSED_TIME: true
+SHOW_SKIPPED_LINTERS: false
+SPELL_PROSELINT_RULES_PATH: .linters
+SPELL_VALE_RULES_PATH: .linters

git_cai_cli-0.1.0/.semgrepignore

@@ -0,0 +1 @@
+.devcontainer/Dockerfile

git_cai_cli-0.1.0/.trivyignore

@@ -0,0 +1,2 @@
+CVE-2024-12797
+CVE-2025-27516

git_cai_cli-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Thorsten Foltz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

git_cai_cli-0.1.0/Makefile

@@ -0,0 +1,47 @@
+#!/usr/bin/make -f
+
+PIP := pipx
+UV := uv
+SHELL := /bin/bash
+
+.PHONY: help lint check-docker check-npx lint-fix add-lint-hook clean
+
+help: ## Shows this help message
+	@echo "Available commands:"
+	@awk '/^[a-zA-Z_-]+:.*## / { printf "  %-20s %s\n", $$1, substr($$0, index($$0, "##") + 3) }' $(MAKEFILE_LIST)
+
+add-lint-hook: ## Adds a git pre-push hook to automatically run 'lint' before pushing
+	@echo "#!/bin/bash" > .git/hooks/pre-push
+	@echo "make lint" >> .git/hooks/pre-push
+	@chmod +x .git/hooks/pre-push
+	@echo "Pre-push hook added. The 'lint' command will now run before each push."
+
+check-docker: ## Checks if docker is installed
+	@if ! command -v docker &> /dev/null; then \
+		echo "Docker is not installed. Please install it."; \
+		exit 1; \
+	else \
+		echo "Docker version:"; \
+		docker --version; \
+	fi
+
+check-npx: ## Checks if npx is installed
+	@if ! command -v npx &> /dev/null; then \
+		echo "npx is not installed. Please install it."; \
+		exit 1; \
+	else \
+		echo "npx version:"; \
+		npx --version; \
+	fi
+
+clean: ## Clean cache of uv and delete virtual environment
+	@$(UV) cache clean
+	@rm -rf .venv
+
+
+lint:
+	@sh ./.linters/check_git_branch_name.sh
+	@npx mega-linter-runner	--flavor python
+
+lint-fix: ## Lints the code using sqlfluff and fixes the issues
+	@npx mega-linter-runner --fix

git_cai_cli-0.1.0/PKG-INFO

@@ -0,0 +1,104 @@
+Metadata-Version: 2.4
+Name: git-cai-cli
+Version: 0.1.0
+Summary: Use LLM to create git commits
+Author-email: Thorsten Foltz <thorsten.foltz@live.com>
+License: MIT
+Project-URL: Homepage, https://github.com/thorstenfoltz/cai
+Project-URL: Issues, https://github.com/thorstenfoltz/cai/issues
+Keywords: Git,LLM,Commit,AI,GenAI
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Version Control
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: openai>=1.0
+Requires-Dist: google-genai>=1.41.0
+Dynamic: license-file
+
+# cai
+
+`cai` is a Git extension written in Python that automates commit message creation. It allows you to run `git cai` to automatically generate a commit message based on changes and new additions in your repository.  
+
+`cai` leverages a **large language model (LLM)** to generate meaningful and context-aware commit messages. Currently, it supports the **OpenAI** and **Gemini API** for generating commit messages.
+
+## Table of Contents
+
+- [About](#about-section)
+- [Prerequisites](#prerequisites)
+- [Features](#features-section)
+- [Installation](#installation-section)
+- [Usage](#usage-section)
+- [License](#license-section)
+
+<h2 id="about-section">About</h2>
+
+`cai` is designed to simplify your Git workflow by automatically generating commit messages using an LLM. No more struggling to summarize changes — `git cai` does it for you.  
+
+Currently, the only supported backend are the OpenAI and Gemini API, but additional LLM integrations may be added in the future.
+
+<h2 id="prerequisites">Prerequisites</h2>
+
+- Python 3.10 or higher
+- [Pipx](https://pypi.org/project/pipx/) or [Pip](https://pypi.org/project/pip/) if installed in a virtual environment
+- API key, currently supported
+  - OpenAI
+  - Gemini
+
+<h2 id="features-section">Features</h2>
+
+- Automatically detects added, modified, and deleted files
+- Generates meaningful commit messages using an LLM
+- Seamless integration with Git as a plugin/extension
+- Written in Python for easy customization
+
+<h2 id="installation-section">Installation</h2>
+
+Install by
+
+```sh
+pipx install git-cai-cli
+```
+
+Afterwards set cai to PATH by
+
+```sh
+pipx ensurepath
+```
+
+Restart your shell by executing `bash` or `zsh` or whatever else is your used shell.
+
+<h2 id="usage-section">Usage</h2>
+
+Once installed, you can use `cai` like a normal Git command:
+
+```sh
+git cai
+```
+
+`cai` automatically creates a configuration file at: `~/.config/cai/token.yml`
+This file stores your OpenAI API key, which is used every time you run `git cai`.
+Open `~/.config/cai/token.yml` and store your token from OpenAI.
+If a `cai_config.yml` file exists in the root of your repository, `cai` will use the settings defined there. Otherwise, it falls back to default settings, which are automatically created in the same directory as `token.yml` if they don’t already exist.
+Currently, the only configurable options are:
+
+- LLM model
+- Temperature
+
+`cai` uses Git’s `diff` output as input for generating commit messages.  
+To exclude specific files or directories from being included in the generated commit message, create a `.caiignore` file in the root of your repository. This file works like a `.gitignore`.  
+
+- Files listed in `.gitignore` are **always excluded**.  
+- `.caiignore` is only needed for files that are tracked by Git but should **not** be included in the commit message.
+
+<h2 id="license-section">License</h2>
+This project is licensed under the MIT License.

git_cai_cli-0.1.0/PKGBUILD

@@ -0,0 +1,36 @@
+# Maintainer: Thorsten Foltz <thorsten.foltz@live.com>
+pkgname=cai
+pkgver=0.1.0
+pkgrel=1
+pkgdesc="Use LLM to create git commit messages."
+arch=('any')
+license=('MIT')
+depends=('python' 'python-pip' 'python-yaml' 'python-openai')
+source=()
+sha256sums=()
+
+build() {
+    # Create a clean staging directory
+    mkdir -p "$srcdir/$pkgname-$pkgver"
+
+    # Copy only project files, skip makepkg internals
+    for f in "$startdir"/*; do
+        case "$(basename "$f")" in
+            src|pkg) ;;  # skip makepkg working dirs
+            *) cp -r "$f" "$srcdir/$pkgname-$pkgver"/ ;;
+        esac
+    done
+
+    cd "$srcdir/$pkgname-$pkgver"
+
+    # Optional: build a wheel (can skip, pip install . works too)
+    python -m pip wheel . --wheel-dir "$srcdir/dist"
+}
+
+package() {
+    cd "$srcdir/$pkgname-$pkgver"
+
+    # Install the package system-wide in staged dir
+    # This ensures console scripts go to /usr/bin
+    python -m pip install --root="$pkgdir" --prefix=/usr .
+}