hourdial

hourdial

Know where the day went. Decide where it goes. hourdial records your working time without a timer, labels it with rules you can read, and turns it into invoices that don't change once issued. Free and open source, on a Mac or on Linux under Hyprland, Sway, i3 or X11; your data stays on your machine, in one SQLite file.

hourdial is for people who work at a computer for themselves and want an honest record of the day. If you work with coding agents, tock agents keeps the other half of the ledger: what your agents worked on today, and what you did while they ran.

The Agents view of the hourdial dashboard for one day: a dial of leverage, the agents' time against your time with them, when each project's sessions ran, and agent time, prompts and sessions per project. The Projects view for a week: time, billable time and its value, each project's share, days, value and budget, and under them hours per day stacked by kind of time and a donut of the week.

What it does

Install

On macOS, with Homebrew:

brew tap confuserdotcom/tock
brew trust confuserdotcom/tock
brew install tock
tock setup

Homebrew builds hourdial on your Mac, so there is no “unidentified developer” warning. tock setup makes a local code-signing certificate, installs trackd and the menu bar app, and starts them.

Without Homebrew, download the .dmg from Releases. It isn’t notarized, so the first time you open it, allow it under System Settings, Privacy & Security, Open Anyway. To build from source, see the README.

On Linux under Hyprland, Sway, i3 or X11, run make install-linux, or download a tarball from Releases. Coming from ActivityWatch? tock import activitywatch export.json brings your history.

How it fits together

trackd takes events from the desktop and writes spans to tock.db. The tock command and tockbar read tock.db and label it with rules.toml, learned.toml and config.toml. Only the tock command reaches the internet, for Claude and Slack, when you turn them on.

More in Architecture.

Privacy

The whole list is in Privacy in detail.