All Commands

Global Options

• --config_file arg -- Use a specific configuration file. Deprecated, set $DOING_CONFIG instead (default: ~/.config/doing/config.yml)

• -f|--doing_file arg -- Specify a different doing_file (default: None)

• --[no-]color -- Colored output

• --debug -- Verbose output

• --default -- Answer yes/no menus with default option

• --help -- Show this message

• --no -- Answer all yes/no menus with no

• --[no-]notes -- Output notes if included in the template

• -p|--[no-]pager -- Use a pager when output is longer than screen

• -q|--quiet -- Silence info messages

• --stdout -- Send results report to STDOUT instead of STDERR

• --version -- Display the program version

• -x|--noauto -- Exclude auto tags and default tags

• --yes -- Answer all yes/no menus with yes

Commands

add_section

Add a new section to the "doing" file

doing add_section SECTION_NAME

again/resume

Repeat last entry as new entry

This command is designed to allow multiple time intervals to be created for an entry by duplicating it with a new start (and end, eventually) time

doing again

doing resume

Options:

• -b|--back|--started DATE_STRING -- Backdate start date by interval or set to time [4pm|20m|2h|"yesterday noon"] (default: None)

• --bool BOOLEAN -- Boolean used to combine multiple tags. Use PATTERN to parse + and - as booleans (default: PATTERN)

• --case TYPE -- Case sensitivity for search string matching [(c)ase-sensitive, (i)gnore, (s)mart] (default: smart)

• --in SECTION_NAME -- Add new entry to section (default: same section as repeated entry) (default: None)

• -n|--note TEXT -- Add a note (default: None)

• -s|--section NAME -- Get last entry from a specific section (default: All)

• --search QUERY -- Repeat last entry matching search. Surround with slashes for regex (e.g. "/query/"), start with a single quote for exact match ("'query"). (default: None)

• --tag TAG -- Repeat last entry matching tags. Combine multiple tags with a comma. Wildcards allowed (*, ?) (default: None)

