🧠 No-Shit-Commit-Messages

Stop writing shitty commit messages.
Just run git commit -m "" — we’ll handle generating a nice commit message.

Uses GPT-5-mini currently.

🚀 Install

brew tap Musti7even/no-shit-commit-messages
brew install no-shit-commit-messages
export OPENAI_API_KEY=sk-...
alias git='nscm'

---

💡 Usage

git add .
git commit -m ""        # → AI generates commit message
git commit -m "manual"  # → still behaves normally, to give you max freedom
git commit               # → opens editor as usual

Example output:

🧠 Generating commit message…
💬 "feat(ui): improve layout responsiveness on profile page"

 2 files changed, 10 insertions(+), 3 deletions(-)

---

⚙️ Configuration

Optional ~/.nscmrc:

provider: openai
model: gpt-5-mini-2025-08-07
style: conventional

Environment variables override the config file:

• NSCM_PROVIDER — provider to use (default: openai)
• NSCM_MODEL — model identifier (default: gpt-5-mini-2025-08-07)
• NSCM_STYLE — style hint (default: conventional)
• OPENAI_API_KEY — required when provider is openai

---

🛠️ Development

Project layout:

no-shit-commit-messages/
├─ nscm.py
├─ brew/
│  └─ no-shit-commit-messages.rb
├─ README.md
├─ LICENSE
└─ .github/workflows/release.yml

Run locally without Homebrew:

export OPENAI_API_KEY=sk-...
python3 ./nscm.py commit -m ""

---

🧭 Roadmap

• Ollama or even faster model providers
• additional context for better commit messages
• Optional interactive confirmation
• --dry-run previews
• Submit to Homebrew core once stable

---

MIT © 2025 / Mustafa Yenler