claude-code

Claude Code Custom Commands

Transform Claude Code into a complete development platform with 45 AI-powered commands that automate your entire software development workflow. Now with improved git identity management!

What This Does

This repository extends Claude Code with custom slash commands that provide intelligent automation for:

• ⚡ Testing: /xtest - Run tests, generate coverage reports, create test cases
• 🔍 Code Quality: /xquality - Format, lint, type-check with auto-fixes
• 🔒 Security: /xsecurity - Scan for vulnerabilities, secrets, security issues
• 🏗️ Architecture: /xarchitecture - Design systems, analyze patterns
• 🚀 Git Workflow: /xgit - Automated commits with smart messages
• 🐛 Debugging: /xdebug - AI debugging assistant with persistent context
• 📚 Documentation: /xdocs - Generate and maintain documentation
• 🔧 Refactoring: /xrefactor - Intelligent code improvements

Think of it like VS Code extensions - but for Claude Code. These commands give Claude deep knowledge of development workflows and tools.

🔒 Security Notice - Please Review Before Use

⚠️ IMPORTANT: This is an open source tool that will execute commands on your system. For your security:

Before Installation:

1. 🔍 Review the source code - Examine the files you'll be running:

   • NPM package source: claude-dev-toolkit/ - The published package code
   • Commands directory: slash-commands/active/ - All command implementations
   • Hook scripts: hooks/ - Scripts that integrate with Claude Code events

2. 🛡️ Understand what runs: Commands will:

   • Execute bash/shell commands on your system
   • Read and modify files in your projects
   • Make git commits and pushes
   • Install dependencies and tools
   • Run tests and linting tools

3. 🔐 Verify authenticity:

   • Check the commit history
   • Review GitHub Actions tests
   • Examine the MIT License

Recommended Security Practices:

• Start with individual commands, not bulk installation
• Test in a disposable/sandbox environment first
• Review any command with /x[name] help before using
• Monitor what files are created/modified
• Keep your git history clean for easy rollback

🐳 Devcontainer for Safe Autonomous Execution

Want to run Claude with --dangerously-skip-permissions safely? Use Anthropic's official devcontainer approach:

# Set up devcontainer with network firewall and security isolation
./setup-devcontainer.sh

# Or use the slash command
/xdevcontainer

# Start container and run Claude with full autonomy (safe inside container)
devcontainer up --workspace-folder .
devcontainer exec --workspace-folder . claude --dangerously-skip-permissions

Security features included:

• Network firewall: Only allows api.anthropic.com, github.com, npmjs.org, pypi.org
• Dropped capabilities: --cap-drop=ALL prevents privileged operations
• No privilege escalation: --security-opt=no-new-privileges
• Isolated filesystem: No host mounts by default

Setup options:

./setup-devcontainer.sh --help              # Show all options
./setup-devcontainer.sh --dry-run           # Preview without creating files
./setup-devcontainer.sh --minimal           # Minimal tooling (Node, Git only)
./setup-devcontainer.sh --strict            # CI mode - fail if prerequisites missing
./setup-devcontainer.sh --allow-domain X    # Add custom domain to firewall allowlist

Enterprise support:

# Add private registries via environment variable
DEVCONTAINER_EXTRA_DOMAINS="npm.company.com,registry.internal" ./setup-devcontainer.sh

See our Devcontainer Guide for complete documentation, or Anthropic's official docs.

This tool is provided as-is under MIT License. Use at your own discretion.

Quick Start

🚀 Get Started in 30 Seconds (NPM Installation)

Security First: Review the Security Notice above before installation

# 1. Install Claude Code (if you haven't already)
npm install -g @anthropic-ai/claude-code

# 2. Install Claude Dev Toolkit via NPM (review source first!)
npm install -g @paulduvall/claude-dev-toolkit

# 3. Deploy commands to Claude Code
claude-commands install --active    # Install 17 core commands
# OR
claude-commands install --all       # Install all 45 commands

# 4. Configure OIDC for GitHub Actions to AWS (NEW!)
claude-commands oidc --help         # Show OIDC configuration options
claude-commands oidc --dry-run      # Preview OIDC setup actions
claude-commands oidc --region us-west-2 --stack-name my-oidc  # Configure AWS OIDC

# 5. Configure Claude Code settings (Recommended)
claude-commands config --list                        # List available templates
claude-commands config --template basic-settings.json   # Apply basic config
# OR
claude-commands config --template security-focused-settings.json  # Enhanced security
# OR  
claude-commands config --template comprehensive-settings.json     # Full features

# 6. Install AI subagents (Optional)
claude-commands subagents --install     # Install 25 specialized AI subagents

