claude-hooks/README.md
Ryan Malloy 162ca67098 Initial commit: Claude Code Hooks with Diátaxis documentation
 Features:
- 🧠 Shadow learner that builds intelligence from command patterns
- 🛡️ Smart command validation with safety checks
- 💾 Automatic context monitoring and backup system
- 🔄 Session continuity across Claude restarts

📚 Documentation:
- Complete Diátaxis-organized documentation
- Learning-oriented tutorial for getting started
- Task-oriented how-to guides for specific problems
- Information-oriented reference for quick lookup
- Understanding-oriented explanations of architecture

🚀 Installation:
- One-command installation script
- Bootstrap prompt for installation via Claude
- Cross-platform compatibility
- Comprehensive testing suite

🎯 Ready for real-world use and community feedback!

🤖 Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>
2025-07-19 18:25:34 -06:00

63 lines
2.0 KiB
Markdown

# Claude Code Hooks
Intelligent hooks system that makes Claude Code smarter, safer, and more reliable through learning and automation.
## What Is This?
Claude Code Hooks transforms your Claude experience by adding:
- **🧠 Learning Intelligence** - Remembers what works in your environment and suggests alternatives for commands that typically fail
- **🛡️ Safety Protection** - Blocks dangerous operations and warns about risky commands before they execute
- **💾 Automatic Backups** - Preserves your work before context limits are reached, with seamless session restoration
- **🔄 Session Continuity** - Maintains context across Claude restarts with detailed session summaries
## Quick Install
```bash
git clone https://github.com/your-org/claude-hooks.git
cd claude-hooks
./scripts/install.sh
```
The installer automatically configures Claude Code. Restart Claude and the hooks will start working immediately.
## See It in Action
Try a command that often fails:
```bash
pip install requests
```
With hooks enabled, you'll see:
```
⚠️ Warning: pip commands often fail (confidence: 88%)
💡 Suggestion: Use "pip3 install requests"
```
The system learned this pattern from your environment and is preventing you from repeating a known failure.
## Documentation
**📚 [Complete Documentation](docs/README.md)** - Organized by your current needs
**🎓 New to Claude Hooks?** → [Tutorial](docs/tutorial/getting-started.md) (30 minutes)
**🛠️ Need to solve a problem?** → [How-To Guides](docs/README.md#-how-to-guides)
**📖 Looking up commands?** → [Reference](docs/README.md#-reference)
**💡 Want to understand how it works?** → [Explanations](docs/README.md#-explanation)
## Requirements
- Python 3.8+
- Claude Code
- Git (optional, for enhanced backup features)
## License
MIT License - see [LICENSE](LICENSE) for details.
---
*Claude Code Hooks makes your AI assistant smarter by giving it memory, environmental awareness, and the ability to learn from experience.*