-
-
Notifications
You must be signed in to change notification settings - Fork 91
Displaying Entries
Among the commands that can show you what you've been doing:
show - List all entries
recent - List recent entries
today - List entries from today
yesterday - List entries from yesterday
last - Show the last entry
grep - Show entries matching text or pattern
since - List entries since a date
doing show on its own will list all entries in the "Currently" section. Add a section name as an argument to display that section instead. Use "all" to display all entries from all sections.
You can filter the show command by tags. Simply list them after the section name (or all). The boolean defaults to ANY, meaning any entry that contains any of the listed tags will be shown. You can use -b ALL or -b NONE to change the filtering behavior: doing show all done cancelled -b NONE will show all tasks from all sections that do not have either @done or @cancelled tags.
Use -c X to limit the displayed results. Combine it with -a newest or -a oldest to choose which chronological end it trims from. You can also set the sort order of the output with -s asc or -s desc.
The show command can also show the time spent on a task if it has a @done(date) tag with the -t option. This requires that you include a %interval token in template -> default in the config. You can also include @start(date) tags, which override the timestamp when calculating the intervals.
If you have a use for it, you can use -o csv on the show or view commands to output the results as a comma-separated CSV to STDOUT. Redirect to a file to save it: doing show all done -o csv > ~/Desktop/done.csv. You can do the same with -o json.
doing yesterday is great for stand-ups (thanks to Sean Collins for that!). Note that you can show yesterday's activity from an alternate section by using the section name as an argument (e.g. doing yesterday archive).
All of the display commands (view, show, today, yesterday, search) support date ranges in addition to other filtering options. Results can be narrowed to a date/time span using --before DATE and --after DATE. The DATE accepts a natural language string but works best in formats like 10/20/21 or 2021-05-13 3pm (or shortened to just 5/13 3pm). For the today and yesterday commands the DATE should just be a time, e.g. 12pm or 15:00, and results will be filtered within the timespan for just that day. Both flags are optional, and you can use just --before to get everything older than a certain date, or use just --after to get everything newer.
doing on allows for full date ranges and filtering. doing on saturday, or doing on one month to today will give you ranges. You can use the same terms with the show command by adding the -f or --from flag. doing show @done --from "monday to friday" will give you all of your completed items for the last week (assuming it's the weekend). There's also doing since a simple alias for doing on PAST_DATE to now, e.g. doing since monday.
You can also show entries matching a search string with doing grep (synonym doing search). If you want to search with regular expressions, surround your search query with forward slashes, e.g. doing search /project name/. If you pass a search string without slashes, it's treated as a fuzzy search string, meaning matches can be found as long as the characters in the search string are in order and with no more than three other characters between each. To force an exact match, start the string with a single quote ("'Exact test").
By default searches are across all sections, but you can limit it to one with the -s SECTION_NAME flag. Searches can be displayed with the default template, or output to any export format available.
view - Display a user-created view
views - List available custom views
Display any of the custom views you make in ~/.doingrc with the view command. Use doing views to get a list of available views. Any time a section or view is specified on the command line, fuzzy matching will be used to find the closest match. Thus, lat will match Later, etc..