Smart Commit：一個保留在 CLI 中的 AI 輔助 Git Commit 工作流程

Navigation Menu

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

To see all available qualifiers, see our documentation.

Generate clean, consistent git commit messages using AI. Preview before commit, extract issue keys from branches, zero magic.

License

Uh oh!

There was an error while loading. Please reload this page.

vicc/smart-commit

Folders and files

Latest commit

History

Repository files navigation

Introducing Smart Commit ✨

CLI-first AI commit messages. Git stays in the terminal.

Smart Commit uses AI to write clean, consistent, and professional commit messages so you can stay in flow. 🌊

🚀 Quickstart

Get up and running in seconds. No complex configuration required.

⚡️ Why Smart Commit?

Whether you are vibe coding a side project or shipping production systems, Smart Commit keeps your Git history clean across iOS, frontend, backend, and everything in between.

It works just as well for Swift, JavaScript, Python, Go, Rails, infra repos, or monorepos 🫠.

🛠 How It Works

Smart Commit acts as a smart wrapper around your staging and committing process:

The Result:
✨ PROJ-123: Add intelligent retry logic to API client

💫 Features

🔧 Multi-Provider Support

🎯 Issue Tracking Integration

🛡️ Safe & Flexible

⚡️ Easy Setup & Management

📦 Installation Options

⚙️ Initial Setup

The first time you run git smart-commit, a friendly wizard will help you:

Need to change something later?

🎮 Usage Guide

🎨 The Emoji Guide

We follow a consistent style to make your git log look like a work of art:

🤝 Contributing

Got an idea to make it even better? Feel free to open an issue or submit a PR!

Philosophy: Good commit history is a love letter to future you or rather less of a FU to future you. 💌

FAQ

How much does it cost?

Smart Commit itself is free and open source. You'll need an API key for cloud LLM providers:

Is my code sent to an LLM?

Only file names and diff summaries are sent - not your actual code content. Smart Commit uses git diff --name-status to see what changed, which shows:

The LLM sees file names and change types (Modified, Added, Deleted), never your source code.

Can I use this with private repositories?

Yes! Since only file names are sent (not code), it's safe for private repos. For extra security, use Ollama with local models.

How do I switch LLM providers?

Run the setup wizard again:

Or manually:

Can I customize the commit message format?

Currently, the format is fixed (emoji + subject + optional bullets). You can:

Does this work with conventional commits?

The emoji-based format is different from conventional commits (feat:, fix:, etc.). The emojis serve a similar purpose but are more visual. You can manually edit messages to conventional commit format using -e.

What happens if the LLM is down or slow?

Can I use this in CI/CD?

Not recommended. Smart Commit is designed for interactive use with preview/confirmation. For CI/CD, write commit messages in your scripts.

How do I update to the latest version?

npm:

Homebrew:

Where is my API key stored?

API keys are stored by the llm tool in ~/.config/llm/keys.json. They're never sent anywhere except to your chosen LLM provider.

Can I use multiple API keys?

The llm tool supports one key per provider. To switch between accounts, run llm keys set <provider> to overwrite the stored key.

What if I want to commit without an LLM?

Just use regular git commands:

Smart Commit is optional - it doesn't replace or modify git's behavior.

📝 License

MIT © Vicc Alexander 2026

About

Generate clean, consistent git commit messages using AI. Preview before commit, extract issue keys from branches, zero magic.

Resources

License

Uh oh!

There was an error while loading. Please reload this page.

Stars

Watchers

Forks

Releases

  4

Packages

  0

Languages

Footer

Footer navigation