Switch branches/tags
Nothing to show
Find file
Fetching contributors…
Cannot retrieve contributors at this time
50 lines (31 sloc) 1.5 KB

things-client is a ruby-base client for API of the popular GTD app Things, available on the Mac.


To use things-client you need Things which is version 1.2.0 or greater.


The gem is hosted on Gemcutter. To install it, use the following command:

sudo gem install things-client --source

To get the latest version, clone the gem from github and run rake install:

git clone
cd things-client
rake check_dependencies:runtime
sudo rake install


Before using this gem you must require it by calling:

require 'things'

From then on you can manipulate Todos, Projects, Areas, Tags, People and Lists, like this:

todo = Things::Todo.create(:name => 'Take out the garbage') = 'Take out the garbage and old boxes'

For more information, see the wiki at


You’re more than welcome to fork and improve this gem. Usual rules:

  • Fork the project.
  • Make your feature addition or bug fix.
  • Add tests for it. This is important so I don’t break it in a
    future version unintentionally.
  • Commit, do not mess with rakefile, version, or history.
    (if you want to have your own version, that is fine but
    bump version in a commit by itself I can ignore when I pull)
  • Send me a pull request.


Copyright © 2010 Marcin Bunsch. See LICENSE for details.