CommiZard

CommiZard is an interactive commit assistant, powered by AI! 🧙‍♂️ Generate, tweak, and copy commit messages with full control, right from a REPL.

Features

• REPL-style Interface: Stay in an interactive session. Generate multiple commit variations without restarting.
• Smart Generation: Creates commit messages directly from your git diff.
• Simple CLI: Familiar, intuitive commands. No learning curve.
• Flexible AI backends: Easily swap models. Online model support planned!
• Clipboard Magic: Instantly copy generated messages to your system clipboard, ready to paste into git commit.
• Zero Daemons: No background processes, No Git hooks, no surprises.
• Absolute Control: Run it when you want, and you decide to commit, copy, tweak, or discard.

[!WARNING]

⚠️ Heads up! CommiZard is in alpha development. Not all features are complete or stable yet.

CommiZard is under active development. Expect bugs, crashes, and missing functionality. Please open an issue if you encounter problems.

Many features are still missing, since this project was released as a Minimum Viable Product (MVP). Stay tuned for new improvements!

⚙️ Installation

There are several ways to install this tool. Here are the most common approaches:

1. The easiest way to get started is with pip:

pip install commizard

[!TIP] Use pipx to install in an isolated environment and avoid dependency conflicts.

2. If you want the latest development version (bleeding-edge), clone the repo and install in editable mode:

git clone https://github.com/Chungzter/CommiZard
cd CommiZard
pip install -e .

You can update anytime with:

git pull && pip install -e .

3. You can also build from source yourself (e.g., with build or hatchling):

git clone https://github.com/Chungzter/CommiZard
cd CommiZard
python -m build
# or: hatchling build
pip install dist/commizard-*-py3-none-any.whl

Usage

After installing CommiZard (See Installation), you can launch the interactive REPL in your Git repository:

commizard

You can also use -h or --help to see the available options.

Once launched, you’ll enter the interactive CommiZard terminal, where you can use the following commands:

Commands

Command	Description
help	Show all commands or details for a specific one.
start <model>	select a particular model to generate for you.
list	List all available Ollama models installed on your system.
gen	Generate a new commit message based on the current Git diff.
cp	Copy the generated output to your clipboard
commit	Directly commit the generated output
cls or clear	Clear the terminal screen
exit or quit	Exit the REPL session.

Example Usage

This is one of the very first times the program helped a user (me 😄) write a meaningful commit message.

🧭 Alternatives & Similar Tools

When I started building CommiZard, I made sure to look around. Guess what?

CommiZard isn’t the only wizard in town! 😊

If you’re exploring AI-powered commit tools, here are some other great projects worth checking out:

• easycommit: written in Go, supports Ollama models out of the box.
• aicommit: Packed with features — including a handy VS Code extension.
• AICommit2: The most complete FOSS option I've found

Why did I still follow through and build this?

Because I couldn’t find a tool that gave me both full user control and the little UX comforts I wanted.

So yeah. I built CommiZard for me… and maybe for you too!

Contributing

Contributions of all kinds are welcome.

If you’d like to get involved:

• Read the CONTRIBUTING.md guide for details on how to report bugs, suggest features, or open pull requests.
• Found a bug 🐞 or have an idea 💡? Open an issue and let’s discuss it!
• Starter-friendly tasks are listed in the Starter Tasks section. Check it out if you’re not ready to dive into core features yet.

Not sure where to start? Open an issue or comment "I’d like to help with this," and we’ll figure it out together!

License

CommiZard is released under the MIT license.

Copyright (c) 2025 Chungzter