Summary

Agentlytics addresses the fragmentation of AI coding assistant session data across multiple editors by providing a unified, local analytics dashboard. It targets developers who use tools like Cursor, Windsurf, and VS Code Copilot, offering insights into session history, token costs, model usage, and editor effectiveness, all processed locally for privacy.

How It Works

The system ingests data from supported editors via Node.js scripts (editors/*.js), normalizes it into a local SQLite cache (~/.agentlytics/cache.db), and exposes this data through a local REST API powered by an Express server. A React Single Page Application (SPA) serves as the user-facing dashboard. The optional Relay feature enables team-wide session context sharing via an MCP server.

Quick Start & Requirements

• Primary Install/Run: npx agentlytics
• Prerequisites: Node.js ≥ 20.19 or ≥ 22.12. macOS required. Windsurf, Windsurf Next, and Antigravity must be running during scans for full data collection.
• Links: Dashboard accessible at http://localhost:4637. Development setup details in CONTRIBUTING.md.

Highlighted Details

• Comprehensive Analytics: Features include a dashboard with KPIs, activity heatmaps, editor breakdowns, coding streaks, token economy, peak hours, and top models/tools. Sessions are searchable and filterable with syntax highlighting.
• Cost & Project Tracking: Estimates AI spend by model, editor, and project, with drill-down capabilities.
• Editor Support: Integrates with numerous editors (Cursor, Windsurf, Claude Code, VS Code, Zed, etc.), though data collection granularity varies.
• Team Collaboration (Relay): Facilitates multi-user context sharing via a local MCP server, enabling cross-team session search and access.

Maintenance & Community

Developed by @f. Roadmap includes planned features like LLM-powered insights, Linux/Windows support, and export capabilities. Development setup and adapter details are available in CONTRIBUTING.md.

Licensing & Compatibility

Licensed under the MIT license, permitting broad use, modification, and distribution, including for commercial purposes.

Limitations & Caveats

Currently limited to macOS; Linux and Windows support are planned. Some editors offer partial data collection (e.g., Zed, Command Code). Windsurf/Antigravity require the respective applications to be running during scans due to their data fetching mechanisms, with offline support pending.