Command-line tool

minuta is the command-line companion to the Mac and iPhone app. It works on the same storage folder as the app — start a timer in the terminal and it appears in the app instantly, and vice versa. Writes are coordinated through a shared lock, so both can run at once safely.

Install

Via Homebrew (bundles man pages and bash, zsh, and fish completions):

brew tap ramil-k/minuta
brew install minuta

Or grab the universal binary from the downloads page. The CLI finds the storage folder the app uses automatically; override with --storage <path> or the MINUTA_STORAGE environment variable.

Track time

minuta start --tag coding --comment "fix the parser"
minuta status
minuta stop

Timers, records, and tags are all manageable from the terminal: records list, records add, records edit, tags add, tags rename, and more.

Export and reports

minuta export csv --this-month -o month.csv
minuta export report --prev-month --open

Reports render as PNG or SVG with per-tag charts — the same reports the app produces, generated headlessly.

Built for scripting

Every command takes --json with stable schemas, stdout carries data only (progress goes to stderr), and exit codes are documented. Pipe it anywhere:

minuta export csv --this-month | duckdb -c \
  "SELECT Tag, SUM(Duration) FROM read_csv_auto('/dev/stdin') GROUP BY Tag"

minuta doctor checks storage health — handy in cron or CI.

Learn more

The full command list, JSON schemas, exit codes, and automation patterns are in the CLI reference. After installing, man minuta works too.