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>
This commit is contained in:
commit
162ca67098
34 changed files with 5904 additions and 0 deletions
183
docs/WEBSITE_COPY.md
Normal file
183
docs/WEBSITE_COPY.md
Normal file
|
|
@ -0,0 +1,183 @@
|
|||
# Claude Hooks Website Copy
|
||||
|
||||
## Hero Section
|
||||
|
||||
### Make Claude Code Smarter
|
||||
**Claude Hooks adds intelligence, safety, and memory to your AI assistant**
|
||||
|
||||
Claude Code is powerful, but it forgets everything between sessions and repeats the same mistakes. Claude Hooks fixes that.
|
||||
|
||||
✨ **Learns from your environment** - Remembers which commands work and suggests alternatives for ones that fail
|
||||
🛡️ **Prevents dangerous operations** - Blocks risky commands before they execute
|
||||
💾 **Never lose work** - Automatic backups before context limits
|
||||
🔄 **Seamless continuity** - Pick up exactly where you left off
|
||||
|
||||
---
|
||||
|
||||
## Get Started in 60 Seconds
|
||||
|
||||
**Already using Claude Code?** Install Claude Hooks in one minute:
|
||||
|
||||
### Step 1: Start Claude Code
|
||||
```bash
|
||||
mkdir hookie && cd hookie && claude
|
||||
```
|
||||
|
||||
### Step 2: Copy & Paste This Prompt
|
||||
*Click to copy the installation prompt*
|
||||
|
||||
<div class="copy-prompt-box">
|
||||
I want to install Claude Hooks - an intelligent system that will make you smarter and safer by learning from my environment and preventing common mistakes.
|
||||
|
||||
**What it does:**
|
||||
- Learns which commands fail in my environment and suggests working alternatives
|
||||
- Automatically backs up my work before context limits
|
||||
- Blocks dangerous commands before they execute
|
||||
- Maintains session history across Claude restarts
|
||||
|
||||
**Installation steps:**
|
||||
1. `git clone https://github.com/anthropics/claude-hooks.git`
|
||||
2. `cd claude-hooks`
|
||||
3. `./scripts/install.sh`
|
||||
4. `./scripts/test.sh`
|
||||
|
||||
**After installation:**
|
||||
- Restart Claude Code to activate the hooks
|
||||
- Try `claude-hooks status` to see it working
|
||||
- Try `pip install requests` to see intelligent command suggestions
|
||||
|
||||
Please guide me through this installation step-by-step. Handle any errors that come up and make sure everything works. After installation, help me test it by trying some commands that commonly fail on different systems (like `pip` vs `pip3`, `python` vs `python3`) so I can see the intelligence in action.
|
||||
|
||||
The goal is to have a working Claude Hooks system that starts learning from my environment immediately.
|
||||
|
||||
[📋 Copy Prompt]
|
||||
</div>
|
||||
|
||||
### Step 3: Watch Claude Install It For You
|
||||
Claude will guide you through the installation and help you test it immediately.
|
||||
|
||||
**That's it!** You now have an AI assistant that gets smarter every time you use it.
|
||||
|
||||
---
|
||||
|
||||
## See It In Action
|
||||
|
||||
### Before Claude Hooks
|
||||
```bash
|
||||
$ pip install requests
|
||||
bash: pip: command not found
|
||||
```
|
||||
*You repeat this mistake in every session*
|
||||
|
||||
### After Claude Hooks
|
||||
```bash
|
||||
$ pip install requests
|
||||
⚠️ Warning: pip commands often fail (confidence: 88%)
|
||||
💡 Suggestion: Use "pip3 install requests"
|
||||
```
|
||||
*Claude Hooks learned from your environment and prevents the mistake*
|
||||
|
||||
---
|
||||
|
||||
## Why Claude Hooks?
|
||||
|
||||
### The Problem
|
||||
Claude Code is incredibly powerful, but it has fundamental limitations:
|
||||
- **No memory** between sessions - repeats the same mistakes
|
||||
- **No environmental awareness** - doesn't know what works on your system
|
||||
- **Context limits** - loses everything when conversations get too long
|
||||
- **No safety checks** - can suggest dangerous operations
|
||||
|
||||
### The Solution
|
||||
Claude Hooks adds persistent intelligence that:
|
||||
- **Learns from every command** you run and every mistake made
|
||||
- **Builds environmental knowledge** specific to your system
|
||||
- **Automatically backs up** your work before context limits
|
||||
- **Validates commands** before execution to prevent problems
|
||||
|
||||
### The Result
|
||||
An AI assistant that doesn't just help you code - it **gets better at helping you** over time.
|
||||
|
||||
---
|
||||
|
||||
## Features
|
||||
|
||||
### 🧠 Shadow Learning
|
||||
- Observes every command execution and outcome
|
||||
- Builds patterns of what works vs. what fails in your environment
|
||||
- Suggests working alternatives when you try something that typically fails
|
||||
- Gets more accurate over time as it learns your specific setup
|
||||
|
||||
### 🛡️ Intelligent Safety
|
||||
- Blocks dangerous operations like `rm -rf /` before execution
|
||||
- Warns about risky commands with explanations
|
||||
- Learns what's safe vs. dangerous in your specific context
|
||||
- Provides alternatives when blocking operations
|
||||
|
||||
### 💾 Smart Backups
|
||||
- Monitors conversation context usage in real-time
|
||||
- Automatically backs up your work before context limits
|
||||
- Creates git commits with descriptive messages
|
||||
- Generates session summaries for easy restoration
|
||||
|
||||
### 🔄 Session Continuity
|
||||
- Maintains `LAST_SESSION.md` with complete session history
|
||||
- Preserves `ACTIVE_TODOS.md` across Claude restarts
|
||||
- Tracks all file modifications and command history
|
||||
- Creates recovery guides when sessions are interrupted
|
||||
|
||||
---
|
||||
|
||||
## Documentation
|
||||
|
||||
**📚 [Complete Documentation](docs/README.md)** - Organized by what you need right now
|
||||
|
||||
**🎓 New to Claude Hooks?** → [30-minute tutorial](docs/tutorial/getting-started.md)
|
||||
|
||||
**🛠️ Need to solve a problem?** → [How-to guides](docs/README.md#-how-to-guides)
|
||||
|
||||
**📖 Looking up commands?** → [Reference documentation](docs/README.md#-reference)
|
||||
|
||||
**💡 Want to understand how it works?** → [Architecture explanations](docs/README.md#-explanation)
|
||||
|
||||
---
|
||||
|
||||
## Community
|
||||
|
||||
- **⭐ Star us on GitHub** - [github.com/anthropics/claude-hooks](https://github.com/anthropics/claude-hooks)
|
||||
- **🐛 Report issues** - Help us make it better
|
||||
- **💬 Discuss** - Share patterns and tips with other users
|
||||
- **🤝 Contribute** - Add new features and improvements
|
||||
|
||||
---
|
||||
|
||||
## FAQ
|
||||
|
||||
**Q: Will this slow down Claude?**
|
||||
A: No. Hooks add <50ms of processing time and often save time by preventing failures.
|
||||
|
||||
**Q: Is it safe?**
|
||||
A: Yes. Hooks are designed to fail safely - if anything goes wrong, Claude continues working normally.
|
||||
|
||||
**Q: Do I need to configure anything?**
|
||||
A: No. The system learns automatically from your actual usage patterns.
|
||||
|
||||
**Q: Can I share patterns with my team?**
|
||||
A: Yes. You can export and share learned patterns across team members.
|
||||
|
||||
**Q: What if Claude Hooks breaks?**
|
||||
A: Claude Code continues working normally. Hooks enhance but never interfere with core functionality.
|
||||
|
||||
---
|
||||
|
||||
## Get Started Now
|
||||
|
||||
Ready to make Claude Code smarter? Copy the prompt above and paste it into Claude Code.
|
||||
|
||||
**Installation takes 60 seconds. The benefits last forever.**
|
||||
|
||||
[📋 Copy Installation Prompt](#step-2-copy--paste-this-prompt)
|
||||
|
||||
---
|
||||
|
||||
*Claude Hooks is open source and MIT licensed. Built by developers, for developers.*
|
||||
Loading…
Add table
Add a link
Reference in a new issue