🎯 Major Features
⚙️ Settings System
- 🏗️ Hierarchical Configuration: Full support for user, project, local, and enterprise settings
- 📦 Modular Components: Individual settings for permissions, model selection, telemetry, and cleanup policies
- 🔧 Interactive Installation: Choose installation location with guided prompts
- 🛡️ Security-First: Proper handling of sensitive data with local settings
🪝 Hooks System Overhaul
- ✅ Claude Code Specification Compliance: All hooks now follow official array/matcher format
- 🎯 Event-Driven Automation: Complete support for PreToolUse, PostToolUse, Stop, and more
- 📱 Telegram Integration: Three notification hooks with comprehensive setup guide
- 🔧 Development Tools: Smart formatting, file backup, change tracking, and linting integration
- 🔄 Git Workflow: Auto-staging and intelligent commit message generation
- 📊 Performance Monitoring: System health tracking and optimization alerts
🌐 Installation Location Selection
- 🏠 User Settings (
~/.claude/settings.json) - Global configuration - 📁 Project Settings (
.claude/settings.json) - Team-shared settings - ⚙️ Local Settings (
.claude/settings.local.json) - Personal, not committed - 🏢 Enterprise Settings - System-wide policies with admin requirements
📚 Comprehensive Documentation
- Complete Docusaurus Integration: Full documentation at https://docs.aitmpl.com
- Settings Guide: 300+ lines covering all configuration levels
- Hooks Manual: 400+ lines with automation examples and best practices
- Telegram Setup: Step-by-step bot creation and integration guide
🔧 Technical Improvements
Hook Structure Compliance
- ✅ Fixed all 20+ hooks to use proper Claude Code array/matcher specification
- 🎯 Enhanced pattern matching with tool-specific matchers
- 🔍 Environment variable integration (CLAUDE_TOOL_NAME, CLAUDE_TOOL_FILE_PATH)
- 🛡️ Error handling improvements with graceful fallbacks
CLI Enhancements
- 🔄 Interactive location selection for both Settings and Hooks
- 📦 Support for multiple component installation in single command
- 🚀 Improved error handling and validation
- 📋 Better user feedback and progress indication
Cross-Platform Support
- 🍎 macOS:
/Library/Application Support/ClaudeCode/ - 🐧 Linux/WSL:
/etc/claude-code/ - 🪟 Windows:
C:\ProgramData\ClaudeCode\
📦 Available Components
Settings Categories
- 🛡️ Permissions:
allow-npm-commands,deny-sensitive-files - 🤖 Model:
use-sonnet,use-haiku - 📊 Telemetry:
enable-telemetry,disable-telemetry - 🧹 Cleanup:
retention-7-days,retention-90-days
Hook Categories
- 🔧 Development Tools: file-backup, smart-formatting, lint-on-save
- 🔄 Git Workflow: auto-git-add, smart-commit
- 🧪 Testing: test-runner
- ⚡ Automation: telegram-notifications, simple-notifications, build-on-change
- 🔒 Security: file-protection, security-scanner
- 📊 Performance: performance-monitor
🚀 Installation
# Install Settings with location selection
npx claude-code-templates@latest --setting=model/use-sonnet
# Install Hooks with location selection
npx claude-code-templates@latest --hook=git-workflow/auto-git-add
# Install multiple components
npx claude-code-templates@latest --setting=model/use-sonnet,telemetry/enable-telemetry
# Skip location prompt (defaults to local settings)
npx claude-code-templates@latest --hook=automation/telegram-notifications --yes📚 Documentation
- 🌐 Web Documentation: https://docs.aitmpl.com
- 📱 Telegram Setup: Complete Integration Guide
- 🔧 Settings Guide: Configure permissions, models, and policies
- 🪝 Hooks Manual: Event-driven automation workflows
🔄 Migration from Previous Versions
If you have existing hook configurations, they will continue to work. However, we recommend updating to the new format for better compatibility:
Old Format (deprecated):
{"PreToolUse": "echo 'starting'"}New Format (recommended):
{
"PreToolUse": [{
"matcher": "*",
"hooks": [{"type": "command", "command": "echo 'starting'"}]
}]
}🛠️ Contributors
Thanks to all contributors who helped make this release possible!
Full Changelog: v1.17.1...v1.18.0