gem-hunter
Language: Go
Todoist CLI Client. I ❤️ Todoist and CLI.
Unofficial Todoist CLI Client, written in Golang.
All users must upgrade to v0.23 or later. Older versions will stop working on February 10, 2026 when Todoist shuts down the Todoist Sync API v9 and Todoist REST API v2.
After upgrading:
todoist sync to refresh your local cacheFor more information, see the official Todoist API announcement.
The sections command is now available for managing Todoist sections. This feature is in BETA — please report any issues.
$ todoist sections --help
Subcommands: list, add, delete, archive, unarchive, update, move, reorder
You can also assign tasks to sections using the --section-name or --section-id flags on the add and modify commands.
Todoist is a cool TODO list web application. This program will let you use the Todoist in CLI.
$ todoist --help
NAME:
todoist - Todoist CLI Client
USAGE:
todoist [global options] command [command options] [arguments...]
VERSION:
0.18.0
COMMANDS:
list, l Show all tasks
show Show task detail
completed-list, c-l, cl Show all completed tasks (only premium users)
add, a Add task
modify, m Modify task
close, c Close task
reopen Reopen (uncomplete) a closed task
delete, d Delete task
labels Show all labels
projects Show all projects
karma Show karma
sync, s Sync cache
quick, q Quick add a task
help, h Show a list of commands or help for one command
GLOBAL OPTIONS:
--color colorize output
--csv output in CSV format
--debug output logs
--namespace display parent task like namespace
--indent display children task with indent
--project-namespace display parent project like namespace
--help, -h show help
--version, -v print the version
You can filter tasks by --filter option on list subcommand.
The filter syntax is base on todoist official filter syntax.
todoist list --filter '(overdue | today) & p1'
Config by default stored in $HOME/.config/todoist/config.json
It has following parameters:
{
"token": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", # todoist api token, required
"color": "true", # colorize all output, not required, default false
"shortdatetimeformat": "06/01/02(Mon) 15:04", # golang datetime format, not required
"shortdateformat": "06/01/02(Mon)" # golang date format, not required
}
From homebrew-core:
$ brew install todoist-cli-go
Or from this project's tap:
$ brew install sachaos/todoist/todoist
Important
The homebrew-core formula name is todoist-cli-go, not todoist-cli.
todoist-cli is a separate formula for the official Doist CLI, which is a different tool. This formula was previously named todoist-cli but was renamed to make room for the official one.
nix-env -iA nixos.todoist
It's important to notice that if you're using NixOS, the cache and config file will be present at your home directory: ~/.todoist.cache.json and ~/.todoist.config.json.
$ git clone https://github.com/sachaos/todoist.git
$ cd todoist
$ make docker-build token=xxxxxxxxxxxxxxxxxxxx
$ make docker-run
You will be running the next commands from inside the container.
PS: We add a step that is run sync before any command, so you will be always up to date!
You need go 1.12+.
$ mkdir -p $GOPATH/src/github.com/sachaos
$ cd $GOPATH/src/github.com/sachaos
$ git clone https://github.com/sachaos/todoist.git
$ cd todoist
$ make install
When you run todoist first time, you will be asked your Todoist API token.
Please input Todoist API token and register it. In order to get your API token
go to https://app.todoist.com/app/settings/integrations/developer
After register API token, you should sync with todoist.com by sync sub command, like below.
$ todoist sync
RECOMMENDED
Install peco and load todoist_functions.sh on your .zshrc, like below.
fish version is here. ka2n/fish-peco_todoist Thanks @ka2n!
If you would prefer to use fzf instead load todoist_functions_fzf.sh like below.
fish version is here. mordax7/fish-fzf-todoist
$ source "$GOPATH/src/github.com/sachaos/todoist/todoist_functions.sh"
If installed via homebrew and using zsh (usually this is added to your .zshrc without the $, usually before loading your ZSH plugin manager):
For peco:
$ source $(brew --prefix)/share/zsh/site-functions/_todoist_peco
For fzf:
$ source $(brew --prefix)/share/zsh/site-functions/_todoist_fzf
TODO: fish + homebrew
<C-x> t t: select task with peco
<C-x> t p: select project with peco
<C-x> t l: select labels with peco
<C-x> t c: select task and close with peco
<C-x> t d: select date
<C-x> t o: select task, and open it with browser when has url
You can also enable shell completion by adding the following lines to your .bashrc/.zshrc files.
# Bash
PROG=todoist source "$GOPATH/src/github.com/urfave/cli/autocomplete/bash_autocomplete"
# Zsh
PROG=todoist source "$GOPATH/src/github.com/urfave/cli/autocomplete/zsh_autocomplete"