██████╗██╗      █████╗ ██╗   ██╗██████╗ ███████╗
██╔════╝██║     ██╔══██╗██║   ██║██╔══██╗██╔════╝
██║     ██║     ███████║██║   ██║██║  ██║█████╗  
██║     ██║     ██╔══██║██║   ██║██║  ██║██╔══╝  
╚██████╗███████╗██║  ██║╚██████╔╝██████╔╝███████╗
 ╚═════╝╚══════╝╚═╝  ╚═╝ ╚═════╝ ╚═════╝ ╚══════╝

 ██████╗ ██████╗ ██████╗ ███████╗
██╔════╝██╔═══██╗██╔══██╗██╔════╝
██║     ██║   ██║██║  ██║█████╗  
██║     ██║   ██║██║  ██║██╔══╝  
╚██████╗╚██████╔╝██████╔╝███████╗
 ╚═════╝ ╚═════╝ ╚═════╝ ╚══════╝

████████╗███████╗███╗   ███╗██████╗ ██╗      █████╗ ████████╗███████╗███████╗
╚══██╔══╝██╔════╝████╗ ████║██╔══██╗██║     ██╔══██╗╚══██╔══╝██╔════╝██╔════╝
   ██║   █████╗  ██╔████╔██║██████╔╝██║     ███████║   ██║   █████╗  ███████╗
   ██║   ██╔══╝  ██║╚██╔╝██║██╔═══╝ ██║     ██╔══██║   ██║   ██╔══╝  ╚════██║
   ██║   ███████╗██║ ╚═╝ ██║██║     ███████╗██║  ██║   ██║   ███████╗███████║
   ╚═╝   ╚══════╝╚═╝     ╚═╝╚═╝     ╚══════╝╚═╝  ╚═╝   ╚═╝   ╚══════╝╚══════╝

                    🚀 Setup Claude Code for any project language 🚀

An open-source CLI tool that provides framework-specific commands, automation hooks, and MCP server integration for JavaScript/TypeScript, Python, Go, Rust, and more. Built by the community, for the community.

# Navigate to your project
cd your-project-directory

# Run the installer (no installation required!)
npx claude-code-templates@latest

# Start coding with Claude
claude

The installer will auto-detect your project type and guide you through selecting commands, hooks, and MCP servers.

Framework-specific commands for testing, linting, building, debugging, and deployment.

Execute at key moments during Claude Code workflow:

• PreToolUse: Security checks, logging, statement detection
• PostToolUse: Auto-formatting, type checking, testing
• Stop: Final linting, bundle analysis
• Notification: Activity logging and monitoring

Extend Claude Code with specialized capabilities:

• IDE Integration: VS Code diagnostics & Jupyter execution
• Web Search: Real-time information retrieval
• Database Tools: PostgreSQL, MySQL connections
• Development Tools: Docker, GitHub, filesystem operations

• Review existing command performance
• Get optimization recommendations
• Analyze token usage and efficiency
• Project-specific improvement suggestions

# View detailed command statistics
npx claude-code-templates --command-stats

What you get:

• Command name, file size, and token count
• Lines, words, and last modified date
• AI-powered optimization recommendations
• Project-specific improvement suggestions

cd my-react-app
npx claude-code-templates
# Auto-detects React and suggests optimal configuration

# React + TypeScript project
npx claude-code-templates --language javascript-typescript --framework react --yes

# Python + Django project
npx claude-code-templates --language python --framework django --yes

# Go + Gin API project
npx claude-code-templates --language go --framework gin --yes

# Rust + Axum project
npx claude-code-templates --language rust --framework axum --yes

# Preview installation without making changes
npx claude-code-templates --dry-run

# Skip all prompts and use defaults
npx claude-code-templates --yes

# Install to custom directory
npx claude-code-templates --directory /path/to/project

# Analyze existing commands
npx claude-code-templates --command-stats

All these commands work exactly the same way:

npx claude-code-templates    # ✅ Recommended (package name)
npx claude-code-template     # Singular alias
npx create-claude-config     # Create-style command
npx claude-init              # Short alias

• Automatic Backups: Existing files are backed up before changes
• Confirmation Required: Always asks before making changes (unless --yes flag)
• Dry Run Mode: Preview installation with --dry-run
• Cancel Anytime: Press Ctrl+C or answer 'No' to cancel
• Back Navigation: Modify previous selections during setup

• Hours of configuration research
• Manual CLAUDE.md creation
• Framework-specific command setup
• Automation hook configuration
• MCP server integration

npx claude-code-templates --language javascript-typescript --framework react --yes
# ✅ Done in 30 seconds!

• Community-Driven: Built by developers, for developers
• Always Updated: Latest best practices and framework support
• Extensible: Easy to add new languages and frameworks
• Transparent: All code is open and auditable
• Free Forever: MIT license, no vendor lock-in

