List Command

View the output of tt list --help

List all time sheet entries

Options:
      --version          Show version number                           [boolean]
      --absolute, --abs  Print dates as absolute timestamps            [boolean]
  -h, --humanize         Print the total duration in human-readable format
                                                                       [boolean]
  -s, --since            Only list entries since the specified date     [string]
  -t, --today            Show results for today                        [boolean]
      --all-sheets       Show results for all sheets                   [boolean]
  -a, --all              Show all sheet entries                        [boolean]
  -y, --yesterday        Show results from yesterday                   [boolean]
  -c, --concise          Exclude start and end dates from output, showing
                         duration only                                 [boolean]
  -f, --filter           Filter results by description                  [string]
      --help             Show help                                     [boolean]
      --sheets           Show results for the specified sheets
      [array] [choices: "main"]

The list command lists time sheet entries. It supports many arguments that can be used to filter results or modify the rendering of dates and durations.

It takes one position argument, <...sheets>, which filters the time sheets shown in the output. If not provided, only the currently active sheet will be considered.

The arguments --today, --yesterday, --since, and --all filter the results by date, while --filter filters by description.

To hide the start and end dates, use the --concise flag.

Arguments

Render durations into a human-readable word form with --humanize

tip

The -h (or --humanize) argument switches the rendering of durations from a simple digit display to a human-readable word form.

Natural language input with --since

tip

Natural language input is supported by the --since argument.

For example, all of the following are valid:

• --since '12 hours ago'
• --since '30 days ago'
• --since 'one year ago'

The time-speak library is used to parse the input.

argument	alias	type	description	default
--absolute	--abs	boolean	Print dates as absolute timestamps	false
--humanize	-h	boolean	Renders durations in human-readable format	false
--since	-s	string	Only lists entries since the specified date; supports natural language input.
--today	-t	boolean	Show results for today	false
--all-sheets		boolean	Show results for all sheets	false
--all	-a	boolean	Show all sheet entries	false
--yesterday	-y	boolean	Show results from yesterday	false
--concise	-c	boolean	Exclude start and end dates from output, showing duration only	false
--filter	-f	string	Filter results by description
--sheets		boolean	Show results for the specified sheets	false

Examples

Below you can find many examples showcasing the various arguments and how you can use them to filter output and control rendering.

Custom Start Date

Running tt l --since '4 hours ago' yields:

Include Specific Sheets

If you want to see the summary for specific sheets, provide a list of sheet names as the positional argument. For example, tt l main results in the following:

View Durations As Human-Readable Words

Render durations in a human-readable format with the -h (or --humanize) argument:

Display Absolute Dates

Instead of exposing a -r (or --relative) argument, the list command displays dates as relative by default. To switch to displaying dates as absolute timestamps, pass the --absolute (or --abs) argument:

Omit Start & End Dates

To reduce the size of the output, you can hide the start and end dates with the -c (or --concise) argument:

Filtering

You can search within entry descriptions with the -f (or **--filter**) argument. The search is case-insensitive. For example, tt l -f 'Updating'

Viewing All Data

To display all data, provide the --all (disables start date filtering) and --all-sheets (includes all sheets in the output). The -c and -h flags are included in the call to customize the output:

View All Entries From Today

Use the -t (or --today) argument to select and display only entries that overlap with the current day. Combine with --all-sheets to see all entries:

View All Entries From Yesterday

Use the -y (or --yesterday) argument to select and display only entries that overlap with yesterday. Combine with --all-sheets to see all entries:

View Entries Since A Custom Start Date

Use the -s (or --since) argument to select and display only entries since the specified date. This argument supports natural language input. Combine with --all-sheets to see all entries since that date:

View Data For All Time

To display all entries for the selected sheets (without filtering by start date), pass the --all argument:

View Data For All Sheets

To display data for all sheets, but respect the active start filter (including --since, --today, etc), pass the --all-sheets argument: