Claudecode Rule2hook

claudecode-rule2hook 🪝

Convert natural language project rules into Claude Code hooks automatically! Write rules in plain English, and let Claude transform them into powerful automation hooks.

✨ Features

- 🎯 Natural Language Processing - Write rules in plain English
- 🔄 Automatic Hook Generation - Converts rules to proper hook configurations
- 🧠 Smart Detection - Intelligently identifies events, tools, and commands
- 📝 CLAUDE.md Integration - Reads from existing project memory files
- 🛡️ Safe Configuration - Backs up existing hooks before applying changes
- 🚀 Zero Dependencies - Works directly with Claude Code

📦 Installation

Option 1: Project-Specific Installation (Recommended)

To use the rule2hook command in your own project:

Option 2: Global Installation

To make the command available in all projects:

Option 3: Use Directly in This Repository

How it works

Claude Code discovers slash commands by scanning:
1. ~/.claude/commands/ for global commands (accessible as /commandname)
2. .claude/commands/ in the current project for project-specific commands (accessible as /project:commandname)

Important: You must be in the correct directory when using Claude Code for the commands to be available.

🚀 Quick Start

After installation, in Claude Code, type:

📚 How It Works

1. Input - Provide rules as text or let Claude read from CLAUDE.md
2. Analysis - Claude analyzes rules to determine:
   - Trigger events (before/after actions)
   - Target tools (Edit, Write, Bash, etc.)
   - Commands to execute
3. Generation - Creates proper hook configurations
4. Application - Saves hooks to ~/.claude/hooks.json

🎯 Examples

Example 1: Code Formatting

Input:

Generated Hook:

Example 2: Git Workflow

Input:

Generated Hook:

📋 Supported Rule Patterns

- Formatting:…