@greyhaven/claude-code-config v2.0.0

@greyhaven/claude-code-config v2.0.0

Hooks and configuration setup for Grey Haven's Claude Code environment

[](https://www.npmjs.com/package/@greyhaven/claude-code-config) [](https://opensource.org/licenses/MIT)

---

🎯 What This Package Does

This npm package provides **setup utilities** for Claude Code:

• ✅ Hooks installation - 7 production hooks for enhanced Claude Code experience
• ✅ MCP configuration - Interactive setup wizard for MCP servers
• ✅ Project initialization - Templates and scaffolding for new projects
• ✅ Settings management - Backup/restore configuration files
• ✅ Diagnostics - Doctor command to troubleshoot issues

🚫 What This Package Does NOT Do

• ❌ Plugin distribution - Use Git repository + plugin marketplace instead
• ❌ Agent management - Agents are loaded from plugin marketplace
• ❌ Command management - Commands are loaded from plugin marketplace

**Why?** Claude Code's plugin marketplace loads plugins from local filesystem, making npm distribution redundant. See [Migration Guide](https://github.com/greyhaven-ai/grey-haven-claude-code-config/blob/main/MIGRATION_V2.md) for details.

---

📦 Installation

Quick Install

npm install -g @greyhaven/claude-code-config

From Source

git clone https://github.com/greyhaven-ai/grey-haven-claude-code-config.git
cd grey-haven-claude-code-config
npm install -g .

---

🚀 Quick Start

1. Install Hooks

claude-config install-hooks

**What it does**:

• Copies 7 hooks to ~/.claude/hooks/
• Sets executable permissions
• Validates Python 3 installation

**Available hooks**:

• subagent-context-preparer.py - Prepare context for subagents
• bash-permission-validator.py - Validate bash commands
• edit-permission-validator.py - Validate file edits
• write-permission-validator.py - Validate file writes
• agent-output-formatter.py - Format agent outputs
• mcp-tool-permission-validator.py - Validate MCP tool calls
• user-prompt-submit.py - Process user prompts

2. Configure MCP Servers (Optional)

claude-config setup-mcp

**Interactive wizard** that configures:

• Firecrawl MCP server
• Linear MCP server
• Playwright MCP server
• Custom MCP servers

3. Create New Project (Optional)

claude-config create-project my-app

**What it creates**:

• .claude/ directory with settings
• .github/workflows/ with CI/CD templates
• vitest.config.ts for testing
• Project README template

---

📚 Using Plugins (Agents & Commands)

Plugins are **NOT** distributed via npm. Use Git + plugin marketplace instead.

Step 1: Clone Repository

git clone https://github.com/greyhaven-ai/grey-haven-claude-code-config.git ~/grey-haven-plugins

Step 2: Configure Plugin Marketplace

**Edit `~/.claude/settings.json