claude-code-templates 1.20.3 → 1.21.1

package/docu/docs/intro.md

@@ -0,0 +1,109 @@
+---
+sidebar_position: 1
+---
+
+# Claude Code Templates
+
+**Claude Code Templates** is a powerful Command Line Interface (CLI) tool designed to streamline the setup, configuration, and monitoring of your Claude Code projects. It provides both complete project templates and individual components (Agents, Commands, MCPs) to ensure the correct and efficient utilization of Claude Code within your development workflow.
+
+## Key Functionalities
+
+The core functionality of `claude-code-templates` revolves around these key areas:
+
+```bash
+npx claude-code-templates@latest
+# Or use the new template-specific syntax:
+npx claude-code-templates@latest --template=react --yes
+```
+
+### 🚀 Project Setup & Configuration
+Automated project configuration and optimization with **real-time GitHub downloads**:
+- **Framework Detection**: Automatically identifies your project type (e.g., React, Vue, Angular, Django, FastAPI) and suggests optimal configurations.
+- **CLAUDE.md Generation**: Creates a customized `CLAUDE.md` file with project-specific instructions and best practices.
+- **Command Configuration**: Sets up pre-configured development, build, and test commands tailored to your stack.
+- **Agent Installation**: Installs specialized Claude Code agents for framework-specific assistance.
+- **GitHub Integration**: All templates and components are downloaded directly from GitHub, ensuring latest versions.
+- **Workflow Optimization**: Implements Claude Code-specific enhancements and best practices for an optimized development workflow.
+
+### 🧩 Individual Components
+Granular control over Claude Code functionality with **dedicated CLI parameters**:
+- **🤖 Agents**: AI specialists for specific development tasks (`--agent=react-performance`, `--agent=api-security-audit`)
+- **⚡ Commands**: Custom slash commands for Claude Code (`--command=check-file`, `--command=generate-tests`)
+- **🔌 MCPs**: Model Context Protocol integrations (`--mcp=github-integration`, `--mcp=database-integration`)
+- **Direct Installation**: Install components individually using specific CLI parameters
+- **GitHub Downloads**: All components download directly from GitHub's `components/` directory
+- **Flexible Installation**: Choose between complete templates (`--template`) or selective component installation
+
+### 📊 Real-time Analytics Dashboard & Agent Chats Manager
+Complementary monitoring and analysis tools:
+- **Live Session Tracking**: Monitor active Claude Code conversations and their status in real-time.
+- **Usage Statistics**: Gain insights into total sessions, token usage, and project activity trends.
+- **Conversation History**: Access complete session logs with export capabilities (CSV/JSON).
+- **Performance Metrics**: Track Claude Code agent performance and identify optimization opportunities.
+- **Web Interface**: Access a clean, terminal-style dashboard at `http://localhost:3333` for real-time monitoring.
+
+### 🔍 Comprehensive Health Check
+Environment and configuration validation:
+- **System Requirements Verification**: Validates your operating system, Node.js version, memory, and network connectivity.
+- **Claude Code Setup Validation**: Checks Claude Code installation, authentication, and permissions.
+- **Project Configuration Analysis**: Analyzes your project structure and configuration files for potential issues.
+- **Custom Commands & Hooks Validation**: Verifies the integrity and availability of your custom slash commands and automation hooks.
+- **Overall Health Score**: Provides an overall system health percentage with actionable recommendations for improvements.
+
+## Quick Start
+
+### 1. Modern Template Installation (Recommended)
+```bash
+# Quick template installation with new syntax
+npx claude-code-templates@latest --template=react --yes
+npx claude-code-templates@latest --template=python --yes
+npx claude-code-templates@latest --template=nodejs --yes
+
+# Or use interactive setup for guidance
+cd your-project-directory
+npx claude-code-templates@latest
+```
+
+### 2. Individual Component Installation
+```bash
+# Install specific components using new CLI parameters
+npx claude-code-templates@latest --agent=react-performance --yes
+npx claude-code-templates@latest --command=check-file --yes
+npx claude-code-templates@latest --mcp=github-integration --yes
+```
+
+### 3. Launch Real-time Analytics Dashboard
+```bash
+npx claude-code-templates --analytics
+# This will launch the real-time monitoring dashboard, accessible at http://localhost:3333.
+```
+
+### 4. Run Comprehensive Health Check
+```bash
+npx claude-code-templates --health-check
+# This command performs a comprehensive system validation and provides optimization recommendations.
+```
+
+## Technical Architecture
+
+Built with modern Node.js technologies and **GitHub-first approach**:
+- **CLI Framework**: Commander.js for robust command-line interface management.
+- **GitHub Integration**: Direct downloads from GitHub repository ensuring latest versions.
+- **File Operations**: `fs-extra` for enhanced file system operations.
+- **Template Engine**: Custom template processing and generation for dynamic project setups.
+- **Download Caching**: Intelligent caching system for improved performance.
+- **Analytics Server**: Express.js with WebSocket support for real-time data streaming (optional).
+- **Monitoring**: Chokidar for efficient file system watching (primarily for analytics).
+
+## Documentation
+
+- **[Project Setup & Configuration](./project-setup/interactive-setup)** - Detailed guide on setting up your projects.
+- **[Individual Components](./components/overview)** - Browse and install Agents, Commands, and MCPs individually.
+- **[Analytics Dashboard](./analytics/overview)** - Explore real-time monitoring and analysis tools.
+- **[Health Check](./health-check/overview)** - Understand system validation and optimization.
+-   **[Core Concepts](/docs/project-setup/what-gets-installed)** - Dive into the underlying structure and components.
+- **[Usage Examples](./usage-examples/interactive-setup)** - Practical examples of how to use the CLI.
+- **[CLI Options](./cli-options)** - A complete reference of all available command-line options.
+- **[Safety Features](./safety-features)** - Learn about the built-in safeguards.
+- **[Contributing](./contributing)** - Guidelines for contributing to the project.
+- **[Support](./support)** - Where to find help and report issues.

