todoist-2

Todoist CLI

Use todoist to manage tasks, projects, labels, and sections via the Todoist REST API.

Tasks

# Today's tasks (default)
todoist

# List tasks
todoist tasks --all
todoist tasks --filter "p1"           # High priority
todoist tasks --filter "overdue"      # Overdue
todoist tasks -p Work                 # By project

Add task

todoist add "Buy groceries" todoist add "Call mom" -d tomorrow todoist add "Urgent" -P 1 -d "today 5pm" -l urgent

Complete / reopen

todoist complete todoist done todoist reopen

Update task

todoist update --due "next monday" todoist update -P 2

Move task (Kanban)

todoist move --section "In Progress" todoist move --project "Work"

Delete task

todoist delete

View / search

todoist view todoist search "meeting"

## Projects

```bash
todoist projects
todoist projects add "New Project" --color blue

Labels

todoist labels
todoist labels add urgent --color red

Sections

todoist sections -p Work
todoist sections add "In Progress" -p Work

Comments

todoist comment <task-id>
todoist comment <task-id> "This is a note"

Completed Tasks

todoist completed
todoist completed --since 2024-01-01 --limit 50

Command Reference

Command	Description
todoist	Show today's tasks
todoist tasks	List tasks with filters
todoist add	Create a new task
todoist complete	Mark task complete
todoist done	Alias for complete
todoist reopen	Reopen completed task
todoist move	Move task to section/project
todoist update	Update a task
todoist delete	Delete a task
todoist view	View task details
todoist search	Search tasks
todoist projects	List/manage projects
todoist labels	List/manage labels
todoist sections	List/manage sections
todoist comment	View/add comments
todoist completed	Show completed tasks

Priority Mapping

CLI	Todoist
-P 1	p1 (highest)
-P 2	p2
-P 3	p3
-P 4	p4 (lowest)

Notes

• All commands support --json for machine-readable output
• Auth: todoist auth or set TODOIST_API_TOKEN