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. 🌊

Screenshot 2026-01-06 at 3 07 22 PM

---

🚀 Quickstart

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

``bash

`1. Install globally`


npm install -g @viccalexander/smart-commit
2. Run it (first time walks you through setup)

git smart-commit


---
⚡️ 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 🫠.
* 🧠 Context-Aware: Understands your changes using LLMs.
* 🏷️ Auto-Tagging: Grabs Linear/Jira issue keys from your branch names automatically.
* 🎨 Scannable: Prepends emojis for a visual, readable history.
* 🛠️ Zero Ceremony: No pre-commit hooks or "standard-version" headaches.
---
🛠 How It Works
Smart Commit acts as a smart wrapper around your staging and committing process:
1. Scans your staged changes (or helps you stage them).
2. Analyzes the diff to understand the intent of the code.
3. Drafts a perfect commit message with an emoji and issue key.
4. Asks for your vibe check—approve, edit, or cancel.
> The Result:
> ✨ PROJ-123: Add intelligent retry logic to API client
> - Implemented exponential backoff
> - Added circuit breaker pattern
---
💫 Features
$3

- OpenAI - GPT-5, GPT-4 models
- Anthropic - Claude 4.5 (Sonnet, Opus, Haiku)
- Google - Gemini 3 Flash/Pro
- Ollama - Local models (Llama, Mistral, CodeLlama, etc.)
- Custom models - Easy model switching
$3

- Auto-detects issue keys from branch names (e.g.,

vicc-123

)
- Linear-friendly - Works with Linear's branch naming
- Any issue tracker - Supports any

prefix-number

 format
$3

- Preview first - See the message before committing
- Edit mode - Tweak messages before committing (

-e

 flag)
- Auto-commit - Fast path when you trust it (

-y

 flag)
- Dry run - Test without committing (

--dry-run

)
$3

- Interactive wizard - One-time setup, auto-installs dependencies
- Multiple commands -

git smart-commit or smart-commit


- Built-in help -

--help

 flag for documentation
- Easy uninstall -

--uninstall

 with smart detection
---
📦 Installation Options

---

`⚙️ Initial Setup`

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

1. Set up the llmCLI tool (automatic). 2. Connect OpenAI or Anthropic. 3. Enter your API key. 4. Select a model (e.g.,gpt-4o-mini or claude-3-haiku).

Need to change something later?

`bash smart-commit --setup`

---

`🤖 Codex skill:` /smart-commit

Use smart-commit inside Codex CLI without keeping this repo around.

Install:

`bash git clone https://github.com/vicc/smart-commit.git cd smart-commit codex skills install dist/smart-commit.skill`

Use:

- Stage your changes (git add ...) in any git repo. - Open Codex CLI and run/smart-commit. - Copy the message or ask Codex togit commit -m "".

Once installed, you can delete the repo—the skill stays available in Codex. Releases also include the .skill file for direct download.

---

`🎮 Usage Guide`

---

`🎨 The Emoji Guide`

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

* ✨ Feature: New functionality * 🐛 Fix: Squashing bugs * ♻️ Refactor: Code improvements (non-breaking) * 🎨 UI: Changes to the look and feel * 🔥 Cleanup: Removing code or files * ⚡️ Perf: Improving performance * 📝 Docs: Documentation changes

---

`🤝 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`

`$3`

Smart Commit itself is free and open source. You'll need an API key for cloud LLM providers: - OpenAI - Pay-per-use (GPT-4o-mini is ~$0.01 per commit) - Anthropic - Pay-per-use (similar pricing) - Google - Pay-per-use (Gemini has free tier) - Ollama - Completely free (runs locally)

`$3`

Only file names and diff summaries are sent - not your actual code content. Smart Commit uses git diff --name-statusto see what changed, which shows:`M src/components/Button.tsx A src/utils/helpers.ts`

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

`$3`

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

`$3`

Run the setup wizard again:`bash smart-commit --setup`

Or manually:`bash llm keys set openai # Switch provider llm models default gpt-4o # Change model`

`$3`

Currently, the format is fixed (emoji + subject + optional bullets). You can: - Use-eflag to edit messages before committing - Use--dry-runto preview and copy messages - Change models for different writing styles

`$3`

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.

`$3`

- OpenAI/Anthropic/Gemini down: The commit fails with an error. Fix connectivity or switch to Ollama. - Slow API: The tool waits for a response (usually 2-5 seconds). Use-yflag to speed up workflow once you trust the output. - Offline: Use Ollama with local models - works completely offline.

`$3`

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

`$3`

npm:`bash npm update -g @viccalexander/smart-commit`

Homebrew:`bash brew update brew upgrade smart-commit`

`$3`

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

`$3`

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

`$3`

