Skip to content
Ruby library (including command line client) for interacting with
Pull request Compare This branch is 27 commits behind wsargent:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


= toodledo



This is a Ruby API and client for, a task management 
website. It implements all of the calls from Toodledo's developer API, and 
provides a nice wrapper around the functionality.

The client allows you to work with Toodledo from the command line. It will
work in either interactive or command line mode.

You can also use the client in your shell scripts, or use the API directly
as part of a web application.  Custom private RSS feed?  Want to have the Mac 
read out your top priority?  Input tasks through Quicksilver?  Print out
tasks with a BetaBrite?  It can all happen.


* Command line client interface
* Interactive client interface
* Fully featured session based API
* Supports Proxy and SSL usage
* Easy configuration and automation (Quicksilver / Scripts / Automator)


=== SETUP:

The first thing you should do is open up your browser and go to:

and retrieve your userid.  You will need this for setup.

Build the gem. 'gem build toodledo.gemspec'

Then, install toodledo.  This is either 'gem install toodledo-1.3.6.gem' or 
'sudo gem install toodledo-1.3.6.gem' depending on your platform.

Then, type 'toodledo setup' and enter your userid and password in
the spaces provided.  Then save the file, and you're good to go.

You can add tasks.  The simplest form is here:

  toodledo add 'This is a test'
But tasks don't have to be simple.  Toodledo has a particularly rich model of 
a task, and allows full GTD type state to be attached to them.  The syntax 
for the client is as follows:


You can encase the symbol with square brackets if there is a space involved:

  *[Blue Sky]
  @[Someday / Maybe]
  ^[Write Toodledo Ruby API]
  %[foo bar]

You can only provide one folder, context, goal, priority, or date, but you can
provide multiple tags, using the syntax shown above (i.e. foo and bar are two 
separate tags).
Let's use the command line client to list only the tasks you have in the office:

  toodledo tasks '@Office *Action'

Now let's add a task with several symbols:

  toodledo add '*Action @Programming ^[Write Toodledo Ruby API] Write docs'

Now let's add a different task with a date and tags:

  toodledo add Write more docs #Today %for_my_boss

You can also edit tasks, using the task id.  This sets the folder to Someday:

  toodledo edit '*Someday 15934131'

And finally you can complete or delete tasks, again using the task id.

  toodledo complete 15934131
  toodledo delete 15934131


Toodledo also comes with an interactive mode that is used if no arguments are 

  > add This is a test
You can type help at the prompt for a complete list of commands.  The client 
makes for a nice way to enter in tasks as you think of them.

The client will also allow you to set up filters.  Filters are added with
the symbols, so in interactive mode

  filter @Office *Action

Then it produces the same results as:

  toodledo tasks '@Office *Action'

Finally, if you want to write your own scripts, working with Toodledo is very
simple, since it will use the YAML config file:

  require 'rubygems'
  require 'toodledo'
  Toodledo.begin do |session|
    # work with session

If you want to work with the session directly, then you should do
this instead:

  require 'rubygems'
  require 'toodledo'
  session =, password)


* A connection to the Internet
* An account to
* Your Toodledo userid (see
* cmdparse
* highline
* rubygems


* sudo gem install toodledo
* toodledo setup (sets up the YAML file with your credentials)
* toodledo

		   GPL v3
Something went wrong with that request. Please try again.