Skip to content

show

Show entries from a section.

Usage

bash
doing show [OPTIONS] [SECTION] [TAGS]...

Arguments

ArgumentDescription
SECTIONSection to display entries from (default: current section, "all" for every section)
TAGSAdditional tag filters (e.g. @tag1 @tag2)

Options

FlagDescription
-c, --count COUNTMaximum number of entries to return
--config-template CONFIG_TEMPLATENamed template from config to use for output
--durationShow elapsed time on open entries
-o, --output OUTPUTOutput format
--save SAVESave the current options as a named view
--sort SORTSort order for results (asc/desc)
--tag-order TAG_ORDERSort order for tag totals (asc/desc)
--tag-sort TAG_SORTSort field for tag totals (name/time)
--template TEMPLATEInline template string for output (e.g. "%title", "%date - %title")
-t, --timesShow time intervals on @done tasks
--title [TITLE]Show section title in output; accepts an optional custom title string
--totalsShow tag time totals
--after AFTERDate range (e.g. "monday to friday")
--age AGEWhich end to keep when limiting by count (newest/oldest)
--before BEFOREUpper bound for entry date
--bool BOOL_OPBoolean operator for combining tag filters (and/or/not/pattern)
--case CASECase sensitivity for search (smart/sensitive/ignore)
-x, --exactUse exact (literal substring) matching for search
--from FROMDate range expression (e.g. "monday to friday")
--notNegate all filter results
--only-timedOnly include entries with a recorded time interval
--search SEARCHText search query
-s, --section SECTIONSection name to filter by
--tag TAGTags to filter by (can be repeated)
-u, --unfinishedOnly include unfinished entries (no @done tag)
--val VALTag value queries (e.g. "progress > 50")
-i, --interactiveInteractively select entries to display
-m, --menuPresent a menu of available sections to choose from

Examples

Show the last 10 entries from the current section:

bash
doing show -c 10

Show all unfinished entries with time intervals:

bash
doing show all -t --unfinished

Show entries tagged @project sorted by oldest first:

bash
doing show --tag project --sort asc --age oldest

Released under the MIT License.