Skip to content
Pippi is a command line tool for entering your time into
Find file
Latest commit 3008259 Jul 28, 2012 @sirkitree inrement version
Failed to load latest commit information.
lib Removing colors as a requirement Jul 28, 2012
.gitignore Adding gitignore Jul 22, 2012
config.json Adding configurables. Jul 20, 2012
package.json inrement version Jul 28, 2012 add -g option for npm install Jul 28, 2012


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