✍️ Claude Commit

Automatically generate conventional commit messages from your staged changes using Claude AI.

Supports VS Code via an extension and any editor via a Claude skill.

⚡ Quick Start

VS Code Extension — install and get a keybind + Source Control menu button:

bash install.sh

Then reload VS Code: Cmd+Shift+P → Developer: Reload Window

Claude Skill — works with any editor, no install needed if the repo is already mounted:

Just say: "generate a commit message" and Claude handles the rest.

✨ Options

| Option | What it does | |--------|-------------| | 🖥️ VS Code Extension | Adds Cmd+Shift+G and a button in the Source Control ... menu | | 🤖 Claude Skill | Works in any editor — Claude reads your staged diff directly |

🖥️ VS Code Extension

Install

bash install.sh

Usage

• Press Cmd+Shift+G anywhere in VS Code, or
• Open the ... menu next to any repo in the Source Control panel → Generate Commit Message (Claude)

If you have multiple repos open with staged files, it will ask which one to use.

Custom Format

Open VS Code Settings (Cmd+,), search claude-commit, and fill in your preferred format. Or add a .vscode/settings.json to your repo to share the format with your team:

{
  "claude-commit.commitFormat": "Always prefix with the Jira ticket from the branch name. Format: TICKET-123: short description."
}

If no format is set, it defaults to Conventional Commits.

🤖 Claude Skill

Works with any editor. Just ask Claude to generate a commit message and it reads your staged diff directly.

Install (personal)

Double-click commit-message-skill.skill to install it in Claude.

Install (shared with your team)

The skill is already bundled in .claude/skills/commit-message/. When anyone mounts this repo in Claude, the skill is automatically available — no manual install needed.

🔧 Prerequisites

• Claude CLI installed and authenticated

⚙️ How It Works

Both options read git diff --cached from your repo, send the diff to Claude Haiku (fast and cost-efficient), and return a single commit message.

| Step | VS Code Extension | Claude Skill | |------|------------------|--------------| | 1 | Triggered by keybind or menu | Triggered by your message | | 2 | Reads git diff --cached | Reads git diff --cached | | 3 | Sends diff to Claude Haiku | Sends diff to Claude Haiku | | 4 | Populates the commit input box | Displays the message to copy |

❓ FAQ

Yes. If you have multiple repos open in VS Code with staged files, Claude Commit will prompt you to select which repo to use.

Yes — set claude-commit.commitFormat in VS Code Settings or .vscode/settings.json. Great for enforcing Jira ticket prefixes, team-specific conventions, etc.

Claude Haiku — chosen for its speed and low cost. Commit messages are short, structured tasks it handles very well.

Yes — it uses the Anthropic API via the Claude CLI. Costs are minimal since Claude Haiku is the most affordable model and each commit diff is a small prompt.

📄 License

MIT — see LICENSE.

Built with ❤️ for the Claude Code community

Commit smarter, not harder.