claude-commit 0.1.0__tar.gz

claude_commit-0.1.0/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 claude-commit contributors
+
+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.
+

claude_commit-0.1.0/PKG-INFO

@@ -0,0 +1,292 @@
+Metadata-Version: 2.4
+Name: claude-commit
+Version: 0.1.0
+Summary: AI-powered git commit message generator using Claude Agent SDK
+Author-email: Johannlai <johannli666@gmail.com>
+License: MIT
+Keywords: git,commit,ai,claude,automation
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: claude-agent-sdk>=0.1.0
+Requires-Dist: click>=8.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: pyperclip>=1.8.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Dynamic: license-file
+
+# claude-commit
+
+🤖 AI-powered git commit message generator using Claude Agent SDK and Claude Code CLI
+
+## What is this?
+
+`claude-commit` uses Claude AI to analyze your code changes and write meaningful commit messages. Claude reads your files, understands the context, and generates commit messages following best practices.
+
+## Quick Start
+
+**Install:**
+```bash
+pip install claude-commit
+
+# Required dependency
+npm install -g @anthropic-ai/claude-code
+```
+
+**Use:**
+```bash
+git add .
+claude-commit --commit
+```
+
+That's it! Claude will analyze your changes and create a commit.
+
+## Installation
+
+### Prerequisites
+
+- Python 3.10+
+- Node.js
+- Git
+
+### Install Steps
+
+```bash
+# 1. Install Claude Code CLI (required)
+npm install -g @anthropic-ai/claude-code
+
+# 2. Install claude-commit
+pip install claude-commit
+
+# Or use pipx for isolation
+pipx install claude-commit
+```
+
+### Authentication
+
+`claude-commit` supports two ways to authenticate with Claude:
+
+**Option 1: [Official Claude Code Login](https://docs.claude.com/en/docs/claude-code/quickstart#step-2%3A-log-in-to-your-account) (Recommended)**
+
+**Option 2: Custom API Endpoint (Environment Variables)**
+
+For custom Claude API endpoints or proxies, set these environment variables:
+
+```bash
+# Required: Set custom endpoint and credentials
+export ANTHROPIC_BASE_URL="https://your-endpoint.com/api/v1"
+export ANTHROPIC_AUTH_TOKEN="your-auth-token"
+
+# Optional: Specify custom model name
+export ANTHROPIC_MODEL="your-model-name"
+
+# Then use claude-commit normally
+claude-commit --commit
+```
+
+Add these to your `~/.zshrc` or `~/.bashrc` to persist across sessions.
+
+## Usage
+
+### Basic Commands
+
+```bash
+# Generate commit message (default: staged changes only)
+claude-commit
+
+# Auto-commit with generated message
+claude-commit --commit
+
+# Include all changes (staged + unstaged)
+claude-commit --all
+
+# Copy message to clipboard
+claude-commit --copy
+```
+
+### Common Options
+
+| Option               | Description                        |
+| -------------------- | ---------------------------------- |
+| `-a, --all`          | Include unstaged changes           |
+| `-c, --commit`       | Auto-commit with generated message |
+| `--copy`             | Copy message to clipboard          |
+| `--preview`          | Preview message only               |
+| `-v, --verbose`      | Show detailed analysis             |
+| `-p, --path PATH`    | Specify repository path            |
+| `--max-diff-lines N` | Limit diff lines (default: 500)    |
+
+## Aliases
+
+Create shortcuts for common commands:
+
+### Install Shell Aliases
+
+```bash
+# Install to your shell config
+claude-commit alias install
+
+# Activate in current terminal
+source ~/.zshrc    # zsh
+source ~/.bashrc   # bash
+```
+
+### Default Aliases
+
+| Alias   | Command                        | Description         |
+| ------- | ------------------------------ | ------------------- |
+| `ccc`   | `claude-commit --commit`       | Quick commit        |
+| `ccp`   | `claude-commit --preview`      | Preview message     |
+| `cca`   | `claude-commit --all`          | Include all changes |
+| `ccac`  | `claude-commit --all --commit` | Commit all changes  |
+| `ccopy` | `claude-commit --copy`         | Copy to clipboard   |
+
+After installation, just use:
+```bash
+git add .
+ccc  # analyzes and commits
+```
+
+### Custom Aliases
+
+```bash
+# Create your own aliases
+claude-commit alias set quick --all --commit
+claude-commit alias list
+claude-commit alias unset quick
+```
+
+## How It Works
+
+Claude autonomously analyzes your changes:
+
+1. **Reads** your modified files to understand context
+2. **Searches** the codebase for related code
+3. **Understands** the intent and impact of changes
+4. **Generates** a clear commit message following conventions
+
+**Example:**
+```
+feat: add JWT authentication
+
+Implement secure authentication system with token refresh.
+Includes login, logout, and session management.
+```
+
+## Examples
+
+### Typical Workflow
+
+```bash
+# Make changes
+git add .
+
+# Preview message
+claude-commit --preview
+
+# Commit if satisfied
+claude-commit --commit
+```
+
+### With Aliases
+
+```bash
+# Make changes
+git add .
+
+# Quick commit
+ccc
+```
+
+### Large Changes
+
+```bash
+# Limit analysis for faster results
+claude-commit --max-diff-lines 200 --commit
+```
+
+## Configuration
+
+Configuration files:
+- Aliases: `~/.claude-commit/config.json`
+- Shell integration: `~/.zshrc`, `~/.bashrc`, or `$PROFILE`
+
+## Platform Support
+
+| Platform | Status | Shells               |
+| -------- | ------ | -------------------- |
+| macOS    | ✅      | zsh, bash, fish      |
+| Linux    | ✅      | bash, zsh, fish      |
+| Windows  | ✅      | PowerShell, Git Bash |
+
+**Windows PowerShell** first-time setup:
+```powershell
+Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
+```
+
+## Troubleshooting
+
+**Claude Code not found?**
+```bash
+npm install -g @anthropic-ai/claude-code
+```
+
+**No changes detected?**
+```bash
+git add .              # stage changes
+# or
+claude-commit --all    # include unstaged
+```
+
+**Analysis too slow?**
+```bash
+claude-commit --max-diff-lines 200
+```
+
+## Development
+
+```bash
+# Clone and setup
+git clone https://github.com/yourusername/claude-commit.git
+cd claude-commit
+python -m venv venv
+source venv/bin/activate
+pip install -e ".[dev]"
+
+# Run tests
+pytest tests/
+```
+
+## Contributing
+
+Contributions welcome! Please:
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Submit a Pull Request
+
+## License
+
+MIT License - see [LICENSE](LICENSE) file
+
+## Links
+
+- [Claude Agent SDK](https://docs.anthropic.com/en/docs/claude-code/agent-sdk)
+- [Conventional Commits](https://www.conventionalcommits.org/)
+- [Issue Tracker](https://github.com/yourusername/claude-commit/issues)
+
+---
+
+Made with ❤️ by [Johann Lai](https://x.com/programerjohann)

claude_commit-0.1.0/README.md

@@ -0,0 +1,263 @@
+# claude-commit
+
+🤖 AI-powered git commit message generator using Claude Agent SDK and Claude Code CLI
+
+## What is this?
+
+`claude-commit` uses Claude AI to analyze your code changes and write meaningful commit messages. Claude reads your files, understands the context, and generates commit messages following best practices.
+
+## Quick Start
+
+**Install:**
+```bash
+pip install claude-commit
+
+# Required dependency
+npm install -g @anthropic-ai/claude-code
+```
+
+**Use:**
+```bash
+git add .
+claude-commit --commit
+```
+
+That's it! Claude will analyze your changes and create a commit.
+
+## Installation
+
+### Prerequisites
+
+- Python 3.10+
+- Node.js
+- Git
+
+### Install Steps
+
+```bash
+# 1. Install Claude Code CLI (required)
+npm install -g @anthropic-ai/claude-code
+
+# 2. Install claude-commit
+pip install claude-commit
+
+# Or use pipx for isolation
+pipx install claude-commit
+```
+
+### Authentication
+
+`claude-commit` supports two ways to authenticate with Claude:
+
+**Option 1: [Official Claude Code Login](https://docs.claude.com/en/docs/claude-code/quickstart#step-2%3A-log-in-to-your-account) (Recommended)**
+
+**Option 2: Custom API Endpoint (Environment Variables)**
+
+For custom Claude API endpoints or proxies, set these environment variables:
+
+```bash
+# Required: Set custom endpoint and credentials
+export ANTHROPIC_BASE_URL="https://your-endpoint.com/api/v1"
+export ANTHROPIC_AUTH_TOKEN="your-auth-token"
+
+# Optional: Specify custom model name
+export ANTHROPIC_MODEL="your-model-name"
+
+# Then use claude-commit normally
+claude-commit --commit
+```
+
+Add these to your `~/.zshrc` or `~/.bashrc` to persist across sessions.
+
+## Usage
+
+### Basic Commands
+
+```bash
+# Generate commit message (default: staged changes only)
+claude-commit
+
+# Auto-commit with generated message
+claude-commit --commit
+
+# Include all changes (staged + unstaged)
+claude-commit --all
+
+# Copy message to clipboard
+claude-commit --copy
+```
+
+### Common Options
+
+| Option               | Description                        |
+| -------------------- | ---------------------------------- |
+| `-a, --all`          | Include unstaged changes           |
+| `-c, --commit`       | Auto-commit with generated message |
+| `--copy`             | Copy message to clipboard          |
+| `--preview`          | Preview message only               |
+| `-v, --verbose`      | Show detailed analysis             |
+| `-p, --path PATH`    | Specify repository path            |
+| `--max-diff-lines N` | Limit diff lines (default: 500)    |
+
+## Aliases
+
+Create shortcuts for common commands:
+
+### Install Shell Aliases
+
+```bash
+# Install to your shell config
+claude-commit alias install
+
+# Activate in current terminal
+source ~/.zshrc    # zsh
+source ~/.bashrc   # bash
+```
+
+### Default Aliases
+
+| Alias   | Command                        | Description         |
+| ------- | ------------------------------ | ------------------- |
+| `ccc`   | `claude-commit --commit`       | Quick commit        |
+| `ccp`   | `claude-commit --preview`      | Preview message     |
+| `cca`   | `claude-commit --all`          | Include all changes |
+| `ccac`  | `claude-commit --all --commit` | Commit all changes  |
+| `ccopy` | `claude-commit --copy`         | Copy to clipboard   |
+
+After installation, just use:
+```bash
+git add .
+ccc  # analyzes and commits
+```
+
+### Custom Aliases
+
+```bash
+# Create your own aliases
+claude-commit alias set quick --all --commit
+claude-commit alias list
+claude-commit alias unset quick
+```
+
+## How It Works
+
+Claude autonomously analyzes your changes:
+
+1. **Reads** your modified files to understand context
+2. **Searches** the codebase for related code
+3. **Understands** the intent and impact of changes
+4. **Generates** a clear commit message following conventions
+
+**Example:**
+```
+feat: add JWT authentication
+
+Implement secure authentication system with token refresh.
+Includes login, logout, and session management.
+```
+
+## Examples
+
+### Typical Workflow
+
+```bash
+# Make changes
+git add .
+
+# Preview message
+claude-commit --preview
+
+# Commit if satisfied
+claude-commit --commit
+```
+
+### With Aliases
+
+```bash
+# Make changes
+git add .
+
+# Quick commit
+ccc
+```
+
+### Large Changes
+
+```bash
+# Limit analysis for faster results
+claude-commit --max-diff-lines 200 --commit
+```
+
+## Configuration
+
+Configuration files:
+- Aliases: `~/.claude-commit/config.json`
+- Shell integration: `~/.zshrc`, `~/.bashrc`, or `$PROFILE`
+
+## Platform Support
+
+| Platform | Status | Shells               |
+| -------- | ------ | -------------------- |
+| macOS    | ✅      | zsh, bash, fish      |
+| Linux    | ✅      | bash, zsh, fish      |
+| Windows  | ✅      | PowerShell, Git Bash |
+
+**Windows PowerShell** first-time setup:
+```powershell
+Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
+```
+
+## Troubleshooting
+
+**Claude Code not found?**
+```bash
+npm install -g @anthropic-ai/claude-code
+```
+
+**No changes detected?**
+```bash
+git add .              # stage changes
+# or
+claude-commit --all    # include unstaged
+```
+
+**Analysis too slow?**
+```bash
+claude-commit --max-diff-lines 200
+```
+
+## Development
+
+```bash
+# Clone and setup
+git clone https://github.com/yourusername/claude-commit.git
+cd claude-commit
+python -m venv venv
+source venv/bin/activate
+pip install -e ".[dev]"
+
+# Run tests
+pytest tests/
+```
+
+## Contributing
+
+Contributions welcome! Please:
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Submit a Pull Request
+
+## License
+
+MIT License - see [LICENSE](LICENSE) file
+
+## Links
+
+- [Claude Agent SDK](https://docs.anthropic.com/en/docs/claude-code/agent-sdk)
+- [Conventional Commits](https://www.conventionalcommits.org/)
+- [Issue Tracker](https://github.com/yourusername/claude-commit/issues)
+
+---
+
+Made with ❤️ by [Johann Lai](https://x.com/programerjohann)

claude_commit-0.1.0/pyproject.toml

@@ -0,0 +1,54 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "claude-commit"
+version = "0.1.0"
+description = "AI-powered git commit message generator using Claude Agent SDK"
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+authors = [{ name = "Johannlai", email = "johannli666@gmail.com" }]
+keywords = ["git", "commit", "ai", "claude", "automation"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+]
+
+dependencies = [
+  "claude-agent-sdk>=0.1.0",
+  "click>=8.0.0",
+  "rich>=13.0.0",
+  "pyperclip>=1.8.0",
+]
+
+[project.optional-dependencies]
+dev = [
+  "pytest>=7.0.0",
+  "pytest-asyncio>=0.21.0",
+  "black>=23.0.0",
+  "mypy>=1.0.0",
+]
+
+[project.scripts]
+claude-commit = "claude_commit.main:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.black]
+line-length = 100
+target-version = ['py39']
+
+[tool.mypy]
+python_version = "3.9"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = false

claude_commit-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

claude_commit-0.1.0/src/claude_commit/__init__.py

@@ -0,0 +1,12 @@
+"""
+claude-commit - AI-powered git commit message generator
+"""
+
+__version__ = "0.1.0"
+__author__ = "Your Name"
+__license__ = "MIT"
+
+from .main import generate_commit_message, main
+
+__all__ = ["generate_commit_message", "main"]
+