= 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