claude-code-templates 1.21.1 → 1.21.3

package/README.md

@@ -2,123 +2,125 @@
 [![npm downloads](https://img.shields.io/npm/dt/claude-code-templates.svg)](https://www.npmjs.com/package/claude-code-templates)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Open Source](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://opensource.org/)
-[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/davila7/claude-code-templates/blob/main/CONTRIBUTING.md)
 [![GitHub stars](https://img.shields.io/github/stars/davila7/claude-code-templates.svg?style=social&label=Star)](https://github.com/davila7/claude-code-templates)
-[![Mentioned in Awesome Claude Code](https://awesome.re/mentioned-badge-flat.svg)](https://github.com/hesreallyhim/awesome-claude-code)
-[![Buy Me a Coffee](https://img.shields.io/badge/☕-Buy%20me%20a%20coffee-ffdd00?style=flat&logo=buy-me-a-coffee)](https://buymeacoffee.com/daniavila)
 
+# Claude Code Templates
 
+**CLI tool for configuring and monitoring Claude Code** - Quick setup for any project with framework-specific commands and real-time monitoring dashboard.
 
-# Claude Code Templates (aitmpl.com)
-
-**Ready-to-use configurations for Anthropic's Claude Code.** A comprehensive collection of AI agents, custom commands, settings, hooks, external integrations (MCPs), and project templates to enhance your development workflow.
-
-## Browse & Install Components and Templates
-
-**[Browse All Templates](https://aitmpl.com)** - Interactive web interface to explore and install 100+ agents, commands, settings, hooks, and MCPs.
-
-<img width="1049" height="855" alt="Screenshot 2025-08-19 at 08 09 24" src="https://github.com/user-attachments/assets/e3617410-9b1c-4731-87b7-a3858800b737" />
-
-## 🚀 Quick Installation
+## 🚀 Quick Start
 
 ```bash
-# Install a complete development stack
-npx claude-code-templates@latest --agent frontend-developer --command generate-tests --mcp github-integration
-
-# Browse and install interactively
+# Interactive setup (recommended)
 npx claude-code-templates@latest
 
-# Install specific components
-npx claude-code-templates@latest --agent security-auditor
-npx claude-code-templates@latest --command optimize-bundle
-npx claude-code-templates@latest --setting mcp-timeouts
-npx claude-code-templates@latest --hook pre-commit-validation
-npx claude-code-templates@latest --mcp postgresql-integration
+# Real-time analytics dashboard
+npx claude-code-templates@latest --analytics
+
+# System health check
+npx claude-code-templates@latest --health-check
 ```
 
-## What You Get
+## ✨ Core Features
 
-| Component | Description | Examples |
-|-----------|-------------|----------|
-| **🤖 Agents** | AI specialists for specific domains | Security auditor, React performance optimizer, database architect |
-| **⚡ Commands** | Custom slash commands | `/generate-tests`, `/optimize-bundle`, `/check-security` |
-| **🔌 MCPs** | External service integrations | GitHub, PostgreSQL, Stripe, AWS, OpenAI |
-| **⚙️ Settings** | Claude Code configurations | Timeouts, memory settings, output styles |
-| **🪝 Hooks** | Automation triggers | Pre-commit validation, post-completion actions |
-| **📦 Templates** | Complete project configurations with CLAUDE.md, .claude/* files and .mcp.json | Framework-specific setups, project best practices |
+- **📋 Smart Project Setup** - Auto-detect and configure any project with framework-specific commands
+- **📊 Real-time Analytics** - Monitor Claude Code sessions with live state detection and performance metrics
+- **🔍 Health Check** - Comprehensive system validation with actionable recommendations
+- **🧩 Individual Components** - Install specialized agents, commands, and MCPs individually
+- **🌍 Global Agents** - Create AI agents accessible from anywhere using Claude Code SDK
 
-## 🛠️ Additional Tools
+## 🎯 What You Get
 
-Beyond the template catalog, Claude Code Templates includes powerful development tools:
+| Component | Description | Example |
+|-----------|-------------|---------|
+| **CLAUDE.md** | Project-specific Claude Code configuration | Framework best practices, coding standards |
+| **Commands** | Custom slash commands for development tasks | `/generate-tests`, `/check-file`, `/optimize-bundle` |
+| **Agents** | AI specialists for specific domains | API security audit, React performance, database optimization |
+| **MCPs** | External service integrations | GitHub, databases, development tools |
+| **Analytics** | Real-time monitoring dashboard | Live session tracking, usage statistics, exports |
 
-### 📊 Claude Code Analytics
-Monitor your AI-powered development sessions in real-time with live state detection and performance metrics.
+## 🛠️ Supported Technologies
 
-```bash
-npx claude-code-templates@latest --analytics
-```
+| Language | Frameworks | Status |
+|----------|------------|---------|
+| **JavaScript/TypeScript** | React, Vue, Angular, Node.js | ✅ Ready |
+| **Python** | Django, Flask, FastAPI | ✅ Ready |
+| **Common** | Universal configurations | ✅ Ready |
+| **Go** | Gin, Echo, Fiber | 🚧 Coming Soon |
+| **Rust** | Axum, Warp, Actix | 🚧 Coming Soon |
 
-### 💬 Conversation Monitor  
-Mobile-optimized interface to view Claude responses in real-time with secure remote access.
+## 🌍 Global Agents (Claude Code SDK Integration)
+
+Create AI agents that can be executed from anywhere using the Claude Code SDK:
 
 ```bash
-# Local access
-npx claude-code-templates@latest --chats
+# Create a global agent (one-time setup)
+npx claude-code-templates@latest --create-agent customer-support
 
-# Secure remote access via Cloudflare Tunnel
-npx claude-code-templates@latest --chats --tunnel
+# Use the agent from anywhere
+customer-support "Help me with ticket #12345"
+sre-logs "Analyze error patterns in app.log"  
+code-reviewer "Review this PR for security issues"
 ```
 
-### 🔍 Health Check
-Comprehensive diagnostics to ensure your Claude Code installation is optimized.
+### Available Global Agents
+
+| Agent | Usage | Description |
+|-------|-------|-------------|
+| `customer-support` | `customer-support "query"` | AI customer support specialist |
+| `api-security-audit` | `api-security-audit "analyze endpoints"` | Security auditing for APIs |
+| `react-performance-optimization` | `react-performance-optimization "optimize components"` | React performance expert |
+| `database-optimization` | `database-optimization "improve queries"` | Database performance tuning |
+
+### Global Agent Management
 
 ```bash
-npx claude-code-templates@latest --health-check
-```
+# List installed global agents
+npx claude-code-templates@latest --list-agents
 
-## 📖 Documentation
+# Update an agent to latest version
+npx claude-code-templates@latest --update-agent customer-support
 
-**[📚 docs.aitmpl.com](https://docs.aitmpl.com/)** - Complete guides, examples, and API reference for all components and tools.
+# Remove an agent
+npx claude-code-templates@latest --remove-agent customer-support
+```
+
+### How It Works
 
-## Contributing
+1. **Download Agent**: Fetches the latest agent from GitHub
+2. **Generate Executable**: Creates a Node.js script that calls Claude Code SDK
+3. **Add to PATH**: Makes the agent available globally in your shell
+4. **Ready to Use**: Execute `agent-name "your prompt"` from any directory
 
-We welcome contributions! **[Browse existing templates](https://aitmpl.com)** to see what's available, then check our [contributing guidelines](CONTRIBUTING.md) to add your own agents, commands, MCPs, settings, or hooks.
+The agents use the Claude Code SDK internally to provide specialized AI assistance with domain-specific knowledge and best practices.
 
-**Please read our [Code of Conduct](CODE_OF_CONDUCT.md) before contributing.**
+## 📖 Documentation
 
-## Attribution
+**[📚 Complete Documentation](https://docs.aitmpl.com/)** - Comprehensive guides, examples, and API reference
 
-This collection includes components from multiple sources:
+Quick links:
+- [Getting Started](https://docs.aitmpl.com/docs/intro) - Installation and first steps
+- [Project Setup](https://docs.aitmpl.com/docs/project-setup/interactive-setup) - Configure your projects
+- [Analytics Dashboard](https://docs.aitmpl.com/docs/analytics/overview) - Real-time monitoring
+- [Individual Components](https://docs.aitmpl.com/docs/components/overview) - Agents, Commands, MCPs
+- [CLI Options](https://docs.aitmpl.com/docs/cli-options) - All available commands
 
-**Agents Collection:**
-- **wshobson/agents Collection** by [wshobson](https://github.com/wshobson/agents) - Licensed under MIT License (48 agents)
+## 🤝 Contributing
 
-**Commands Collection:**
-- **awesome-claude-code Commands** by [hesreallyhim](https://github.com/hesreallyhim/awesome-claude-code) - Licensed under CC0 1.0 Universal (21 commands)
+We welcome contributions! Browse available templates and components at **[aitmpl.com](https://aitmpl.com)**, then check our [contributing guidelines](https://github.com/davila7/claude-code-templates/blob/main/CONTRIBUTING.md).
 
 ## 📄 License
 
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+MIT License - see the [LICENSE](LICENSE) file for details.
 
 ## 🔗 Links
 
-- **🌐 Browse Templates**: [aitmpl.com](https://aitmpl.com)
+- **🌐 Browse Components**: [aitmpl.com](https://aitmpl.com)
 - **📚 Documentation**: [docs.aitmpl.com](https://docs.aitmpl.com)
-- **💬 Community**: [GitHub Discussions](https://github.com/davila7/claude-code-templates/discussions)
 - **🐛 Issues**: [GitHub Issues](https://github.com/davila7/claude-code-templates/issues)
-
-## ⭐ Star History
-
-<a href="https://star-history.com/#davila7/claude-code-templates&Date">
-  <picture>
-    <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=davila7/claude-code-templates&type=Date&theme=dark" />
-    <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=davila7/claude-code-templates&type=Date" />
-    <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=davila7/claude-code-templates&type=Date" />
-  </picture>
-</a>
+- **💬 Discussions**: [GitHub Discussions](https://github.com/davila7/claude-code-templates/discussions)
 
 ---
 
-**⭐ Found this useful? Give us a star to support the project!**
-
-[![Buy Me A Coffee](https://img.buymeacoffee.com/button-api/?text=Buy%20me%20a%20coffee&slug=daniavila&button_colour=FFDD00&font_colour=000000&font_family=Cookie&outline_colour=000000&coffee_colour=ffffff)](https://buymeacoffee.com/daniavila)
+**⭐ Found this useful? Give us a star to support the project!**

package/package.json

@@ -1,28 +1,95 @@
 {
   "name": "claude-code-templates",
-  "version": "1.21.1",
-  "description": "Component templates and tracking system for Claude Code",
-  "main": "index.js",
-  "scripts": {
-    "dev": "vercel dev",
-    "build": "echo 'Build complete'",
-    "start": "vercel dev",
-    "test": "echo 'No tests specified'",
-    "agent:security-auditor": "security-auditor 'Security audit covering codebase, dependencies, and deployment configuration'"
-  },
-  "dependencies": {
-    "@vercel/postgres": "^0.10.0"
+  "version": "1.21.3",
+  "description": "CLI tool to setup Claude Code configurations with framework-specific commands, automation hooks and MCP Servers for your projects",
+  "main": "src/index.js",
+  "bin": {
+    "create-claude-config": "bin/create-claude-config.js",
+    "claude-code-templates": "bin/create-claude-config.js",
+    "claude-code-template": "bin/create-claude-config.js",
+    "claude-init": "bin/create-claude-config.js",
+    "cctemplates": "bin/create-claude-config.js",
+    "cct": "bin/create-claude-config.js",
+    "claude-setup": "bin/create-claude-config.js",
+    "claude-config": "bin/create-claude-config.js"
   },
-  "devDependencies": {
-    "@vercel/node": "^3.0.0"
+  "scripts": {
+    "start": "node bin/create-claude-config.js",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "test:unit": "jest tests/unit",
+    "test:integration": "jest tests/integration",
+    "test:e2e": "jest tests/e2e",
+    "test:analytics": "jest --testPathPattern=analytics",
+    "test:commands": "./test-commands.sh",
+    "test:detailed": "./test-detailed.sh",
+    "test:react": "make test-react",
+    "test:vue": "make test-vue",
+    "test:node": "make test-node",
+    "test:all": "npm run test:coverage && make test",
+    "dev:link": "npm link",
+    "dev:unlink": "npm unlink -g claude-code-templates",
+    "pretest:commands": "npm run dev:link",
+    "analytics:start": "node src/analytics.js",
+    "analytics:test": "npm run test:analytics"
   },
   "keywords": [
+    "claude",
     "claude-code",
-    "templates",
-    "components",
-    "tracking",
-    "analytics"
+    "ai",
+    "configuration",
+    "template",
+    "setup",
+    "cli",
+    "hooks",
+    "automation",
+    "javascript",
+    "typescript",
+    "react",
+    "vue",
+    "angular",
+    "nodejs",
+    "python",
+    "django",
+    "flask",
+    "fastapi",
+    "rust",
+    "go"
   ],
   "author": "Claude Code Templates",
-  "license": "MIT"
+  "license": "MIT",
+  "dependencies": {
+    "boxen": "^5.1.2",
+    "chalk": "^4.1.2",
+    "chokidar": "^3.5.3",
+    "commander": "^11.1.0",
+    "express": "^4.18.2",
+    "fs-extra": "^11.1.1",
+    "inquirer": "^8.2.6",
+    "open": "^8.4.2",
+    "ora": "^5.4.1",
+    "uuid": "^11.1.0",
+    "ws": "^8.18.3"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/davila7/claude-code-templates.git"
+  },
+  "bugs": {
+    "url": "https://github.com/davila7/claude-code-templates/issues"
+  },
+  "homepage": "https://github.com/davila7/claude-code-templates#readme",
+  "files": [
+    "bin/",
+    "src/",
+    "README.md"
+  ],
+  "devDependencies": {
+    "jest": "^30.0.4",
+    "jest-watch-typeahead": "^3.0.1"
+  }
 }

package/{cli-tool/src → src}/index.js

@@ -1247,9 +1247,26 @@ async function getAvailableAgentsFromGitHub() {
       }
     }
     
-    // Fallback to GitHub API if local file not found
-    console.log(chalk.yellow('⚠️  Local components.json not found, using GitHub API...'));
+    // Fallback to aitmpl.com API if local file not found
+    console.log(chalk.yellow('⚠️  Local components.json not found, fetching from aitmpl.com...'));
     
+    try {
+      // Try aitmpl.com API first
+      const apiResponse = await fetch('https://aitmpl.com/api/agents.json');
+      if (apiResponse.ok) {
+        const apiData = await apiResponse.json();
+        
+        if (apiData.agents && Array.isArray(apiData.agents)) {
+          console.log(chalk.green(`✅ Loaded ${apiData.agents.length} agents from aitmpl.com API`));
+          return apiData.agents;
+        }
+      }
+    } catch (apiError) {
+      console.warn('Could not fetch from aitmpl.com, trying GitHub API...');
+    }
+    
+    // If aitmpl.com API fails, try GitHub API as secondary fallback
+    console.log(chalk.yellow('⚠️  Falling back to GitHub API...'));
     const response = await fetch('https://api.github.com/repos/davila7/claude-code-templates/contents/cli-tool/components/agents');
     if (!response.ok) {
       // Check for rate limit error