Install and connect
The Hourdini CLI runs in your terminal. Here's how to get it set up.
The CLI covers the terminal-first workflows: start and stop timers, log time, browse entries, manage tags, inspect budgets, review overlaps, and check which organization your token is scoped to.
Install
npm i -g hourdiniThis installs the hourdini command globally. You'll need Node.js 20
or newer.
Connect
Sign in to the web app, open /cli/connect, and click Generate token. Copy the token (it only shows once).
In your terminal:
hourdini auth loginPaste the token when asked. The CLI saves it locally and you're set.
Where the token is stored
The CLI keeps your token at ~/.config/hourdini/config.json with
permissions 0600 (only you can read it). It never sends the token
anywhere except hourdini.app.
Try it out
hourdini statusYou should see "no timer running" (or, if you started one in the web app, the running timer's project and elapsed time).
hourdini start "first project name"Type a partial project name and the CLI fuzzy-matches against your projects. The web app shows the running timer immediately.
Updating
npm i -g hourdini@latestDisconnecting
If you lose your laptop or want to reset:
- Revoke the token from Settings → Tokens in the web app. This kills it everywhere.
- Forget the token locally with
hourdini auth logout.