cursor-usage-tracker 0.0.0-development → 0.0.0

package/README.md

@@ -1,11 +1,15 @@
 <p align="center">
-  <img src="public/logo.png" alt="Cursor Usage Tracker" width="100" height="100" />
+  <img src="public/logo.png" alt="Cursor Usage Tracker - open-source Cursor Enterprise cost monitoring dashboard with anomaly detection and Slack alerts" width="100" height="100" />
 </p>
 
 <h1 align="center">Cursor Usage Tracker</h1>
 
 <p align="center">
-  Know who's burning through your AI budget before the invoice tells you.
+  Know who's burning through your AI budget before the invoice tells you. Open-source Cursor Enterprise cost monitoring with anomaly detection, Slack alerts, and spend analytics.
+</p>
+
+<p align="center">
+  <a href="https://cursor-usage-tracker.sticklight.app">Website</a> · <a href="#quick-start">Quick Start</a> · <a href="#deploy">Deploy</a> · <a href="#features">Features</a>
 </p>
 
 <p align="center">
@@ -20,11 +24,19 @@
 
 ---
 
-## AI is the new cloud bill
+## Why This Exists
+
+This dashboard answers three questions:
+
+1. **Cost monitoring** - Are we spending too much? Who's driving it? Why?
+2. **Adoption tracking** - Is everyone using the tool we're paying for?
+3. **Usage understanding** - How is each person working with AI?
+
+## AI Spend Is a Blind Spot
 
 Engineering costs used to be two things: headcount and cloud infrastructure. You had tools for both. Then AI coding assistants showed up, and suddenly there's a third cost center that nobody has good tooling for.
 
-A single developer on Cursor can burn through hundreds of dollars a day just by switching to an expensive model or letting an agent loop run wild. Now multiply that by 50, 100, 500 developers. The bill gets big fast, and there's nothing like Datadog or CloudHealth for this category yet.
+A single developer on Cursor can burn through hundreds of dollars a day just by switching to an expensive model or letting an agent loop run wild. Developers often don't know which models cost more - one of our team members used `opus-max` for weeks thinking it was a cheaper option. Now multiply that confusion by 50, 100, 500 developers. The bill gets big fast, and there's nothing like Datadog or CloudHealth for this category yet.
 
 Cursor's admin dashboard shows you the raw numbers, but it won't tell you when something is off. No anomaly detection. No alerts. No incident tracking. You find out about cost spikes when the invoice lands, weeks after the damage is done.
 
@@ -38,7 +50,7 @@ Your company has 50+ developers on Cursor. Do you know who's spending $200/day o
 
 You're about to find out.
 
-![Demo](assets/demo.gif)
+![Cursor Usage Tracker dashboard showing team spend, anomaly detection alerts, and per-user AI cost breakdown](assets/demo.gif)
 
 <sub>Demo animation created with <a href="https://github.com/ofershap/remotion-readme-kit">remotion-readme-kit</a></sub>
 
@@ -104,6 +116,18 @@ Anomaly Detected ──→ Alert Sent ──→ Acknowledged ──→ Resolved
 
 ---
 
+## Deploy
+
+### One-click deploy
+
+Deploy your own instance in minutes. You'll need a [Cursor Enterprise](https://cursor.com) plan and an Admin API key.
+
+[![Deploy to Render](https://render.com/images/deploy-to-render-button.svg)](https://render.com/deploy?repo=https://github.com/ofershap/cursor-usage-tracker)
+
+> **Railway and Docker** options below. Want help setting this up for your team — deployment, threshold tuning, first spend analysis, and ongoing support? [Let's talk](https://linkedin.com/in/ofershap).
+
+---
+
 ## Quick Start
 
 ### Prerequisites
@@ -206,9 +230,9 @@ This collects data, runs anomaly detection, and sends alerts in one call.
 
 ---
 
-## Docker
+## Production Deployment
 
-For production deployment:
+### Docker (self-hosted)
 
 ```bash
 cp .env.example .env   # configure your keys
@@ -236,6 +260,16 @@ volumes:
 
 </details>
 
+### Cloud platforms
+
+Any platform that supports Docker + persistent volumes works. Tested with:
+
+- **[Render](https://render.com)** — use the deploy button above, or `render.yaml` in this repo
+- **[Railway](https://railway.app)** — create a project from this repo, attach a volume at `/app/data`
+- **[Fly.io](https://fly.io)** — deploy with `fly launch`, create a volume for `/app/data`
+
+> **Note:** Vercel is not supported — SQLite requires a persistent filesystem that Vercel's serverless functions don't provide.
+
 ---
 
 ## Architecture

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "cursor-usage-tracker",
-  "version": "0.0.0-development",
+  "version": "0.0.0",
   "description": "Open-source Cursor IDE usage monitoring, anomaly detection, and alerting for enterprise teams",
+  "homepage": "https://github.com/ofershap/cursor-usage-tracker#readme",
   "type": "module",
   "scripts": {
     "dev": "next dev",
@@ -59,12 +60,15 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/ofershap/cursor-usage-tracker.git"
+    "url": "git+https://github.com/ofershap/cursor-usage-tracker.git"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
   },
   "bugs": {
     "url": "https://github.com/ofershap/cursor-usage-tracker/issues"
   },
-  "homepage": "https://github.com/ofershap/cursor-usage-tracker#readme",
   "dependencies": {
     "@tailwindcss/postcss": "^4.1.18",
     "better-sqlite3": "^12.6.2",