Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Waddup retraces your activities from arbitrary sources - such as version control, issue tracking software and mail clients - and displays them in a neat chronological overview
Ruby AppleScript
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
bin
lib
spec
.gitignore
.rspec
.travis.yml
CHANGELOG.md
Gemfile
Guardfile
LICENSE.md
README.md
Rakefile
waddup.gemspec

README.md

Waddup

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

Installation

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

Usage

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.

Sources

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.

Formats

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
Something went wrong with that request. Please try again.