# 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.*