package/docu/docs/project-setup/automation-hooks.md

@@ -0,0 +1,14 @@
+---
+sidebar_position: 5
+---
+
+# Automation Hooks
+
+Automation hooks in `claude-code-templates` allow you to execute custom actions at key moments during the Claude Code workflow. This enables powerful automation and integration with your existing development processes.
+
+## Types of Hooks
+
+-   **PreToolUse**: These hooks execute before Claude Code uses a tool. They can be used for security checks, logging, or statement detection.
+-   **PostToolUse**: These hooks run after Claude Code has used a tool. Common uses include auto-formatting code, performing type checking, or running tests.
+-   **Stop**: These hooks are triggered when the Claude Code workflow stops. They can be used for final linting, bundle analysis, or other post-completion tasks.
+-   **Notification**: These hooks are designed for activity logging and monitoring, allowing you to receive notifications about various events within the Claude Code workflow.

package/docu/docs/project-setup/framework-specific-setup.md

@@ -0,0 +1,86 @@
+---
+sidebar_position: 2
+---
+
+# Framework-Specific Setup
+
+While the interactive setup is recommended, you can also quickly configure `claude-code-templates` for specific templates using the modern `--template` parameter or legacy `--language`/`--framework` commands.
+
+## Modern Template Installation (Recommended)
+
+Use the new `--template` parameter for streamlined template installation:
+
+```bash
+# React project with all components
+npx claude-code-templates@latest --template=react --yes
+
+# Python project with all components
+npx claude-code-templates@latest --template=python --yes
+
+# Node.js project with all components
+npx claude-code-templates@latest --template=nodejs --yes
+
+# Vue.js project with all components
+npx claude-code-templates@latest --template=vue --yes
+
+# Django project with all components
+npx claude-code-templates@latest --template=django --yes
+```
+
+## Legacy Syntax (Still Supported)
+
+The original `--language` and `--framework` flags are still supported but deprecated:
+
+```bash
+# React + TypeScript project (legacy)
+npx claude-code-templates@latest --language=javascript-typescript --framework=react --yes
+
+# Python + Django project (legacy)
+npx claude-code-templates@latest --language=python --framework=django --yes
+```
+
+**Note**: These legacy parameters will continue to work but using `--template` is preferred for new installations.
+
+The `--yes` flag will skip all prompts and use default configurations, making the setup process fully automated.
+
+## Interactive Setup (Recommended)
+
+Even when you know your framework, running the tool without specific flags is often the best approach:
+
+```bash
+cd my-react-app
+npx claude-code-templates@latest
+# The tool will auto-detect React and suggest optimal configuration
+```
+
+This method allows the tool to intelligently detect your project's environment and offer tailored suggestions, ensuring the best possible setup for your Claude Code workflow.
+
+## Template vs Component Installation
+
+### Complete Templates (`--template`)
+- Downloads complete project configuration from `templates/` directory
+- Includes CLAUDE.md, agents, commands, and MCP configurations
+- Best for new project setups
+
+### Individual Components
+You can also install individual components instead of complete templates:
+
+```bash
+# Install specific agent
+npx claude-code-templates@latest --agent=react-performance --yes
+
+# Install specific command
+npx claude-code-templates@latest --command=check-file --yes
+
+# Install specific MCP
+npx claude-code-templates@latest --mcp=github-integration --yes
+```
+
+## GitHub Download System
+
+All templates and components are now downloaded directly from GitHub:
+
+- **Real-time Downloads**: Always get the latest versions
+- **Transparent URLs**: See exactly what files are being downloaded
+- **Caching**: Downloaded files are cached for better performance
+- **Repository Structure**: Templates in `templates/`, components in `components/`

