Skip to content

Timer commands

Start, inspect, and stop the live timer. ttd keeps at most one timer running; stopping it logs an entry. See Tracking time.

start

ttd start [OPTIONS] [ARGS]

Start a timer (project defaults to defaults.project from config).

Parameters:

  • PROJECT, --project: Project slug
  • --client:
  • --at: Clock time like '9am' or 'today 8:30'
  • --note, -n:
  • --interactive, --no-interactive, -i: Fill remaining fields via a form [default: False]

stop

ttd stop [OPTIONS]

Stop the running timer and log the entry.

Parameters:

  • --at: Clock time like '9am' or 'today 8:30'
  • --note, -n:

status

ttd status

Show the running timer and today's total.

cancel

ttd cancel

Discard the running timer without logging.