Waqt

CLI Reference

Canonical command reference based on waqt --help and subcommand help output.

Command index

CommandPurposeNotes
waqt startStart time trackingSupports --time, --date, --description
waqt endEnd active tracking sessionSupports --time, --date
waqt addAdd completed time entryPause handling: default, none, or minute values
waqt edit-entryEdit existing entry by dateUpdate start/end/description
waqt summary / waqt sumShow weekly/monthly summaryPeriod + reference date options
waqt exportExport entriesCSV/JSON/Excel
waqt import FILEImport entriesFormat auto-detect + conflict mode + dry-run
waqt leave-requestCreate leave requestsMulti-day with weekend exclusion
waqt config ...Manage settingslist/get/set/reset
waqt template ... + waqt applyManage/apply templatesCreate reusable entry shapes
waqt ui ...Run/manage web UI processForeground or background start/stop/status
waqt update ...Check/install updatesFrozen executables only
waqt versionShow version infoUseful 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

Related documentation

← Previous: Export and import Next: MCP integration →