package/docu/docs/project-setup/interactive-setup.md

@@ -0,0 +1,59 @@
+---
+sidebar_position: 1
+---
+
+# Interactive Project Setup
+
+The `claude-code-templates` CLI provides an interactive way to set up and configure your projects for Claude Code. This is the recommended way to get started.
+
+## Quick Start
+
+To begin, navigate to your project directory and run the following command:
+
+```bash
+npx claude-code-templates@latest
+```
+
+You'll be greeted with an interactive welcome screen:
+
+```bash
+
+ ██████╗██╗      █████╗ ██╗   ██╗██████╗ ███████╗
+██╔════╝██║     ██╔══██╗██║   ██║██╔══██╗██╔════╝
+██║     ██║     ███████║██║   ██║██║  ██║█████╗  
+██║     ██║     ██╔══██║██║   ██║██║  ██║██╔══╝  
+╚██████╗███████╗██║  ██║╚██████╔╝██████╔╝███████╗
+ ╚═════╝╚══════╝╚═╝  ╚═╝ ╚═════╝ ╚═════╝ ╚══════╝
+
+ ██████╗ ██████╗ ██████╗ ███████╗
+██╔════╝██╔═══██╗██╔══██╗██╔════╝
+██║     ██║   ██║██║  ██║█████╗  
+██║     ██║   ██║██║  ██║██╔══╝  
+╚██████╗╚██████╔╝██████╔╝███████╗
+ ╚═════╝ ╚═════╝ ╚═════╝ ╚══════╝
+
+████████╗███████╗███╗   ███╗██████╗ ██╗      █████╗ ████████╗███████╗███████╗
+╚══██╔══╝██╔════╝████╗ ████║██╔══██╗██║     ██╔══██╗╚══██╔══╝██╔════╝██╔════╝
+   ██║   █████╗  ██╔████╔██║██████╔╝██║     ███████║   ██║   █████╗  ███████╗
+   ██║   ██╔══╝  ██║╚██╔╝██║██╔═══╝ ██║     ██╔══██║   ██║   ██╔══╝  ╚════██║
+   ██║   ███████╗██║ ╚═╝ ██║██║     ███████╗██║  ██║   ██║   ███████╗███████║
+   ╚═╝   ╚══════╝╚═╝     ╚═╝╚═╝     ╚══════╝╚═╝  ╚═╝   ╚══════╝╚══════╝╚══════╝
+
+🚀 Welcome to Claude Code Templates!
+
+¿What would you like to do?
+❯ 📊 Analytics Dashboard - Monitor your Claude Code usage and sessions
+  🔍 Health Check - Validate your Claude Code configuration and system
+  ⚙️ Project Setup - Configure Claude Code for your project
+```
+
+From this interactive menu, you can choose to:
+- **📊 Analytics Dashboard**: View your Claude Code sessions, usage patterns, and performance metrics.
+- **🔍 Health Check**: Perform a comprehensive system validation and configuration verification.
+- **⚙️ Project Setup**: Configure Claude Code for your project with framework-specific commands and hooks.
+
+Choosing "Project Setup" will guide you through the process of setting up your project with the appropriate Claude Code templates and configurations. This includes:
+- Auto-detection of your project's language and framework.
+- Generation of `CLAUDE.md` with project-specific instructions.
+- Configuration of development commands.
+- Installation of Claude Code agents for specialized assistance.

