Usage
Getting started and configuring Waqt to fit your workflow.
How it works
01
Install the extension
Search for "Waqt" in the VS Code Extensions panel or install from the Marketplace. The extension activates automatically when VS Code starts.
02
Open any file and start coding
Waqt begins tracking immediately. Every 5 seconds it records which category your time falls into: typed, AI-assisted, pasted, or debugging.
03
Optionally allow terminal tracking
On first launch Waqt will ask if it can monitor terminal commands. Allow it to detect CLI tools like Claude Code and Gemini CLI. You can deny or revoke at any time via settings.
04
Open the dashboard
Run "Waqt: Show Dashboard" from the Command Palette (⌘⇧P). The dashboard adapts to your editor theme and shows today's split, a 30-day history, per-project stats, and AI tool breakdown.
Settings
| Key | Default | Description |
|---|---|---|
| waqt.aiTools | [] | Additional VS Code extension IDs to recognize as AI tools. |
| waqt.cliTools | [] | Custom CLI patterns. Each entry needs a name and a regex pattern string. |
| waqt.idleThresholdSeconds | 120 | Seconds of inactivity before tracking pauses. Range: 30–600. |
| waqt.cliTrackingConsent | "ask" | Terminal monitoring consent: "ask", "allowed", or "denied". |
Commands
Waqt: Show Dashboard Opens the time-tracking dashboard in a webview panel. Waqt: Reset All Statistics Clears all accumulated data from global state. Irreversible.