Todoist CLI

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

安装

# 需要 todoist-ts-cli >= 0.2.0 (以支持 --top / --order 选项)
npm install -g todoist-ts-cli@^0.2.0

设置

1. 获取 API 令牌，请访问https://todoist.com/app/settings/integrations/developer
2. 任选以下一种方式设置令牌：

   todoist auth <your-token>
   # 或者
   export TODOIST_API_TOKEN="your-token"

命令

任务

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

添加任务

todoist add "Buy groceries"
todoist add "Meeting" --due "tomorrow 10am"
todoist add "Review PR" --due "today" --priority 1 --project "Work"
todoist add "Prep slides" --project "Work" --order 3  # 在指定位置添加（从 1 开始计数）
todoist add "Triage inbox" --project "Work" --order top  # 添加到顶部（替代 --top 选项）
todoist add "Call mom" -d "sunday" -l "family"  # 添加标签

管理任务

todoist view <id>          # 查看任务详情
todoist done <id>          # 完成任务
todoist reopen <id>        # 重新打开已完成的任务
todoist update <id> --due "next week"
todoist move <id> -p "Personal"
todoist delete <id>

搜索

todoist 搜索 "会议"

项目与标签

todoist 项目           # 列出项目
todoist 项目添加 "新项目"
todoist 标签             # 列出标签
todoist 标签添加 "紧急"

评论

todoist 评论 <任务ID>
todoist 评论 <任务ID> "关于此任务的备注"

使用示例

用户："我今天要做什么？"

todoist 今天

用户："将'买牛奶'添加到我的任务中"

todoist 添加 "买牛奶" --截止 "今天"

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

todoist 添加 "打电话给牙医" --截止 "明天"

用户："将购物任务标记为完成"

todoist 搜索 "购物"   # 查找任务ID
todoist 完成 <ID>

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

todoist tasks -p "工作"

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

todoist tasks -f "p1"

筛选语法

Todoist 支持强大的筛选查询：

• p1、p2、p3、p4- 优先级等级
• 今天、明天,逾期
• @标签- 带标签的任务
• #项目- 项目中的任务
• 搜索：关键词- 搜索

备注

• 任务ID会在任务列表中显示
• 截止日期支持自然语言（"明天"、"下周一"、"1月15日"）
• 优先级1为最高，4为最低
• 使用--order <n>（从1开始计数）或--order top将任务插入到项目/部分的特定位置