# 7. Install quality/security hooks + status line (Optional)
bash setup-hooks.sh                     # Symlinks hooks, configures status line

# 8. Start using AI-powered development commands
claude
/xtest          # Run all tests intelligently
/xquality       # Check and fix code quality issues
/xsecurity      # Scan for security vulnerabilities
/xgit           # Automated git workflow with smart commits

🔧 Development and Customization

For contributing or accessing experimental features (⚠️ Review source code first!):

# Install development version with experimental commands
npm install -g @paulduvall/claude-dev-toolkit

# Install experimental commands (28 additional commands)
claude-commands install --experiments    # Experimental features
claude-commands install --all            # All 45 commands

# Access AI subagents for specialized tasks
claude-commands subagents --install      # 25 specialized AI assistants

That's it! You now have 17 powerful AI development commands + intelligent subagents available in any project.

Core Commands (Always Available)

Once installed, these essential commands work in any project on your machine:

Source of truth: slash-commands/active/ — run bash scripts/generate-command-docs.sh update to regenerate.

Command	Description
/xarchitecture	Design, analyze, and evolve system architecture using Domain-Driven Design, 12-Factor App, and proven patterns
/xconfig	Manage project configuration files, environment variables, and application settings
/xcontinue	Continue an execution plan from where it left off across sessions
/xdebug	Interactive debugging support with error analysis and fix suggestions - integrates with Debug Specialist sub-agent for complex issues
/xdocs	Generate and maintain comprehensive documentation from code
/xexplore	Explore a codebase topic before making changes (read-only)
/xgit	Automate git workflow - stage, commit with smart messages, and push to specified branch
/xhelp	Command navigator that recommends the right slash commands for your task
/xpipeline	Advanced CI/CD pipeline configuration, build automation, deployment orchestration, and optimization
/xquality	Run code quality checks with maturity-aware thresholds and centralized-rules integration
/xrefactor	Interactive refactoring assistant based on Martin Fowler's catalog and project-specific rules for code smell detection
/xrelease	Comprehensive release management with planning, coordination, deployment automation, and monitoring
/xsecurity	Run security scans with maturity-aware checks and centralized-rules integration
/xspec	Machine-readable specifications with unique identifiers and authority levels for precise AI code generation
/xtdd	Complete Test-Driven Development workflow automation with Red-Green-Refactor-Commit cycle
/xtest	Run tests with smart defaults, maturity-aware thresholds, and centralized-rules integration
/xverify	Verify references before taking action — catch fabricated URLs, placeholder IDs, and unverified claims

Every command includes built-in help: /xtest help, /xquality help, etc.

Real-World Usage Examples

Daily Development Workflow

# Check code quality and fix issues
/xquality           # Run all quality checks
/xquality fix       # Auto-fix formatting, imports, etc.

# Run tests with intelligent defaults  
/xtest              # Runs all tests automatically
/xtest coverage     # Include coverage analysis
/xtest unit         # Run only unit tests

# Security scanning
/xsecurity          # Comprehensive security scan
/xsecurity secrets  # Quick check for exposed credentials

# Automated git workflow
/xgit               # Stage, commit with AI message, and push

Weekly Code Review Prep

# Comprehensive analysis before code review
/xrefactor --analyze         # Find code smells and improvement opportunities
/xquality report            # Detailed quality metrics
/xsecurity                  # Security vulnerability scan
/xdocs --update             # Update documentation
/xgit                       # Commit improvements

Architecture and Planning

# Design system architecture
/xarchitecture --design --pattern microservices

# Create specifications
/xspec --feature "user-authentication" --gherkin

# Generate documentation
/xdocs --api --architecture

Prerequisites

You need Claude Code installed first:

# Install Claude Code
npm install -g @anthropic-ai/claude-code

# Authenticate (opens browser automatically)
claude

Most users authenticate via browser (no API key needed). See Claude Code docs for details.

Advanced Features

🤖 AI Sub-Agents

Debug Specialist - Persistent debugging assistant for complex issues:

# Simple debugging handled by /xdebug command
/xdebug "ImportError: No module named 'requests'"

# Complex issues automatically route to specialist sub-agent  
@debug-specialist analyze this intermittent memory leak
@debug-specialist continuing our investigation from yesterday

Features:

• Persistent Context: Remembers previous debugging sessions
• Root Cause Analysis: Systematic investigation methodology
• Multi-Language Support: Python, JavaScript, Java, Go, and more
• Performance Debugging: Memory leaks, bottlenecks, optimization

🔒 Code Quality & Security Hooks