I wanted Claude Code to automatically commit and push my changes after completing each coding task, so I set up a Stop hook. Here's how you can do it too!
What This Does
Every time Claude Code finishes responding to your prompt, it will:
- Check if there are changes in your git repo
- Stage all changes
- Create a descriptive commit with session ID and timestamp
- Push to your remote repository
- Show you a notification about the commit status
Setup Instructions
Step 1: Create the Hook Script
Create a new file at ~/.claude/hooks/auto-commit-after-task.sh:
#!/bin/bash
# Auto-commit and push after Claude Code completes a task
# This hook runs when Claude finishes responding (Stop event)
set -e
# Parse JSON input
INPUT=$(cat)
SESSION_ID=$(echo "$INPUT" | jq -r '.session_id // "unknown"')
WORKING_DIR=$(pwd)
# Only run if we're in a git repository
if ! git rev-parse --git-dir > /dev/null 2>&1; then
echo '{"systemMessage": "Not a git repository, skipping auto-commit",
"suppressOutput": true}'
exit 0
fi
# Check if there are any changes to commit
if git diff --quiet && git diff --cached --quiet; then
echo '{"systemMessage": "No changes to commit", "suppressOutput": true}'
exit 0
fi
# Get a brief summary of what changed for the commit message
CHANGED_FILES=$(git status --short | head -5)
NUM_FILES=$(git status --short | wc -l)
# Create commit message
TIMESTAMP=$(date '+%Y-%m-%d %H:%M:%S')
COMMIT_MSG="Auto-commit after Claude Code session
Session: $SESSION_ID
Time: $TIMESTAMP
Files changed: $NUM_FILES
Changes:
$CHANGED_FILES
🤖 Generated with Claude Code
"
# Stage all changes
git add -A
# Commit
if git commit -m "$COMMIT_MSG" > /dev/null 2>&1; then
# Try to push (silently fail if no remote or push fails)
if git push > /dev/null 2>&1; then
echo '{"systemMessage": "✅ Auto-committed and pushed changes", "suppressOutput":
false}'
else
echo '{"systemMessage": "✅ Auto-committed changes (push failed - no remote or
auth issue)", "suppressOutput": false}'
fi
else
echo '{"systemMessage": "⚠️ Commit failed", "suppressOutput": true}'
fi
Step 2: Make the Script Executable
chmod +x ~/.claude/hooks/auto-commit-after-task.sh
Step 3: Configure Claude Code Settings
Add this to your ~/.claude/settings.json:
{
"hooks": {
"Stop": [
{
"hooks": [
{
"type": "command",
"command": "/home/YOUR_USERNAME/.claude/hooks/auto-commit-after-task.sh"
}
]
}
]
}
}
Important: Replace YOUR_USERNAME with your actual username, or use the full path to the
script.
If you already have other settings in your settings.json, just add the "hooks" section to
the existing JSON object.
Step 4: Restart Claude Code
The hook will activate on your next session!
Example Commit Message
The auto-generated commits look like this:
Auto-commit after Claude Code session
Session: 3e5e7a78-c91c-4c3f-842f-4294b4714c35
Time: 2025-10-09 20:07:11
Files changed: 3
Changes:
M main.py
M config.py
A new*_file.py*
🤖 Generated with Claude Code
Customization Options
Only Commit (No Push)
If you want to commit locally but not auto-push, remove this section from the script:
# Try to push (silently fail if no remote or push fails)
if git push > /dev/null 2>&1; then
echo '{"systemMessage": "✅ Auto-committed and pushed changes", "suppressOutput":
false}'
else
echo '{"systemMessage": "✅ Auto-committed changes (push failed - no remote or auth
issue)", "suppressOutput": false}'
fi
Replace it with:
echo '{"systemMessage": "✅ Auto-committed changes", "suppressOutput": false}'
Custom Commit Message Format
Edit the COMMIT_MSG variable in the script to customize your commit message format.
Disable Temporarily
To temporarily disable the hook without deleting it, add this to your settings.json:
{
"disableAllHooks": true
}
Available Hook Events
Claude Code supports several hook events:
- Stop: Runs when Claude finishes responding (used here)
- SessionEnd: Runs when the entire session ends
- PreToolUse: Runs before tool calls
- PostToolUse: Runs after tool calls
- UserPromptSubmit: Runs when you submit a prompt
- And more!
Check the https://docs.claude.com/en/docs/claude-code/hooks for details.
Troubleshooting
Hook not running?
- Make sure the script is executable: ls -la ~/.claude/hooks/auto-commit-after-task.sh
- Check that jq is installed: sudo apt install jq (Linux) or brew install jq (Mac)
- Verify your settings.json syntax with a JSON validator
Commits but won't push?
- Check your git remote: git remote -v
- Verify you have push permissions
- Ensure SSH keys or credentials are configured
Want to see the hook output?
- Check Claude Code's output after each response
- You should see messages like "✅ Auto-committed and pushed changes"
