Consistify Time Tracker

Automatically track your active coding time and sync it to your Consistify dashboard — effortlessly.

✨ Features

🚀 Quick Start

1. Install the extension from the VS Code Marketplace.
2. Open the Command Palette (Ctrl+Shift+P / Cmd+Shift+P).
3. Run Consistify: Set API Key.
4. Head to your Consistify Dashboard, copy your Extension Token, and paste it in.
5. Start coding. Time tracking begins immediately in the background. ✅

⌨️ Commands

Access these from the Command Palette (Ctrl+Shift+P / Cmd+Shift+P):

⚙️ How It Works

The extension listens to VS Code editor events (typing, scrolling, file switching, window focus, terminal usage) and batches them into heartbeat payloads. These are:

1. Cached locally after each coding session ends (idle timeout, window blur, or VS Code close).
2. Synced to the server every 15 minutes, on window blur, or on shutdown.
3. Retried automatically if a sync fails due to network issues.

An anti-cheat engine scores each 5-minute activity window. If 25+ consecutive minutes show low activity scores, that time is discarded before syncing.

🔒 Privacy

• This extension only collects: timestamp, active duration (in seconds), programming language, and workspace folder name.
• No file names, file paths, or code content are ever collected or transmitted.
• All data is sent exclusively to https://consis-sigma.vercel.app using your personal API key as authentication.
• Your API key is stored using VS Code's built-in Secret Storage (OS keychain on most systems).

📋 Requirements

• VS Code 1.85.0 or higher
• A free Consistify account

🛠️ Development

To build or contribute to this extension locally:

# 1. Clone the repository
git clone https://github.com/TechifyCoder/consistify-time-tracker-vs-code.git
cd consistify-time-tracker-vs-code

# 2. Install dependencies
npm install

# 3. Compile TypeScript
npm run compile

# 4. Press F5 in VS Code to launch the Extension Development Host

📄 License

MIT © Satish Patel — see LICENSE for details.