The CLI is designed for low-friction daily time tracking. You create work items, start a timer, stop it, and review reports without opening a browser.
Initialize your workspace
humblebee init
This creates a local workspace and the default SQLite database.
Create work items
humblebee add "Client Project"
humblebee add "Client Project > Development"
humblebee show
Work items can be hierarchical. Use a project-level item for the client or project and child items for tasks.
Start and stop time
humblebee start "Client Project > Development"
humblebee stop
Only one timer runs at a time. This keeps reports simple and avoids accidental overlaps.
Import a Time & Bill export
humblebee import timeandbill-export.json
Use this when you want to migrate existing work time from Time & Bill into a local HumbleBee database.
Run reports
humblebee report
humblebee report 5
humblebee report 5 2026
Reports help you review project time for the current month or a specific month and year.
Diagnose the local database
humblebee doctor
humblebee doctor --fix --dry-run
Use doctor if the database looks inconsistent, after an interrupted run, or before you rely on a migrated database.