- Created TRACKING_SYSTEM.md with complete architecture overview
- Added detailed Mermaid diagrams for data flow and system components
- Documented privacy controls, security considerations, and troubleshooting
- Updated README.md with link to technical documentation
- Provides complete reference for tracking system implementation
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Fix last_updated field to use actual timestamp instead of literal string
- Use CURRENT_TIMESTAMP variable with proper command substitution
- Update sample data to reflect recent testing (2 agent downloads)
- Remove single quotes around EOF to allow variable expansion
- Switch from Vercel to GitHub Pages tracking endpoint
- Use custom domain aitmpl.com for tracking requests
- Verified working with successful 200 responses
- Completely anonymous tracking through GitHub Pages infrastructure
- Add track.html endpoint for visible tracking
- Add api/track.html for silent tracking with 1x1 pixel
- Create GitHub Action to process tracking logs
- Use GitHub Pages infrastructure for anonymous tracking
- No external dependencies or authentication required
- Add public telemetry endpoint that returns 1x1 GIF (like Google Analytics)
- Enable anonymous tracking via GET requests with no-cors mode
- Endpoint creates GitHub issues for existing analytics workflow
- Maintains full compatibility with current download-stats.json system
- No authentication required - completely anonymous tracking
- Replace GitHub repository dispatch with Vercel function
- Add vercel-tracking/ project with /api/track endpoint
- Enable completely anonymous tracking without user credentials
- Maintain same analytics data structure and GitHub issues creation
- Replace direct issue creation with repository dispatch events
- Add tracking-dispatch.yml workflow to handle tracking events
- Enable anonymous tracking without requiring user tokens
- Maintain same analytics data structure for compatibility
## Major Changes
### 🔄 GitHub Download System
- All templates now download directly from GitHub instead of local files
- Components (agents, commands, MCPs) download from `components/` directory
- Templates download from `templates/` directory
- Added download caching to avoid repeated requests
- Show clear GitHub URLs for transparency
### 🆕 New --template Parameter
- Added `--template` parameter as modern replacement for `--language`/`--framework`
- Maintains backward compatibility with deprecated `--language`/`--framework`
- Updated web interface to use new syntax: `npx claude-code-templates@latest --template=python --yes`
### 🎯 Component vs Template Separation
- `--agent=name`: Downloads individual component to `.claude/agents/`
- `--command=name`: Downloads individual component to `.claude/commands/`
- `--mcp=name`: Downloads individual component to `.mcp.json`
- `--template=name`: Downloads complete template with full configuration
### 📦 Web Interface Updates
- Updated installation commands to use `npx` with latest version
- Changed from `--language`/`--framework` to `--template` syntax
- Made global installation optional in step 1
- All template cards now show correct download commands
### ✅ Benefits
- Always up-to-date content from GitHub main branch
- No need to republish npm package for content updates
- Clear distinction between individual components and full templates
- Improved user experience with transparent download sources
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Reorder HTML sections to show downloadStatsSection before unified-filter-section
- Community downloads statistics now appear above component filter buttons
- Maintains proper visual hierarchy as requested
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Disable hideStatisticsSection function to prevent hiding stats
- Add CSS !important rule to ensure section stays visible
- Maintain download statistics display even when data is not available
- Keep section positioned above the component filters as requested
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Comment out documentation button link to /docu/
- Prevents users from accessing broken documentation page
- Will restore once Docusaurus deployment is fixed
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Replace npm ci with npm install to avoid lock file sync issues
- This ensures dependencies install even with minor version conflicts
- Keep npm caching for better performance
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Revert tsconfig.json to use @docusaurus/tsconfig properly
- Clean install dependencies to sync package-lock.json
- Fix npm ci compatibility for GitHub Actions deployment
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Fix tsconfig.json by removing invalid @docusaurus/tsconfig extends
- Add proper TypeScript configuration for Docusaurus
- Complete download count badges for template, agent, command, and MCP cards
- Add analytics data integration with card regeneration
- Include tracking service and GitHub Actions workflow for analytics processing
- Update web interface with download statistics display
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
### ✨ New Features
- **Custom Domain**: Documentation now available at https://aitmpl.com/docu/
- **Expert Agents System**: New agent-expert, command-expert, and mcp-expert for community contributions
- **Unified Component Cards**: Fixed "Add New" cards design and behavior consistency
### 📚 Documentation
- **Complete Docusaurus Site**: Comprehensive documentation with searchable content
- **Simplified READMEs**: Streamlined both root and cli-tool READMEs, directing to full docs
- **Expert Agent Workflows**: Detailed guides for creating agents, commands, and MCPs
### 🎨 UI/UX Improvements
- **Component Cards**: Fixed design inconsistencies in "Add New" template/component cards
- **Navigation**: All documentation links now point to custom domain
- **Responsive Design**: Better mobile experience for documentation site
### 🔧 Infrastructure
- **GitHub Pages**: Custom domain configuration with proper routing
- **Community Workflow**: Streamlined process for community contributions using expert agents
### 🤝 Community
- **Contribution System**: New expert agents enable easy community contributions
- **Component Creation**: Standardized workflow for creating agents, commands, and MCPs
- **Documentation Hub**: Centralized documentation for better developer experience
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Remove non-existent 'claude auth status' command check
- Add proper detection for Claude Code OAuth authentication via ~/.claude.json
- Check for oauthAccount field to verify OAuth authentication
- Support API key authentication via config file or environment variable
- Display user email for OAuth authentication when available
- Provide more accurate status messages based on actual auth state
The health check was incorrectly reporting 'Claude CLI available but
authentication not verified' even when users were properly authenticated.
This fix ensures proper detection and reporting of authentication status
for Claude Code users using either OAuth or API key authentication methods.
- Remove install-note sections from component cards to match template design
- Fix commands installation to include mkdir -p for .claude/commands
- Simplify card back to show only Installation Command title
- Remove unused CSS for install-note styling
- Clean up unused getInstallationTitle function
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Introduced AgentAnalyzer class to analyze agent invocation data, usage frequency, and workflow patterns.
- Implemented endpoint for agent usage analytics in ClaudeAnalytics.
- Enhanced session management to account for scheduled reset times instead of fixed durations.
- Updated SessionAnalyzer to reflect new session reset logic and improved warning messages.
- Added functionality to calculate agent efficiency and popular usage hours.
- Created a .nojekyll file for GitHub Pages deployment in Docusaurus configuration.
* feat: add agents selection to interactive setup
- Add agents step to interactive setup flow in prompts.js
- Include React performance optimization and state management agents
- Include Django API security and database optimization agents
- Integrate agent selection with existing setup workflow
- Show agent count in confirmation step
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* chore: bump version to 1.12.2 for agents feature
---------
Co-authored-by: Claude <noreply@anthropic.com>
* feat: Enhanced analytics dashboard with custom tool modals
- Implemented custom modals for all Claude Code tools (Read, Edit, Write, Bash, Glob, Grep, TodoWrite)
- Added intelligent diff viewer for Edit tool with dual modes (By Lines vs Smart Diff)
- Enhanced tool parameter visualization with project-specific insights
- Improved modal consistency with unified design patterns
- Added comprehensive CSS styling for all tool modals
- Fixed modal functionality and error handling across all tools
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* feat: improve startup screen and fix framework structure
- Redesign compact ASCII art for better terminal usage
- Add version info and documentation links to startup screen
- Fix frameworks → examples directory structure consistency
- Update all code references to use examples/ instead of frameworks/
- Fix Jest configuration typo (moduleNameMapping → moduleNameMapper)
- Add new agents.js module for agent management
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* chore: bump version to 1.12.1 for release
---------
Co-authored-by: Claude <noreply@anthropic.com>
- Exposed agentsPage globally for modal access in App.js, allowing for custom tool modals.
- Implemented cleanup of global references when navigating away from the agents page.
- Added detailed logging for token chart data in DashboardPage.js to aid in debugging.
- Improved tool display logic in ToolDisplay.js to store tool data for supported tools, enhancing modal interactions.
- Introduced extensive styling for various tool modals in index.html, ensuring a consistent and responsive design.
- Updated showResultsModal function to handle custom tool modals based on stored tool data, improving user experience.
- Added a new SVG file `undraw_docusaurus_tree.svg` to the static images directory for enhanced visual representation.
- Introduced a new TypeScript configuration file `tsconfig.json` to improve editor experience and project structure.
🚀 Released version 1.11.0 to npm with Claude Code Console Bridge integration
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
* feat: Enhance DataService with paginated conversations and improved error handling
- Added `getConversationsPaginated` method to fetch conversations with pagination support.
- Improved error handling in `cachedFetch` to provide clearer messages and fallback behavior.
- Updated WebSocket integration to handle connection failures with fallback polling.
- Reduced WebSocket auto-reconnect attempts and disabled auto-reconnect to minimize console noise.
- Added CORS middleware to the web server for better API accessibility.
- Implemented paginated conversations endpoint in the server.
- Added conversation messages endpoint to retrieve messages for a specific conversation.
- Enhanced conversation analysis to include detailed session data and compatibility with original dashboard.
* feat: Implement real-time conversation change handling and notifications
- Added handleConversationChange method to ClaudeAnalytics for processing updates to conversation files.
- Integrated WebSocket notifications for new messages in conversations.
- Enhanced setupFileWatchers to include conversation change callbacks.
- Updated conversation state API to calculate states for all conversations, improving performance and accuracy.
- Introduced pagination for conversation messages endpoint to support large message sets.
- Implemented cache management endpoint for clearing specific cache types.
- Enhanced DataCache and ConversationAnalyzer to support tool correlation in message parsing.
- Created ToolDisplay component for safe rendering of tool uses and results in the analytics dashboard.
- Added comprehensive documentation for Claude data structures and formats.
* feat: Enhance real-time messaging and dashboard features
- Improved logging for new messages in DataService to include message data.
- Increased WebSocket reconnection attempts for better reliability.
- Enabled auto-reconnect in WebSocketService for real-time updates.
- Updated conversation change handling in ClaudeAnalytics to include file path.
- Enhanced error handling and logging in ConversationAnalyzer and DataCache.
- Added new settings file for local permissions.
- Introduced a new Chats Dashboard option in the main menu.
- Created detailed architecture documentation for the analytics web application.
- Deprecated old main.js and Dashboard.js files in favor of a modular structure.
* feat: Implement real-time message handling and improve logging in DataService and AgentsPage
* feat: Implement comprehensive conversation state detection improvements
- Enhanced frontend message analysis for tool execution and content analysis.
- Introduced file activity detection to accurately identify user typing.
- Adopted a WebSocket-first approach for real-time state updates.
- Expanded state vocabulary with new contextual states and visual indicators.
- Improved state banner display with new CSS classes.
- Integrated system components for cohesive state management.
- Added health check feature to validate system requirements and configurations.
- Developed ConsoleBridge for web-based interaction with Claude Code processes.
- Created test script for ConsoleBridge to facilitate integration testing.
Dani