A Python-based dashboard generator for analyzing Cursor AI usage within teams. Generate beautiful HTML reports showing usage statistics, trends, and team insights.

Here's what the dashboard looks like:

• Team Analytics: Generate comprehensive usage reports for your entire team
• Predefined Groups: Create reports for specific groups (AI Champions, Engineering, QA, etc.)
• Interactive Dashboards: Beautiful HTML reports with charts and visualizations
• Flexible Filtering: Include/exclude specific users, analyze custom date ranges
• Command Line Interface: Easy-to-use CLI for quick report generation

• Python 3.8+
• uv package manager

1. Clone the repository:

   gh repo clone galprz/cursor-analytics
   cd cursor-analytics

   Or using git directly:

   git clone https://github.com/galprz/cursor-analytics.git
   cd cursor-analytics

2. Install dependencies:

   uv sync

3. Set up environment variables:

   cp .env.example .env

   Edit .env and add your configuration (see Environment Setup)

Create a .env file in the project root with the following variables:

1. Log into Cursor Admin Dashboard
2. Open Developer Tools (F12)
3. Go to Network tab
4. Refresh the page
5. Find any request to cursor.com
6. Copy the entire Cookie header value
7. Add it to your .env file as CURSOR_COOKIE_STRING

1. In Cursor Admin Dashboard, check the URL
2. The team ID appears in URLs like: https://cursor.com/admin/team/1234567
3. Use that number as your CURSOR_TEAM_ID

Configure team groups in generate_live_dashboard.py:

Reports are generated in the reports/ directory with timestamped filenames:

• Lines of Agent: Total lines of AI-generated code
• Chat Interactions: Number of chat sessions with Cursor AI
• Tab Completions: Autocomplete suggestions accepted
• Active Users: Team members using Cursor regularly

• Weekly Trends: Line charts showing activity over time
• User Filtering: Toggle individual users on/off in charts
• Multiple Views: Switch between Lines, Chats, and Completions
• Growth Tracking: Week-over-week percentage changes

• Top Performers: Ranked by total lines of agent code
• Growth Champions: Biggest week-over-week improvements
• Persistence Leaders: Most consistent daily usage (500+ lines/day)

• User Performance: Comprehensive metrics per team member
• Usage Distribution: Pie chart showing feature adoption
• Export Functionality: Download data as JSON for further analysis

Error: CursorAuthError: Authentication failed

Solutions:

1. Refresh your cookie string from browser
2. Ensure you're logged into Cursor Admin
3. Check cookie expiration

Error: Group 'xyz' not found

Solutions:

1. Run --list-groups to see available groups
2. Check spelling of group name
3. Add the group to PREDEFINED_GROUPS if needed

Issue: Report shows no data

Solutions:

1. Verify team ID is correct
2. Check if users have any Cursor usage in the specified period
3. Ensure email addresses in groups are correct

1. Edit PREDEFINED_GROUPS in generate_live_dashboard.py
2. Add group name and email list:
   "new_group": [
   "user1@example.com",
   "user2@example.com"
   ]

• Modify HTML templates in _generate_template_inline() method
• Adjust chart configurations in the template
• Add new metrics by extending the analytics aggregation

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test thoroughly
5. Submit a pull request

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

For issues and questions:

1. Check the troubleshooting section
2. Review existing issues
3. Create a new issue with detailed information