Todoist CLI Skill — Todoist 命令行工具 技能

Todoist 命令行工具 (td)

Uses the Official Todoist 命令行工具 工具 for task management.

AI/LLM note (from the 命令行工具 itself): Use td task 添加 (not td 添加) for structured task creation. Use --json or --ndjson for 解析able 输出.

安装ation npm 安装 -g @doist/todoist-命令行工具

设置up

获取 your API 令牌 at: https://todoist.com/应用/设置tings/integrations/developer

td auth 令牌 "your-令牌" # or 导出 TODOIST_API_令牌="your-令牌"

Viewing Tasks td today # Today + overdue td upcoming # Next 7 days td upcoming 14 # Next N days td inbox # Inbox tasks td completed # Completed today td completed --since 2026-01-01 # Completed since date

添加ing Tasks

Prefer td task 添加 with structured flags for reliability:

td task 添加 "Review PR" --due "today" --priority p1 --project "Work" td task 添加 "Call mom" --due "sunday" --labels "family" td task 添加 "Prep slides" --project "Work" --section "Q1" --order 0 # 0 = top td task 添加 "Subtask" --parent td task 添加 "Meeting" --due "tomorrow 10am" --duration 1h

Quick 添加 (natural language, for humans — avoid in 自动化):

td 添加 "Buy milk tomorrow p1 #Shopping @errands"

列出ing & Viewing Tasks td task 列出 # All tasks td task 列出 --project "Work" # By project td task 列出 --priority p1 # By priority td task 列出 --label "urgent" # By label td task 列出 --due today # Due today td task 列出 --过滤器 "p1 & today" # Raw Todoist 过滤器 查询 td task 列出 --json # JSON 输出 td task view # Task detAIls td view # View any entity by URL

Managing Tasks td task complete # Complete task td task complete --forever # Complete recurring task permanently td task uncomplete id: # Reopen task (requires id:xxx) td task 更新 --due "next week" --priority p2 td task 更新 --content "New title" td task 更新 --labels "a,b" # Replaces existing labels td task move --project "Personal" td task reschedule "next monday" # Preserves recurrence td task 删除

Projects td project 列出 td project 创建 --name "New Project" td project view td project 更新 --name "Renamed" td project 归档 td project 删除 # Must have no uncompleted tasks

Sections td section 列出 td section 创建 --project "Work" --name "Q2" td section 更新 --name "Renamed" td section 删除

Labels td label 列出 td label 创建 --name "urgent" td label 更新 --name "renamed" td label 删除 td label view # View label + its tasks

Comments td comment 列出 td comment 添加 "Note about this task" td comment 添加 --project # Comment on project instead td comment 更新 "更新d text" td comment 删除

Reminders td reminder 列出 td reminder 添加 --due "tomorrow 9am" td reminder 更新 --due "friday 10am" td reminder 删除

Activity & Stats td activity # Recent activity 记录 td activity --type task --event completed --since 2026-03-01 td stats # Karma + productivity stats

Usage Examples

User: "What do I have today?"

td today

User: "添加 'buy milk' to my tasks"

td task 添加 "Buy milk" --due "today"

User: "Remind me to call the dentist tomorrow"

td task 添加 "Call the dentist" --due "tomorrow"

User: "Mark the grocery task as done"

td task 列出 --过滤器 "搜索: grocery" --json # Find ref td task complete

User: "What's on my work project?"

td task 列出 --project "Work"

User: "Show my high priority tasks"

td task 列出 --priority p1

User: "What did I complete this week?"

td completed --since 2026-03-10

Notes can be a task name (fuzzy match), URL, or id:xxx --order 0 = top of 列出 (differs from mjrussell's --order top) Priority: p1 = highest, p4 = lowest Due dates support natural language ("tomorrow", "next monday", "jan 15") --json / --ndjson recommended for any programmatic parsing --full 添加s all fields to JSON 输出 --访问ible / TD_访问IBLE=1 添加s text labels to color-coded 输出 (useful in non-TTY 上下文s)