Todoist 集成

通过td命令行界面（todoist-rs）管理任务。

安装

brew install LuoAndOrder/tap/todoist-cli

或通过 Cargo 安装：cargo install todoist-cli-rs

同步行为

• 写入操作自动同步：添加、完成、编辑、删除直接调用 API
• 读取操作使用缓存：列表、今日、显示从本地缓存读取
• 需要时同步使用--sync标志或td sync来获取最新数据

td sync              # Incremental sync (fast)
td sync --full       # Full rebuild if cache seems off

常用操作

列出任务

# Today's agenda (includes overdue)
td today --sync

# Today only (no overdue)
td today --no-overdue

# All tasks
td list --sync

# By project
td list -p "Inbox" --sync
td list -p "Work" --sync

# High priority
td list -f "p1 | p2" --sync

# By label
td list -l "urgent" --sync

# Complex filters
td list -f "today & p1" --sync
td list -f "(today | overdue) & !@waiting_on" --sync

添加任务

快速添加（自然语言）：

td quick "Buy milk tomorrow @errands #Personal"
td quick "Review PR tomorrow" --note "Check the auth changes carefully"

结构化添加：

td add "Task content" \
  -p "Inbox" \
  -P 2 \
  -d "today" \
  -l "urgent"

# With description
td add "Prepare quarterly report" -P 1 -d "friday" \
  --description "Include sales metrics and customer feedback summary"

选项：

• -P, --priority- 1（最高）到 4（最低，默认值）
• -p, --project- 项目名称
• -d, --due- 截止日期（"today"、"tomorrow"、"2026-01-30"、"next monday"）
• -l, --label- 标签（可重复使用以添加多个）
• --description- 任务描述/备注（显示在任务标题下方）
• --section- 项目内的目标分区
• --parent- 父任务ID（创建子任务）

完成任务

td done <task-id>
td done <id1> <id2> <id3>              # Multiple at once
td done <id> --all-occurrences         # End recurring task permanently

修改任务

td edit <task-id> -c "New content"
td edit <task-id> --description "Additional notes here"
td edit <task-id> -P 1
td edit <task-id> -d "tomorrow"
td edit <task-id> --add-label "urgent"
td edit <task-id> --remove-label "next"
td edit <task-id> --no-due             # Remove due date
td edit <task-id> --section "Next Actions"
td edit <task-id> -p "Work"            # Move to different project

编辑选项：

• -c, --content- 更新任务标题
• --description- 更新任务描述/备注
• -P, --priority- 更改优先级（1-4）
• -d, --due- 更改截止日期
• --no-due- 移除截止日期
• -l, --label- 替换所有标签
• --add-label- 添加标签
• --remove-label- 移除标签
• -p, --project- 移至不同项目
• --section- 移至项目内的分区

显示任务详情

td show <task-id>
td show <task-id> --comments

删除任务

td delete <task-id>

重新打开已完成任务

td reopen <task-id>

项目与标签管理

# Projects
td projects                            # List all
td projects add "New Project"
td projects show <id>

# Labels
td labels                              # List all
td labels add "urgent"

筛选语法

与-f/--filter配合使用：

• 逻辑或（OR）使用：today | overdue逻辑与（AND）使用：
• @next & #Personal括号：(today | overdue) & p1
• 否定：!@waiting_on
• 优先级：p1
• ,p2,p3,p4日期：p4
• Dates:今天,明天,逾期,无日期,7天

工作流提示

1. 晨间回顾:td today --sync
2. 快速捕捉:td quick "待办事项"
3. 焦点清单:td list -f "@next" --sync
4. 等待中:td list -f "@waiting_on" --sync
5. 日终:td today（缓存即可，已同步）