Nuveon Time Keeper
Nuveon Time Keeper helps you log what you are doing in Visual Studio Code or Cursor with minimal friction. You work in segments: each segment has a short description, a start time, and an end time (or it can still be running). Only one segment runs at a time.
Your data is stored in the editor’s global storage for this extension (not inside your project folders).
Quick start
- Start or stop — Press
Ctrl+Shift+; (Windows/Linux) or Cmd+Shift+; (macOS) to open the start picker when idle, or stop the current segment when one is running. Or use the status bar Start… / Stop.
- See everything — Open the Command Palette (
Ctrl+Shift+P / Cmd+Shift+P), run Nuveon Time Keeper: Open summary, and use the filters to explore past work.
You can change shortcuts under File → Preferences → Keyboard Shortcuts and search for Nuveon Time Keeper.
Status bar
| State |
What you see |
| Idle |
Nuveon Time Keeper with a watch icon. |
| Running |
Watch icon, your description (truncated if long), and a live timer (mm:ss). |
Click the status bar item to open a small menu (same entries as Nuveon Time Keeper: Status bar menu):
- Open summary… — Opens the full summary table (see below).
- Build timesheet text… — Pick start and end local dates (end defaults to match start); opens a text buffer with one block per day that has logged time (
YYYY-MM-DD [hours] — two significant figures, rounded up — then sorted task lines), separated by blank lines; days with no time are skipped (behavior follows settings Timesheet: use aligned values and Alignment interval).
- Set up MCP (VS Code or Cursor)… — Merges MCP configuration so assistants can use the bundled timer tools against your ledger (optional).
- Start… / Switch… — When idle, Start…; when a segment is running, Switch… (same picker behavior as the commands).
- Stop — Ends the current segment (when one is running).
- Resume previous — When idle, starts a new segment with the same description as the last stopped segment.
Commands (Command Palette)
| Command |
What it does |
| Nuveon Time Keeper: Start… |
Opens a picker: recent descriptions (as templates) or New entry… then asks what you are doing. Starts a new segment. If something was already running, it is stopped first, then the new segment starts. |
| Nuveon Time Keeper: Stop |
Ends the current segment and records the end time. |
| Nuveon Time Keeper: Toggle start or stop |
When idle, same as Start…; when running, same as Stop. Default chord (Ctrl+Shift+; / Cmd+Shift+;) uses this command. |
| Nuveon Time Keeper: Switch… |
Same as Start: pick what to do next; the current segment stops and a new one starts with the new description. |
| Nuveon Time Keeper: Resume previous |
When nothing is running, starts a new segment using the last stopped description. If a segment is already running, you are asked to stop it first. |
| Nuveon Time Keeper: Open summary |
Opens the summary page in the main editor area (see next section). |
| Nuveon Time Keeper: Build timesheet text… |
Quick Pick start date, then end date (same as start for a single day) → plaintext buffer with one summary block per day that has logged time in that inclusive range (aligned vs raw per settings). |
| Nuveon Time Keeper: Set up MCP (VS Code or Cursor)… |
Guides merge of mcp.json for the bundled stdio MCP server. |
| Nuveon Time Keeper: Status bar menu |
Same choices as clicking the status bar (for rebinding keys). |
Default keyboard shortcuts
| Action |
Windows / Linux |
macOS |
| Toggle start or stop |
Ctrl+Shift+; |
Cmd+Shift+; |
| Resume previous |
Ctrl+Shift+, |
Cmd+Shift+, |
Start…, Stop, and Switch are available from the status bar or Command Palette; assign your own keys if you want them separate from the toggle.
Summary (table and filters)
Nuveon Time Keeper: Open summary opens a table of every logged segment with these columns:
| Column |
Meaning |
| Start |
When the segment started (your local date and time). |
| End |
When it ended, or … running if it is still open. |
| Duration |
Length of the segment. Running rows show a live duration and a * marker. |
| Aligned start / end / duration |
When Alignment interval is enabled in settings and the segment is finished, grid-aligned timestamps and duration; otherwise —. |
| Description |
The text you entered for that segment. |
Toolbar filters (all optional):
- Description contains — Show only rows whose description includes the text you type (ignores case).
- Duration (seconds) — Min and/or max length in seconds.
- Start time — Any, a single calendar day, an inclusive day range, or between two local date-times.
- End time — Same modes as start (for finished work, or for “as if it ended now” while still running).
- Treat running segments as ending “now” — When checked (default), end-time filters can include in-progress segments by comparing against the current time.
The line under the table shows how many rows match the filters and the total of their durations.
Export to CSV — Click Export visible rows to CSV… (under the filters). You choose where to save the file. The file includes only the rows currently shown (after filters), with a UTF-8 BOM for Excel. Columns:
| CSV column |
Contents |
segment_id |
Internal id for that segment |
start_iso |
Segment start (ISO-8601 UTC) |
end_iso |
Segment end, or empty while running |
duration_seconds |
Decimal seconds (matches the summary at export time) |
aligned_start_iso |
Aligned grid start (UTC), or empty if none |
aligned_end_iso |
Aligned grid end (UTC), or empty if none |
aligned_duration_ms |
Aligned duration in whole milliseconds, or empty if none |
description |
Your description text (quoted in CSV if needed) |
running |
yes or no |
To export everything, clear or widen the filters first, then export.
How segments and descriptions work
- Each time you start (or switch), Nuveon Time Keeper creates a new segment and a new internal id, even if the description matches something you used before.
- Recent entries in the picker are shortcuts: they copy the old text; they do not “continue” the old row.
- Resume previous copies the last stopped description into a new segment so you can pick up the same kind of work again.
Privacy and data
- Data stays on your machine in the editor’s extension storage.
- There is no built-in cloud sync or team server in this version.
