CLI reference¶
Everything ttd can do from the command line. Run ttd <command> --help for the
same information in your terminal.
Running bare ttd with no command launches the TUI.
Global options¶
| Option | Description |
|---|---|
--version, -V |
Print the ttd version. |
--install-completion |
Install shell completion (bash, zsh, or fish auto-detected). |
--help, -h |
Show help for any command. |
Commands¶
| Command | Description |
|---|---|
client |
Manage clients. |
project |
Manage projects. |
entry |
List and edit time entries. |
start · stop · status · cancel |
Start, inspect, stop, or discard the live timer. |
log |
Log completed work from a natural-language time spec. |
report |
Summaries by day, week, month, or range. |
invoice |
Create and manage invoices. |
tax |
Track tax set-aside and IRS estimated-tax payments. |
config |
Read and write configuration. |
db |
Database utilities. |
export |
Export entries (csv, json, xlsx, or Apple Numbers). |
import |
Import entries; matches by uid then content, never touches invoiced entries. |