MonDev Tracker
Log work hours to Monday.com items directly from VS Code — without ever leaving your editor.
Features
- Sidebar panel — Active session timer, Quick Start list, and recent session history in the Activity Bar
- Status bar timer — Live elapsed time displayed while a session is running
- Board & item picker — Browse your Monday.com boards and items (including sub-items) via VS Code's Quick Pick
- Sub-item support — Automatically updates the parent item's hour column when logging time to a sub-item
- Quick Start — One-click restart for your 5 most recently used tasks; remove tasks you no longer need
- Persistent sessions — A running session survives VS Code window reloads
- hh:mm:ss precision — Hours are stored and displayed in
hh:mm:ss format in a Text column on Monday.com
- Secure token storage — Your Monday.com API token is stored in the OS keychain via VS Code's Secret Storage — never in any file
Requirements
- VS Code
1.80.0 or later
- A Monday.com account with API access
- A Text column on your Monday.com board to store logged hours
Setup
- Go to monday.com → click your avatar (bottom-left) → Profile
- Scroll to API → copy your personal API token
2. Find your column ID
- Open a board in Monday.com
- Enable Developer Mode: click your avatar → Developers → toggle Developer Mode
- Hover over the column header you want to use for hours — the column ID appears in a tooltip
The column must be a Text type. Number columns do not support hh:mm:ss format.
Open the Command Palette (Ctrl+Shift+P / Cmd+Shift+P) and run:
MonDev: Configure API Token & Column
You will be prompted for:
- Your Monday.com API token (stored securely in the OS keychain)
- The Text column ID for logging hours on items
- (Optional) A Text column ID on parent items — if set, parent items are auto-updated when logging sub-item hours
Usage
Start tracking
Click the MonDev Tracker icon in the Activity Bar, then click ▶ Start Tracking — or use the keyboard shortcut Alt+Shift+S.
Select a board, then select a task or sub-item. The timer starts immediately and appears in both the sidebar and the status bar.
Stop & log
Click ⏹ Stop & Log in the sidebar (or Alt+Shift+E). A confirmation dialog shows the elapsed time in hh:mm:ss — adjust it if needed, then confirm to write the hours to Monday.com.
Cancel
Click ✕ Cancel in the sidebar to discard the session without logging anything.
Quick Start
The sidebar shows your 5 most recently used tasks. Click any task to start tracking it immediately — no board/item picker needed.
To remove a task from the list, hover over it and click the ✕ that appears on the right.
Commands
| Command |
Description |
MonDev: Start Tracking |
Open board → item picker and start a session |
MonDev: Stop & Log to Monday |
Stop the current session and log hours |
MonDev: Cancel Session |
Stop the current session without logging |
MonDev: Configure API Token & Column |
Set up or update your API token and column IDs |
Keyboard Shortcuts
| Shortcut |
Action |
Condition |
Alt+Shift+S |
Start tracking |
No session running |
Alt+Shift+E |
Stop & log |
Session running |
Shortcuts can be customized in File → Preferences → Keyboard Shortcuts.
How hours are stored
When you log time, the extension:
- Reads the current value from your Monday.com Text column
- Adds the new session duration
- Writes the total back in
hh:mm:ss format (e.g. 03:45:10)
Hours accumulate over time — each log session adds to the existing total in the column.
Security
- The API token is stored in the OS keychain (macOS Keychain, Windows Credential Manager, or Linux Secret Service) via VS Code's built-in
SecretStorage API
- No token or sensitive data is stored in any file, settings, or the extension source code
- The extension communicates only with
https://api.monday.com/v2
