TimeStream

Response Formats

All URLs that output your TimeStream data respond to the following extensions:

• .csv
• .html
• .json
• .pdf
• .rss
• .txt
• .xml

Just add the extension to any TimeStream URL in your browser to see examples or use cURL if you want to use the API. Below are some examples.

Get current task

Here's an example of how to use cURL to get your current task.

This is an example to get the amount of time spent on the current task.

Here's how to get the current task and time together.

And this is how to get the time first, then the task.

See it in action (2:16)

Download bash script

Add a task

Here's an example of how to use cURL to POST a new task.

Please note that you MUST include a valid "source" when you are posting a new task via the API. The following are valid sources you can use:

• android
• bash
• ipad
• iphone
• launchbar
• linux_client
• mac_client
• quicksilver
• terminal
• web
• windows_client

See it in action (2:16)

Download bash script

List tasks

Getting a list of tasks is pretty easy. You can retrieve today's list, a specific date or search results. Output formats can be: CSV, HTML, JSON, PDF, RSS, TXT and XML. Here are some examples.

How to get today's tasks:

How to get tasks for a specific date:

And how to get search results:

See it in action (2:16)

Download bash script

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:

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

See it in action (2:22)

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.

See it in action (2:16)

Download bash script