package/docu/docs/project-setup/mcp-integration.md

@@ -0,0 +1,17 @@
+---
+sidebar_position: 6
+---
+
+# MCP Integration
+
+Model Context Protocol (MCP) integration allows you to extend Claude Code with specialized capabilities, enabling it to interact with various external tools and services. This enhances Claude Code's ability to understand and operate within your development environment.
+
+## Extending Claude Code with MCP
+
+MCP integration enables functionalities such as:
+
+-   **Deep Graph MCP**: Integrates with Deep Graph to allow any Codebase Graph to be used as context, improving Claude Code's responses.
+-   **IDE Integration**: Facilitates diagnostics within VS Code and execution within Jupyter notebooks.
+-   **Web Search**: Allows real-time information retrieval directly through Claude Code.
+-   **Database Tools**: Provides connections to various databases like PostgreSQL and MySQL.
+-   **Development Tools**: Enables interaction with tools like Docker, GitHub, and direct filesystem operations.

package/docu/docs/project-setup/supported-languages-frameworks.md

@@ -0,0 +1,15 @@
+---
+sidebar_position: 4
+---
+
+# Supported Languages & Frameworks
+
+`claude-code-templates` is designed to support a wide range of programming languages and frameworks, providing tailored configurations and commands for each. The following table outlines the current status of support:
+
+| Language | Frameworks | Status | Commands | Hooks | MCP |
+|----------|------------|---------|----------|--------|-----|
+| **JavaScript/TypeScript** | React, Vue, Angular, Node.js | ✅ Ready | 7+ | 9+ | 4+ |
+| **Python** | Django, Flask, FastAPI | ✅ Ready | 5+ | 8+ | 4+ |
+| **Common** | Universal | ✅ Ready | 2+ | 1+ | 4+ |
+| **Go** | Gin, Echo, Fiber | 🚧 Coming Soon | - | - | - |
+| **Rust** | Axum, Warp, Actix | 🚧 Coming Soon | - | - | - |

package/docu/docs/project-setup/what-gets-installed.md

