CLI Reference
Canonical command reference based on waqt --help and subcommand help output.
Command index
| Command | Purpose | Notes |
|---|---|---|
waqt start | Start time tracking | Supports --time, --date, --description |
waqt end | End active tracking session | Supports --time, --date |
waqt add | Add completed time entry | Pause handling: default, none, or minute values |
waqt edit-entry | Edit existing entry by date | Update start/end/description |
waqt summary / waqt sum | Show weekly/monthly summary | Period + reference date options |
waqt export | Export entries | CSV/JSON/Excel |
waqt import FILE | Import entries | Format auto-detect + conflict mode + dry-run |
waqt leave-request | Create leave requests | Multi-day with weekend exclusion |
waqt config ... | Manage settings | list/get/set/reset |
waqt template ... + waqt apply | Manage/apply templates | Create reusable entry shapes |
waqt ui ... | Run/manage web UI process | Foreground or background start/stop/status |
waqt update ... | Check/install updates | Frozen executables only |
waqt version | Show version info | Useful in bug reports |
Tracking commands
waqt start --time 09:00 --description "Planning"
waqt end --time 17:00
waqt add --date 2026-01-08 --start 09:00 --end 17:30 --pause none
waqt edit-entry --date 2026-01-08 --start 08:45 --end 17:15 --desc "Corrected entry"
waqt summary --period month
Data transfer commands
waqt export --period all --format excel --output full_history.xlsx
waqt import backup.json --on-conflict skip
waqt import entries.csv --on-conflict overwrite --dry-run
Leave and report commands
waqt leave-request --from 2026-02-10 --to 2026-02-14 --type vacation
waqt leave-request --from 2026-02-20 --to 2026-02-20 --type sick --desc "Medical"
waqt summary --period week
Configuration commands
waqt config list
waqt config get weekly_hours
waqt config set weekly_hours 35
waqt config reset weekly_hours
Integration commands
waqt ui
waqt ui start --port 5555
waqt ui status
waqt ui stop --force
waqt update check
waqt update install --yes
waqt update install --prerelease
Template commands
waqt template list
waqt template create "Daily Standup" --start 09:30 --duration 15 --desc "Standup"
waqt template show "Daily Standup"
waqt template edit "Daily Standup" --desc "Team Standup"
waqt template delete "Daily Standup" --yes
waqt apply "Daily Standup" --date 2026-01-10