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:
- Apple Mail
- Apple Calendar
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
with-keyword is ommitted it will default to all usable sources.
To specify a start date, use either
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:
- last night
- last winter
- 3rd wednesday in november
- may seventh '97 at three in the morning
To specify an end date, use one of
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.
--format flag to indicate the desired output format:
waddup since yesterday --format json