claude-code-templates/
├── cli-tool/                    # 📦 NPM Package
│   ├── src/                     # Core CLI implementation
│   │   ├── index.js            # Main entry point
│   │   ├── prompts.js          # Interactive prompts
│   │   ├── command-stats.js    # Command analysis
│   │   └── templates.js        # Template configuration
│   ├── templates/              # Language and framework templates
│   │   ├── common/             # Universal templates
│   │   ├── javascript-typescript/ # JS/TS with React, Vue, Angular, Node.js
│   │   ├── python/             # Python with Django, Flask, FastAPI
│   │   ├── go/                 # Go with Gin, Echo, Fiber
│   │   └── rust/               # Rust with Axum, Warp, Actix
│   └── bin/                    # Executable scripts
├── CONTRIBUTING.md             # Contribution guidelines
├── LICENSE                     # MIT License
└── README.md                   # This file

• Frameworks: React, Vue, Angular, Node.js
• Hooks: Console.log detection, Prettier formatting, TypeScript checking, ESLint
• MCP: TypeScript SDK, GitHub, Puppeteer, Slack, File System
• Commands: Testing (Jest), building (Webpack/Vite), debugging, deployment

• Frameworks: Django, Flask, FastAPI
• Hooks: Print statement detection, Black formatting, MyPy type checking, pytest
• MCP: Python SDK, Docker, Jupyter, PostgreSQL, Opik
• Commands: Testing (pytest), linting (flake8), virtual env management

• Frameworks: Gin, Echo, Fiber
• Hooks: Print statement detection, gofmt formatting, go vet analysis
• MCP: Go SDK, Language Server, MySQL
• Commands: Testing (go test), building, dependency management

• Frameworks: Axum, Warp, Actix
• Hooks: Print macro detection, rustfmt formatting, clippy linting
• MCP: Rust SDK, Documentation, Substrate
• Commands: Testing (cargo test), building (cargo build), clippy analysis

We welcome contributions from the open source community! This project thrives on community input and collaboration.

• 🆕 Add new languages - Rust, Go, Java, C#, PHP, etc.
• 🎯 Add frameworks - Svelte, Next.js, Nuxt.js, NestJS, Laravel, Spring Boot
• 🔧 Improve commands - Better testing, deployment, debugging workflows
• 📖 Write documentation - Clearer guides and examples
• 🐛 Fix bugs - Improvements to existing templates
• 💡 Suggest features - New CLI features and options

# Fork and clone the repository
git clone https://github.com/your-username/claude-code-templates.git
cd claude-code-templates

# Set up development environment
cd cli-tool
npm install && npm link

# Test your changes
npm test
npm start -- --dry-run

# Submit a pull request
git checkout -b feature/your-feature
# Make changes, test, commit, push

📖 See CONTRIBUTING.md for detailed guidelines

• Node.js 14+ (for the installer)
• Claude Code installed

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

# Set up your project (no installation required!)
cd your-project
npx claude-code-templates

# Start coding with Claude
claude

• CLAUDE.md - Main configuration file with language-specific best practices
• .claude/settings.json - Automation hooks and Claude Code settings
• .claude/commands/ - Custom commands for common development tasks
• .mcp.json - Model Context Protocol server configurations

Each language template includes optimized commands for:

• Testing: Jest, pytest, go test, cargo test
• Linting: ESLint, flake8, go vet, clippy
• Formatting: Prettier, Black, gofmt, rustfmt
• Building: Webpack, setuptools, go build, cargo build
• Debugging: Chrome DevTools, pdb, delve, gdb
• Framework Operations: Component generation, migrations, scaffolding

• PreToolUse: Code quality checks, security scans, statement detection
• PostToolUse: Auto-formatting, type checking, test execution
• Stop: Final linting, bundle analysis, cleanup
• Notification: Activity logging, performance monitoring

• IDE Integration: VS Code diagnostics, Jupyter kernel execution
• Web Search: Real-time web search for documentation and solutions
• Database Tools: PostgreSQL, MySQL, SQLite connections
• Development Tools: Docker containers, GitHub API, filesystem operations

This project is licensed under the MIT License - see the LICENSE file for details.

This project is built by the community, for the community. We believe in:

• 🌍 Open Collaboration: Everyone can contribute and improve the project
• 🔄 Knowledge Sharing: Share best practices and learn from others
• 🤝 Inclusive Environment: Welcome developers of all skill levels
• 📈 Continuous Improvement: Always evolving with community feedback
• 🆓 Free Forever: MIT license ensures it stays open and free

• Contributors: All contributors are recognized in our GitHub contributors page
• Community: Join discussions and help others in GitHub Discussions
• Star History: Show your support by starring the repository

• 🐛 Issues: Report bugs or request features
• 💬 Discussions: Join community discussions
• 📖 Documentation: Claude Code Official Docs
• 🤝 Contributing: Read our contribution guidelines

⭐ Found this useful? Give us a star on GitHub to support the project!

🤝 Want to contribute? Check out our contribution guidelines - all skill levels welcome!