WorkLens
A developer-first watcher for any folder
.git meets fswatch meets a live dashboard. Watches directories for file changes, tracks activity over time, and renders a real-time dashboard with file heatmaps, activity timelines, and event history — all backed by a local SQLite store.
Features
Real-time file watching
Watches any directory for file system events — creates, modifies, deletes, renames. Configurable ignore patterns (node_modules, .git, build artifacts).
Activity timeline
Chronological view of all file activity. See when your peak coding hours are, how long you spent on each file, and where context switches happened.
File heatmap
Visual heatmap of which files are touched most frequently. Instantly spot hot paths in your codebase — the files that get changed every sprint.
SQLite event store
Every event persisted to a local SQLite database. Query your work history with SQL. Export, analyze, or build custom dashboards on top of the raw data.
Live dashboard
Terminal-based live dashboard showing current activity, recent events, and aggregate stats. No browser needed — runs entirely in your terminal.
Architecture
CLI tool with three layers: file watcher (chokidar), event store (SQLite), and dashboard renderer (blessed). Runs locally, no cloud dependency. Fully offline.