DevPulse — Developer Productivity Insights

A VS Code extension that tracks not just time, but output, focus, and productivity patterns.

🚀 Overview

DevPulse automatically tracks your coding activity and transforms it into meaningful productivity insights — going far beyond simple time tracking.

Instead of just telling you "you coded 5 hours", DevPulse tells you:

"3h building features, 1.5h debugging, 30m reading code — and you work best between 10–12 AM."

✨ Features

⏱ Automatic Time Tracking

• Tracks coding activity in real time — no manual timers
• Detects active coding vs idle time
• Tracks time per file, language, and project
• Runs silently in the background with minimal overhead

🧠 Work Intent Detection

🎯 Focus Session Management

• Start timed focus sessions with a goal description
• Track context switches and files worked on during the session
• Automatic flow score calculation (0–10)
• Goal completion notifications
• Historical session log with scores

🔀 Context Switching Detection

• Counts file/project switches throughout the day
• Optional notification when excessive switching is detected
• Per-hour context switch rate in weekly reports

📊 Interactive Dashboard

• Today Tab: Hourly heatmap, work breakdown, language stats
• Weekly Tab: 7-day trend, top projects, top languages
• AI Insights Tab: Productivity score, coaching tips, peak hours
• Focus Tab: Active session controls, recent session history

🤖 AI Coaching

• Productivity score (0–100) based on your patterns
• Focus score (0–10) based on session depth
• Personalized recommendations generated from your data
• Peak hour identification
• Context switching warnings

🔒 Privacy-First

• All data stored locally using VS Code's built-in global state
• No API keys, no cloud sync, no external requests
• Configurable data retention (7–365 days)
• Full data export to JSON
• One-click data deletion

📦 Installation

1. Open VS Code
2. Press Ctrl+P / Cmd+P
3. Type ext install apertacodex.devpulse
4. Press Enter

Or install from the VS Code Marketplace.

🎮 Usage

Sidebar Panel

Click the DevPulse icon (pulse wave) in the Activity Bar to open the sidebar with four views:

• Today's Activity — live stats for the current day
• Insights & Coaching — AI-generated tips and quick stats
• Projects & Languages — breakdown by project and language
• Focus & Flow — manage and review focus sessions

Keyboard Shortcuts

Command Palette

All commands are available via Ctrl+Shift+P:

• DevPulse: Open Dashboard
• DevPulse: Start Focus Session
• DevPulse: Show Weekly Report
• DevPulse: Generate AI Insights
• DevPulse: Toggle Tracking On/Off
• DevPulse: Export Data as JSON
• DevPulse: Clear All Tracking Data

⚙️ Configuration

🏗 Architecture

src/
├── extension.ts          # Activation, command registration
├── logger.ts             # Centralized output channel logging
├── types.ts              # Shared TypeScript interfaces
├── ActivityTracker.ts    # Core event-based tracking engine
├── InsightsEngine.ts     # Analytics, AI coaching, report generation
├── FocusSessionManager.ts # Focus session lifecycle
├── StorageManager.ts     # VS Code globalState persistence
├── StatusBarManager.ts   # Status bar items
├── DashboardPanel.ts     # Webview dashboard panel
├── TodayViewProvider.ts  # Today's activity tree view
├── InsightsViewProvider.ts # Insights tree view
├── ProjectsViewProvider.ts # Projects tree view
└── FocusViewProvider.ts  # Focus sessions tree view

🆚 Comparison

🤝 Contributing

Pull requests are welcome! Please open an issue first to discuss major changes.

git clone https://github.com/apertacodex/devpulse.git
cd devpulse
npm install
npm run watch
# Press F5 in VS Code to launch Extension Development Host

📄 License

MIT © apertacodex