doing
A command line tool for keeping track of what you’re doing and tracking what you’ve done.
For a summary of all commands and options, see Doing - All Commands.
The current version of doing is 2.1.86.
Find all of the documentation in the doing wiki.
Check out some craziness with Doing in the iTerm status bar and the Mac Touch Bar/menu bar.
What and why
doing is a basic CLI for adding and listing “what was I doing” reminders in a
TaskPaper-formatted text file. It allows for
multiple sections/categories and flexible output formatting.
While I’m working, I have hourly reminders to record what I’m working on, and I
try to remember to punch in quick notes if I’m unexpectedly called away from a
project. I can do this just by typing doing now tracking down the CG bug.
If there’s something I want to look at later but doesn’t need to be added to a
task list or tracker, I can type doing later check out the pinboard bookmarks
from macdrifter. When I get back to my computer — or just need a refresher
after a distraction — I can type doing last to see what the last thing on
my plate was. I can also type doing recent (or just doing) to get a list of
the last few entries. doing today gives me everything since midnight for the
current day, making it easy to see what I’ve accomplished over a sleepless
night.
Doing has over 30 commands for tracking your status, recording your time, and analyzing the results.
See the wiki for installation and usage instructions.
Launchbar/Alfred
The LaunchBar action requires that doing be available in
/usr/local/bin/doing. If it’s not (because you’re using RVM or similar),
you’ll need to symlink it there. Running the action with Return will show the
latest 9 items from Currently, along with any time intervals recorded, and
includes a submenu of Timers for each tag.
Pressing Spacebar and typing allows you to add a new entry to currently. You an also trigger a custom show command by typing “show [section/tag]” and hitting return. Include any command line flags at the end of the string, and if you add text in parenthesis, it will be processed as a note on the entry.
Point of interest, the LaunchBar Action makes use of the -o json flag for
outputting JSON to the action’s script for parsing.
Doing for LaunchBar v2.2
Download Doing for LaunchBar v2.2
A LaunchBar action for use with doing
Published 02/07/20.
Updated 07/01/21. Changelog
Evan Lovely has created an Alfred workflow as well.
Contributing
If you create a plugin, custom command, or hook you can share, please let me know. If I get a few plugin contributions, I’ll set up a second repository for them.
Feel free to fork the repository on GitHub and make pull requests
with changes. Please target the develop branch with pull requests.
Changelog
Click to expand
2.1.86
2024-03-26 10:57
FIXED
- Unterminated date range, e.g.
--from todaywill now assume current time as end date. Results ofdoing show all --from todaywill now matchdoing today.
2.1.85
2024-03-26 10:17
NEW
- Add todo as an example command plugin
FIXED
- Error thrown when trying to guess a section/view when there’s no match.
2.1.84
2023-08-17 09:49
NEW
- Shortdate format config options (run
doing config updateand see the newshortdate_formatsection in your config file)
2.1.83
2023-07-01 12:49
FIXED
- Error on deep_set when value is an array
2.1.82
2023-07-01 12:39
IMPROVED
- Better handling of defaults for normalize functions
FIXED
- Allow value of 0 to be considered a good result when testing for good values
2.1.81
2023-05-31 11:47
IMPROVED
- Most commands that allow –section can now take multiple values, either by using –section multiple times or providing a comma separated list of sections to the flag
2.1.80
2023-03-11 10:50
FIXED
- Remove extra divider line before grand total in byday table
2.1.79
2023-03-11 10:21
FIXED
- Table header in byday output
2.1.78
2023-03-11 06:03
IMPROVED
- Add plugins.byday.item_width config for byday plugin
2.1.77
2023-03-11 05:50
IMPROVED
- Formatting and color for byday table
- Remove @done tag from byday items
2.1.76
2023-03-10 15:16
NEW
- ‘byday’ export plugin to allow display of items grouped by day with total times
2.1.75
2023-01-01 07:30
FIXED
- Error running
commands listwithout--styleflag
2.1.69
2022-08-28 14:37
IMPROVED
- Add –since as alias for –back on again, done, meanwhile and now
2.1.68
2022-08-08 12:19
FIXED
- Comparison of Doing::Section to string
2.1.66
2022-08-08 12:05
FIXED
- Deprecation warning
2.1.65
2022-08-08 11:58
2.1.64
2022-07-21 09:31
- Maintenance release
2.1.63
2022-07-21 07:11
NEW
- Allow gem-based plugins. Any gem that starts with
doing-plugin-*will be loaded and available to doing.
2.1.62
2022-07-01 10:02
IMPROVED
- Better way to insert a colored string into a another string and return the the previous color at the end of the inserted string. Whew, that was a weird way to say it.
FIXED
doing viewnot respecting search.highlight config
2.1.61
2022-06-29 05:54
IMPROVED
- Remove @meanwhile from tag totals
- Less spacing between items in default HTML export CSS
FIXED
- Code duplication in timers.rb
2.1.60
2022-06-29 02:06
FIXED
- Failed to include update command in release
2.1.59
2022-06-29 01:59
NEW
doing updatewill update doing to the latest available version
FIXED
doing done ...wasn’t autotagging the new entry
2.1.58
2022-06-01 10:20
CHANGED
- BREAKING: The
-sflag ondoing shownow means section instead of search. Use--searchfor the search flag.
NEW
- You can now use %#FFFFFF style hex strings to set colors in templates. Use %bg#FFFFFF to set a background color. Colors must be 6-digit hex codes
doing show --section NAMEallows limiting tag results to a section (same as runningdoing show SECTION_NAME @TAGbut added for compatibility with other commands)
2.1.57
2022-05-26 11:20
IMPROVED
- Add
i[:finished]as a boolean in Markdown export template (tests for @done tag and provides true/false)
2.1.56
2022-05-26 10:20
IMPROVED
- In Markdown templates (erb),
i[:flagged]will be set to true or false based on whether the item has @flagged (or whatever marker_tag is set to) present
FIXED
doing recent --interactive XXwasn’t respecting XX count and instead showing alldoing recent --section SECT COUNTnot respecting count when section is provided
2.1.55
2022-05-26 07:11
FIXED
- more permissions issues
2.1.54
2022-05-25 16:10
FIXED
- permissions issue
IMPROVED
- Reduce keypath translation logging
2.1.52
2022-05-25 12:36
FIXED
doing select-> select repeat/resume from menu, failed to repeat
2.1.51
2022-05-25 12:33
FIXED
doing archive --no-labelnot being respected
2.1.50
2022-05-16 07:40
FIXED
- Bash completion linking dash vs underscore in path
2.1.49
2022-05-12 08:49
FIXED
- When using
doing again, don’t replace an existing @done tag on the entry to be repeated
2.1.48
2022-05-11 10:13
FIXED
doing now --finish_lastnot finishing most recent entrydoing now --fromnot parsing finish date from time range
2.1.47
2022-03-26 11:12
IMPROVED
--output doingnow outputs true Doing file format, including IDs, so existing entries can be updated when re-importing this output- Add
doing config openas a synonym foredit - Help output for
--boolflag
2.1.46
2022-03-23 08:19
NEW
- Store MD5 ids with each entry
- JSON import takes Doing format JSON and updates existing items with matching ids, adding new entries for unmatched
IMPROVED
- JSON output includes section and id for each entry
2.1.45
2022-03-22 08:57
FIXED
- Specifying ‘12am’ as a start time filter resulted in a Nil error
2.1.44
2022-03-21 07:46
NEW
doing views --remove NAMEto delete a view- Deleting all view content in editor (
doing views -e) deletes the view
IMPROVED
- When saving a view, ignore keys that are the same as the default template
- Commands accepting
--savealso accept--title TITLE
FIXED
- When saving a view, store original date string instead of chronified result
- Error when testing for valid date
2.1.43
2022-03-20 12:44
NEW
- ‘parent’ key in view config allows inheritance
- Use
--save NAMEwith view commands to store command line options as a view in config - Views function as commands, so you can run
doing customand getdoing view customif ‘custom’ is not a recognized command - Breaking change - boolean switches on the command line no longer override views
- Add an argument to
doing viewsto dump the YAML for a single view - Use
doing views NAME --editorto open the YAML for a single view in the default editor, saving the result to main config - Use
doing views [-e] -o json NAMEto dump or edit a view as json instead of YAML
IMPROVED
doing changes --only [changed,new,improved,fixed]to only show changes of a type- Allow all show options in view config
- Disable autocorrect for command names so custom views can better override similarly-spelled commands
doing changes --prefixwill output each change with a type prefix- Include -F switch in
lesswhen paging to avoid pager if less than one screen
FIXED
doing templates --listreturning error
2.1.42
2022-03-17 09:38
NEW
- Config option
editors.pagerallows you to force a pager (ignore env settings)
IMPROVED
- Change pager preference order to $PAGER, less -Xr, $GIT_PAGER
- Remove
batfrom pager options as it just falls back toless -Xranyway - Using CTRL-C when entring a note interactively won’t cancel the whole operation, just the note
FIXED
- Add delay between
doing select --editorand opening the editor, fixes some TTY echo issues - If
doing last --editorhas no changes, exit gracefully - Trigger pre/post_write hooks when using undo/redo
doing config setissues with keys that default to nil- Notification for
doing config set --removemissing last element of key path
2.1.41
2022-03-16 09:29
NEW
- Filter methods available to plugins on Items collection - #in_section, #search, #tagged, #between_dates
IMPROVED
- Better comparison methods for Items and Sections
doing tag_dir -r TAGcan remove an indivudal tag from default_tags (–clear removes all)doing tag_diraccepts--editorto edit tag list in default editordoing tag_dirwithout arguments requests input via readline- Use
.txtinstead of.mdfor editor temp file to avoid incorrect syntax higlighting in editor - Further API documentation
FIXED
- Security warnings related to regular expressions
- Items.diff method returning too many changes
2.1.40
2022-03-14 19:56
NEW
doing finishaccepts--fromranges to update both start and finish datesdoing finishallows--backand--tookto be used togetherdoing finishallows--searchand--tagto be used togetherdoing finish --from 'DATE to DATE'allows you to set a new start and end time with a single range stringdoing reset --from 'DATE to DATE'allows you to reset an entry’s start time and update or add @done timedoing resetaccepts a--took Xmflag to change the finish time--output FORMAToption for all display commands, including last, recent and today
IMPROVED
- Code refactoring, split up WWID class
- Better diff method available to hooks to see what changed
FIXED
- Search highlighting was being skipped in all cases
2.1.39
2022-03-13 04:32
NEW
--valaccepts date, time, title, note, text for comparisons
IMPROVED
- Allow time filtering for
--valwhere if only a time is supplied for a date query, ignore the date and filter entries by time of day - Check for tag matching property name before assuming property in
--valcomparisons - Allow
doing tag 'name(value)'to update an existing value (already works with--valueflag) --editorflag fordoing showto batch edit results- When adding a tag via
doing select, allow a tag with a value to update an existing value
FIXED
doing on todaybreaking on Ruby 2.6- Sort entries by both date and title to prevent shuffling between revisions
2.1.38
2022-03-12 15:40
NEW
--val 'duration > 2h'allows querying elapsed time of entries
IMPROVED
- Exclude never_finish entries when searching for @done items
FIXED
--editornot saving results in some commands (includingdoing search -e)- Clock or dhm interval output not converting hours to days in some cases
2.1.37
2022-03-12 11:37
FIXED
- Recognize STDIN input on non-Mac systems. I don’t know if this will translate to Windows or not. Resolves #136, thanks @sjsrey for the pointer
- Recongnition of ‘today’ as a date input, e.g.
doing on today, converts to ‘current date 12am to 11:59pm’
2.1.36
2022-02-25 08:44
FIXED
- Warning when using
doing done --took
2.1.35
2022-02-21 14:53
FIXED
- Revert switch to sys-uname, hopefully solve crash
2.1.34
2022-02-20 09:32
IMPROVED
- Allow
--from 8amtime range without end time to mean8am to 11:59pm --tag_orderfor commands with--totalsoutput that were missing it- Tag and search filters for on, since, today and yesterday
- Time filters for today and yesterday
--only_timedfilter for yesterday--only_timedfor today- Remove exact duplicates from content before saving
doing sectionsnow has subcommands –sections list,sections add SECTION(replacesadd_section) andsections remove SECTIONallows removal of a section and archiving of its contents
FIXED
doing yesterday --fromnot filtering time range- Don’t return a duration or interval for entries configured as never_time or never_finish
--fromtime filter for yesterday- Regex error in
doing archive --timeserror indoing today
2.1.33
2022-02-18 12:09
FIXED
- Major fixes for completion scripts, especially zsh
2.1.32
2022-02-18 08:34
NEW
doing config set --localflag to force updates to local .doingrc, creating if it doesn’t exist, and bypassing menu selection
IMPROVED
doing tag_dirwill not allow duplicate tags or tags that are already applied by a config higher up the hierarchydoing tag_dirwill force updates to .doingrc in the current directory rather than offering a menu
FIXED
- When running without subcommand, e.g.
doing this thing, the first word was being lost - Remove blank lines when running
doing changes --changes --md(output changes only in Markdown format)
2.1.31
2022-02-17 12:59
NEW
doing completion install SHELLwill copy the default completion scripts to your ~/.local/share/doing folder and offer to symlink them to autoload directories. These scripts are generated with each release but will not include any custom commands or plugins in the completions.doing completionnow uses subcommands,generateandinstall. The install command will write default scripts to ~/.local/share/doing/completion and link them into the appropriate autoload directory for the shell. The generate command will create new scripts that include any custom commands and plugins.- Convenience methods for plugins getting and setting configuration options using dot key paths (
Doing.setting('plugins.myplugin.setting')andDoing.set('plugins.myplugin.setting', value))
IMPROVED
- When generating completion scripts using
doing completion --file FILE_PATH, if the file specified is not in an auto-load directory for the shell type, offer to symlink the output to an appropriate directory - Update examples in
doing help completionand its subcommands - Move in-memory configuration into a module variable so it can be persisted/accessed outside of a WWID object using
Doing.config - Clean up/update
wikiexample command
FIXED
- Don’t output empty notes as empty brackets in JSON output (also fixes the LaunchBar view of recent entries)
- Error in
--backflag fordoing again - Don’t try to finish items already marked @done in
doing again - Generating scripts using
doing completionwould fail if the terminal running it was narrow enough to wrap help output
2.1.29
2022-02-14 12:42
IMPROVED
doing changes --interactivewill load up a changelog viewer using fzf. Because it makes me happy, that’s why.
2.1.28
2022-02-14 11:39
FIXED
- Lines merging in
doing changes --changesoutput
2.1.27
2022-02-14 06:04
NEW
doing finish --updatewill overwrite any existing @done tag with a new date (current time or set with--ator--back)
IMPROVED
- Code refactoring and cleanup
- Include release dates in
doing changesoutput when available - Allow various naming conventions for %color strings in templates. Now
boldwhite,brightwhite,bg_bold_cyan, andbold_bg_cyanall work (for example) - Common flags (e.g. –search, –tag) found on multiple commands consolidated and help descriptions matched
commands_acceptingnow accepts multiple arguments and a--boolflagchangescommand can now output changes only (no version numbers) and defaults to raw Markdown if not a TTY or the--mdflag is useddoing archivenow accepts--afterand--fromdate filters
FIXED
- Some flag descriptions in help
- Editor detection
2.1.26
2022-01-23 16:14
NEW
- Use plugins.hidden_commands in configuration to disable any command (array of command names). Note that some commands use aliases and the first name should be used.
doing commands [add|remove]allows interactive enabling and disabling of default and custom commands
IMPROVED
- Moved all commands into separate files for management
FIXED
- Changelog command regex too greedy when parsing changelog
2.1.25
2022-01-23 09:25
2.1.24
2022-01-22 17:27
IMPROVED
- Minor update to Fish completion script
FIXED
- Changelog formatting issue
2.1.23
2022-01-22 15:52
NEW
- All display commands (except view) now accept
--config_template TEMPLATE_KEYto override that commands default template. - Display commands accept
--template, which takes a template string containing %placeholders and overrides the commands default template output. Affects grep, last, on, recent, show, since, today, yesterday
IMPROVED
- With complete examples in the help output for most commands,
doing helpalmost always requires scrolling up. It now automatically paginates using your system $PAGER (or best detected option). doing tagstakes a MAX_COUNT argument to limit results when searchingdoing tags --lineflag to output tags in a single line- Mostly for my own use,
doing changes(which views the changelog) now accepts--lookup VERSIONand--search SEARCH_PATTERN doing changes --lookupaccepts"< 2.1 > 2.0","2.1.10-2.2", a specific version, or a version number with wildcards- When registering hooks, you can pass an array to register a block for multiple events, assuming the events provide the same block arguments (like post_entry_added and post_entry_updated)
FIXED
- Running
--tag "@doing"wouldn’t work where--tag "doing"would. Now properly ignoring @ symbols
2.1.22
2022-01-21 14:53
2.1.21
2022-01-20 12:05
FIXED
- Custom types not available to custom commands
2.1.20
2022-01-20 11:49
NEW
- Autotag option for interactive
doing selectmenu - (Breaking change) Made the later command an optional plugin, see wiki for how to install (and create) custom commands
- Config setting doing_file_sort (asc or desc) determines the sort order of entries in the actual Doing file. Has no effect on other operations, just allows you to store the file with newest entries at top (desc) or bottom (asc).
IMPROVED
- Autotag improvements
- If doing is run without a command but with arguments, execute it as if you’d run
doing now, passing the arguments to that. So you can just write “doing this thing” instead of “doing now this thing”, as long as the first word of the arguments is not a recognized command.
FIXED
doing againshould only mark the original repeating entry @done, not search for the last unfinished entry- Error when using
doing finish --auto doing on wedwhen today is wednesday not returning results- Using
config setwith a false value deleted the key from config config setwith true or false value was inserting a quoted string- Entries were not being sorted (at all) within sections when writing the Doing file
2.1.19
2022-01-18 08:40
FIXED
- Search highlighting error with some pattern searches
- Reverse sort of items in menu from
--interactiveflags - Nil error when
--interactivewas called without search results
2.1.18
Build automation test
2.1.17
2022-01-18 07:26
NEW
--hiliteoption fordoing searchto highlight matches in search results (terminal output only)--hiliteflag forshowandviewto highlight results when used with--search
IMPROVED
- Show preview of up to 5 items when confirming a delete operation so you actually know what you’re deleting
- Allow
--askwhen creating new entry via STDIN pipe - Tab completion for known tags when creating an entry interactively
- Add purple as an alias for magenta in template colors
FIXED
- Clear STDIN before requesting input
2.1.16
2022-01-18 02:45
NEW
doing done --from "3pm to 3:15pm"to set start and end times with natural language string
IMPROVED
- Running
doing tagwithout arguments takes command line input - If
doing nowordoing laterare run without arguments, interactively request necessary information (you can still use--editorto edit in your preferred editor) - Tab completion for tags when entering at prompt
- Use readline when requesting input text, better editing features
doing done --atno longer overrides--back
FIXED
doing select-> output formatted empty output- Sort items by date when using
doing select --editor(was loading in selection order instead) - Ruby 2.7 error in template output (.empty? on FalseClass)
- Don’t add empty entry when cancelling
--editor - Batch editing bugs
2.1.15
2022-01-17 07:25
NEW
- When completing an entry, if the elapsed time would be greater than a (configurable) amount, doing will now ask for confirmation and allow you to enter a new duration before setting the @done date
IMPROVED
- When entering intervals, you can now use 1h30m in addition to 1.5h or 90m
- Date expansion works in more circumstances
- You can include date tags with natural language values when adding tags via
doing select
FIXED
- Tags containing values with spaces no longer cause errors
2.1.14
NEW
- All commands that accept
--notenow accept--ask, which requests input via readline after creating the note. Multiple lines are allowed, hit return twice to end editing. Works alongside--noteand--editor
IMPROVED
- Implement
--searchand--fromfiltering for import plugins - UTC format date strings in select menus for consistency (was relative date formatting)
- Don’t populate the fzf search with
--search, it’s already filtered. Separated--queryfrom--searchif you do want to populate the query string in addition to--searchfiltering - When showing relative dates, don’t include the year if the date is the previous year but a later month than the current month (less than a year old)
- When using
--editorwhile adding an entry, include any note specified on the command line or via--askfor further editing
2.1.13
NEW
--valflag for all display commands, allows tag value queries. Tag values are contained in parenthesis after the tag, e.g. @progress(50). Queries look like--val "done < two weeks ago", “project *= oracle” or “progress >= 50”. Wildcards allowed in value, comparators can be <, >, <=, >=, ==, *= (contains), ^= (begins with), $= (ends with). Numeric and date comparisons are detected automatically. Text comparisons are case insensitive.--valcan be used multiple times in a command and you can use--boolto specify AND, OR, or NOT (default AND)doing tagnow accepts a--valueflag to define a value for a single tag, e.g. @tag(value)
FIXED
doing last --editorerrors
2.1.12
NEW
- Tag_dir command creates/updates .doingrc files in the current directory with default_tags values. Then all entries created within that directory (or subdirs) get tagged with that value.
- Synonym triggers allow
*and?wildcards - Add
--deleteflag fordoing lastto delete last entry --deleteand--editorflags fordoing search, batch edit and delete- Example hook to add new entries containing a certain tag to Day One
- New hooks: pre_entry_add, post_entry_added, post_entry_updated, post_entry_removed, pre_export
IMPROVED
- If you need to use a colon in an autotag transform pattern, you can split with double colon, e.g. pattern::replacement
- Arrays defined in local configurations merge with main config instead of overwriting
FIXED
doing tags --interactivewasn’t showing menu
2.1.10
NEW
-
--age(oldestnewest) option for view command
2.1.9
IMPROVED
- Only attempt to install fzf if it doesn’t exist on the system. In case of errors, this means a user can manually install fzf and still be able to access
--interactiveoptions
FIXED
- Rotate command only archiving half of requested items
- Frozen string error in doing import plugin
2.1.8
NEW
- Hidden command
doing commands_acceptingwhich shows all commands that accept a given option, e.g.doing commands_accepting searchshows all commands that take a search filter - Hidden command
doing changelogwhich outputs a paginated, formatted version of the change history.
IMPROVED
- The output of
doing template --listnow shows the file type of each template - Output templates can now be saved to a default location/filename using
doing template html --save
FIXED
- Error running
doing recenton certain older ruby versions
2.1.6
NEW
doing redoundoes a redodoing undo -ioffers a list of available versions for selection- Multiple undo. Every time a command modifies the doing file, a backup is written. Running
doing undorepeatedly steps back through history,doing undo 5jumps back 5 versions - When resetting via
doing select, prompt for a date string doing resetaccepts a date string argument to use as start date instead of current time if provideddoing tagslists tags used in any/all sections, sortable, with or without frequency countsdoing show --menuoffers an interactive menu for selecting section and tag filters- All commands that accept a
--tagfilter can now handle wildcards in the tag names. * to match any number of characters, ? to match a single character. - New boolean type for tag searches, PATTERN (which is now the default). Combine tags using symbols to create more complex boolean searches, e.g. “doing +coding -work”
- You can now define
date_tagsin config, an array of tags/patterns that will be recognized when parsing for natural language dates which are converted when saving new entries --searchstrings can contain quoted phrases and use +/- to require or ban terms, e.g. `–search ‘doing +coding -writing’- Interactive option for redo command
- Plugins for Day One export
IMPROVED
- Better diff output for fzf preview of
doing undohistory - Fall back to good ol’ sed for colorizing diffs when no good tool is available
doing redo(a.k.a.doing undo --redo) can be run multiple times, stepping forward through undo history. Can also take a count to jump- Matching algorithm can be configured in settings
- All template placeholders can now use the “printf” formatting that %title and %note have, allowing for padding, prefixes, etc.
- Move default locations for doing file and backups to ~/.local/share/doing
doing show --menuwill only offer tags that exist after any tag/search filters have been rundoing show @tagwith--menuwill first filter by the @tag, then do an OR search for tags selected from the menu
FIXED
doing resetwithout filter not automatically affecting most recent entryconfig setnow preserves value type (string, array, mapping) of previous value, coercing new value if needed- Preserve colors when wrapping text to new lines
- Tag highlighting errors
- Template options specified in views were being overriden by options in templates. View config now has precedence, but will fall back to template config for missing keys
IMPROVED
- Better diff output for fzf preview of
doing undohistory - Fall back to good ol’ sed for colorizing diffs when no good tool is available
doing redo(a.k.a.doing undo --redo) can be run multiple times, stepping forward through undo history. Can also take a count to jump
FIXED
doing resetwithout filter not automatically affecting most recent entryconfig setnow preserves value type (string, array, mapping) of previous value, coercing new value if needed
2.1.3
NEW
- BREAKING CHANGE: custom classes for Section (hash) and Items (Array). @content is still a regular Hash. Sections have methods :original and :items. This will affect plugins as wwid.content[section][:items] is now wwid[section].items (same for :original)
doing config set -r key.pathwill delete a key from any config file, removing empty parent keysconfig listwill list detected .doingrc files and the main config file in order of precedence - refactoring- When modifying start dates or @done dates via an editor command, natural language strings can be used and will be parsed into doing-formatted dates automatically
- When editor is invoked, entry titles include start date, which can be modified
--before,--after, and--fromdate filters for select command--fromflag fordoing todayanddoing yesterday, filter by time range--fromflag fordoing search, filter by date/time range- Commands that accept
--before,--after, and--fromcan now filter on time ranges. If the date string given contains only a time (no day or date), it will be interpreted as a time range, meaning the date isn’t filtered, but only entries within the time range are shown/processed - Add %duration placeholder to template variables
- Add
interval_formatsetting to config (applies to root or any view/template) to set intervals/durations to human (2h 15m) or text (00:02:15) - Add
durationkey to config (root or view/template). If set to true, will display durations by default (no need for--duration) - Most display commands now have a
--durationflag that will display an elapsed time if the entry is not marked @done
IMPROVED
- Config -o raw outputs value as YAML if result is a Hash/mapping, unquoted string if a single value, comma-separated list if it’s an Array.
- Config -o json no longer includes key, only value.
- System agnostic method for checking available executables (pager, editor)
- Using
config setand selecting a local config will no longer write the entire config to the local .doingrc. Instead, a nested path to the particular setting will be added to the config file. - Config set will create missing keys. Fuzzy matching will work until the path fails, then path elements after that point will be added as verbatim keys to the specified configuration (with confirmation)
- Make menus only as tall as needed, so 5 options don’t take up the whole screen
- Better word wrap for long note lines
FIXED
finish --took 60mis supposed to backdate the start date if needed to finish at the current time and maintain an elapsed time- If an editor was specified for config (or default as fallback) with command line options (e.g.
emacs -nw), Doing would fail to recognize that the executable was available.
2.0.25
NEW
doing config setto set single config values from command line- BREAKING CHANGE: Moves ~/.doingrc to ~/.config/doing/config.yml
- BREAKING CHANGE: convert config flags to subcommands, e.g.
doing config --udpate=>doing config update, anddoing config --dump=>doing config dump
2.0.24
- include fzf source directly, in case git isn’t installed
- fall back to installing fzf with sudo on error
2.0.20
IMPROVED
- completion script generator refactor and progress bars
FIXED
- compile fzf for current operating system
2.0.19
FIXED
- Remove any coloring before writing to doing file
2.0.18
FIXED
- Escape codes being included in doing file
2.0.17
IMPROVED
- Improvements to %title formatting and wrapping
2.0.16
- Test release to validate git flow automation
2.0.13
FIXED
- Remove amatch gem dependency due to compatibility issues with Windows systems (also removes
--fuzzyoption from all search commands)
2.0.11
NEW
- Append
/rto tag transforms to replace original tag
FIXED
- Autotag tag transform fixes
2.0.10
NEW
- Add ‘timer_format’ config with ‘human’ option for tag totals
- If
doing viewanddoing showare confused, offer option to run the other command doing completionto generate shell completion scripts for zsh, bash, and fish--searchand--notfor cancel command--caseflag for commands with--search. Can be (c)ase-sensitive, (i)nsensitive, or (s)mart (default smart, case insensitive unless search string contains uppercase letters)- Add
--exactflag to all commands with--searchflag to force exact matching without requiring single quote prefix - Add
--notflag to all commands with filters (--tag,--search,--before, etc.) to negate the filter and return entries NOT matched
IMPROVED
- More command line feedback
- Error formatting and output
- Add subcommand completion for
doing helpin fish shell - Logging and error handling
FIXED
- Zsh completion not outputting results
- Remove
--[no]from non-negatable options doing plugins -t export -cnot outputting columns- View config not respecting tag_order setting
2.0.3.pre
NEW
- Import calendar events from Calendar.app on macOS
doing config --updatewill add newly added config keys to your existing config file (handy with plugins that define their own config keys)- Add %idnote template placeholder for “indented note” (entire note indented one tab)
- (loosely printf-esque) formatting options for
%notetemplate placeholder --interactivemode to act on results ofdoing grep- Printf formatting for title and date
- Doing import plugin
- Plugins command to list plugins
--dumpoption fordoing configto output a key.path config key as JSON, YAML, or raw output--no-colorglobal flag- Log levels, with
--quietand--verboseglobal flags - Convert CLI messaging to Logger-based system
- Use DOING_DEBUG, DOING_QUIET, or DOING_LOG_LEVEL environment variables to specify log levels before configuration is read
- Hooks, register plugins to run based on events
- –[no-]pager and paginate: config option to enable paging output
- Never_finish and never_time config options to prevent items matching tags/sections from ever receiving @done (never_finish) or @done timestamp (never_time) - More configuration refactoring
IMPROVED
- Timeline output formatting
- Major plugin architecture refactoring
- Fix regression where notes stored in doing file were outdented, breaking TaskPaper compatibility
- When accepting a date filter, allow end date to be in the future
- If an edited item has no changes, don’t update/output notification - Don’t start with query when using grep
--interactive - Select menu item formatting
- Output wrapping for terminal display
- Redirect warn to STDOUT when run with
--stdout - Fish autocomplete
--config_fileglobal flag deprected, now uses $DOING_CONFIG environment variable so that config overrides can be available before the initial configuration is run- When
--stdoutor not a TTY, no color or output formatting - Highlight tags when showing results. Because it looks nice.
--tagand--searchfordoing note- View/section fuzzy guessing
- Error reporting
- If
doing configfinds local doingrc files, offers a menu for editing - More filtering options for
doing finish - Doing done accepts
--unfinishedflag to finish last entry not marked @done (instead of last entry) - Doing done accepts
--noteflag to append a note when completing an entry
FIXED
- Multi-word unquoted arguments to add_section being truncated
- Show
--fromwith date span - Handling of arbitrary times in natural language dates
- Backward scope of since command with arbitrary times
doing rotate --keepwasn’t respecting keep value
1.0.93
FIXED
- Gemfile error
1.0.91
NEW
- “taskpaper” format available for all output options
- “markdown” format available for all output commands (GFM-style task list, customizable template)
--renameoption for tag command to replace tags--regexoption for tag command, for--removeand--rename
1.0.90
IMPROVED
- doing finish
--autonow pulls from all sections, not just the section of the target entry
FIXED
- Minor fix for shell command in doing select
- Fix for doing finish
--autowhen matched item is last in list
1.0.89
NEW
- Pretty print JSON output
--no-menuoption for select command to use--queryas a filter and act on matching entries without displaying menu
1.0.88
IMPROVED
- Add
--beforeand--aftertime search to yesterday command - Add
--beforeand--afterdate search to search/grep command - Add
--tag_orderto yesterday command
1.0.87
IMPROVED
- Add leading spaces to make %shortdate align properly, at least for the last week
- Add
--tag,--bool, and--searchto view command - Add
--beforeand--afterdate search to view command - Add
--beforeand--afterdate search to show command - Add
--beforeand--aftertime search to today command - Add
--searchfilter to show command - More alignment/formatting fixes for %shortdate
1.0.86
IMPROVED
- Add
countconfig option for templates->recent
1.0.85
IMPROVED
- Add
--beforeDATE_STRING to archive and rotate commands - Only create on rotate file per day, merge new entries into existing file
FIXED
- Fix
--autofor finish command
1.0.84
NEW
rotatecommand for archiving entries to new file
FIXED
- Fixed current_section config key not being honored in some commands
1.0.83
FIXED
- Fixes for
doing viewoptions, additional config keys for views
1.0.82
FIXED
- Bugfixes
1.0.81
IMPROVED
- fzf menu improvements
- allow multiple selections
doing selectaction menu
1.0.80
IMPROVED
- Convert all menus to fzf screens
1.0.79
IMPROVED
- Wildcard tag removal using
doing select -t "tag*" -r - fzf menu display polish
FIXED
FIXED
- Gem missing fzf
1.0.78
IMPROVED
- If no action is specified with select command, an interactive menu is presented
- add output action select command with formatting and save options
- Don’t link URLs in html output that don’t have a protocol
1.0.76
IMPROVED
- Refine editing multiple selections (doing select)
1.0.74
NEW
- Add
--tagand--searchflags to tag command to tag all entries matching search terms - Add since command, which is the same as
doing on tuesday to nowbutdoing since tuesdayjust feels more intuitive.
1.0.73
FIXED
- Fix for timeline output
1.0.72
NEW
- Add
doing selectto show menu of all tasks, searchable with fuzzy matching and the ability to perform certain tasks on multiple selections.
1.0.71
FIXED
- Fix for template command not working at all
1.0.70
FIXED
- Fix for
doing done --took 30msetting the wrong @done timestamp when completing previous item
1.0.69
IMPROVED
- Add
--unfinishedoption to finish and cancel commands
1.0.68
FIXED
- Fix error in
doing show --sortargument parsing
1.0.67
FIXED
- Gem packaging error
1.0.66
IMPROVED
- More flexible boolean specification, can be: all, and, any, or, not, or none
FIXED
- Fix for some long flags being interpreted as arrays instead of strings
- Fix for archive command not removing original entries from archived section
1.0.65
IMPROVED
- Prevent duplicates/overlapping entries when importing
1.0.64
NEW
- Initial import feature for Timing.app reports
1.0.63
IMPROVED
- If
doing done --took=Xresults in completion date greater than current time, use current time as completion date and backdate the entry’s timestamp to fit
1.0.62
FIXED
doing donewith--took=and without--back=should set end time to start date plus--tookvalue
1.0.61
IMPROVED
- Add
--searchfilter todoing archive
1.0.60
FIXED
- Default value for
doing again --boolwas ALL, should be AND
1.0.59
IMPROVED
- Improvements to
doing again --tag=functionality
1.0.58
IMPROVED
- Finish previous task if
doing againand not already completed
1.0.57
IMPROVED
- Unit tests
1.0.56
IMPROVED
- Tag command tests
FIXED
- Doing not reading per-directory .doingrc configs
1.0.55
NEW
- Added config_editor_app setting to config so you can have
- A parenthetical at the end of an entry title becomes an attached
--editorflag fordoing lastto edit last entry--tag=flag to filterdoing lastby tag--search=to filterdoing lastby text/regex search--search=fordoing finish, finish last X entries matching search- Add
tags_coloras a primary config key to highlight @tags in displayed entries
IMPROVED
- Clean up command line help
--editorimprovements for all commands that use it
FIXED
- Doing finish
--tookthrowing error - Doing tag
--removewas adding tags if they didn’t exist - Creating a meanwhile task with a note resulted in an error
1.0.54
FIXED
- Bugfix for
finish --tag=TAG
1.0.53
NEW
--tagand--boolfiltering for again/resume, cancel--inflag foragain/resumeto specify to which section the new- Finish command accepts
--tag=flag, finishing last entry doing cancelto end X tasks without completion date
IMPROVED
- Add
--no-coloroption to view command - Add
--tagto show for compatibility
FIXED
- Error running finish without
--tagflag --archiveflag on finish, done, and cancel causing error
1.0.52
NEW
- Finish command accepts
--tag=flag, finishing last entry
FIXED
--archiveflag on finish, done, and cancel causing error
1.0.49
FIXED
- Fix for missing date on @done tags
1.0.48
FIXED
- Fix confirmation dialog for
doing tag -a -c 0(autotag all)
1.0.47
IMPROVED
- Remove check for file existence before attempting to run run_after script
- Don’t autotag entries restarted with
again/resume - Add short flags (
-b) for--backon all commands that support it
1.0.46
IMPROVED
- Code cleanup
1.0.45
IMPROVED
- Only execute run_after script if changes are written
1.0.44
IMPROVED
- Remove unnecessary console logging
1.0.43
NEW
- Add
againcommand to repeat last entry without @done tag - Add
run_afterconfiguration option to execute external script after any change
1.0.42
FIXED
- Fix note indentation in doing file
1.0.41
FIXED
- Fix for repeated backreferences in tag transform
1.0.40
IMPROVED
- Add
--tag_sortto all subcommands with--totalsoption
1.0.39
NEW
- Tag transforms
- Option to sort tags by name in
--totals
1.0.33
FIXED
- Gem dependency updates
1.0.30
FIXED
- Fix for array comparison error
1.0.29
FIXED
- Bugfixes
1.0.28
IMPROVED
- Global option
-xto skip autotags and default_tags from global/local .doingrc - Remove extra spaces when creating entry
1.0.27
IMPROVED
- More graceful writing of default config (~/.doingrc) on first run
- Repaired testing setup. Needs moar tests.
1.0.26
IMPROVED
- Add
--atflag fordoing done, e.g.doing done --at=1:35pm --took=15m A new task I already finished - Allow decimal quantities when using natural language for hours or days, e.g.
--took=2.5h - Add
didas a synonym fordonesubcommand
1.0.25
IMPROVED
IMPROVED
- Smarter method of getting user $HOME
- Improved avoiding duplicate tags when autotagging
- Improved autotag reporting
1.0.24
IMPROVED
doing noteoperates on whatever is most recent, not just the last note in Currentlydoing tagwith no count specified operates on most recent entry in any section, not just Currentlydoing tagwith a count greater than 1 requires a section to be specified- Improved results reporting for
doing tag - When removing tag do a whole-word match to avoid removing part of a longer tag
1.0.23
IMPROVED
- Apply default_tags after autotagging to avoid tags triggering tags
- Set
doing recentto default to All sections instead of Currently - Fix error in time reporting
- improved y/n prompt for TTY
1.0.22
IMPROVED
- Allow cascading of local config files
- Allow
doing todayandyesterdayto specify a section
FIXED
- Fix handling of “local” config files, allowing per-project configurations
1.0.21
NEW
- Add legitimate regex search capabilities
- Synonyms for grep (search) and now (next)
FIXED
- CSS fix
1.0.20
NEW
- New command
doing templatesto export default templates for HAML and CSS - New config options under
html_templateforhamlandcss
IMPROVED
- Rewrite HTML export templates with responsive layout and typography
- Ability to customize the HTML output using HAML and CSS
1.0.19
IMPROVED
- For
doing note -einclude the entry title so you know what you’re adding a note to - For any other command that allows
-einclude a comment noting that anything after the first line creates a note - Ignore # comments when parsing editor results
- Add a .md extension to the temp file passed to the editor so you can take advantage of any syntax highlighting and other features in your editor
1.0.18
IMPROVED
- Loosened up the template color resetting a bit more
FIXED
- Fix
undefined method [] for nil classerror indoing view
1.0.17
NEW
- Add
--stdoutglobal option to send reporting to STDOUT instead of STDERR (for use with LaunchBar et al)
1.0.16
FIXED
- Fixes overzealous color resetting
1.0.15
FIXED
- CLI/text totals block was outputting when HTML output was selected
- Have all template colors reset bold and background automatically when called
1.0.14
IMPROVED
- Fish completion
- views and sections subcommands have -c option to output single column
- Fix html title when tag_bool is NONE
- Fix @from tagging missing closing paren
- Fix tag coloring
1.0.13
FIXED
- Fix gsub error in doing meanwhile
1.0.8pre
NEW
- added doing on command
- Added autotagging to tag command
- JSON output option to view commands
- date filtering, improved date language
- let view templates define output format (csv, json, html, template)
IMPROVED
- add
%chompnotetemplate variable (item note with newlines and extra whitespace stripped)
1.0.7pre
IMPROVED
- Slightly fuzzier searching in the grep command
- cleaner exits,
only_timedkey for view configs - making the note command append new notes better, and load existing notes in the editor if
-eis called - handle multiple tag input in
showtag filter - Global tag operations, better reporting
FIXED
- fix for
-voption
1.0.4pre
IMPROVED
- Improved HTML output
--only_timedoption for view/show commands that only outputs items with elapsed timers (interval between start and done dates)- add seconds for timed items in CSV output, run
--only_timedbefore chopping off--count # - fix for 1.8.7
Dir.homeissue - version bump
- don’t show tag totals with zero times
- zsh completion for doing
- HTML styling
--only_timedoption- added zsh completion file to
README.md - add zsh completion file
1.0.3pre
IMPROVED
donecommand: making--tookmodify start time if--backisn’t specified- Cleaned up time totals, improved HTML output
- fixes for
--backand--tookparsing - Adding more complete terminal reporting to archive command
1.0.0pre
IMPROVED
- Skipped ahead in the version numbering. Because I don’t care.
- Added a
notecommand and--noteflags for entry creation commands
0.2.6pre
IMPROVED
--totals,--[no-]times,--output [csv,html]options foryesterdaycommand.- Add tests for Darwin to hide OS X-only features on other systems
-fflag tonowcommand for finishing last task when starting a new one (Looks back for the last unfinished task in the list)--tookoption fordoneandfinishfor specifying intervals from the start date for the completion date- Basic command line reporting
--autoflag forfinishanddonethat will automatically set the completion time to 1 minute before the next start time in the list. You can use it retroactively to add times to sequential todos.doing grepfor searching by text or regex
0.2.5
IMPROVED
- Default to showing times #26, show totals even if no tags exist #27, fix indentation #29
- Add section label to archived tasks automatically, excepting
Currentlysection - Today outputs and backdate for finish
- HTML styling and fix for 1.8.7 HAML errors
- Look, HTML output! (
--output html) - Also,
--output csv - let doing
archivefunction on all sections - option to exclude date from @done,
- output newlines in sections and views
- Flagging (
doing mark) - fix for view/section guess error
- Adding tag filtering to archive command (
doing archive \@done) doing yesterdaydoing done -rto remove last doing tag (optionally from-s Section)- Add
-fflag to specify alternate doing file meanwhilecommand
0.2.1
IMPROVED
- CSV output for show command (
--csv) - HTML output for show command (
--output html) - fuzzy searching for all commands that specify a view.
- In the terminal, you’ll see “Assume you meant XXX” to show what match it found, but this is output to STDERR (and won’t show up if you’re redirecting the output or using it in GeekTool, etc.)
tags_colorin view config to highlight tags at the end of the lines. Can be set to any of the%colors.- Basic time tracking.
-tonshowandviewwill turn on time calculations- Intervals between timestamps and dated @done tags are calculated for each line, if the tag exists.
- You must include a
%intervaltoken in the appropriate template for it to show - @start(date) tags can optionally be used to override the timestamp in the calculation
- Any other tags in the line have that line’s total added to them
- Totals for tags can be displayed at the end of output with
--totals
0.2.0
IMPROVED
doing donewithout argument tags last entry done-aarchives themdoing finishordoing finish Xmarks last X entries done-aarchives themdoing tag tag1 [tag2]tags last entry or-c Xentriesdoing tag -r tag1 [tag2]removes said tag(s)- custom views additions
- custom views can include
tagsandtags_bool tagsis a space-separated list of tags to filter the results bytags_booldefinesAND(all tags must exist),OR(any tag exists), orNONE(none of the tags exist)orderkey (ascordesc) defines output sort order by date- section key can be set to
Allto combine sections doing showupdates- accepts
allas a section - arguments following section name are tags to filter by
-bsets boolean (AND,OR,NONE) or (ALL,ANY,NONE) (defaultOR/ANY)- use
-c Xto limit results - use
-sto set sort order (ascordesc) - use
-ato set age (newestoroldest) - fuzzy section guessing when specified section isn’t found
- fuzzy view guessing for
doing viewcommand
0.1.9
IMPROVED
- colors in templated output
opencommand- opens in the default app for file type
-a APPNAME(doing open -a TaskPaper)-b bundle_id(doing open -b com.sublimetext.3)-eswitch fornow,lateranddonecommands- save a tmp file and open it in an editor
- allows multi-line entries, anything after first line is considered a note
- assumed when no input is provided (
doing now) doing viewsshows all available custom viewsdoing viewwithout a view name will let you choose a view from a menudoing archivefixed so that-k Xworks to keepXnumber of entries in the section
0.1.7
IMPROVED
- colors in templated output
opencommand- opens in the default app for file type
-a APPNAME(doing open -a TaskPaper)-b bundle_id(doing open -b com.sublimetext.3)-eswitch fornow,later, anddonecommands- save a tmp file and open it in an editor
- allows multi-line entries, anything after first line is considered a note
- assumed when no input is provided (
doing now)
Speaking of doing…
- Doing with multiple sections
- Brett's Favorites 2022 - Personal Projects
- He's Doing it again...
- Doing 2.0
- See what you're "doing" in the iTerm status bar
- Let's get crazy with BetterTouchTool and Touch Bar Simulator
- Doing (more) with more tags
- Scatterbrained: Revisiting the "doing" CLI
- Web Excursions for November 17, 2014
- Thinking in the shell
- doing 0.2.5
- Logging Git commits with doing
- doing gone wild
- A couple of followups to "doing"
- Scatterbrains 3: a new tool for doing
- Scatterbrains 2: The geekening
- A solution for scatterbrains