committhis is a streamlined AI-Augmented Git commit message tool, built for speed and semantic clarity. It uses OpenAI to analyze your changes and generate intelligent, well-formatted commit messages — so you can stay focused on writing code, not prose.
🧠 Derived from the full-featured MAIASS script, committhis is stripped down to do one thing extremely well: suggest commit messages based on your code diff.
- 🔍 Analyzes your staged changes
- 🧠 Uses OpenAI (GPT-4o by default) to suggest commit messages
- ✍️ Outputs messages in configurable styles:
bullet(default)conventionalsimple- Custom prompt support
- ⌨️ Supports multi-line editing before committing
- 🧩 Works in any Git repo — just drop it in
You can install committhis via Homebrew:
brew tap vsmash/committhis
brew install committhisOr manually:
curl -o /usr/local/bin/committhis https://raw.githubusercontent.com/vsmash/committhis/main/committhis.sh
chmod +x /usr/local/bin/committhiscommitthiscommitthis will:
- Detect your staged changes
- Ask if you want AI to suggest a commit message
- Display the message
- Let you accept, reject, or edit it
- Commit your changes
It will not bump versions, merge branches, or update changelogs.
Set your OpenAI key and preferences via environment variables or a .env file in the repo root:
export MAIASS_AI_TOKEN=your-api-key
export MAIASS_AI_MODE=ask
export MAIASS_AI_COMMIT_MESSAGE_STYLE=bulletAlternatively, create a .env file:
MAIASS_AI_TOKEN=your-api-key
MAIASS_AI_MODE=autosuggest
MAIASS_AI_COMMIT_MESSAGE_STYLE=conventionalWant full control over the AI prompt?
Create a .maiass.prompt file:
Write a git commit message summarizing the following changes in conventional commit format. Use past tense.
Git diff:
$git_diffYou'll need an OpenAI API key. You can generate one from https://platform.openai.com/account/api-keys and export it as:
export MAIASS_AI_TOKEN=sk-...This version does not:
- Handle changelogs
- Manage versions
- Create or merge branches
- Require Git Flow
It's a focused tool for intelligent commits — nothing more.
- MAIASS – the full-fat version with version management, changelogs, and release flow automation.
- committhis – this repo.
Licensed under the GNU GPL v3.0.
Made with ❤️ for my fellow developers who are also crap at writing commit messages and mangaging versioning and changelogs
When this tool saves your ass, consider sponsoring mine:
