Overview Version History Q & A Rating & Review
Clockify Pro - VS Code Extension
Advanced Clockify timer management directly from VS Code with workspace selection, templates, idle detection, timesheet export, and calendar week view.
Quick Start
Getting Your Clockify API Key
Go to Clockify and log in to your account
Click on your Profile (top right corner)
Select Settings
Navigate to the API section (or find the API token option)
Click Generate to create your API token
Copy the API token (you'll only see it once)
In VS Code, run the command Clockify: Set API Key and paste your token
Initial Setup
Install the extension from VS Code Marketplace
Run Clockify: Set API Key and paste your Clockify API token
Click the Clockify Pro icon in the Activity Bar
Select your workspace, project, and tags
Click ▶ Start to begin tracking time
Features
Core Timer Features
⏱️ Start/Stop Timer - Quick timer control from the sidebar with live elapsed time
🏢 Workspace Selection - Choose workspace and project from dropdowns
🏷️ Tags Support - Select multiple tags for each time entry
📝 Templates - Save and load timer templates for recurring tasks
⚡ Recent Entries - Quick access to your 5 most recent time entries with resume option
Advanced Features
🔔 Idle Detection - Get a notification if your timer runs for 2+ hours ("Still working on this?")
📊 Today's Progress - Visual progress bar showing hours worked today vs. daily goal
📅 This Week View - Calendar timeline showing all entries grouped by day with times and durations
📄 Export Timesheet - Export last 7 or 30 days to CSV for reporting and invoicing
💾 Daily Goal - Set and track your daily hour target
Smart Features
🧠 Smart Selection Memory - Remembers your workspace/project selection per repository
⚙️ Global Settings - Configure defaults via VS Code settings
📌 Status Bar - Quick timer status and elapsed time in the status bar
Usage Guide
Starting a Timer
Open the Clockify Pro sidebar view
Select workspace, project, and tags (optional)
Enter a description for your work
Click ▶ Start
Stopping the Timer
Click ⏹ Stop in the sidebar, or
Click the timer in the status bar
Using Templates
Start a timer with the configuration you want to save
Click Save under "Save as Template" and give it a name
Later, find your template under "⭐ Templates" and click Load to apply it
Or click Delete to remove a template
Exporting Your Timesheet
Select the date range (Last 7 days or Last 30 days)
Click CSV to download
Choose where to save the file
Use the CSV for invoicing, reporting, or import to accounting software
Viewing This Week
Scroll to "📅 This Week"
Click Refresh to load your entries for the current calendar week
Entries are grouped by day with start times and durations
Setting Your Daily Goal
Scroll to "⚙️ Settings"
Enter your target hours (e.g., 8 for 8 hours)
Click Set
The progress bar at the top will reflect your goal
Screenshots
Main Timer View
Features Overview
Settings
Configure via VS Code Settings (Ctrl+, → search "clockify"):
clockify.quickStartWithLastSelection - Start immediately with your last workspace/project (boolean, default: false)clockify.skipPickIfSingle - Skip workspace picker if you only have one (boolean, default: true)clockify.defaultWorkspaceId - Preselect a workspace (string)clockify.defaultProjectId - Preselect a project (string)clockify.defaultTaskId - Preselect a task (string)clockify.defaultTagIds - Preselect tags (array of strings)
Troubleshooting
"Clockify API key is required"
Run Clockify: Set API Key in VS Code and paste your API token from Clockify Settings → API
Timer not starting
Make sure a workspace is selected in the dropdown
Check your API key is valid by verifying it in Clockify Settings
No entries showing in "This Week"
Click Refresh to load entries
Make sure you have time entries logged in Clockify for this week
Idle warning not appearing
The warning triggers after 2 hours of continuous timer running
Check your timer is actually running in the sidebar
License
MIT
Support
For issues or feature requests, visit GitHub Issues
