// Create a conventional commit and push to the current branch. Ensures commit messages follow the Conventional Commits spec for automatic versioning with release-please.
| name | commit |
| description | Create a conventional commit and push to the current branch. Ensures commit messages follow the Conventional Commits spec for automatic versioning with release-please. |
| argument-hint | ["optional commit description"] |
Create a git commit following the Conventional Commits specification. This is required for release-please to auto-determine version bumps.
Check the current state — run git status (no -uall flag) and git diff --staged to understand what's being committed. If nothing is staged, stage the relevant files (prefer specific files over git add .).
Determine the commit type from the changes:
| Type | When to use | Version bump |
|---|---|---|
feat | New feature or capability | minor (0.x.0) |
fix | Bug fix | patch (0.0.x) |
docs | Documentation only | no release |
style | Formatting, whitespace, semicolons (no logic change) | no release |
refactor | Code restructuring (no feature/fix) | no release |
perf | Performance improvement | patch (0.0.x) |
test | Adding or fixing tests | no release |
build | Build system, dependencies, CI | no release |
chore | Maintenance, tooling, configs | no release |
ci | CI/CD pipeline changes | no release |
revert | Reverting a previous commit | depends on reverted type |
Format the commit message strictly as:
type(scope): short description
Optional longer body explaining the "why" (not the "what").
BREAKING CHANGE: description (if applicable)
Rules:
composer, sync, settings, db, ui, ai, calendar, auth, search, shortcuts, tray, notifications, labels, filters, queue, imap, attachments)Examples:
feat(composer): add scheduled send with date picker
fix(sync): handle expired Gmail history token gracefully
refactor(db): consolidate migration helpers
docs: update keyboard shortcuts table in CLAUDE.md
chore(ci): add release-please workflow
perf(search): use FTS5 trigram index for faster lookups
feat(ai)!: switch to streaming responses
BREAKING CHANGE: AI provider interface now requires stream() method
Create the commit using a HEREDOC for proper formatting:
git commit -m "$(cat <<'EOF'
type(scope): description
EOF
)"
Push to the current branch with git push. If the branch has no upstream, use git push -u origin HEAD.
$ARGUMENTS