✨ Add template system for reusable commit messages (v0.0.5)

0xkaz · claude · 0xkaz · commit a5d49bd0fdce · 2025-06-13T17:49:16.000+08:00
New features: - Add template management system - Save templates: --save-template <name> "<template>" - Use templates: --template <name> or -T <name> - List templates: --list-templates - Delete templates: --delete-template <name> - Support smart placeholders with {variable} syntax - Prompts for values when using templates - Multiple placeholders per template supported - Templates stored in ~/.claude-auto-commit/templates/ Examples: - Save: claude-auto-commit --save-template hotfix "🔥 HOTFIX: {description}" - Use: claude-auto-commit --template hotfix - List: claude-auto-commit --list-templates Documentation: - Update README with template examples - Add template section to FEATURES.md - Update CHANGELOG for v0.0.5 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -5,6 +5,20 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.0.5] - 2024-06-13
+
+### Added
+- **Template System** for saving and reusing commit message patterns
+  - `--save-template <name> "<template>"` to save a template
+  - `--template <name>` or `-T <name>` to use a saved template
+  - `--list-templates` to show all saved templates
+  - `--delete-template <name>` to remove a template
+- **Smart placeholders** in templates using `{variable}` syntax
+  - Prompts for values when using templates with placeholders
+  - Supports multiple placeholders in a single template
+  - Example: `🔥 HOTFIX: {description} - fixes {issue}`
+- Templates stored in `~/.claude-auto-commit/templates/`
+
 ## [0.0.4] - 2024-06-13
 
 ### Added
diff --git a/README.md b/README.md
@@ -44,6 +44,7 @@ claude-auto-commit -l en -e -t feat
 - 📋 **Change Summary**: Detailed statistics about your changes (lines added/deleted, file types)
 - 🧠 **Commit Learning**: Analyze your commit history to maintain consistent style
 - 🎯 **Smart Grouping**: Intelligently categorize files for logical commits
+- 📝 **Template System**: Save and reuse common commit message patterns
 - ⚡ **Lightweight**: Shell script with minimal dependencies
 - 🛠️ **Configurable**: Extensive customization through CLI options and config files
 
@@ -132,6 +133,11 @@ claude-auto-commit --summary
 # Combine options for detailed preview
 claude-auto-commit --dry-run --summary -v
 
+# Template management
+claude-auto-commit --save-template hotfix "🔥 HOTFIX: {description}"
+claude-auto-commit --template hotfix
+claude-auto-commit --list-templates
+
 # Update tool
 claude-auto-commit --update
 ```
@@ -180,12 +186,14 @@ git:
   auto_push: true
 ```
 
-## 🚀 What's New in v0.0.4
+## 🚀 What's New in v0.0.5
 
-- **Smart Grouping**: Analyze and categorize files for logical commits with `--smart-group`
-- **Commit History Learning**: Learn from your project's commit style with `--analyze-history`
-- **Learned Style**: Apply analyzed patterns to new commits with `--style learned`
-- **macOS Compatibility**: Fixed compatibility issues for macOS users
+- **Template System**: Save and reuse commit message templates
+  - Save templates: `--save-template <name> "<template>"`
+  - Use templates: `--template <name>` or `-T <name>`
+  - List templates: `--list-templates`
+  - Delete templates: `--delete-template <name>`
+- **Smart placeholders**: Use `{variable}` in templates for dynamic values
 
 ## 🤝 Contributing
 