• --val QUERY -- Perform a tag value query ("@done Move entries between sections

Argument can be a section name to move all entries from a section,

or start with an "@" to move entries matching a tag.

Default with no argument moves items from the "Currently" section to Archive.

two hours ago" or "@progress < 50"). May be used multiple times, combined with --bool (default: None)

• --ask -- Prompt for note via multi-line input

• -e|--editor -- Edit duplicated entry with /opt/homebrew/bin/vim before adding

• -i|--interactive -- Select item to resume from a menu of matching entries

• --not -- Resume items that don't match search/tag filters

• -x|--exact -- Force exact search string matching (case sensitive)

archive/move

doing archive SECTION_OR_TAG

doing move SECTION_OR_TAG

Options:

• --before DATE_STRING -- Archive entries older than date

  (Flexible date format, e.g. 1/27/2021, 2020-07-19, or Monday 3pm) (default: None)

• --bool BOOLEAN -- Tag boolean (AND|OR|NOT). Use PATTERN to parse + and - as booleans (default: PATTERN)

• --case TYPE -- Case sensitivity for search string matching [(c)ase-sensitive, (i)gnore, (s)mart] (default: smart)

• -k|--keep X -- How many items to keep (ignored if archiving by tag or search) (default: None)

• --search QUERY -- Search filter (default: None)

• -t|--to SECTION_NAME -- Move entries to (default: Archive)

• --tag TAG -- Tag filter, combine multiple tags with a comma. Wildcards allowed (*, ?). Added for compatibility with other commands (default: None)

• --val QUERY -- Perform a tag value query ("@done Autotag last entry or filtered entries

two hours ago" or "@progress < 50"). May be used multiple times, combined with --bool (default: None)

• --[no-]label -- Label moved items with @from(SECTION_NAME)

• --not -- Show items that don't match search string

• -x|--exact -- Force exact search string matching (case sensitive)

autotag

doing autotag

Options:

• --bool BOOLEAN -- Boolean (AND|OR|NOT) with which to combine multiple tag filters (default: AND)

• -c|--count COUNT -- How many recent entries to autotag (0 for all) (default: 1)

• -s|--section SECTION_NAME -- Section (default: All)

• --search QUERY -- Autotag entries matching search filter, surround with slashes for regex (e.g. "/query.*/"), start with single quote for exact match ("'query") (default: None)

• --tag TAG -- Autotag the last X entries containing TAG. Separate multiple tags with comma (--tag=tag1,tag2), combine with --bool (default: None)

• --force -- Don't ask permission to autotag all entries when count is 0

• -i|--interactive -- Select item(s) to tag from a menu of matching entries

• -u|--unfinished -- Autotag last entry (or entries) not marked @done

cancel

End last X entries with no time tracked

Adds @done tag without datestamp so no elapsed time is recorded. Alias for doing finish --no-date

doing cancel COUNT

Options:

• --bool BOOLEAN -- Boolean (AND|OR|NOT) with which to combine multiple tag filters. Use PATTERN to parse + and - as booleans (default: PATTERN)

• --case TYPE -- Case sensitivity for search string matching [(c)ase-sensitive, (i)gnore, (s)mart] (default: smart)

• -s|--section NAME -- Section (default: None)

• --search QUERY -- Cancel the last X entries matching search filter, surround with slashes for regex (e.g. "/query.*/"), start with single quote for exact match ("'query") (default: None)

• --tag TAG -- Cancel the last X entries containing TAG. Separate multiple tags with comma (--tag=tag1,tag2). Wildcards allowed (*, ?) (default: None)

• --val QUERY -- Perform a tag value query ("@done List recent changes in Doing

Display a formatted list of changes in recent versions. Without flags, displays only the most recent version. Use --lookup or --all for history.

two hours ago" or "@progress < 50"). May be used multiple times, combined with --bool (default: None)

• -a|--archive -- Archive entries

• -i|--interactive -- Select item(s) to cancel from a menu of matching entries

• --not -- Finish items that don't match search/tag filters

• -u|--unfinished -- Cancel last entry (or entries) not already marked @done

• -x|--exact -- Force exact search string matching (case sensitive)

changes/changelog

doing changes

doing changelog

Options:

• -l|--lookup VERSION -- Look up a specific version. Specify versions as "MAJ.MIN.PATCH", MIN and PATCH are optional. Use List available color variables for configuration templates and views

or < to see all changes since or prior to a version. (default: None)

• -s|--search arg -- Show changelogs matching search terms (uses pattern-based searching). Add slashes to search with regular expressions, e.g. --search "/output.*flag/" (default: None)

• -a|--all -- Display all versions

colors

doing colors

commands

Enable and disable Doing commands

doing commands

Commands

Enable Doing commands

Run without arguments to select commands from a list.

doing Commands

add/enable COMMAND [COMMAND...]

remove/disable

Disable Doing commands

Generate shell completion scripts

Generates the necessary scripts to add command line completion to various shells, so typing 'doing' and hitting

tab will offer completions of subcommands and their options.

Default Command: add

completion

doing completion

Options:

• -f|--file PATH -- File to write output to (default: STDOUT)

• -t|--type SHELL -- Shell to generate for (bash, zsh, fish) (default: zsh)

config

Edit the configuration file or output a value from it

Run without arguments, doing config opens your config.yml in an editor.

If local configurations are found in the path between the current directory

and the root (/), a menu will allow you to select which to open in the editor.

It will use the editor defined in config_editor_app, or one specified with --editor.

Use doing config get to output the configuration to the terminal, and

provide a dot-separated key path to get a specific value. Shows the current value

including keys/overrides set by local configs.

doing config

Options:

• -d|--[no-]dump -- DEPRECATED

• -u|--[no-]update -- DEPRECATED

Commands

Open config file in editor

doing Commands

edit

#Options:

• -a|--app APP_NAME -- Application to use (default: None)

• -b|--bundle_id BUNDLE_ID -- Application bundle id to use (default: None)

• -e|--editor EDITOR -- Editor to use (default: None)

• -x|--[no-]default -- Use the config_editor_app defined in ~/.config/doing/config.yml (config_editor_app not set)

get/dump

Output a key's value

#Options:

• -o|--output FORMAT -- Format for output (json|yaml|raw) (default: yaml)

list

List configuration paths, including .doingrc files in the current and parent directories

Config files are listed in order of precedence (if there are multiple configs detected). Values defined in the top item in the list will override values in configutations below it.

set

Set a key's value in the config file

#Options:

• -r|--remove -- Delete specified key

undo

Undo the last change to a config file

update/refresh

Update default config file, adding any missing keys

Add a completed item with @done(date). No argument finishes last entry

Use this command to add an entry after you've already finished it. It will be immediately marked as @done.

You can modify the start and end times of the entry using the --back, --took, and --at flags, making it an easy

way to add entries in post and maintain accurate (albeit manual) time tracking.

Default Command: edit

done/did

doing done [ENTRY]

doing did [ENTRY]

Options:

• --at|--finished DATE_STRING -- Set finish date to specific date/time (natural langauge parsed, e.g. --at=1:30pm). Used with --took, backdates start date (default: None)

• -b|--back|--started DATE_STRING -- Backdate start date by interval or set to time [4pm|20m|2h|"yesterday noon"] (default: None)

• --from TIME_RANGE -- Start and end times as a date/time range doing done --from "1am to 8am".

    Overrides other date flags.
  

(default: None)

• -n|--note TEXT -- Include a note (default: None)

• -s|--section NAME -- Section (default: None)

• -t|--took|--for INTERVAL -- Set completion date to start date plus interval (XX[mhd] or HH:MM). If used without the --back option, the start date will be moved back to allow the completion date to be the current time. (default: None)

• -a|--archive -- Immediately archive the entry

• --ask -- Prompt for note via multi-line input

• --[no-]date -- Include date

• -e|--editor -- Edit entry with /opt/homebrew/bin/vim (with no arguments, edits the last entry)

• -r|--remove -- Remove @done tag

• -u|--unfinished -- Finish last entry not already marked @done

finish

Mark last X entries as @done

Marks the last X entries with a @done tag and current date. Does not alter already completed entries.

doing finish [COUNT]

Options:

• --at|--finished DATE_STRING -- Set finish date to specific date/time (natural langauge parsed, e.g. --at=1:30pm). If used, ignores --back. (default: None)

• -b|--back|--started DATE_STRING -- Backdate completed date to date string [4pm|20m|2h|yesterday noon] (default: None)

• --bool BOOLEAN -- Boolean (AND|OR|NOT) with which to combine multiple tag filters. Use PATTERN to parse + and - as booleans (default: PATTERN)

• --case TYPE -- Case sensitivity for search string matching [(c)ase-sensitive, (i)gnore, (s)mart] (default: smart)

• -s|--section NAME -- Section (default: None)

• --search QUERY -- Finish the last X entries matching search filter, surround with slashes for regex (e.g. "/query.*/"), start with single quote for exact match ("'query") (default: None)

• -t|--took|--for INTERVAL -- Set the completed date to the start date plus XX[hmd] (default: None)

• --tag TAG -- Finish the last X entries containing TAG. Separate multiple tags with comma (--tag=tag1,tag2), combine with --bool. Wildcards allowed (*, ?). (default: None)

• --val QUERY -- Perform a tag value query ("@done Search for entries

Search all sections (or limit to a single section) for entries matching text or regular expression. Normal strings are fuzzy matched.

To search with regular expressions, single quote the string and surround with slashes: doing search '/m.*?x/'

two hours ago" or "@progress < 50"). May be used multiple times, combined with --bool (default: None)

• -a|--archive -- Archive entries

• --auto -- Auto-generate finish dates from next entry's start time. Automatically generate completion dates 1 minute before next item (in any section) began. --auto overrides the --date and --back parameters.

• --[no-]date -- Include date

• -i|--interactive -- Select item(s) to finish from a menu of matching entries

• --not -- Finish items that don't match search/tag filters

• -r|--remove -- Remove done tag

• -u|--unfinished -- Finish last entry (or entries) not already marked @done

• -x|--exact -- Force exact search string matching (case sensitive)

grep/search

doing grep SEARCH_PATTERN

doing search SEARCH_PATTERN

Options:

• --after DATE_STRING -- Search entries newer than date. If this is only a time (8am, 1:30pm, 15:00), all dates will be included, but entries will be filtered by time of day (default: None)

• --before DATE_STRING -- Search entries older than date. If this is only a time (8am, 1:30pm, 15:00), all dates will be included, but entries will be filtered by time of day (default: None)

• --bool arg -- Combine multiple tags or value queries using AND, OR, or NOT (default: AND)

• --case TYPE -- Case sensitivity for search string matching [(c)ase-sensitive, (i)gnore, (s)mart] (default: smart)

• --config_template TEMPLATE_KEY -- Output using a template from configuration (default: default)

• --from DATE_OR_RANGE -- Date range to show, or a single day to filter date on.

  Date range argument should be quoted. Date specifications can be natural language.
  
  To specify a range, use "to" or "through": `doing search --from "monday 8am to friday 5pm"`.
  
  If values are only time(s) (6am to noon) all dates will be included, but entries will be filtered
  
  by time of day.
  

(default: None)

• -o|--output FORMAT -- Output to export format (csv|dayone|dayone-days|dayone-entries|doing|html|json|markdown|say|taskpaper|template|timeline|wiki) (default: None)

• -s|--section NAME -- Section (default: All)

• --tag_sort KEY -- Sort tags by (name|time) (default: name)

• --template TEMPLATE_STRING -- Override output format with a template string containing %placeholders (default: None)

• --val QUERY -- Perform a tag value query ("@done Shows a list of commands or help for one command

Gets help for the application or its commands. Can also list the commands in a way helpful to creating a bash-style completion function

two hours ago" or "@progress < 50"). May be used multiple times, combined with --bool (default: None)

• -d|--delete -- Delete matching entries

• --[no-]duration -- Show elapsed time on entries without @done tag

• -e|--editor -- Edit matching entries with /opt/homebrew/bin/vim

• -h|--[no-]hilite -- Highlight search matches in output. Only affects command line output

• -i|--interactive -- Display an interactive menu of results to perform further operations

• --not -- Show items that don't match search string

• --only_timed -- Only show items with recorded time intervals

• -t|--[no-]times -- Show time intervals on @done tasks

• --totals -- Show intervals with totals at the end of output

• -x|--exact -- Force exact string matching (case sensitive)

help

doing help command

Options:

• -c -- List commands one per line, to assist with shell completion

import

Import entries from an external source

Imports entries from other sources. Available plugins: calendar, capturething, doing, timing

doing import PATH

Options:

• --after DATE_STRING -- Import entries newer than date (default: None)

• --before DATE_STRING -- Import entries older than date (default: None)

• --case TYPE -- Case sensitivity for search string matching [(c)ase-sensitive, (i)gnore, (s)mart] (default: smart)

• -f|--from DATE_OR_RANGE -- Date range to import. Date range argument should be quoted. Date specifications can be natural language.

  To specify a range, use "to" or "through": --from "monday to friday" or --from 10/1 to 10/31.

  Has no effect unless the import plugin has implemented date range filtering. (default: None)

• --prefix PREFIX -- Prefix entries with (default: None)

• -s|--section NAME -- Target section (default: None)

• --search QUERY -- Only import items matching search. Surround with slashes for regex (/query/), start with single quote for exact match ("'query") (default: None)

• -t|--tag TAGS -- Tag all imported entries (default: None)

• --type TYPE -- Import type (calendar|capturething|doing|timing) (default: doing)

• --[no-]autotag -- Autotag entries

• --not -- Import items that don't match search/tag/date filters

• --only_timed -- Only import items with recorded time intervals

• --[no-]overlap -- Allow entries that overlap existing times

• -x|--exact -- Force exact search string matching (case sensitive)

last

Show the last entry, optionally edit

Shows the last entry. Using --search and --tag filters, you can view/edit the last entry matching a filter,

allowing doing last to target historical entries.

doing last

Options:

• --bool BOOLEAN -- Tag boolean (AND|OR|NOT). Use PATTERN to parse + and - as booleans (default: PATTERN)

• --case TYPE -- Case sensitivity for search string matching [(c)ase-sensitive, (i)gnore, (s)mart] (default: smart)

• --config_template TEMPLATE_KEY -- Output using a template from configuration (default: last)

• -s|--section NAME -- Specify a section (default: All)

• --search QUERY -- Search filter, surround with slashes for regex (/query/), start with single quote for exact match ("'query") (default: None)

• --tag TAG -- Tag filter, combine multiple tags with a comma. Wildcards allowed (*, ?) (default: None)

• --template TEMPLATE_STRING -- Override output format with a template string containing %placeholders (default: None)

• --val QUERY -- Perform a tag value query ("@done Add an item to the Later section

two hours ago" or "@progress < 50"). May be used multiple times, combined with --bool (default: None)

• -d|--delete -- Delete the last entry

• --[no-]duration -- Show elapsed time if entry is not tagged @done

• -e|--editor -- Edit entry with /opt/homebrew/bin/vim

• -h|--[no-]hilite -- Highlight search matches in output. Only affects command line output

• --not -- Show items that don't match search string or tag filter

• -x|--exact -- Force exact search string matching (case sensitive)

later

doing later ENTRY

Options:

• -b|--back|--started DATE_STRING -- Backdate start time to date string [4pm|20m|2h|yesterday noon] (default: None)

• -n|--note TEXT -- Note (default: None)

• --ask -- Prompt for note via multi-line input

• -e|--editor -- Edit entry with /opt/homebrew/bin/vim

mark/flag

Mark last entry as flagged

doing mark

doing flag

Options:

• --bool BOOLEAN -- Boolean (AND|OR|NOT) with which to combine multiple tag filters. Use PATTERN to parse + and - as booleans (default: PATTERN)

• -c|--count COUNT -- How many recent entries to tag (0 for all) (default: 1)

• --case TYPE -- Case sensitivity for search string matching [(c)ase-sensitive, (i)gnore, (s)mart] (default: smart)

• -s|--section SECTION_NAME -- Section (default: All)

• --search QUERY -- Flag the last entry matching search filter, surround with slashes for regex (e.g. "/query.*/"), start with single quote for exact match ("'query") (default: None)

• --tag TAG -- Flag the last entry containing TAG. Separate multiple tags with comma (--tag=tag1,tag2), combine with --bool. Wildcards allowed (*, ?). (default: None)

• --val QUERY -- Perform a tag value query ("@done Finish any running @meanwhile tasks and optionally create a new one

The @meanwhile tag allows you to have long-running entries that encompass smaller entries.

This command makes it easy to start and stop these overarching entries. Just run `doing meanwhile Starting work on this

big projectto start a @meanwhile entry, add other entries as you work on the project, then usedoing meanwhile` by

itself to mark the entry as @done.

two hours ago" or "@progress < 50"). May be used multiple times, combined with --bool (default: None)

• -d|--date -- Include current date/time with tag

• --force -- Don't ask permission to flag all entries when count is 0

• -i|--interactive -- Select item(s) to flag from a menu of matching entries

• --not -- Flag items that don't match search/tag/date filters

• -r|--remove -- Remove flag

• -u|--unfinished -- Flag last entry (or entries) not marked @done

• -x|--exact -- Force exact search string matching (case sensitive)

meanwhile

doing meanwhile [ENTRY]

Options:

• -b|--back|--started DATE_STRING -- Backdate start date for new entry to date string [4pm|20m|2h|yesterday noon] (default: None)

• -n|--note TEXT -- Note (default: None)

• -s|--section NAME -- Section (default: None)

• -a|--archive -- Archive previous @meanwhile entry

• --ask -- Prompt for note via multi-line input

• -e|--editor -- Edit entry with /opt/homebrew/bin/vim

note

Add a note to the last entry

If -r is provided with no other arguments, the last note is removed. If new content is specified through arguments or STDIN, any previous note will be replaced with the new one.

Use -e to load the last entry in a text editor where you can append a note.

doing note [NOTE_TEXT]

Options:

• --bool BOOLEAN -- Boolean (AND|OR|NOT) with which to combine multiple tag filters. Use PATTERN to parse + and - as booleans (default: PATTERN)

• --case TYPE -- Case sensitivity for search string matching [(c)ase-sensitive, (i)gnore, (s)mart] (default: smart)

• -s|--section NAME -- Section (default: All)

• --search QUERY -- Add/remove note from last entry matching search filter, surround with slashes for regex (e.g. "/query.*/"), start with single quote for exact match ("'query") (default: None)

• --tag TAG -- Add/remove note from last entry matching tag. Wildcards allowed (*, ?) (default: None)

• --val QUERY -- Perform a tag value query ("@done Add an entry

Record what you're starting now, or backdate the start time using natural language.

A parenthetical at the end of the entry will be converted to a note.

Run without arguments to create a new entry interactively.

Run with --editor to create a new entry using /opt/homebrew/bin/vim.

two hours ago" or "@progress < 50"). May be used multiple times, combined with --bool (default: None)

• --ask -- Prompt for note via multi-line input

• -e|--editor -- Edit entry with /opt/homebrew/bin/vim

• -i|--interactive -- Select item for new note from a menu of matching entries

• --not -- Add note to item that doesn't match search/tag filters

• -r|--remove -- Replace/Remove last entry's note (default append)

• -x|--exact -- Force exact search string matching (case sensitive)

now/next

doing now ENTRY

doing next ENTRY

Options:

• -b|--back|--started DATE_STRING -- Backdate start time [4pm|20m|2h|"yesterday noon"] (default: None)

• --from TIME_RANGE -- Set a start and optionally end time as a date range ("from 1pm to 2:30pm").

    If an end time is provided, a dated @done tag will be added
  

(default: None)

• -n|--note TEXT -- Include a note (default: None)

• -s|--section NAME -- Section (default: None)

• --ask -- Prompt for note via multi-line input

• -e|--editor -- Edit entry with /opt/homebrew/bin/vim

• -f|--finish_last -- Timed entry, marks last entry in section as @done

on

List entries for a date

Date argument can be natural language. "thursday" would be interpreted as "last thursday,"

and "2d" would be interpreted as "two days ago." If you use "to" or "through" between two dates,

it will create a range.

doing on DATE_STRING

Options:

• --config_template TEMPLATE_KEY -- Output using a template from configuration (default: default)

• -o|--output FORMAT -- Output to export format (csv|dayone|dayone-days|dayone-entries|doing|html|json|markdown|say|taskpaper|template|timeline|wiki) (default: None)

• -s|--section NAME -- Section (default: All)

• --tag_sort KEY -- Sort tags by (name|time) (default: name)

• --template TEMPLATE_STRING -- Override output format with a template string containing %placeholders (default: None)

• --[no-]duration -- Show elapsed time on entries without @done tag

• -t|--[no-]times -- Show time intervals on @done tasks

• --totals -- Show time totals at the end of output

open

Open the "doing" file in an editor

doing open defaults to using the editors->doing_file setting in ~/.config/doing/config.yml (/opt/homebrew/bin/vim).

doing open

Options:

• -a|--app APP_NAME -- Open with app name (default: None)

• -b|--bundle_id BUNDLE_ID -- Open with app bundle id (default: None)

• -e|--editor COMMAND -- Open with editor command (e.g. vim, mate) (default: None)

plugins

List installed plugins

Lists available plugins, including user-installed plugins.

Export plugins are available with the --output flag on commands that support it.

Import plugins are available using doing import --type PLUGIN.

doing plugins

Options:

• -t|--type TYPE -- List plugins of type (import, export) (default: all)

• -c|--column -- List in single column for completion

recent

List recent entries

doing recent COUNT

Options:

• --config_template TEMPLATE_KEY -- Output using a template from configuration (default: recent)

• -s|--section NAME -- Section (default: All)

• --tag_sort KEY -- Sort tags by (name|time) (default: name)

• --template TEMPLATE_STRING -- Override output format with a template string containing %placeholders (default: None)

• --[no-]duration -- Show elapsed time on entries without @done tag

• -i|--interactive -- Select from a menu of matching entries to perform additional operations

• -t|--[no-]times -- Show time intervals on @done tasks

• --totals -- Show intervals with totals at the end of output

reset/begin

Reset the start time of an entry

Update the start time of the last entry or the last entry matching a tag/search filter.

If no argument is provided, the start time will be reset to the current time.

If a date string is provided as an argument, the start time will be set to the parsed result.

doing reset [DATE_STRING]

doing begin [DATE_STRING]

Options:

• --bool BOOLEAN -- Boolean (AND|OR|NOT) with which to combine multiple tag filters. Use PATTERN to parse + and - as booleans (default: PATTERN)

• --case TYPE -- Case sensitivity for search string matching [(c)ase-sensitive, (i)gnore, (s)mart] (default: smart)

• -s|--section NAME -- Limit search to section (default: All)

• --search QUERY -- Reset last entry matching search filter, surround with slashes for regex (e.g. "/query.*/"), start with single quote for exact match ("'query") (default: None)

• --tag TAG -- Reset last entry matching tag. Wildcards allowed (*, ?) (default: None)

• --val QUERY -- Perform a tag value query ("@done Move entries to archive file

As your doing file grows, commands can get slow. Given that your historical data (and your archive section)

probably aren't providing any useful insights a year later, use this command to "rotate" old entries out to an archive

file. You'll still have access to all historical data, but it won't be slowing down daily operation.

two hours ago" or "@progress < 50"). May be used multiple times, combined with --bool (default: None)

• -i|--interactive -- Select from a menu of matching entries

• -n -- Change start date but do not remove @done (shortcut for --no-resume)

• --not -- Reset items that don't match search/tag filters

• -r|--[no-]resume -- Resume entry (remove @done)

• -x|--exact -- Force exact search string matching (case sensitive)

rotate

doing rotate

Options:

• --before DATE_STRING -- Rotate entries older than date

  (Flexible date format, e.g. 1/27/2021, 2020-07-19, or Monday 3pm) (default: None)

• --bool BOOLEAN -- Tag boolean (AND|OR|NOT). Use PATTERN to parse + and - as booleans (default: PATTERN)

• --case TYPE -- Case sensitivity for search string matching [(c)ase-sensitive, (i)gnore, (s)mart] (default: smart)

• -k|--keep X -- How many items to keep in each section (most recent) (default: None)

• -s|--section SECTION_NAME -- Section to rotate (default: All)

• --search QUERY -- Search filter (default: None)

• --tag TAG -- Tag filter, combine multiple tags with a comma. Wildcards allowed (*, ?). Added for compatibility with other commands (default: None)

• --val QUERY -- Perform a tag value query ("@done List sections

two hours ago" or "@progress < 50"). May be used multiple times, combined with --bool (default: None)

• --not -- Rotate items that don't match search string or tag filter

• -x|--exact -- Force exact search string matching (case sensitive)

sections

doing sections

Options:

• -c|--column -- List in single column

select

Display an interactive menu to perform operations

List all entries and select with typeahead fuzzy matching.

Multiple selections are allowed, hit tab to add the highlighted entry to the

selection, and use ctrl-a to select all visible items. Return processes the

selected entries.

Search in the menu by typing:

sbtrkt fuzzy-match Items that match sbtrk*t

'wild exact-match (quoted) Items that include wild

!fire inverse-exact-match Items that do not include fire

doing select

Options:

• --after DATE_STRING -- Select from entries newer than date. If this is only a time (8am, 1:30pm, 15:00), all dates will be included, but entries will be filtered by time of day (default: None)

• --before DATE_STRING -- Select from entries older than date. If this is only a time (8am, 1:30pm, 15:00), all dates will be included, but entries will be filtered by time of day (default: None)

• --case TYPE -- Case sensitivity for search string matching [(c)ase-sensitive, (i)gnore, (s)mart] (default: smart)

• --from DATE_OR_RANGE -- Date range to show, or a single day to filter date on.

  Date range argument should be quoted. Date specifications can be natural language.
  
  To specify a range, use "to" or "through": `doing select --from "monday 8am to friday 5pm"`.
  
  If values are only time(s) (6am to noon) all dates will be included, but entries will be filtered
  
  by time of day.
  

(default: None)

• -m|--move SECTION -- Move selected items to section (default: None)

• -o|--output FORMAT -- Output entries to format (csv|dayone|dayone-days|dayone-entries|doing|html|json|markdown|say|taskpaper|template|timeline|wiki) (default: None)

• -q|--query QUERY -- Initial search query for filtering. Matching is fuzzy. For exact matching, start query with a single quote, e.g. --query "'search" (default: None`)

• -s|--section SECTION -- Select from a specific section (default: None)

• --save_to FILE -- Save selected entries to file using --output format (default: None)

• --search QUERY -- Select from entries matching search filter, surround with slashes for regex (e.g. "/query.*/"), start with single quote for exact match ("'query") (default: None)

• -t|--tag TAG -- Tag selected entries (default: None)

• --val QUERY -- Perform a tag value query ("@done List all entries

The argument can be a section name, @tag(s) or both. "pick" or "choose" as an argument will offer a section menu. Run with --menu to get a menu of available tags.

Show tags by passing @tagname arguments. Multiple tags can be combined, and you can specify the boolean used to combine them with --bool (AND|OR|NOT). You can also use @+tagname to require a tag to match, or @-tagname to ignore entries containing tagname. +/- operators require --bool PATTERN (which is the default).

two hours ago" or "@progress < 50"). May be used multiple times, combined with --bool (default: None)

• -a|--archive -- Archive selected items

• --again|--resume -- Copy selection as a new entry with current time and no @done tag. Only works with single selections. Can be combined with --editor.

• -c|--cancel -- Cancel selected items (add @done without timestamp)

• -d|--delete -- Delete selected items

• -e|--editor -- Edit selected item(s)

• -f|--finish -- Add @done with current time to selected item(s)

• --flag -- Add flag to selected item(s)

• --force -- Perform action without confirmation

• --[no-]menu -- Use --no-menu to skip the interactive menu. Use with --query to filter items and act on results automatically. Test with --output doing to preview matches

• --not -- Select items that don't match search/tag filters

• -r|--remove -- Reverse -c, -f, --flag, and -t (remove instead of adding)

• -x|--exact -- Force exact search string matching (case sensitive)

show

doing show [SECTION|@TAGS]

Options:

• -a|--age AGE -- Age (oldest|newest) (default: newest)

• --after DATE_STRING -- Show entries newer than date. If this is only a time (8am, 1:30pm, 15:00), all dates will be included, but entries will be filtered by time of day (default: None)

• -b|--bool BOOLEAN -- Tag boolean (AND,OR,NOT). Use PATTERN to parse + and - as booleans (default: PATTERN)

• --before DATE_STRING -- Show entries older than date. If this is only a time (8am, 1:30pm, 15:00), all dates will be included, but entries will be filtered by time of day (default: None)

• -c|--count MAX -- Max count to show (default: 0)

• --case TYPE -- Case sensitivity for search string matching [(c)ase-sensitive, (i)gnore, (s)mart] (default: smart)

• --config_template TEMPLATE_KEY -- Output using a template from configuration (default: default)

• --from DATE_OR_RANGE -- Date range to show, or a single day to filter date on.

  Date range argument should be quoted. Date specifications can be natural language.
  
  To specify a range, use "to" or "through": `doing show --from "monday 8am to friday 5pm"`.
  
  If values are only time(s) (6am to noon) all dates will be included, but entries will be filtered
  
  by time of day.
  

(default: None)

• -o|--output FORMAT -- Output to export format (csv|dayone|dayone-days|dayone-entries|doing|html|json|markdown|say|taskpaper|template|timeline|wiki) (default: None)

• -s|--sort ORDER -- Sort order (asc/desc) (default: asc)

• --search QUERY -- Search filter, surround with slashes for regex (/query/), start with single quote for exact match ("'query") (default: None)

• --tag TAG -- Tag filter, combine multiple tags with a comma. Use --tag pick for a menu of available tags. Wildcards allowed (*, ?). Added for compatibility with other commands (default: None)

• --tag_order DIRECTION -- Tag sort direction (asc|desc) (default: asc)

• --tag_sort KEY -- Sort tags by (name|time) (default: name)

• --template TEMPLATE_STRING -- Override output format with a template string containing %placeholders (default: None)

• --val QUERY -- Perform a tag value query ("@done List entries since a date

Date argument can be natural language and are always interpreted as being in the past. "thursday" would be interpreted as "last thursday,"

and "2d" would be interpreted as "two days ago."

two hours ago" or "@progress < 50"). May be used multiple times, combined with --bool (default: None)

• --[no-]duration -- Show elapsed time on entries without @done tag

• -h|--[no-]hilite -- Highlight search matches in output. Only affects command line output

• -i|--interactive -- Select from a menu of matching entries to perform additional operations

• -m|--menu -- Select section or tag to display from a menu

• --not -- Show items that don't match search/tag/date filters

• --only_timed -- Only show items with recorded time intervals

• -t|--[no-]times -- Show time intervals on @done tasks

• --totals -- Show intervals with totals at the end of output

• -x|--exact -- Force exact search string matching (case sensitive)

since

doing since DATE_STRING

Options:

• --config_template TEMPLATE_KEY -- Output using a template from configuration (default: default)

• -o|--output FORMAT -- Output to export format (csv|dayone|dayone-days|dayone-entries|doing|html|json|markdown|say|taskpaper|template|timeline|wiki) (default: None)

• -s|--section NAME -- Section (default: All)

• --tag_sort KEY -- Sort tags by (name|time) (default: name)

• --template TEMPLATE_STRING -- Override output format with a template string containing %placeholders (default: None)

• --[no-]duration -- Show elapsed time on entries without @done tag

• -t|--[no-]times -- Show time intervals on @done tasks

• --totals -- Show time totals at the end of output

tag

Add tag(s) to last entry

Add (or remove) tags from the last entry, or from multiple entries (with --count), entries matching a search (with --search), or entries containing another tag (with --tag). When removing tags with -r, wildcards are allowed (* to match multiple characters, ? to match a single character). With --regex, regular expressions will be interpreted instead of wildcards. For all tag removals the match is case insensitive by default, but if the tag search string contains any uppercase letters, the match will become case sensitive automatically. Tag name arguments do not need to be prefixed with @.

doing tag TAG...

Options:

• --bool BOOLEAN -- Boolean (AND|OR|NOT) with which to combine multiple tag filters. Use PATTERN to parse + and - as booleans (default: PATTERN)

• -c|--count COUNT -- How many recent entries to tag (0 for all) (default: 1)

• --case TYPE -- Case sensitivity for search string matching [(c)ase-sensitive, (i)gnore, (s)mart] (default: smart)

• --rename ORIG_TAG -- Replace existing tag with tag argument, wildcards (*,?) allowed, or use with --regex (default: None)

• -s|--section SECTION_NAME -- Section (default: All)

• --search QUERY -- Tag entries matching search filter, surround with slashes for regex (e.g. "/query.*/"), start with single quote for exact match ("'query") (default: None)

• --tag TAG -- Tag the last X entries containing TAG. Separate multiple tags with comma (--tag=tag1,tag2), combine with --bool. Wildcards allowed (*, ?). (default: None)

• -v|--value VALUE -- Include a value, e.g. @tag(value) (default: None)

• --val QUERY -- Perform a tag value query ("@done Set the default tags for the current directory

Adds default_tags to a .doingrc file in the current directory. Any entry created in this directory or its

subdirectories will be tagged with the default tags. You can modify these any time using the config set commnand or

manually editing the .doingrc file.

two hours ago" or "@progress < 50"). May be used multiple times, combined with --bool (default: None)

• -a|--autotag -- Autotag entries based on autotag configuration in ~/.config/doing/config.yml

• -d|--date -- Include current date/time with tag

• --force -- Don't ask permission to tag all entries when count is 0

• -i|--interactive -- Select item(s) to tag from a menu of matching entries

• --not -- Tag items that don't match search/tag filters

• -r|--remove -- Remove given tag(s)

• --regex -- Interpret tag string as regular expression (with --remove)

• -u|--unfinished -- Tag last entry (or entries) not marked @done

• -x|--exact -- Force exact search string matching (case sensitive)

tag_dir

doing tag_dir TAG [TAG..]

Options:

• -r|--remove -- Remove all default_tags from the local .doingrc

tags

List all tags in the current Doing file

doing tags [MAX_COUNT]

Options:

• --bool BOOLEAN -- Boolean used to combine multiple tags. Use PATTERN to parse + and - as booleans (default: PATTERN)

• --case TYPE -- Case sensitivity for search string matching [(c)ase-sensitive, (i)gnore, (s)mart] (default: smart)

• -o|--order ORDER -- Sort order (asc/desc) (default: asc)

• -s|--section SECTION_NAME -- Section (default: All)

• --search QUERY -- Get tags for items matching search. Surround with slashes for regex (e.g. "/query/"), start with a single quote for exact match ("'query"). (default: None)

• --sort SORT_ORDER -- Sort by name or count (default: name)

• --tag TAG -- Get tags for entries matching tags. Combine multiple tags with a comma. Wildcards allowed (*, ?) (default: None)

• --val QUERY -- Perform a tag value query ("@done Output HTML, CSS, and Markdown (ERB) templates for customization

Templates are printed to STDOUT for piping to a file. Save them and use them in the configuration file under export_templates.

two hours ago" or "@progress < 50"). May be used multiple times, combined with --bool (default: None)

• -c|--[no-]counts -- Show count of occurrences

• -i|--interactive -- Select items to scan from a menu of matching entries

• -l|--[no-]line -- Output in a single line with @ symbols. Ignored if --counts is specified.

• --not -- Get tags from items that don't match search/tag filters

• -x|--exact -- Force exact search string matching (case sensitive)

template

doing template TYPE

Options:

• -p|--path DIRECTORY -- Save template to alternate location (default: ~/.config/doing/templates)

• -c|--[no-]column -- List in single column for completion

• -l|--list -- List all available templates

• -s|--save -- Save template to file instead of STDOUT

test

Test Stuff

This command is coming from ~/.config/doing/commands/test.rb

doing test

today

List entries from today

List entries from the current day. Use --before, --after, and

--from to specify time ranges.

doing today

Options:

• --after TIME_STRING -- View entries after specified time (e.g. 8am, 12:30pm, 15:00) (default: None)

• --before TIME_STRING -- View entries before specified time (e.g. 8am, 12:30pm, 15:00) (default: None)

• --config_template TEMPLATE_KEY -- Output using a template from configuration (default: today)

• --from TIME_RANGE -- Time range to show doing today --from "12pm to 4pm" (default: None)

• -o|--output FORMAT -- Output to export format (csv|dayone|dayone-days|dayone-entries|doing|html|json|markdown|say|taskpaper|template|timeline|wiki) (default: None)

• -s|--section NAME -- Specify a section (default: All)

• --tag_sort KEY -- Sort tags by (name|time) (default: name)

• --template TEMPLATE_STRING -- Override output format with a template string containing %placeholders (default: None)

• --[no-]duration -- Show elapsed time on entries without @done tag

• -t|--[no-]times -- Show time intervals on @done tasks

• --totals -- Show time totals at the end of output

undo

Undo the last X changes to the Doing file

Reverts the last X commands that altered the doing file.

All changes performed by a single command are undone at once.

Specify a number to jump back multiple revisions, or use --select for an interactive menu.

doing undo COUNT

Options:

• -f|--file PATH -- Specify alternate doing file (default: None)

• -p|--prune COUNT -- Remove old backups, retaining X files (default: None)

• -i|--interactive -- Select from recent backups

• -r|--[no-]redo -- Redo last undo. Note: you cannot undo a redo

view

Display a user-created view

Views are defined in your configuration (use doing config to edit).

Command line options override view configuration.

doing view VIEW_NAME

Options:

• --after DATE_STRING -- View entries newer than date. If this is only a time (8am, 1:30pm, 15:00), all dates will be included, but entries will be filtered by time of day (default: None)

• --age AGE -- Age (oldest|newest) (default: newest)

• -b|--bool BOOLEAN -- Tag boolean (AND,OR,NOT). Use PATTERN to parse + and - as booleans (default: PATTERN)

• --before DATE_STRING -- View entries older than date. If this is only a time (8am, 1:30pm, 15:00), all dates will be included, but entries will be filtered by time of day (default: None)

• -c|--count COUNT -- Count to display (default: None)

• --case TYPE -- Case sensitivity for search string matching [(c)ase-sensitive, (i)gnore, (s)mart] (default: smart)

• --from DATE_OR_RANGE -- Date range to show, or a single day to filter date on.

  Date range argument should be quoted. Date specifications can be natural language.
  
  To specify a range, use "to" or "through": `doing view --from "monday 8am to friday 5pm" view_name`.
  
  If values are only time(s) (6am to noon) all dates will be included, but entries will be filtered
  
  by time of day.
  

(default: None)

• -o|--output FORMAT -- Output to export format (csv|dayone|dayone-days|dayone-entries|doing|html|json|markdown|say|taskpaper|template|timeline|wiki) (default: None)

• -s|--section NAME -- Section (default: None)

• --search QUERY -- Search filter, surround with slashes for regex (/query/), start with single quote for exact match ("'query") (default: None)

• --tag TAG -- Tag filter, combine multiple tags with a comma. Wildcards allowed (*, ?) (default: None)

• --tag_order DIRECTION -- Tag sort direction (asc|desc) (default: None)

• --tag_sort KEY -- Sort tags by (name|time) (default: None)

• --val QUERY -- Perform a tag value query ("@done List available custom views

two hours ago" or "@progress < 50"). May be used multiple times, combined with --bool (default: None)

• --[no-]color -- Include colors in output

• --[no-]duration -- Show elapsed time on entries without @done tag

• -h|--[no-]hilite -- Highlight search matches in output. Only affects command line output

• -i|--interactive -- Select from a menu of matching entries to perform additional operations

• --not -- Show items that don't match search string

• --only_timed -- Only show items with recorded time intervals (override view settings)

• -t|--[no-]times -- Show time intervals on @done tasks

• --totals -- Show intervals with totals at the end of output

• -x|--exact -- Force exact search string matching (case sensitive)

views

doing views

Options:

• -c|--[no-]column -- List in single column

wiki

Output a tag wiki

doing wiki

Options:

• --after DATE_STRING -- Include entries newer than date (default: None)

• -b|--bool BOOLEAN -- Tag boolean (AND,OR,NOT) (default: OR)

• --before DATE_STRING -- Include entries older than date (default: None)

• -f|--from DATE_OR_RANGE -- Date range to include, or a single day to filter date on.

  Date range argument should be quoted. Date specifications can be natural language.

  To specify a range, use "to" or "through": doing show --from "monday to friday" (default: None)

• -s|--section SECTION_NAME -- Section to rotate (default: All)

• --search QUERY -- Search filter, surround with slashes for regex (/query/), start with single quote for exact match ("'query") (default: None)

• --tag TAG -- Tag filter, combine multiple tags with a comma, use with --bool (default: None)

• --only_timed -- Only show items with recorded time intervals

yesterday

List entries from yesterday

Show only entries with start times within the previous 24 hour period. Use --before, --after, and --from to limit to

time spans within the day.

doing yesterday

Options:

• --after TIME_STRING -- View entries after specified time (e.g. 8am, 12:30pm, 15:00) (default: None)

• --before TIME_STRING -- View entries before specified time (e.g. 8am, 12:30pm, 15:00) (default: None)

• --config_template TEMPLATE_KEY -- Output using a template from configuration (default: today)

• --from TIME_RANGE -- Time range to show, e.g. doing yesterday --from "1am to 8am" (default: None)

• -o|--output FORMAT -- Output to export format (csv|dayone|dayone-days|dayone-entries|doing|html|json|markdown|say|taskpaper|template|timeline|wiki) (default: None)

• -s|--section NAME -- Specify a section (default: All)

• --tag_order DIRECTION -- Tag sort direction (asc|desc) (default: asc)

• --tag_sort KEY -- Sort tags by (name|time) (default: name)

• --template TEMPLATE_STRING -- Override output format with a template string containing %placeholders (default: None)

• --[no-]duration -- Show elapsed time on entries without @done tag

• -t|--[no-]times -- Show time intervals on @done tasks

• --totals -- Show time totals at the end of output

Default Command: recent