v2.2.0 · VS Code & Cursor AI

Know exactly where
your time goes

DevTracker automatically logs every coding session per project — no manual start/stop, no accounts, no cloud required. Streaks, daily goals, 30-day history, and dark mode built in.

DevTracker — Web Dashboard Dashboard Projects Sessions
Today
4h 32m
4.5h of 6h goal · 75%
This Week
28h
14 sessions this week
Active Projects
8
5 active this week
Streak
12 🔥
Best: 24 days
devtracker-final: 1h 12m 44s
☁ API connected
TypeScript · Ln 284
Features

Everything you need,
nothing you don't

Lightweight, private, and reliable — whether you're online or not.

Live Status Bar Timer

Counts every second while you're active. Shows today's total when idle. Always visible without getting in the way.

💾

100% Local-First

All data saved to .devtracker/sessions.json in your project. No accounts, no cloud, no tracking of your data.

🌙

Smart Idle Detection

Session auto-ends after configurable idle time. Midnight resets split sessions correctly by day — IST timezone aware.

📊

Built-in Dashboard

Local webview with 30-day bar chart, daily breakdown, dedicated Sessions tab with pagination, and dark mode. No browser needed.

Optional Online Sync

Self-host a PHP + MySQL server for a full web dashboard. Your server, your data, all endpoints secured by API key auth.

Project Management

Rename folder keys to friendly names, or delete projects entirely. Changes propagate across sessions, summaries, and all reports.

🔥

Streak Tracking

Current and longest streak counters computed server-side from daily activity. A live streak card on the dashboard keeps you motivated.

🎯

Daily Coding Goals

Set a daily hour target in the dashboard config. A live progress bar in the Today card shows exactly how close you are to your goal.

🌑

Dark Mode

One-click dark mode toggle in the web dashboard header. Preference saved to localStorage and survives page refreshes.

How it works

Set it and forget it

DevTracker runs silently in the background. No timers to start, no buttons to click.

1

Install & open a project

The moment you open a workspace folder, the timer starts and the live counter appears in the status bar. Zero config for local use.

2

Code normally

Works with any file type. AI tools like Cursor AI and Claude Code keep the session alive — no file editing needed.

3

Idle auto-saves the session

Step away for 5 minutes (configurable) and the session ends automatically, saved to .devtracker/sessions.json.

4

View your dashboard

Click the status bar timer to open the full dashboard — 30-day chart, streak counter, daily goal progress, sessions tab, and dark mode.

Commands

Everything at your
fingertips

Open the Command Palette Ctrl+Shift+P (or Cmd+Shift+P) and type DevTracker.

Primary

DevTracker: Open Report / Dashboard

Opens your full report — the local webview dashboard if offline, or your online web dashboard if sync is configured. Click the status bar timer for a shortcut.

New

DevTracker: Show Local Dashboard

Always opens the local graph & dashboard inside VS Code — even when online sync is configured. Includes your current live session in real time.

Report

DevTracker: Show Today's Summary

Opens a quick Markdown file showing today's sessions, total time, and per-session start/end times for the current project.

Setup

DevTracker: Configure Online API

Set your PHP API URL, secret key, and idle timeout. Step-by-step guided input prompts.

Sync

DevTracker: Sync to Server Now

Manually push all pending sessions to your online server. Useful after working offline.

Project

DevTracker: Set Display Name for Project

Assign a friendly name to any project folder. Shows in the status bar, dashboard, and all reports.

Data

DevTracker: Clear Project Data

Permanently deletes all local session data for the current project. Confirms before deleting.

Installation

Up in 30 seconds

Two ways to install — Marketplace is easiest.

A

Option 1 — VS Code Marketplace (recommended)

Open VS Code, go to the Extensions panel, search for DevTracker by kuldipsinhparmar. Click Install. Done.

Or install directly from the terminal:

code --install-extension kuldipsinhparmar.devtracker
B

Option 2 — Install via VSIX file

Download the .vsix from the GitHub releases page, then install manually:

# VS Code Command Palette: Extensions: Install from VSIX... # Or via terminal: code --install-extension devtracker-2.2.0.vsix
C

Option 3 — Build from source

cd extension npm install npm run compile # Press F5 in VS Code to launch in dev mode

After install

Open any project folder — the ⏱ ProjectName: 0s timer appears in the status bar immediately. No configuration required for local use.

Add .devtracker/ to your .gitignore to keep session data private.

Online Sync

Your server, your data

Self-host a PHP + MySQL backend for a full web dashboard with streaks, goals, dark mode, and 30-day history. Completely optional.

Server Setup

You need a PHP + MySQL server. Upload two files and run one SQL script.

📁 Upload api.php and dashboard.html
🗄 Run setup.sql to create the database tables
🔑 Set DB credentials + a secret api_key in api.php
Cmd+Shift+P → DevTracker: Configure Online API
Sessions sync automatically from now on
● Online Sessions sync after each coding session ends
⊟ Offline Queued locally, synced on next connection
↑ Manual Use Sync to Server Now command anytime

Web Dashboard v2.2.0

A single HTML file — no framework, no build step, no dependencies.

🔥 Current & longest streak counter, computed server-side
🎯 Daily hour goal with live progress bar in the Today card
🌑 Dark mode toggle, saved in localStorage
📋 Dedicated Sessions tab — filter, search, paginate
📅 30-day activity bar chart with 7d / 14d / 30d range pills
🔒 All GET & POST endpoints protected by API key auth
🗑 Delete a project and all its data in one click
Rename projects — syncs across all tables instantly
Local Data

Transparent & portable

Your data is plain JSON stored in your project. No lock-in, readable by any tool.

your-project/
  .devtracker/
    sessions.json
  src/
  package.json
  .gitignore ← add .devtracker/
Each session stores:
idUnique session identifier
projectWorkspace folder name (key)
display_nameFriendly project name
start_timeISO 8601 timestamp
end_timeISO 8601 timestamp
duration_secondsInteger seconds
dateYYYY-MM-DD (IST timezone)
synced_onlineBoolean — synced to server?