Gem Version Build Status Dependency Status Code Climate Coverage Status

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: 1.9.3 or higher

Licensed under the MIT license, see LICENSE for more information.



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 until yesterday 23:00

Waddup is fairly liberal in what it accepts. The keywords described below may be mixed or ommitted 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 ommitted it will default to all usable sources.

Start date

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 ommitted. 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

End date

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 ommitted.


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