Skip to main content
The Commit Commands Plugin automates common git operations, reducing context switching and manual command execution. Use a single slash command to handle your entire git workflow.

​
Overview

This plugin provides three commands that automate:
  • Creating commits with auto-generated messages
  • Complete commit-push-PR workflows
  • Cleaning up stale local branches
Philosophy: Reduce manual git commands and let Claude handle the workflow while you focus on coding.

​
Commands

​
/commit

Creates a git commit with an automatically generated commit message based on staged and unstaged changes. What It Does:
1

Analyzes Changes

Reviews current git status, staged/unstaged changes, and recent commit messages
2

Drafts Message

Creates a commit message that matches your repository’s style
3

Stages and Commits

Stages relevant files and creates the commit
Usage: 
/commit
Example: 
# Make some changes to your code
# Then simply run:
/commit

# Claude will:
# - Review your changes
# - Stage the files
# - Create a commit with an appropriate message
# - Show you the commit status
Features:
  • Automatically drafts commit messages that match your repo’s style
  • Follows conventional commit practices
  • Avoids committing files with secrets (.env, credentials.json)
  • Includes Claude Code attribution in commit message

​
/commit-push-pr

Complete workflow command that commits, pushes, and creates a pull request in one step. What It Does:
1

Branch Creation

Creates a new branch if currently on main/master
2

Commit Changes

Stages and commits changes with an appropriate message
3

Push to Remote

Pushes the branch to origin with tracking
4

Create PR

Creates a pull request using gh pr create with comprehensive description
5

Provide URL

Returns the PR URL for review
Usage: 
/commit-push-pr
Example: 
# Make your changes
# Then run:
/commit-push-pr

# Claude will:
# - Create a feature branch (if needed)
# - Commit your changes
# - Push to remote
# - Open a PR with summary and test plan
# - Give you the PR URL to review
Features:
  • Analyzes all commits in the branch (not just the latest)
  • Creates comprehensive PR descriptions with:
    • Summary of changes (1-3 bullet points)
    • Test plan checklist
    • Claude Code attribution
  • Handles branch creation automatically
  • Uses GitHub CLI (gh) for PR creation
Requirements:
  • GitHub CLI (gh) must be installed and authenticated
  • Repository must have a remote named origin

​
/clean_gone

Cleans up local branches that have been deleted from the remote repository. What It Does:
1

Identify Stale Branches

Lists all local branches to identify [gone] status
2

Remove Worktrees

Identifies and removes worktrees associated with [gone] branches
3

Delete Branches

Deletes all branches marked as [gone]
4

Report Results

Provides feedback on removed branches
Usage: 
/clean_gone
Example: 
# After PRs are merged and remote branches are deleted
/clean_gone

# Claude will:
# - Find all branches marked as [gone]
# - Remove any associated worktrees
# - Delete the stale local branches
# - Report what was cleaned up
Features:
  • Handles both regular branches and worktree branches
  • Safely removes worktrees before deleting branches
  • Shows clear feedback about what was removed
  • Reports if no cleanup was needed
When to Use:
  • After merging and deleting remote branches
  • When your local branch list is cluttered with stale branches
  • During regular repository maintenance

​
Best Practices

​
Using /commit

Review Changes

Review staged changes before committing

Trust Auto-Messages

Let Claude analyze and match your repo’s commit style

Routine Commits

Use for routine commits during development

Verify Accuracy

Verify the message is accurate before proceeding

​
Using /commit-push-pr

  • Use when you’re ready to create a PR
  • Ensure all your changes are complete and tested
  • Claude will analyze the full branch history for the PR description
  • Review the PR description and edit if needed
  • Minimizes context switching

​
Using /clean_gone

  • Run periodically to keep your branch list clean
  • Especially useful after merging multiple PRs
  • Safe to run - only removes branches already deleted remotely
  • Helps maintain a tidy local repository

​
Workflow Examples

​
Quick Commit Workflow

# Write code
/commit
# Continue development

​
Feature Branch Workflow

# Develop feature across multiple commits
/commit  # First commit
# More changes
/commit  # Second commit
# Ready to create PR
/commit-push-pr

​
Maintenance Workflow

# After several PRs are merged
/clean_gone
# Clean workspace ready for next feature

​
Troubleshooting

​
/commit Creates Empty Commit

Issue: No changes to commit Solution:
  • Ensure you have unstaged or staged changes
  • Run git status to verify changes exist

​
/commit-push-pr Fails to Create PR

Issue: gh pr create command fails Solution:
  • Install GitHub CLI: brew install gh (macOS) or see GitHub CLI installation
  • Authenticate: gh auth login
  • Ensure repository has a GitHub remote

​
/clean_gone Doesn’t Find Branches

Issue: No branches marked as [gone] Solution:
  • Run git fetch --prune to update remote tracking
  • Branches must be deleted from the remote to show as [gone]

​
Tips

Combine commands: Use /commit during development, then /commit-push-pr when ready
Let Claude draft: The commit message analysis learns from your repo’s style
Regular cleanup: Run /clean_gone weekly to maintain a clean branch list
Review before pushing: Always review the commit message and changes before pushing

​
Plugin Information

Author: Anthropic ([email protected])
Version: 1.0.0

Build docs developers (and LLMs) love

Get started for freeTalk to us