Tracklytics

A powerful VS Code extension for tracking development time with live timer, Pomodoro technique, AI-assisted coding detection, and comprehensive statistics.

📸 Screenshot

Tracklytics panel showing time tracking, live timer, and Pomodoro in the status bar

✨ Features

⏱️ Live Timer (Stopwatch)

Start/Stop/Pause - Full stopwatch with second precision
Lap times - Record split times during your session
Session labels - Name sessions for easy tracking
Continue sessions - Resume or continue previous sessions
Auto-pause on idle - Automatically pauses after 2 minutes of inactivity
Daily history - View and manage all sessions

🍅 Pomodoro Timer

Focus sessions - 25-minute work intervals (customizable)
Smart breaks - Short (5 min) and long (15 min) breaks
Auto-progression - Automatically starts breaks after work
Progress tracking - Daily pomodoro count
Notifications - Get notified when sessions complete
Fully customizable - Adjust all durations in settings

🕐 Development Time Tracking

Per-file tracking - Time spent on each file
Session tracking - Current coding session stats
Lifetime statistics - Accumulated stats over time
Activity types - Editing, testing, debugging breakdown

🤖 AI/Agent Tracking

Auto-detection - Detects GitHub Copilot, Cody, and other AI tools
Chat panel detection - Tracks when AI chat is open
Manual toggle - Start/end AI sessions manually
Separate stats - AI-assisted vs manual coding time

📊 Statistics & Reports

Explorer panel with live stats
Detailed markdown reports
Export to JSON or CSV
Daily, session, and lifetime views

🚀 Quick Start

Status Bar

Three status bar items appear on the right:

Icon	Name	Click Action
⌚	Timer	Open stopwatch menu
❤️	Pomodoro	Open Pomodoro menu
🕐	Dev Time	View time report

Keyboard Shortcuts

Shortcut	Action
`Cmd/Ctrl+Alt+P`	Start Pomodoro
`Cmd/Ctrl+Alt+;`	Pause/Resume Pomodoro
`Cmd/Ctrl+Alt+T`	Start Live Timer
`Cmd/Ctrl+Alt+'`	Pause/Resume Timer
`Cmd/Ctrl+Alt+L`	Record Lap

📋 Commands

Access via Command Palette (Cmd/Ctrl+Shift+P):

Time Tracking

Command	Description
`Tracklytics: Show Development Time Report`	Open detailed report
`Tracklytics: Export Development Time Data`	Export as JSON/CSV
`Tracklytics: Reset Development Time Data`	Clear all data
`Tracklytics: Start AI/Agent Session`	Start AI tracking
`Tracklytics: End AI/Agent Session`	End AI tracking

Pomodoro Timer

Command	Description
`Tracklytics: Pomodoro Timer Menu`	Open quick menu
`Tracklytics: Start Pomodoro Focus Session`	Start 25-min focus
`Tracklytics: Pause/Resume Pomodoro`	Toggle pause
`Tracklytics: Stop Pomodoro Timer`	Stop timer
`Tracklytics: Skip Current Session`	Skip to next

Live Timer

Command	Description
`Tracklytics: Live Timer Menu`	Open quick menu
`Tracklytics: Start Live Timer`	Start stopwatch
`Tracklytics: Pause/Resume Live Timer`	Toggle pause
`Tracklytics: Stop Live Timer`	Stop and save
`Tracklytics: Record Lap`	Record lap time

⚙️ Configuration

General Settings

Setting	Default	Description
`tracklytics.showStatusBar`	`true`	Show dev time in status bar
`tracklytics.idleThreshold`	`60`	Seconds before marking idle
`tracklytics.trackAgentTime`	`true`	Track AI vs manual time
`tracklytics.trackAllFiles`	`true`	Track all file types
`tracklytics.excludePatterns`	`[...]`	Glob patterns to exclude

Pomodoro Settings

Setting	Default	Description
`tracklytics.pomodoro.showStatusBar`	`true`	Show in status bar
`tracklytics.pomodoro.workDuration`	`25`	Work duration (minutes)
`tracklytics.pomodoro.shortBreakDuration`	`5`	Short break (minutes)
`tracklytics.pomodoro.longBreakDuration`	`15`	Long break (minutes)
`tracklytics.pomodoro.longBreakInterval`	`4`	Pomodoros until long break
`tracklytics.pomodoro.autoStartBreaks`	`true`	Auto-start breaks
`tracklytics.pomodoro.autoStartWork`	`false`	Auto-start work
`tracklytics.pomodoro.autoStartOnOpen`	`false`	Start on VS Code open
`tracklytics.pomodoro.showNotifications`	`true`	Show notifications

Live Timer Settings

Setting	Default	Description
`tracklytics.liveTimer.showStatusBar`	`true`	Show in status bar
`tracklytics.liveTimer.autoPauseOnIdle`	`true`	Auto-pause on idle

📦 Installation

From VSIX

Download the .vsix file from Releases
In VS Code, go to Extensions (Cmd/Ctrl+Shift+X)
Click ... menu → "Install from VSIX..."
Select the downloaded file

From Source

git clone https://github.com/Avinava/vscode-tracklytics.git
cd vscode-tracklytics
yarn install
yarn build

The .vsix file will be in the release/ folder.

🔍 How AI Detection Works

Tracklytics uses multiple signals to detect AI-assisted coding:

Extension detection - Checks for active AI extensions (Copilot, Cody, TabNine, etc.)
Chat panel detection - Detects when AI chat panels are open
Bulk change detection - Identifies large multi-line insertions typical of AI
Manual override - You can manually start/end AI sessions

📄 License

MIT License - See LICENSE for details.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Avinava/vscode-tracklytics