https://github.com/aaronc81/td
Minimalistic, single-list Trello CLI for organising your day
https://github.com/aaronc81/td
Last synced: 6 months ago
JSON representation
Minimalistic, single-list Trello CLI for organising your day
- Host: GitHub
- URL: https://github.com/aaronc81/td
- Owner: AaronC81
- Created: 2019-12-30T14:50:40.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2023-01-20T21:42:19.000Z (almost 3 years ago)
- Last Synced: 2025-07-21T12:52:54.780Z (6 months ago)
- Language: Ruby
- Homepage:
- Size: 63.5 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# td
td (for "today") is a minimal to do list which integrates with Trello. Select a
list and a "done" label from your Trello board, then interact with that list
from your command line.
## Installation
To invoke td, create a script somewhere in your PATH which runs the Ruby
interpreter on `src/td.rb`, passing any arguments. I use:
```bash
#!/bin/bash
ruby /src/td.rb $@
```
You'll also need to create a configuration file in `~/.config/td` with the
following format:
```json
{
"key": "",
"token": "",
"todayList": "",
"doneLabel": ""
}
```
You can get the key or token [here](https://trello.com/app-key/), and the list
and label IDs by poking the Trello API. I'll add an easier way to do this setup
in future!
## Usage
- `td` prints an overview of your list.
- `td done n` and `td not n` mark item number `n` as done or not done
respectively, by adding or removing your "done" label.
- `td count` prints a summary of how many tasks you have and how many are done,
perfect for putting in a widget or for when you launch your shell.