名称： todoist
描述： 管理 Todoist 中的任务与项目。当用户询问任务、待办事项、提醒或生产力相关问题时使用。
主页： https://todoist.com
元数据：
clawdbot:
emoji: "✅"
requires:
bins: ["todoist"]
env: ["TODOIST_API_TOKEN"]

Todoist CLI

基于官方 TypeScript SDK 构建的 Todoist 任务管理命令行工具。

安装

# 需要 todoist-ts-cli >= 0.2.0 版本（以支持 --top / --order 参数）
npm install -g todoist-ts-cli@^0.2.0

配置

1. 从 https://todoist.com/app/settings/integrations/developer 获取 API 令牌。
2. 选择以下任一方式配置令牌：
   bash todoist auth <你的令牌> # 或 export TODOIST_API_TOKEN="你的令牌"

命令

任务管理

todoist                    # 显示今日任务（默认）
todoist today              # 同上
todoist tasks              # 列出任务（今日 + 逾期）
todoist tasks --all        # 所有任务
todoist tasks -p "工作"    # 指定项目中的任务
todoist tasks -f "p1"      # 使用过滤器查询（优先级 1）
todoist tasks --json       # 输出 JSON 格式

添加任务

todoist add "购买日用品"
todoist add "会议" --due "明天 10点"
todoist add "评审 PR" --due "今天" --priority 1 --project "工作"
todoist add "准备幻灯片" --project "工作" --order 3  # 在指定位置添加（基于 1 的索引）
todoist add "处理收件箱" --project "工作" --order top  # 添加到顶部（--top 的替代写法）
todoist add "给妈妈打电话" -d "周日" -l "家庭"  # 添加标签

管理任务

todoist view <任务ID>      # 查看任务详情
todoist done <任务ID>      # 完成任务
todoist reopen <任务ID>    # 重新打开已完成任务
todoist update <任务ID> --due "下周"
todoist move <任务ID> -p "个人"
todoist delete <任务ID>    # 删除任务

搜索

todoist search "会议"

项目与标签

todoist projects           # 列出项目
todoist project-add "新项目"
todoist labels             # 列出标签
todoist label-add "紧急"

评论

todoist comments <任务ID>  # 查看任务评论
todoist comment <任务ID> "关于此任务的备注"  # 添加评论

使用示例

用户：“我今天有什么要做的？”

todoist today

用户：“把‘买牛奶’加到我的任务里”

todoist add "买牛奶" --due "今天"

用户：“提醒我明天给牙医打电话”

todoist add "给牙医打电话" --due "明天"

用户：“把购物任务标记为完成”

todoist search "购物"   # 查找任务 ID
todoist done <任务ID>

用户：“我的工作项目里有什么？”

todoist tasks -p "工作"

用户：“显示我的高优先级任务”

todoist tasks -f "p1"

过滤器语法

Todoist 支持强大的过滤器查询：
- p1, p2, p3, p4 - 优先级等级
- today, tomorrow, overdue - 时间
- @标签名 - 带有指定标签的任务
- #项目名 - 指定项目中的任务
- search: 关键词 - 搜索关键词

注意事项

• 任务 ID 会在任务列表中显示。
• 截止日期支持自然语言（如“明天”、“下周一”、“1月15日”）。
• 优先级 1 为最高，4 为最低。
• 使用 --order <n>（基于 1 的索引）或 --order top 可在项目/分区内的特定位置插入任务。