Time Streak Builder ⏱️🔥
Time Streak Builder is a local-first VS Code extension that tracks your active coding time, builds daily streaks, and rewards you with meaningful feedback — without sending any data anywhere.
No accounts. No SaaS. No tracking servers.
Everything stays on your machine.
✨ Features
⏱️ Smart Time Tracking
- Tracks active coding time only
- Automatically pauses when you switch apps
- Ends a session only after 15 minutes of inactivity
- Prevents false session endings during quick tab switches
🔥 Streaks & ⭐ Stars
- Daily streaks for consistent coding
- Stars for manually completed projects
- No auto-guessing — user intent is respected
- Full-screen reward popup on session end
- Shows:
- Time spent building the project
- Current streak
- Total stars
- Motivational message
- Clean black UI with animated fire
⏲️ Live Stopwatch + Pomodoro
- Minimal black stopwatch UI
- Start / Stop / Reset controls
- Optional Pomodoro mode (50 min focus / 10 min break)
- Notifications at focus & break completion
- Quotes refresh after each Pomodoro cycle
🔒 Privacy First
- 100% local storage (JSON)
- No APIs
- No network requests
- You own your data
🧠 How It Works (In Simple Terms)
- Time is counted only when VS Code is focused
- Short tab switches (docs, browser) do not end sessions
- Long inactivity (15+ min) ends the session and shows a reward
- Project completion is manual, never guessed
🚀 Commands
Open Command Palette (Ctrl + Shift + P):
- Time Streak Builder: Open Stopwatch
- Time Streak Builder: Mark Project Complete
📦 Installation
From VS Code Marketplace
- Open VS Code
- Go to Extensions
- Search for Time Streak Builder
- Click Install
That’s it. No setup required.
📦 Installation
✅ From VS Code Marketplace
- Open Visual Studio Code
- Go to the Extensions view
- Search for Time Streak Builder
- Click Install
No configuration required.
The extension works out of the box.
📦 Local Installation (VSIX)
If you have a .vsix file, install it using:
code --install-extension time-a-productivity-streak-builder-0.1.0.vsix
🧑💻 Development Setup (For Contributors)
This section is for developers who want to run or modify the extension locally.
🔧 Prerequisites
Ensure the following are installed:
Node.js (v18+ recommended)
npm
Visual Studio Code
📥 Clone the Repository
Copy code
git clone https://github.com/ypranay3232/Time-A-productivity-streak-builder.git
cd time-a-productivity-streak-builder
📦 Install Dependencies
Copy code
npm install
🛠️ Compile the Extension
Copy code
npm run compile
▶️ Run in Development Mode
Open the project in VS Code
Press F5
A new Extension Development Host window will open
Test commands using Ctrl + Shift + P
📁 Data Storage
All data is stored locally using VS Code’s global storage:
Per-project total coding time
Daily streak count
Star count
No files are synced or uploaded.
You can reset all data using the Reset Stats command or by clearing VS Code global storage.
