doist - todoist CLI Client

An unofficial todoist API CLI client written in Rust.

About

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.

Installation

TODO

How to use

Auth

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:

doist auth MY_TOKEN

Now you're authenticated and can use the other functions of the tool.

List tasks

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:

doist list
# Altenatively: `doist l`

This will allow you to type parts of the output until you select the task you want to work with. 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:

doist list --nointeractive
# Alternatively: `doist l --noi`

Adding tasks

A quick way to add a task is:

doist add "Do the laundry" --due "tomorrow"
# Alternatively: `doist a "Do the laundry" -d tomorrow`

Help

Feel free to browse the help output for more help:

doist help