Skip to content
Finishes a Trello card.
Find file
New pull request
Fetching latest commit...
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Trellish is used to start and finish a Trello card. It does everything necessary to move a development card from "Next up" to "In Progress" when you start work on a card and again from "In Progress" to "QA" when you finish a card.


Add this line to your application's Gemfile:

gem 'trellish'

And then execute:

$ bundle

Or install it yourself as:

$ gem install trellish


Create a ./trellish.yml, ~/trellish.yml or ~/.trellish file with the contents of trellish.example.yml. Set it up like this:

  1. Sign in to Trello and go to
  2. Copy "Key" from that page to trello_api_key.
  3. Copy "Secret (for OAuth signing)" from that page to trello_oauth_secret.
  4. Visit\_API\_KEY\_FROM\_ABOVE&name=Trellish&expiration=never&response_type=token&scope=read,write
  5. Copy the token to trello_oauth_token.
  6. Run: curl -u 'username' -d '{"scopes":["repo"],"note":"Trellish"}'
  7. Copy the token parameter from the response to github_oauth_token.

Optionally, Trellish can announce the starting and finishing of cards on 37signal's Campfire. To enable this:

  1. Sign in to Campfire and go to your "my info" page. You can find the link in the upper-right corner.
  2. Copy your subdomain name to campfire_subdomain.
  3. Copy your API authentication token to campfire_token.
  4. Specify the room name in campfire_room.


By default, Trellish expects a Trello board named Current with 3 lists: Next up, In progress, and QA. You can change these defaults using the Trellish config file.

To start work on a card:

trellish start [Trello card id or URL]

This will:

  • move the card from Next up to In progress,
  • add you as a member,
  • create a local git branch named using your git initials and the card's title.

If you don't provide a card id or URL on the command line, trellish shows you the cards in Next up and prompts you to select one, like so:

Select a card:
1. BUG: crash adding a comment
2. users can select an avatar
3. add iPad integration tests

When you're done working on a card, finish it using:

trellish finish [Trello card id or URL]


trellish finish
trellish finish a3Wbcde4
trellish finish

This will:

  • create a pull request to merge your topic branch into master (with a description linking back to the card)
  • add a link to the pull request from the card's description
  • remove everyone from the card
  • move the card to the QA list

Certificate issues

If you're stuck with an error along the lines of

SSL_connect returned=1 errno=0 state=SSLv3 read server certificate B: certificate verify failed

try updating your root certificates. If you use RVM, this may work:

curl -o ~/.rvm/usr/ssl/cert.pem


  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Added some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request
Something went wrong with that request. Please try again.