Todoist CLI (td)

使用官方 Todoist CLI 工具进行任务管理。

AI/LLM 提示（来自 CLI 本身）： 使用 td task add（而非 td add）进行结构化任务创建。使用 --json 或 --ndjson 获取可解析的输出。

安装

bash
npm install -g @doist/todoist-cli

设置

在此处获取您的 API 令牌：https://todoist.com/app/settings/integrations/developer

bash
td auth token your-token

或

查看任务

bash
td today # 今日 + 逾期
td upcoming # 未来 7 天
td upcoming 14 # 未来 N 天
td inbox # 收件箱任务
td completed # 今日已完成
td completed --since 2026-01-01 # 自指定日期起已完成

添加任务

建议使用 td task add 配合结构化标志以确保可靠性：

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

快速添加（自然语言，适合人类使用——自动化中请避免）：

bash
td add Buy milk tomorrow p1 #Shopping @errands

列出与查看任务

bash
td task list # 所有任务
td task list --project Work # 按项目筛选
td task list --priority p1 # 按优先级筛选
td task list --label urgent # 按标签筛选
td task list --due today # 今日到期
td task list --filter p1 & today # 原始 Todoist 筛选查询
td task list --json # JSON 输出
td task view # 任务详情
td view # 通过 URL 查看任意实体

管理任务

bash
td task complete # 完成任务
td task complete --forever # 永久完成重复任务
td task uncomplete id: # 重新打开任务（需使用 id:xxx）
td task update --due next week --priority p2
td task update --content New title
td task update --labels a,b # 替换现有标签
td task move --project Personal
td task reschedule next monday # 保留重复规则
td task delete

项目

bash
td project list
td project create --name New Project
td project view
td project update --name Renamed
td project archive
td project delete # 必须无未完成任务

分区

bash
td section list
td section create --project Work --name Q2
td section update --name Renamed
td section delete

标签

bash
td label list
td label create --name urgent
td label update --name renamed
td label delete
td label view # 查看标签及其任务

评论

bash
td comment list
td comment add Note about this task
td comment add --project # 改为对项目添加评论
td comment update Updated text
td comment delete

提醒

bash
td reminder list
td reminder add --due tomorrow 9am
td reminder update --due friday 10am
td reminder delete

活动与统计

bash
td activity # 近期活动日志
td activity --type task --event completed --since 2026-03-01
td stats # 业力 + 生产力统计

使用示例

用户：我今天有什么任务？
bash
td today

用户：将买牛奶添加到我的任务中
bash
td task add Buy milk --due today

用户：提醒我明天给牙医打电话
bash
td task add Call the dentist --due tomorrow

用户：将购物任务标记为已完成
bash
td task list --filter search: grocery --json # 查找引用
td task complete

用户：我的工作项目上有什么？
bash
td task list --project Work

用户：显示我的高优先级任务
bash
td task list --priority p1

用户：我这周完成了什么？
bash
td completed --since 2026-03-10

注意事项

• - 可以是任务名称（模糊匹配）、URL 或 id:xxx
• --order 0 = 列表顶部（与 mjrussell 的 --order top 不同）
• 优先级：p1 = 最高，p4 = 最低
• 到期日期支持自然语言（tomorrow、next monday、jan 15）
• 建议在程序化解析时使用 --json / --ndjson
• --full 为 JSON 输出添加所有字段
• --accessible / TD_ACCESSIBLE=1 为彩色输出添加文本标签（在非 TTY 环境中很有用）