Track time with klog from the VS Code status bar.
The status bar shows the duration of the open record and clicking it opens a menu
to start, pause, resume, switch or stop tracking. The extension shells out to the
klog CLI, so your .klg files stay the source of truth.
The klog CLI must be installed and on
your PATH (or point klog.path at it).
Run Klog: Select Active File to pick the file to track in — either a path or
one of your klog bookmarks (@name). The
selection is shared across VS Code windows.
Then use the status bar item, or the commands:
| Command | Description |
|---|---|
Klog: Start New Record |
Open a new entry, prompting for a summary. |
Klog: Pause Open Record |
Pause tracking without closing the entry. |
Klog: Resume Open Record |
Resume, booking the pause as time off. |
Klog: Switch to New Record |
Close the open entry and start a new one. |
Klog: Stop Open Record |
Close the open entry. |
Klog: Edit Active File |
Open the file in the editor. |
Klog: Refresh Active File |
Re-read the file. |
Klog: Show Menu |
The status bar menu. |
Klog: Open Output Channel |
Every klog invocation is logged here. |
| Setting | Default | Description |
|---|---|---|
klog.path |
klog |
Path to the klog executable. |
klog.round |
none |
Round written times to 5m–60m. |

