⏰ CandyCodetime
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/candy-codetimeQuickstart
# Editor plug-in / cron / git hook pushes a heartbeat:
candy-codetime push sugarcraft php src/App.php 60
# Open the dashboard:
candy-codetime
# Override the data dir:
CANDY_CODETIME_DIR=/var/data/tick candy-codetimeFormerly shipped as sugar-tick: the old SUGARTICK_DIR // @rename-keep
env var and the ~/.local/share/sugar-tick data directory are still // @rename-keep
honoured once and migrated automatically on first launch.
What'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
- Originally inspired by TakaTime (Go); SugarCraft is developed as a native PHP project.
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 |
