Track your coding time, take mindful breaks, and stay in flow — directly from your VSCode workspace.
✨ Features
⏳ Live Timer: Displays the time you've spent coding since VSCode started.
🧘 Zen Mode Colors: Smooth, animated color transitions to reduce fatigue and boost focus.
⏸️ Pause / ▶️ Resume: Control your timer easily from the status bar.
🔁 Reset: Start a fresh session anytime.
⏰ Break Reminders: Get notified to take a break every 2 hours of continuous work.
🎯 Focus Detection: Automatically pauses the timer when you leave VSCode, and resumes when you return.
🛠️ Toggle Focus Pause: Choose whether leaving VSCode should pause your timer or not (configurable).
📊 Daily Summary: View the total time you spent coding today — right from the status bar.
🚀 Getting Started
Open VSCode.
Install Coder's Clock from the Extensions Marketplace (or install manually via .vsix).
The timer will appear in your status bar.
Use the Pause, Reset, and Résumé buttons to control your session.
🔧 Commands
Accessible via the Command Palette (Ctrl+Shift+P / Cmd+Shift+P):
Coder's Clock: Pause/Resume Timer
Coder's Clock: Reset Timer
Coder's Clock: Show Daily Summary
⚙️ Extension Settings
You can configure Coder's Clock from your VSCode settings:
🔲 codersClock.pauseOnDefocus
Type: boolean
Default: true
Description: Automatically pause the timer when VSCode loses focus.
To update this setting:
Open Command Palette → Preferences: Open Settings (UI)
Search for "Coder's Clock"
Check or uncheck "Automatically pause the timer when VSCode loses focus"
🔄 Restart VSCode or reload the extension (Developer: Reload Window) to apply changes
💡 Why?
Because coding is intense. It’s easy to lose track of time and forget to rest. Coder's Clock helps you stay productive and healthy.
A tiny mindfulness tool for big developer brains.
📦 Contributing
Have ideas? Want to improve this?
Feel free to open issues or PRs — contributions are welcome!
