claude-hooks/docs/BOOTSTRAP_PROMPT.md

# Claude Hooks Bootstrap Prompt

*Copy this prompt and paste it into a fresh Claude Code session to install Claude Hooks*

---

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.

**⚠️ IMPORTANT: Claude Hooks installs user-wide and affects ALL Claude Code instances. If you have other Claude sessions with hooks already installed, this will create conflicts. Check first!**

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

**Pre-installation check:**
First, verify no hooks are already installed:
1. Check: `claude-hooks status 2>/dev/null || echo "No claude-hooks found - safe to proceed"`
2. Check: `ls ~/.config/claude/hooks.json 2>/dev/null || echo "No hooks config found - safe to proceed"`

If either check shows existing hooks, **STOP** and run the uninstall process first:
- `claude-hooks uninstall` (if available)
- Or manually remove: `rm -rf ~/.config/claude/hooks.json`

**Installation:**

**NPM (Recommended):**
1. `npm install -g claude-hooks`
2. Hooks auto-configure during install
3. `claude-hooks test` to verify

**Git (For developers):**
1. `git clone https://git.supported.systems/rsp2k/claude-hooks.git`
2. `cd claude-hooks && npm install && npm run postinstall`
3. `claude-hooks test`

**After installation:**
- Restart Claude Code to activate the hooks
- Try `claude-hooks status` to verify it's working
- Try `pip install requests` to see intelligent command suggestions

**To uninstall later:** `claude-hooks uninstall` or `npm uninstall -g claude-hooks`

Please guide me through this installation step-by-step, including the pre-installation checks. Use the NPM method unless I specifically request git installation. Handle any errors that come up and make sure everything works. The installation now auto-configures during npm install - no manual steps needed! 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.