ssube/togo repository overview

⁠togo

CLI for Todoist's⁠ v8 API⁠ written in Go.

⁠Config

togo expects a ~/.togo.yml file to exist in the current user's home directory.

The config file should contain:

root: "https://beta.todoist.com/API/v8"
token: "api-token"

You can find your API token on the Integrations page⁠.

⁠Usage

togo can list and complete pending tasks, as well as add new tasks.

You can run togo from a Docker container (mounting the config):

$ docker run -it -v ${HOME}:/root:ro ssube/togo:master list

    ID   Priority  Content
...

⁠Count

togo

Count incomplete tasks:

$ togo

3 tasks to go

⁠List

togo list [--columns col1,col2] [--project project_id] [--labels label1,label2,label3] [filter...]

List incomplete tasks:

$ togo list

    ID   Priority  Content
 01231          1  clean desk
 01232          1  update gitlab
 01233          1  clean computer monitor

$ togo list --project 03211 --labels computer,desk "search: monitor"

    ID   Priority  Content
 01233          1  clean computer monitor

The columns parameter selects fields from the tasks, in order, and displays them in a table with headers:

$ togo list --columns ID,Order

    ID   Order
 01231       1
 01232       2
 01233       3

The project parameter only lists tasks from a single project, labels are applied with an | operator, and any trailing arguments are passed as an & filter.

Filters are documented here⁠ and limited to Todoist Premium. If no filter is provided, the parameter is omitted, which is equivalent to "all". Labels are combined with the | operator. Additional filters are wrapped in parentheses and joined with &.

⁠Add

togo add [content...]

Add a new task:

$ togo add "task"

    id   priority  content
 01234          1  hello world

Trailing arguments are merged with " " (a space).

⁠Done

togo done [id...]

Complete a task:

$ togo done 01231 01232 01233 01234

closing 01231
closing 01232
closing 01233
closing 01234

⁠Todo

Features:

• labels
• filters
• custom columns
• sort order
• list projects