Mac Desktop Application

Recommended for most users. The Mac desktop application is the simplest way to add entries to TimeStream.


Command Line Usage

The API is pretty simple. You can add new tasks (via a cURL POST) from the terminal using a simple bash wrapper. You can also retrieve your current task and time via a cURL GET method. Below is a link to some simple bash scripts to help with automated Git/SVN commit messages.

# POST a new task
# Response can be JSON, TXT or XML depending on your request
# Sample response: Success: New task successfully added.
curl -d "password=yourpassword" -d "task=This is some task" -d "source=bash"
# GET the current task
# Response can be JSON, TXT or XML depending on your request
# Sample response: This is my awesome task
curl -G -d "password=yourpassword"
# GET the current task time
# Response is only TXT
# Sample response: 00:02:31
curl -G -d "password=yourpassword"

Ruby Gem

The easiest way to interact with TimeStream from the command line is to simply use the Ruby gem. You can install it with:

gem install timestreamapp

Check out the documentation on GitHub or watch the screencast below.

Bash Wrappers

Below is a link to some helpful bash wrapper functions to make it easier to include your current task in your commit messages.

Third-Party Applications*


We highly recommend using GeekTool (and it's Windows/Linux analogs) for displaying your current task on your desktop. This is a gentle reminder to show what you are working on (or should be working on). It's a very cool piece of software and it's free! Below is the line of code you would use with GeekTool to show your current task.

curl -G -d "password=yourpassword"


Quicksilver is one of those tools we can't live without. If you're a hardcore QS user, you'll appreciate our TimeStream plugin.


All the cool kids are using LaunchBar these days. If you're one of them, check out the TimeStream plugin for LaunchBar.


TextExpander (and it's ilk) are great timesavers. Below is a quick tutorial on how to set up a TextExpander alias to dynamically paste your current task anywhere.

do shellscript curl -G -d "password=yourpassword"


SizeUp is a really nice tool to help you organize your desktop windows. It works really well with GeekTool.

* We're not affiliated with any of the software mentioned above; we're just fans and they help you be productive and organized.