diff --git a/docs/FEATURES.md b/docs/FEATURES.md
@@ -167,9 +167,36 @@ Apply analyzed patterns to new commits:
 claude-auto-commit --style learned
 ```
 
+## New Features (v0.0.5)
+
+### 📝 Template System
+Save and reuse common commit message patterns:
+
+```bash
+# Save a template
+claude-auto-commit --save-template hotfix "🔥 HOTFIX: {description}"
+claude-auto-commit --save-template deps "⬆️ Update {package} from {old_version} to {new_version}"
+claude-auto-commit --save-template wip "[WIP] {feature}: {status}"
+
+# Use a template
+claude-auto-commit --template hotfix
+# Prompts: Enter value for description: [user input]
+# Result: 🔥 HOTFIX: [user input]
+
+# Short form
+claude-auto-commit -T deps
+
+# List all templates
+claude-auto-commit --list-templates
+
+# Delete a template
+claude-auto-commit --delete-template wip
+```
+
+Templates support placeholders with `{variable}` syntax. When using a template with placeholders, you'll be prompted to enter values for each variable.
+
 ## Upcoming Features
 
-- 📝 **Template System**: Save and reuse common commit message patterns
 - ✂️ **Split Commits**: Break large changes into logical commits
 - 🔧 **Selective Analysis**: Filter files to include/exclude from analysis
 - 🔗 **Git Hook Integration**: Automatic message generation on commit
diff --git a/src/claude-auto-commit.sh b/src/claude-auto-commit.sh
@@ -1,10 +1,10 @@
 #!/bin/bash
 
 # Claude Auto-Commit - AI-powered Git commit message generator
-# Version: 0.0.4
+# Version: 0.0.5
 # Homepage: https://claude-auto-commit.0xkaz.com
 
-VERSION="0.0.4"
+VERSION="0.0.5"
 REPO="0xkaz/claude-auto-commit"
 CONFIG_DIR="$HOME/.claude-auto-commit"
 CONFIG_FILE="$CONFIG_DIR/config.yml"
@@ -26,6 +26,10 @@ SHOW_SUMMARY=false
 SMART_GROUP=false
 ANALYZE_HISTORY=false
 USE_LEARNED_STYLE=false
+SAVE_TEMPLATE=""
+USE_TEMPLATE=""
+LIST_TEMPLATES=false
+DELETE_TEMPLATE=""
 
 # Display usage information
 usage() {
@@ -50,6 +54,10 @@ Options:
     --smart-group              Group related files into logical commits
     --analyze-history          Analyze commit history to learn patterns
     --style learned            Use learned commit style from history
+    --save-template <name>     Save a commit message template
+    --template <name>          Use a saved template (-T for short)
+    --list-templates           List all saved templates
+    --delete-template <name>   Delete a saved template
     --update                   Check for updates now
     --no-update                Skip update check
     --version                  Show version information
@@ -62,6 +70,8 @@ Examples:
     $(basename $0) --dry-run  # Generate message only
     $(basename $0) --smart-group  # Group related files
     $(basename $0) --analyze-history  # Learn from commit history
+    $(basename $0) --save-template hotfix "🔥 HOTFIX: {description}"
+    $(basename $0) --template hotfix  # Use saved template
 EOF
 }
 
@@ -264,6 +274,23 @@ while [[ $# -gt 0 ]]; do
             fi
             shift 2
             ;;
+        --save-template)
+            SAVE_TEMPLATE="$2"
+            CUSTOM_MESSAGE="$3"
+            shift 3
+            ;;
+        --template|-T)
+            USE_TEMPLATE="$2"
+            shift 2
+            ;;
+        --list-templates)
+            LIST_TEMPLATES=true
+            shift
+            ;;
+        --delete-template)
+            DELETE_TEMPLATE="$2"
+            shift 2
+            ;;
         --update)
             # Force update
             AUTO_UPDATE=true
@@ -295,12 +322,56 @@ done
 # Create config directory
 mkdir -p "$CONFIG_DIR"
 
+# Create templates directory
+TEMPLATES_DIR="$CONFIG_DIR/templates"
+mkdir -p "$TEMPLATES_DIR"
+
 # Load config
 load_config
 
 # Auto-update check
 check_for_updates "$@"
 
+# Template management functions
+if [ "$LIST_TEMPLATES" = true ]; then
+    print_info "📝 Available templates:"
+    if [ -d "$TEMPLATES_DIR" ] && [ "$(ls -A "$TEMPLATES_DIR" 2>/dev/null)" ]; then
+        for template in "$TEMPLATES_DIR"/*; do
+            [ -f "$template" ] && {
+                name=$(basename "$template")
+                content=$(cat "$template")
+                echo "  • $name: $content"
+            }
+        done
+    else
+        echo "  No templates found."
+        echo "  Create one with: $(basename $0) --save-template <name> \"<template>\""
+    fi
+    exit 0
+fi
+
+if [ -n "$DELETE_TEMPLATE" ]; then
+    if [ -f "$TEMPLATES_DIR/$DELETE_TEMPLATE" ]; then
+        rm "$TEMPLATES_DIR/$DELETE_TEMPLATE"
+        print_success "Template '$DELETE_TEMPLATE' deleted"
+    else
+        print_error "Template '$DELETE_TEMPLATE' not found"
+    fi
+    exit 0
+fi
+
+if [ -n "$SAVE_TEMPLATE" ]; then
+    if [ -z "$CUSTOM_MESSAGE" ]; then
+        print_error "Template content required"
+        echo "Usage: $(basename $0) --save-template <name> \"<template>\""
+        exit 1
+    fi
+    echo "$CUSTOM_MESSAGE" > "$TEMPLATES_DIR/$SAVE_TEMPLATE"
+    print_success "Template '$SAVE_TEMPLATE' saved"
+    echo "Use it with: $(basename $0) --template $SAVE_TEMPLATE"
+    exit 0
+fi
+
 # Check if we're in a Git repository
 if ! git rev-parse --git-dir > /dev/null 2>&1; then
     print_error "Not a Git repository"
@@ -491,6 +562,37 @@ if [ "$AUTO_STAGE" = false ]; then
     fi
 fi
 
+# Use template if specified
+if [ -n "$USE_TEMPLATE" ]; then
+    if [ -f "$TEMPLATES_DIR/$USE_TEMPLATE" ]; then
+        TEMPLATE_CONTENT=$(cat "$TEMPLATES_DIR/$USE_TEMPLATE")
+        print_info "Using template: $USE_TEMPLATE"
+        
+        # Process template placeholders
+        if echo "$TEMPLATE_CONTENT" | grep -q "{"; then
+            # Extract placeholders
+            PLACEHOLDERS=$(echo "$TEMPLATE_CONTENT" | grep -o '{[^}]*}' | sort -u)
+            
+            # Replace each placeholder
+            FINAL_MESSAGE="$TEMPLATE_CONTENT"
+            for placeholder in $PLACEHOLDERS; do
+                var_name=$(echo "$placeholder" | tr -d '{}')
+                echo
+                read -p "Enter value for $var_name: " -r var_value
+                FINAL_MESSAGE=$(echo "$FINAL_MESSAGE" | sed "s/$placeholder/$var_value/g")
+            done
+            CUSTOM_MESSAGE="$FINAL_MESSAGE"
+        else
+            CUSTOM_MESSAGE="$TEMPLATE_CONTENT"
+        fi
+    else
+        print_error "Template '$USE_TEMPLATE' not found"
+        print_info "Available templates:"
+        ls "$TEMPLATES_DIR" 2>/dev/null | sed 's/^/  • /' || echo "  No templates found"
+        exit 1
+    fi
+fi
+
 # Generate message with Claude CLI if no custom message provided
 if [ -z "$CUSTOM_MESSAGE" ]; then
     # Get detailed changes and save to temp file