Just use regular git commands:`bash git add . git commit -m "Your message"``

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

---

📝 License

MIT © Vicc Alexander 2026

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. 🌊

Screenshot 2026-01-06 at 3 07 22 PM

---

🚀 Quickstart

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

``bash

`1. Install globally`


npm install -g @viccalexander/smart-commit
2. Run it (first time walks you through setup)

git smart-commit


---
⚡️ 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 🫠.
* 🧠 Context-Aware: Understands your changes using LLMs.
* 🏷️ Auto-Tagging: Grabs Linear/Jira issue keys from your branch names automatically.
* 🎨 Scannable: Prepends emojis for a visual, readable history.
* 🛠️ Zero Ceremony: No pre-commit hooks or "standard-version" headaches.
---
🛠 How It Works
Smart Commit acts as a smart wrapper around your staging and committing process:
1. Scans your staged changes (or helps you stage them).
2. Analyzes the diff to understand the intent of the code.
3. Drafts a perfect commit message with an emoji and issue key.
4. Asks for your vibe check—approve, edit, or cancel.
> The Result:
> ✨ PROJ-123: Add intelligent retry logic to API client
> - Implemented exponential backoff
> - Added circuit breaker pattern
---
💫 Features
$3

- OpenAI - GPT-5, GPT-4 models
- Anthropic - Claude 4.5 (Sonnet, Opus, Haiku)
- Google - Gemini 3 Flash/Pro
- Ollama - Local models (Llama, Mistral, CodeLlama, etc.)
- Custom models - Easy model switching
$3

- Auto-detects issue keys from branch names (e.g.,

vicc-123

)
- Linear-friendly - Works with Linear's branch naming
- Any issue tracker - Supports any

prefix-number

 format
$3

- Preview first - See the message before committing
- Edit mode - Tweak messages before committing (

-e

 flag)
- Auto-commit - Fast path when you trust it (

-y

 flag)
- Dry run - Test without committing (

--dry-run

)
$3

- Interactive wizard - One-time setup, auto-installs dependencies
- Multiple commands -

git smart-commit or smart-commit


- Built-in help -

--help

 flag for documentation
- Easy uninstall -

--uninstall

 with smart detection
---
📦 Installation Options

---

`⚙️ Initial Setup`

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

1. Set up the llmCLI tool (automatic). 2. Connect OpenAI or Anthropic. 3. Enter your API key. 4. Select a model (e.g.,gpt-4o-mini or claude-3-haiku).

Need to change something later?

`bash smart-commit --setup`

---

`🤖 Codex skill:` /smart-commit

Use smart-commit inside Codex CLI without keeping this repo around.

Install:

`bash git clone https://github.com/vicc/smart-commit.git cd smart-commit codex skills install dist/smart-commit.skill`

Use:

- Stage your changes (git add ...) in any git repo. - Open Codex CLI and run/smart-commit. - Copy the message or ask Codex togit commit -m "".

Once installed, you can delete the repo—the skill stays available in Codex. Releases also include the .skill file for direct download.

---

`🎮 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`

`$3`

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

`$3`

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

`$3`

Run the setup wizard again:`bash smart-commit --setup`

Or manually:`bash llm keys set openai # Switch provider llm models default gpt-4o # Change model`

`$3`

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

`$3`

npm:`bash npm update -g @viccalexander/smart-commit`

Homebrew:`bash brew update brew upgrade smart-commit`

`$3`

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

`$3`

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

`$3`

Just use regular git commands:`bash git add . git commit -m "Your message"``

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

---

@viccalexander/smart-commit

Introducing Smart Commit ✨

🚀 Quickstart

1. Install globally

2. Run it (first time walks you through setup)

⚡️ Why Smart Commit?

🛠 How It Works

💫 Features

$3

$3

$3

$3

📦 Installation Options

⚙️ Initial Setup

🤖 Codex skill: /smart-commit

🎮 Usage Guide

🎨 The Emoji Guide

🤝 Contributing

FAQ

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3

📝 License

@viccalexander/smart-commit

Introducing Smart Commit ✨

🚀 Quickstart

1. Install globally

2. Run it (first time walks you through setup)

⚡️ Why Smart Commit?

🛠 How It Works

💫 Features

$3

$3

$3

$3

📦 Installation Options

⚙️ Initial Setup

🤖 Codex skill: /smart-commit

🎮 Usage Guide

🎨 The Emoji Guide

🤝 Contributing

FAQ

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3

📝 License

`1. Install globally`

`⚙️ Initial Setup`

`🤖 Codex skill:` /smart-commit

`🎮 Usage Guide`

`🎨 The Emoji Guide`

`🤝 Contributing`

`FAQ`

`$3`

`$3`

`$3`

`$3`

`$3`

`$3`

`$3`

`$3`

`$3`

`$3`

`$3`

`$3`

`1. Install globally`

`⚙️ Initial Setup`

`🤖 Codex skill:` /smart-commit

`🎮 Usage Guide`

`🎨 The Emoji Guide`

`🤝 Contributing`

`FAQ`

`$3`

`$3`

`$3`

`$3`

`$3`

`$3`

`$3`

`$3`

`$3`

`$3`

`$3`

`$3`