CURSTAT // VISUALIZER

Visualize your Cursor IDE usage statistics with a cyberpunk aesthetic.

CurStat is a powerful, privacy-focused tool designed to help developers visualize and analyze their coding activity in Cursor IDE. By parsing your usage CSV export, CurStat generates a detailed dashboard featuring daily activity timelines, token usage metrics, and cost analysis—all wrapped in a sleek, stunning interface.

✨ Features

• Cyberpunk Dashboard: A visually striking interface with "noise" overlays, pixel fonts, and a dark mode aesthetic designed for developers.
• Detailed Timeline: Visualize your daily coding activity with a custom-styled timeline that highlights active hours and gaps.
• Advanced Metrics:
  • Golden Hour: Identify the hour of day you are most productive (most tokens generated).
  • Peak Velocity: See your highest token count in a single event.
  • Consistency Score: Track how reliable your coding habits are.
  • User Categorization: Get assigned a category (e.g., ELITE, STANDARD) based on your usage patterns.
• Cost Analysis: Track your daily and total spending on LLM tokens.
• Privacy First: All data processing happens locally in your browser. Your CSV data is never uploaded to any server.
• Social Sharing: Generate shareable cards of your stats to show off your productivity.

🛠 Tech Stack

Built with modern web technologies for performance and aesthetics:

• Frontend Framework: React 19
• Build Tool: Vite
• Styling: Tailwind CSS
• Visualization: Recharts
• Animations: Framer Motion
• Icons: Lucide React

🚀 Getting Started

Follow these steps to get a local copy up and running.

Prerequisites

• Functions requiring npm (Node Package Manager).
• Node.js (v18 or higher recommended)

Installation

1. Clone the repository:

   git clone https://github.com/apptension/curstat.git

2. Navigate to the project directory:

   cd curstat

3. Install dependencies:

   npm install

Running Locally

Start the development server:

npm run dev

Open your browser and navigate to the URL shown in the terminal (usually http://localhost:5173).

Building for Production

To build the project for production deployment:

npm run build

The output will be in the dist directory.

📊 Usage

1. Export Usage Data: Go to your Cursor settings and export your usage data as a CSV file.
2. Upload to CurStat: Drag and drop the CSV file into the CurStat file uploader or click to select via the file dialog.
3. Analyze: Explore your stats on the dashboard!

🤝 Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📝 License

Distributed under the MIT License. See LICENSE for more information.

---

Built with ❤️ for the Cursor Community