Waddup

Waddup is a Ruby gem that retraces your activities from arbitrary sources - such as version control, issue tracking software and mail clients - and displays them in a neat chronological overview.

Perfect for those who have lost track of what they have worked on.

Supported Ruby versions: 2.2 or higher

Licensed under the MIT license.

Waddup is available from RubyGems and can be installed through the command-line.

Fire up your favourite terminal and run:

gem install waddup

Installing on OSX and using the default system Ruby? Run:

sudo gem install waddup

Once installed, use the command waddup or its alias sup as follows:

waddup with git and mail since last week through yesterday 23:00

Waddup is fairly liberal in what it accepts. The keywords described below may be mixed or omitted as desired.

At present, Waddup ships with three sources:

• Git git
• Apple Mail mail
• Apple Calendar ical

To specify one or multiple sources, use the with-keyword forming a regular sentence with the listed aliases:

waddup with git

waddup with git, mail and ical

When the with-keyword is omitted it will default to all usable sources.

To specify a start date, use either from or since as a keyword:

waddup from october 29, 2013 9:00 AM

waddup since last friday

Defaults to right now if a start date is omitted. This default is likely to change in the future.

Dates/times are liberally parsed using Chronic. A grasp of crazy inputs one can use:

• yesterday
• last night
• last winter
• 3rd wednesday in november
• may seventh '97 at three in the morning

To specify an end date, use one of to, until, uptil, upto or through:

waddup upto one week ago

waddup through yesterday

Defaults to right now if an end date is omitted.

At present, Waddup supports two formats: visual (see screenshot) and JSON.

Use the --format flag to indicate the desired output format:

waddup since yesterday --format json