Automatic coding time tracking for VS Code
Seamlessly records your focus time and syncs it to your epoch instance.
epoch runs silently in the background and tracks how much time you actively spend coding. It detects your current project via git, sends periodic heartbeats to your epoch instance, and shows a live timer in the status bar. Everything works offline — heartbeats are queued locally and synced automatically when connectivity is restored.
- Live status bar — shows today's total coding time at a glance (
1 hrs 23 mins) - Automatic project detection — resolves the project name from your git remote
- Offline queue — heartbeats are stored locally and flushed when back online
- Zero configuration needed — connects to
https://epoch.mirello.cloudby default - Self-hosted support — point it at any epoch instance with a custom URL
- Install the extension from the VS Code Marketplace
- Open the command palette (
Ctrl+Shift+P/Cmd+Shift+P) and runepoch: Set API Key - Optionally run
epoch: Set Instanceif you're using a self-hosted server - Start coding — the timer appears in the bottom-left status bar
| Command | Description |
|---|---|
epoch: Set API Key |
Store your epoch API key |
epoch: Set Instance |
Set the URL of your epoch instance |
epoch: Validate API Key |
Check that your key authenticates successfully |
epoch: Open Dashboard |
Open your epoch dashboard in the browser |
epoch: Show Output |
Open the epoch output channel for diagnostics |
Settings can be managed via VS Code settings or by editing the config file directly at ~/.config/epoch/config.json (respects $XDG_CONFIG_HOME).
| Setting | Default | Description |
|---|---|---|
epoch.apiKey |
— | API key for authentication |
epoch.baseUrl |
https://epoch.mirello.cloud |
URL of your epoch instance |
| Display | Meaning |
|---|---|
⏰ 2 hrs 14 mins |
Tracking — connected and syncing |
↻ 1 hrs 05 mins (offline) |
Offline — data queued for sync |
✕ Unconfigured |
API key missing or invalid |
GPL-3.0 — see LICENSE for details.
Built by Mirello