todoist.nvim

A hopefully usable todoist extension for neovim

Warning

This repository should work as it is but doesn't receive much maintenance.

For integration with vim-clap (fuzzy finder) see below.

Install

Find your API key here: https://todoist.com/prefs/integrations

For security reasons, it is recommended to use pass to store it:

$ pass insert Todoist/API
Enter password for Todoist/API: XXXXXXXXX

Export it in your ~/.config/environment.d/*.conf/~/.profile/~/.bashrc

export TODOIST_API_KEY="$(pass Todoist/API)"

Plug 'romgrk/todoist.nvim', { 'do': ':TodoistInstall' }

If you don't use vim-plug, run the TodoistInstall command manually to complete the installation.

Requirements

neovim 0.4.0
nodejs 10.0.0
npm install -g neovim@latest (NOTE: needs to be at v4.9.0 at least!)

Make sure your nodejs provider works (:checkhealth to confirm).

Usage

:Todoist [project_name] (default: Inbox. Creates project if it doesn't exist)

Mappings

Keys	Effect
`x`	Toggle current task completion
`cc`	Change current task text
`cd`	Change current task date (date formats)
`p1`	Make task Priority 1
`p2`	Make task Priority 2
`p3`	Make task Priority 3
`p4`	Make task Priority 4
`DD`	Delete current task
`O`	Add new task before
`o`	Add new task after
`<`	Unindent
`>`	Indent
`r`	Refresh
`pcc`	Change current project color
`pcn`	Change current project name
`pdd`	Archive current project premium users only :/
`pDD`	Delete current project

Options

Below are the default options:

let todoist = {
\  'icons': {
\    'unchecked': ' [ ] ',
\    'checked':   ' [x] ',
\    'loading':   ' […] ',
\    'error':     ' [!] ',
\  },
\  'defaultProject': 'Inbox',
\  'useMarkdownSyntax': v:true,
\}

If you have a NerdFont installed, you can use the icons below, that will render like in the gif above.

let todoist = {
\ 'icons': {
\   'unchecked': '  ',
\   'checked':   '  ',
\   'loading':   '  ',
\   'error':     '  ',
\ },
\}

Integration with Clap

This plugin implements a vim-clap provider for selecting your projects.

Clap todoist