An unofficial Todoist API CLI client written in Rust.
This is an unofficial Todoist CLI that focuses on being easy to use. It is currently not feature complete, but covers some basic common use-cases and adds more as we go along.
Currently it's installed only via cargo install from source:
bash
cargo install doist
More options coming eventually.
First, set up your API token. Go into your Todoist settings, go to
Integrations and copy out the API token. Plug it into the tool:
bash
doist auth MY_TOKEN
Now you're authenticated and can use the other functions of the tool.
Listing tasks and then working with them interactively is the recommended way to work with the CLI.
By default the list view shows todays tasks and lets you work with them:
```bash doist list
doist l```
This will allow you to type parts of the output until you select the task you want to work with (fuzzy search). Selecting will allow you to select various other subcommands, like closing, changing due dates or even editing tasks.
You can also disable interactive mode to pipe use the output somewhere else:
```bash doist list --nointeractive
doist l -n```
By default all interactive commands have a filter applied to show the most relevant tasks. See the documentation to see what inputs are accepted. To then use the filter, add it to the command parameters:
```bash doist list --filter "all"
doist l -f all```
A quick way to add a task is:
```bash doist add "Do the laundry" --due "tomorrow"
doist a "Do the laundry" -d tomorrow```
A quick way to close one of todays tasks is:
```bash doist close
```
And then fuzzy finding the task you want to close. Submitting the ID directly also works if you're more comfortable with that:
```bash doist close "BIGIDFROM_API"
```
Feel free to browse the help output for more help:
bash
doist help