⏰ SugarTick
Privacy-first coding-time tracker
Tracks edit-time per project / language to a local JSONL file (no cloud, no MongoDB) and renders a SugarCharts-driven dashboard. Editor plug-ins push heartbeats via the tick push CLI subcommand; the dashboard reads them.
Install
composer require sugarcraft/sugar-tickQuickstart
// Editor plug-in / cron / git hook pushes a heartbeat:
sugar-tick push sugarcraft php src/App.php 60
// Open the dashboard:
sugar-tick
// Override the data dir:
SUGARTICK_DIR=/var/data/tick sugar-tickWhat's in the box
Heartbeat schema
{time, project, language, file, duration} — JSONL, one beat per line.Per-day filesStorage is one
YYYY-MM-DD.jsonl per day — append-only, easy to ship to cold storage.Top projects + languagesTwo ranking panes side-by-side, sorted by total time descending.
Daily timelineSugarCharts
Sparkline driven by per-day minute buckets.Window navigation
← / → shift the 7-day window; r reloads.Pure folding
Stats::compute is total-input deterministic — every dashboard test runs against fixed beats.Source & demos
- Source on GitHub
- Full README
- Runnable examples
- Port of TakaTime (Go upstream)
Key Classes
| Class | Method | Description |
|---|---|---|
| Stats | compute(heartbeats) | Compute statistics from heartbeats |
| Heartbeat | new(time, project, language, file, duration) | Create a heartbeat |
| Dashboard | new(stats) | Create dashboard view |
| App | start() | Create the app model |
