General
Mac Desktop Application
Recommended for most users. The Mac desktop application is the simplest way to add entries to TimeStream.
Developers
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.
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.
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*
GeekTool
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.
Quicksilver
Quicksilver is one of those tools we can't live without. If you're a hardcore QS user, you'll appreciate our TimeStream plugin.
LaunchBar
All the cool kids are using LaunchBar these days. If you're one of them, check out the TimeStream plugin for LaunchBar.
TextExpander
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.
SizeUp
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.
