rsp2k/claude-hooks
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
claude-hooks/docs/BOOTSTRAP_PROMPT.md
Ryan Malloy 9445e09c48 Add NPM distribution support with hybrid installation approach 
Major changes:
- Add package.json with NPM packaging configuration
- Create Node.js CLI interface (bin/claude-hooks.js) with full command set
- Convert bash scripts to Python for better npm integration
- Add npm postinstall/preuninstall hooks for automatic setup
- Update bootstrap prompt to recommend NPM method with git fallback
- Enhance README with NPM-first documentation
- Maintain backward compatibility with existing git installation

Features:
- npm install -g claude-hooks for easy distribution
- claude-hooks init/status/test/backup/uninstall commands
- Automatic Python dependency installation
- Conflict detection and prevention
- Hybrid approach supporting both npm and git workflows

This resolves installation complexity while maintaining developer flexibility.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-07-19 21:03:13 -06:00

2.3 KiB
Raw Blame History

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 (choose one method):

Method 1 - NPM (Recommended):

  1. npm install -g claude-hooks
  2. claude-hooks init
  3. claude-hooks test

Method 2 - Git (For developers):

  1. git clone https://git.supported.systems/rsp2k/claude-hooks.git
  2. cd claude-hooks && ./scripts/install.sh
  3. ./scripts/test.sh

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