Everyday tracking

burrowtime start "deep work" +planning
burrowtime status
burrowtime stop
burrowtime report --week

BurrowTime starting a project timer, showing its status, stopping it, and printing a daily report — The standard timer lifecycle. Open the full-size demo.

Command	Purpose
`burrowtime`	Open the interactive terminal dashboard.
`start`, `stop`, `status`	Control and inspect live timers.
`restart`, `cancel`	Resume a frame or discard a running timer.
`add`, `edit`, `remove`	Maintain historical frames.
`log`, `report`, `aggregate`	Inspect and summarize recorded time.
`projects`, `tags`, `frames`	List values for scripts and completion.
`rename`, `merge`	Rewrite names or resolve a frames-file merge.
`agent`	Control and report owned coding-agent sessions.
`mcp`	Run the local MCP server over stdio.
`skill`	Install or diagnose bundled agent skills.
`migrate`	Copy compatible data between BurrowTime and Watson.
`completion`	Generate shell completion scripts.

Concurrent timers

Scripts must choose replacement or concurrency explicitly:

# Stop active timers, then start this one
burrowtime start --stop "client call" +meeting

# Keep active timers and add another
burrowtime start --concurrent "background export" +ops

# Stop one known timer or every active timer
burrowtime stop --timer 4e169a2
burrowtime stop --all

Machine-readable output

burrowtime log --all --json | jq '.[0]'
burrowtime report --month --csv > august.csv
burrowtime capabilities --json

Reports and filters

burrowtime log --day
burrowtime log --month --project "client portal"
burrowtime report --week --tag billable
burrowtime report --from 2026-08-01 --to 2026-08-15
burrowtime aggregate --year

Shell completion

# Bash
source <(burrowtime completion bash)

# Zsh
burrowtime completion zsh > "${fpath[1]}/_burrowtime"

# Fish
burrowtime completion fish > ~/.config/fish/completions/burrowtime.fish

Run burrowtime <command> --help for every flag and example.