todoist-cli

Bun-based Todoist CLI focused on automation-friendly workflows.

Install

bun add -g @vforsh/todoist

Run without global install:

bunx @vforsh/todoist --help

Configure

# secret via stdin only
printf "$TODOIST_API_TOKEN" | todoist cfg set apiToken -

# non-secret values
todoist cfg set endpoint=https://api.todoist.com retries=2 timeout=15000

# inspect
 todoist cfg ls

Environment variables override config values:

• TODOIST_API_TOKEN
• TODOIST_ENDPOINT
• TODOIST_TIMEOUT
• TODOIST_RETRIES

Usage

todoist task add "Buy milk" --priority 4
todoist task add "Pay rent" --due-string "tomorrow 09:00" --reminder 60 --reminder 10
todoist task update <taskId> --content "Buy milk and bread" --priority 4 --reminder 5
todoist task list --limit 10 --plain
todoist task find "взносы 14 348" --exact
todoist task done <taskId>
todoist task delete <taskId>

# aliases
todoist task a "Quick task"
todoist task create "Quick task 2"
todoist task edit <taskId> --content "Updated"
todoist task complete <taskId>
todoist task rm <taskId>
todoist task ls --limit 5 --plain
todoist task search "rent"
todoist task f "взносы" --project-id <projectId> --all
todoist cfg get endpoint retries --plain

Required infrastructure commands:

todoist cfg ls
todoist doctor
todoist skill

JSON / Plain modes

todoist task list --json
todoist task list --plain

Development gate

bun run typecheck
bun test