Grey Haven Claude Code Configuration

Version 2.0.0 - Hooks, configuration, and plugin marketplace for Claude Code

🎯 What This Repository Provides

This repository contains Grey Haven Studio's comprehensive Claude Code ecosystem:

12 Plugin Packages with 26+ Agents and 30+ Commands

• Distributed via local plugin marketplace (not npm)
• Clone this repository and configure in Claude Code settings

npm Package (@greyhaven/claude-code-config) for:

• ✅ Hook installation and management
• ✅ MCP server configuration
• ✅ Project initialization
• ✅ Settings backup/restore
• ✅ Diagnostics

📦 Installation

Option 1: Full Setup (Recommended)

Get plugins + CLI tools:

# 1. Clone repository for plugins
git clone https://github.com/greyhaven-ai/grey-haven-claude-code-config.git ~/grey-haven-plugins

# 2. Configure plugin marketplace in ~/.claude/settings.json
{
  "plugin": {
    "marketplaces": [{
      "name": "grey-haven-plugins",
      "source": "/Users/YOU/grey-haven-plugins/grey-haven-plugins"
    }],
    "install": [
      "grey-haven-core@grey-haven-plugins",
      "grey-haven-developer-experience@grey-haven-plugins",
      "grey-haven-observability@grey-haven-plugins"
    ]
  }
}

# 3. (Optional) Install CLI tools for hook management
npm install -g @greyhaven/claude-code-config
claude-config install-hooks

Option 2: Plugins Only

If you only need agents and commands:

# Clone and configure plugin marketplace
git clone https://github.com/greyhaven-ai/grey-haven-claude-code-config.git ~/grey-haven-plugins

# Add to ~/.claude/settings.json (see full config above)

No npm package required!

Option 3: CLI Tools Only

If you only need hook installation and setup utilities:

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

🚀 Quick Start

1. Install Hooks

claude-config install-hooks

2. Test Installation

claude-config doctor

3. Use Plugins

In Claude Code:

/tdd-implement          # Test-driven development
/code-review            # Code review analysis
/security-scan          # Security audit
/doc-generate-api       # API documentation

📦 Available Plugins

| Plugin | Agents | Commands | Description | |--------|--------|----------|-------------| | grey-haven-core | 3 | 5 | Core functionality (research, context, git) | | grey-haven-developer-experience | 5 | 8 | DX tools (TDD, code review, docs) | | grey-haven-observability | 2 | 3 | Monitoring, logging, metrics | | grey-haven-infrastructure | 3 | 4 | IaC, deployment, scaling | | grey-haven-quality-assurance | 2 | 3 | Testing, E2E, visual regression | | grey-haven-security | 2 | 2 | Security scanning, vulnerability analysis | | grey-haven-data-engineering | 2 | 2 | ETL, data pipelines, analytics | | grey-haven-ai-ml | 2 | 1 | AI/ML workflows, model training | | grey-haven-mobile-development | 2 | 1 | Mobile app development | | grey-haven-cloudflare | 1 | 1 | Cloudflare Workers/Pages deployment | | grey-haven-linear-integration | 1 | 1 | Linear project management | | grey-haven-hooks | 0 | 0 | Hook documentation |

Total: 26+ agents, 30+ commands across 12 plugins

🔧 CLI Commands

Hooks Management

claude-config install-hooks         # Install hooks to ~/.claude/hooks/
claude-config list-hooks            # Show available hooks

Configuration

claude-config init                  # Initialize .claude/ directory
claude-config backup-settings       # Backup user settings
claude-config restore-settings      # Restore from backup

Diagnostics

claude-config doctor                # Diagnose installation
claude-config version               # Show version

📚 Documentation

• Migration Guide - Upgrade from v1.x to v2.0.0
• npm Package README - CLI tool documentation
• Installation Guide - Detailed setup instructions
• Architecture Plan - v2.0.0 design decisions

🔄 Updating

Update Plugins

cd ~/grey-haven-plugins
git pull origin main

Update CLI Tools

npm update -g @greyhaven/claude-code-config
# Or: claude-config self-update

🎯 Key Features

26+ Specialized Agents

Core Functionality:

• docs-architect - Technical documentation creation
• code-quality-analyzer - Multi-mode code analysis
• tdd-python-implementer - Test-driven Python development
• tdd-typescript-implementer - Test-driven TypeScript development

Observability:

• observability-architect - Monitoring setup
• sli-slo-engineer - SLI/SLO implementation

Security:

• security-analyzer - Vulnerability scanning
• security-audit-orchestrator - Comprehensive security audits

See full agent catalog in plugins/

30+ Slash Commands

Development:

• /tdd-implement - TDD implementation workflow
• /code-review - Comprehensive code review
• /refactor-clarity - Clarity-focused refactoring

Documentation:

• /doc-generate-api - OpenAPI 3.1 generation
• /doc-coverage - Documentation coverage validation

Security & Quality:

• /security-scan - Security audit
• /quality-pipeline - Full quality check

See full command catalog in plugins/

4 Production Hooks

• subagent-context-preparer.py - Optimize subagent context
• security-validator.py - Security validation
• prompt-enhancer.py - Enhance user prompts
• work-completion-assistant.py - Work completion tracking

🆚 v2.0.0 Changes

| Feature | v1.x | v2.0.0 | |---------|------|--------| | Plugin distribution | ✅ npm | ❌ Git + marketplace | | Hooks | ✅ npm | ✅ npm (optional) | | CLI tools | ✅ npm | ✅ npm (optional) | | Package size | ~2 MB | ~500 KB | | Update method | npm update | git pull + npm update |

See MIGRATION_V2.md for complete migration guide.

📋 System Requirements

Required

• Claude Code installed
• Git

Optional

• Python 3.8+ (for hooks)
• Node.js 14+ (for npm CLI tools)

Check Installation

claude-config doctor

🤝 Contributing

Contributions welcome! See CONTRIBUTING.md.

Development Setup

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

📄 License

MIT © Grey Haven Studio

🔗 Links

• GitHub: https://github.com/greyhaven-ai/grey-haven-claude-code-config
• npm: https://www.npmjs.com/package/@greyhaven/claude-code-config
• Issues: https://github.com/greyhaven-ai/grey-haven-claude-code-config/issues

Built with ❤️ for the Claude Code community