Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Pippi is a command line tool for entering your time into
Branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.


'Cuz Pippi has freckles.

Basic command line tool for logging hours in Freckle. Uses the excellent freckle api bindings from the Node.js library created by Tim Branyan @tbranyen.


You can install this by installing node and npm and then running:

npm install pippi -g

Pip reads from a config file, so you'll want to create a ~/.freckle file with the following information and then modify each variable to your specific information.

    "subdomain": "",
    "token": "lx3gi6pxdjtjn57afp8c2bv1me7g89j",
    "user": ""

Note: your API token can be found by logging into Freckle, clicking on 'settings & tools', and then the API tab.

You'll want to run pippi list at least once to make sure you're connected properly, and to get a list of all projects which will be saved and used for project id lookups.


Usage: pippi [command] [options]

list            List projects associated with your subdomain. This will give
                you a list of project names and their IDs which you need for
                logging your entries.
                  ex: pippi list

log             Log time entries using various options.
                  ex: pippi log -p 101814 -m "quick update" -t 15m

-h, --help      Display this help page.
                  ex: pippi -h

-t, --time      Time entry in freckle specified format.
                  ex: pippi -t 15m
                  ex: pippi -t 1.5h

-p, --project   The project ID.
                  ex: pippi -p 101814

-m, --message   Post a message to yammer
                  ex: pippi -m "I'm working on pippi"
                  ex: pippi -m "tag, tag, tag"

-d, --date      Optional date formated in YYYY-MM-DD. Defaults to today.
                  ex: pippi -d 2012-07-20

-u, --user      Optional user to log time for. Defaults to user in config.json.
                  ex: pippi -u


  • I'd like to have tab completion for project names and tags.
Something went wrong with that request. Please try again.