@@ -0,0 +1,176 @@
+---
+sidebar_position: 3
+---
+
+# What Gets Installed
+
+When you use `claude-code-templates` to set up your project, it installs several core files and configurations to integrate Claude Code effectively into your development environment. You can choose between **complete templates** (comprehensive project setup) or **individual components** (selective functionality).
+
+## Installation Methods
+
+### Complete Template Installation
+For comprehensive project setup with all recommended components:
+
+```bash
+# Interactive setup (recommended)
+npx claude-code-templates@latest
+
+# Modern template installation (preferred)
+npx claude-code-templates@latest --template=react --yes
+npx claude-code-templates@latest --template=python --yes
+npx claude-code-templates@latest --template=nodejs --yes
+
+# Legacy syntax (still supported but deprecated)
+npx claude-code-templates@latest --language=javascript-typescript --framework=react
+```
+
+### Individual Component Installation
+For selective component installation using **dedicated CLI parameters**:
+
+#### Agents (🤖)
+Install specialized AI assistants using the `--agent` parameter:
+
+```bash
+# Install specific agents
+npx claude-code-templates@latest --agent=react-performance --yes
+npx claude-code-templates@latest --agent=api-security-audit --yes
+npx claude-code-templates@latest --agent=database-optimization --yes
+```
+
+**Available agents include:**
+- React Performance Optimization Agent
+- API Security Audit Agent  
+- Database Optimization Agent
+- And more framework-specific agents
+
+#### Commands (⚡)
+Install custom slash commands using the `--command` parameter:
+
+```bash
+# Install specific commands
+npx claude-code-templates@latest --command=check-file --yes
+npx claude-code-templates@latest --command=generate-tests --yes
+npx claude-code-templates@latest --command=optimize-imports --yes
+```
+
+**Manual installation (alternative method):**
+```bash
+# Create commands directory
+mkdir -p .claude/commands
+
+# Install specific commands via direct download
+curl -o .claude/commands/check-file.md \
+  https://raw.githubusercontent.com/davila7/claude-code-templates/main/components/commands/check-file.md
+```
+
+#### MCPs (🔌)
+Install Model Context Protocol integrations using the `--mcp` parameter:
+
+```bash
+# Install specific MCPs
+npx claude-code-templates@latest --mcp=github-integration --yes
+npx claude-code-templates@latest --mcp=database-integration --yes
+npx claude-code-templates@latest --mcp=deepgraph-react --yes
+```
+
+**Manual installation (alternative method):**
+```bash
+# GitHub integration
+curl -o ./github-integration.json \
+  https://raw.githubusercontent.com/davila7/claude-code-templates/main/components/mcps/github-integration.json
+```
+
+## Core Files Installed
+
+### Complete Template Installation Files
+
+-   **`CLAUDE.md`**: This is the main configuration file for Claude Code, containing language-specific best practices and instructions.
+-   **`.claude/settings.json`**: This file stores automation hooks and general Claude Code settings.
+-   **`.claude/commands/`**: This directory contains custom commands tailored for common development tasks within your project.
+-   **`.mcp.json`**: This file holds Model Context Protocol (MCP) server configurations, extending Claude Code's capabilities.
+
+### Individual Component Files
+
+#### Agent Files
+- **Embedded in `CLAUDE.md`**: Agent configurations are integrated into the main Claude Code configuration file
+- **Specialized prompts**: Domain-specific instructions for focused AI assistance
+
+#### Command Files
+- **`.claude/commands/*.md`**: Individual command files in Markdown format
+- **Custom slash commands**: Extend Claude Code with project-specific functionality
+
+#### MCP Files
+- **`*.json`**: MCP configuration files for external service integrations
+- **Authentication configs**: Secure connection settings for external services
+
+## Templates vs Individual Components
+
+### Complete Templates (`--template`)
+**Full project setup with comprehensive configuration**
+
+```bash
+# Downloads complete template with multiple components
+npx claude-code-templates@latest --template=react --yes
+```
+
+**Use Templates When:**
+- ✅ Setting up a new project from scratch
+- ✅ You want a comprehensive, tested configuration
+- ✅ You're new to Claude Code and want everything configured properly
+- ✅ You prefer opinionated setups with best practices included
+
+### Individual Components (`--agent`, `--command`, `--mcp`)
+**Selective installation of specific functionality**
+
+```bash
+# Downloads individual components to specific locations
+npx claude-code-templates@latest --agent=react-performance --yes
+npx claude-code-templates@latest --command=check-file --yes
+npx claude-code-templates@latest --mcp=github-integration --yes
+```
+
+**Use Individual Components When:**
+- ✅ You have an existing Claude Code setup to enhance
+- ✅ You only need specific functionality (e.g., just GitHub integration)
+- ✅ You want to gradually add capabilities to your workflow
+- ✅ You're experimenting with new tools and integrations
+- ✅ You have custom requirements that don't match standard templates
+
+## GitHub Download System
+
+All templates and components are now downloaded directly from GitHub in real-time:
+
+- **Templates**: Downloaded from `templates/` directory
+- **Components**: Downloaded from `components/` directory
+  - Agents: `components/agents/`
+  - Commands: `components/commands/`
+  - MCPs: `components/mcps/`
+- **Caching**: Downloaded files are cached for performance
+- **Transparency**: All download URLs are visible during installation
+- **Latest Versions**: Always get the most up-to-date components
+
+## Component Discovery
+
+You can discover and install components through:
+
+1. **CLI Parameters**: Use dedicated parameters (`--agent`, `--command`, `--mcp`, `--template`)
+2. **Web Interface**: Visit the [unified component browser](https://davila7.github.io/claude-code-templates/) to explore all available templates and components
+3. **Interactive CLI**: Run `npx claude-code-templates@latest` and select "⚙️ Project Setup"
+4. **GitHub Repository**: Browse components directly in the [repository structure](https://github.com/davila7/claude-code-templates)
+
+## Installation Paths
+
+Components are installed to specific locations based on their type:
+
+| Component Type | CLI Parameter | Installation Path | Example |
+|----------------|---------------|-------------------|----------|
+| **Template** | `--template=name` | Multiple files | Full project setup |
+| **Agent** | `--agent=name` | `.claude/agents/` | Embedded in CLAUDE.md |
+| **Command** | `--command=name` | `.claude/commands/` | `.claude/commands/name.md` |
+| **MCP** | `--mcp=name` | `.mcp.json` | MCP configuration |
+
+For detailed information about each component type, see:
+- [Individual Components Overview](../components/overview)
+- [Agents Documentation](../components/agents)
+- [Commands Documentation](../components/commands)
+- [MCPs Documentation](../components/mcps)

package/docu/docs/safety-features.md

@@ -0,0 +1,13 @@
+---
+sidebar_position: 1
+---
+
+# Safety Features
+
+`claude-code-templates` is designed with several safety features to ensure that your project and data are protected during the setup and configuration process.
+
+-   **Automatic Backups**: Existing files are automatically backed up before any changes are made, allowing you to revert to a previous state if needed.
+-   **Confirmation Required**: The CLI always asks for your confirmation before making significant changes to your project (unless the `--yes` flag is used), giving you full control over the process.
+-   **Dry Run Mode**: You can preview the installation and changes without actually modifying your files by using the `--dry-run` option.
+-   **Cancel Anytime**: You can cancel the operation at any point by pressing `Ctrl+C` or by answering 'No' to confirmation prompts.
+-   **Back Navigation**: During interactive setup, you can navigate back to modify previous selections, preventing accidental configurations.

package/docu/docs/support.md

@@ -0,0 +1,13 @@
+---
+sidebar_position: 1
+---
+
+# Support
+
+If you encounter any issues, have questions, or need assistance with `claude-code-templates`, please refer to the following resources:
+
+-   **🐛 Issues**: [Report bugs or request features](https://github.com/davila7/claude-code-templates/issues)
+-   **💬 Discussions**: [Join community discussions](https://github.com/davila7/claude-code-templates/discussions)
+-   **🔒 Security**: [Report security vulnerabilities](https://github.com/davila7/claude-code-templates/blob/main/SECURITY.md)
+-   **📖 Documentation**: [Claude Code Official Docs](https://docs.anthropic.com/en/docs/claude-code)
+-   **🤝 Contributing**: [Read our contribution guidelines](https://github.com/davila7/claude-code-templates/blob/main/CONTRIBUTING.md)

package/docu/docs/usage-examples/advanced-options.md

@@ -0,0 +1,87 @@
+---
+sidebar_position: 3
+---
+
+# Advanced Options
+
+`claude-code-templates` provides several advanced command-line options for more granular control over its behavior.
+
+## Template and Component Installation
+
+```bash
+# Modern template installation (recommended)
+npx claude-code-templates@latest --template=react --yes
+npx claude-code-templates@latest --template=python --yes
+
+# Individual component installation
+npx claude-code-templates@latest --agent=react-performance --yes
+npx claude-code-templates@latest --command=check-file --yes
+npx claude-code-templates@latest --mcp=github-integration --yes
+
+# Legacy syntax (still supported but deprecated)
+npx claude-code-templates@latest --language=javascript-typescript --framework=react --yes
+```
+
+## Installation Control Options
+
+```bash
+# Preview installation without making changes
+npx claude-code-templates@latest --dry-run
+
+# Skip all prompts and use defaults
+npx claude-code-templates@latest --yes
+
+# Install to custom directory
+npx claude-code-templates@latest --directory /path/to/project
+```
+
+## System Analysis and Monitoring
+
+```bash
+# Run comprehensive system health check
+npx claude-code-templates@latest --health-check
+npx claude-code-templates@latest --health
+npx claude-code-templates@latest --check
+npx claude-code-templates@latest --verify
+
+# Analyze existing commands 
+npx claude-code-templates@latest --commands-stats
+
+# Analyze automation hooks
+npx claude-code-templates@latest --hooks-stats
+
+# Analyze MCP server configurations 
+npx claude-code-templates@latest --mcps-stats
+
+# Launch real-time analytics dashboard
+npx claude-code-templates@latest --analytics
+npx cct --analytics
+```
+
+## Component-Specific Examples
+
+### Installing Multiple Components
+```bash
+# Install multiple components in sequence
+npx claude-code-templates@latest --agent=react-performance --yes
+npx claude-code-templates@latest --command=check-file --yes
+npx claude-code-templates@latest --mcp=github-integration --yes
+```
+
+### Combining with Analysis
+```bash
+# Install component and run stats
+npx claude-code-templates@latest --template=react --yes
+npx claude-code-templates@latest --commands-stats
+```
+
+## GitHub Download System
+
+All installations now use the GitHub download system:
+
+- **Real-time Downloads**: Always get the latest versions from GitHub
+- **Caching**: Downloaded files are cached for better performance  
+- **Transparency**: All download URLs are visible during installation
+- **Repository Structure**: Templates from `templates/`, components from `components/`
+
+For a complete list of options and their descriptions, refer to the [CLI Options](/docs/cli-options) documentation.

package/docu/docs/usage-examples/alternative-commands.md

@@ -0,0 +1,31 @@
+---
+sidebar_position: 4
+---
+
+# Alternative Commands
+
+`claude-code-templates` offers several alternative commands that perform the exact same function, providing flexibility and convenience.
+
+## Long Form Commands
+
+These commands are more descriptive and can be used interchangeably:
+
+```bash
+npx claude-code-templates    # ✅ Recommended (package name)
+npx claude-code-template     # Singular alias
+npx create-claude-config     # Create-style command
+npx claude-setup             # Setup-style command
+npx claude-config            # Config-style command
+npx claude-init              # Init-style command
+```
+
+## Short Form Commands
+
+For quicker access, you can use these abbreviated commands:
+
+```bash
+npx cctemplates              # Claude Code Templates
+npx cct                      # ⚡ Super short (3 letters)
+```
+
+All these commands work exactly the same way, allowing you to choose the one that best fits your workflow.