trello

A CLI app for interacting with Trello.

I personally find Trello's UI offerings to be too taxing on my computer and the many things it loads in an attempt to look nice make it a bit jumpy and sluggish. I spend a ton of my day on the command line and wanted an interface with Trello in that environment.

Add to that my long-time fascination with ncurses apps and a desire to learn Crystal and the result is this project.

Installation

1. Install it through homebrew! If you don't have homebrew, you'll have to compile it yourself for now. See Development below for instructions. Otherwise, run

   brew install geolessel/homebrew-repo/trello-cli
   

2. Get an API token from Trello

3. Create a .trello-cli directory in your $HOME directory (like /Users/geolessel)

   mkdir ~/.trello-cli
   

4. Create a ~/.trello-cli/secrets.json file in and add keys and values for key (your Trello API key), token (your Trello API token), and memberId (your Trello member id).

   {
     "token": "YOUR TRELLO TOKEN",
     "memberId": "YOUR MEMBER ID"
   }
   

   You can get your member id by visiting this URL: https://api.trello.com/1/members/me?key=3020057fffe933d81fe081eb4f8d126a&token={YOUR_TOKEN}

   This will return JSON and inside of that, you can find your "id".

Usage

1. Run it!

   trello
   

Development

For now, you need to build it yourself and you must have the Crystal language installed. You can

1. Clone this repo

   git clone https://github.com/geolessel/trello-cli.git
   

2. Install the Crystal Shards (in the trello-cli directory)

   shards install
   

3. Run the app (in the trello-cli directory)

   crystal run src/trello.cr
   

Contributing

1. Fork it (https://github.com/geolessel/trello/fork)
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create a new Pull Request

Contributors

• geolessel Geoffrey Lessel - creator, maintainer