Skip to content
| Marketplace
Sign in
Visual Studio Code>Visualization>epoch-timeNew to Visual Studio Code? Get it now.
epoch-time

epoch-time

Mirello

|
2 installs
| (0) | Free
The swiss army knive for coding time tracking.
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

epoch logo

epoch

Automatic coding time tracking for VS Code
Seamlessly records your focus time and syncs it to your epoch instance.

VS Marketplace License Issues


What it does

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.

Features

  • 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.cloud by default
  • Self-hosted support — point it at any epoch instance with a custom URL

Getting started

  1. Install the extension from the VS Code Marketplace
  2. Open the command palette (Ctrl+Shift+P / Cmd+Shift+P) and run epoch: Set API Key
  3. Optionally run epoch: Set Instance if you're using a self-hosted server
  4. Start coding — the timer appears in the bottom-left status bar

Commands

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

Configuration

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

Status bar indicators

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

License

GPL-3.0 — see LICENSE for details.


Built by Mirello

  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
© 2026 Microsoft