Todoist CLI client

Todoist CLI Client, written in Golang.

Description

Todoist is a cool TODO list web application. This program will let you use the Todoist in CLI.

Demo (with peco)

Add Task

Close Task

Usage

$ todoist --help
NAME:
   todoist - Todoist CLI Client

USAGE:
   todoist [global options] command [command options] [arguments...]

VERSION:
   0.10.0

COMMANDS:
     list, l         Shows all tasks
     show            Show task detail
     completed-list  Shows all completed tasks (only premium user)
     add, a          Add task
     modify, m       Modify task
     close, c        Close task
     delete, d       Delete task
     labels          Shows all labels
     projects        Shows all projects
     karma           Show karma
     sync, s         Sync cache
     quick, q        Quick add a task
     help, h         Shows a list of commands or help for one command

GLOBAL OPTIONS:
   --color              colorize output
   --csv                output in CSV format
   --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

`list --filter`

You can filter tasks by --filter option on list subcommand.
The filter syntax is base on todoist official filter syntax.

Supported filter is here.

e.g. List tasks which over due date and have high priority

todoist list --filter '(overdue | today) & !p1'

Install

Homebrew (Mac OS)

$ brew tap sachaos/todoist
$ brew install todoist

Build it yourself

You need version 1.7 or higher Golang, and golang/dep: Go dependency management tool.

$ git clone https://github.com/sachaos/todoist.git
$ cd todoist
$ make install

Register API token

When you run todoist first time, you will be asked your Todoist API token. Please input Todoist API token and register it.

Use with peco

RECOMMENDED

install peco and load todoist_functions.sh on your .zshrc, like below.

fish version is here. ka2n/fish-peco_todoist Thanks @ka2n!

$ source "$GOPATH/src/github.com/sachaos/todoist/todoist_functions.sh"

keybind

<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

TODO

Refactoring
Restrict view option

Author

sachaos

jordie / todoist