doing

A basic CLI for adding and listing "what was I doing" reminders in a text file. Allows for multiple sections and flexible output formatting.

The format of the "WWID" file is TaskPaper-compatible. You can edit it by hand at any time, but it uses a specific format for parsing, so be careful. By default the file is created in "~/what_was_i_doing.md", but this can be modified in the config file.

The config file is stored in "~/.doingrc", and is created on the first run. It contains, among other things, templates for various command outputs. Include placeholders by placing a % before the keyword. The available placeholders are:

  • %title: the "wwid" entry line
  • %date: the date based on the templates "date_format" setting
  • %shortdate: a custom date formatter that removes the day/month/year from the entry if they match the current day/month/year
  • %note: Any note in the entry will be included here, a newline and tabs are automatically added.
  • %odnote: The notes with a leading tab removed (outdented note)
  • %hr: a horizontal rule (-) the width of the terminal
  • %hr_under: a horizontal rule (_) the width of the terminal
  • %[color]: color can be black, green, blue, yellow, magenta, cyan or white
    • you can prefix "bg" to affect background colors (%bgyellow)
    • prefix "bold" and "boldbg" for strong colors (%boldgreen, %boldbgblue)

Date formats are based on Ruby strftime formatting.

Usage:

doing [global options] command [command options] [arguments...]

Global options:

--help              - Show this message
--[no-]notes        - Output notes if included in the template (default: enabled)
--version           - Display the program version

Commands:

archive  - Archive all but the most recent 5 entries
choose   - Select a section to display
config   - Edit the default configuration
done     - Add an entry tagged with @done(YYYY-mm-dd hh:mm)
help     - Shows a list of commands or help for one command
last     - Show the last entry
later    - Add an item to the Later section
now      - Add an entry
recent   - List recent entries
sections - List sections
show     - List all entries
today    - List entries from today