claude-hooks/docs/WEBSITE_COPY.md

# 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://git.supported.systems/rsp2k/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 Git** - [git.supported.systems/rsp2k/claude-hooks](https://git.supported.systems/rsp2k/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.*