Python 3.12+MIT licensev0.1.0 Beta
hunknote

Commit messages,
perfected by AI.

Hunknote transforms messy working trees into clean, atomic commit stacks. Stop writing "wip" and let AI generate semantic, structured messages for you.

Get Started
curl -fsSL hunknote.com/install.sh | bash
The Killer Feature

Split messy work into
atomic commits.

Developers often accumulate unrelated changes. Manually splitting them is tedious.

Compose Mode analyzes your entire diff, understands logical boundaries, and creates a clean stack of atomic commits automatically.

  • Analyzes semantic relationships between files
  • Generates focused messages for each split
  • Handles mixed refactors, features, and fixes
  • Preview the plan before executing
Learn more about Compose Mode →
hunknote compose
Your Messy Working Tree
M src/auth.py
M src/api.py
? tests/test_auth.py
M README.md
A src/utils/hash.py
Compose Plan
C1: feat(auth)
Add secure password hashing
C2: fix(api)
Handle null responses in auth
C3: test
Add auth unit tests
C4: docs
Update API documentation
Analyzing diff... 4 files, 12 hunksReady to execute

Everything you need for a modern workflow

Designed for developers who care about their git history but don't want to spend hours maintaining it.

Multi-LLM Support

Use Anthropic, OpenAI, Gemini, Mistral, Cohere, Groq, or OpenRouter with a consistent UX.

Repo-Aware Defaults

Automatic scope inference, per-repo style profiles, and smart caching keep your workflow smooth.

Structured Output

Strict JSON generation ensures clean titles and bullet points, formatted exactly how you want.

Style Profiles

Choose from Conventional, Blueprint, Ticket-prefixed, Kernel-style or create your own.

Intent Channel

Guide the AI with human context ('Fix race condition') while letting it handle the technical details.

Merge Detection

Automatically detects merge states and generates semantic descriptions for merge commits.

# 1. Stage your changes
git add src/auth.py src/api.py

# 2. Generate a logical commit
hunknote --style conventional

# Output:
# feat(auth): Add secure password hashing
#
# - Implement Argon2 hashing for user passwords
# - Update login endpoint to verify hashes
# - Add migration for existing users
#
# (Opens in your editor for final review)

Fits your workflow,
not the other way around.

Hunknote operates as a simple CLI tool or git subcommand. It opens your configured editor, lets you review, and commits only when you're ready.

1

Intelligent Context

Reads your staged diff, branch name, and recent history.

2

Human-in-the-loop

Generated messages open in your editor (`$EDITOR` or config).

3

Zero Lock-in

It's just text. Edit it, discard it, or commit it.

Ready to clean up your git history?

Join developers who are saving hours every week by letting AI handle the grunt work of commit messages.

Open source under MIT License. Bring your own API keys.