用途
Todoist CLI 用于通过命令行管理 Todoist 中的任务、项目、标签和分区，底层调用 Todoist REST API。适合希望在终端内直接操作待办事项，或需要将 Todoist 集成到脚本与自动化流程中的用户。
主要能力
- 任务管理：查看今日任务（默认命令）、列出任务并支持筛选（如高优先级 p1、逾期 overdue、按项目 -p Work）、添加任务（可指定截止日期、优先级、标签）、完成或重新打开任务、更新任务（截止日期、优先级等）、移动任务到分区或项目（支持看板式流转）、删除任务、查看任务详情、搜索任务。
- 项目管理：列出和管理项目，例如添加项目并指定颜色。
- 标签管理：列出和管理标签，例如添加标签并指定颜色。
- 分区管理：列出和管理分区，例如在指定项目下添加分区。
- 评论：查看或添加任务评论。
- 已完成任务：查看已完成任务，支持按起始日期和数量限制筛选。
使用方式
通过 todoist 命令调用，常用示例如下：
- 查看今日任务：
todoist - 列出任务：
todoist tasks --all、todoist tasks --filter "p1"、todoist tasks --filter "overdue"、todoist tasks -p Work - 添加任务：
todoist add "Buy groceries"、todoist add "Call mom" -d tomorrow、todoist add "Urgent" -P 1 -d "today 5pm" -l urgent - 完成/重新打开：
todoist complete、todoist done、todoist reopen - 更新任务：
todoist update --due "next monday"、todoist update -P 2 - 移动任务：
todoist move --section "In Progress"、todoist move --project "Work" - 删除任务：
todoist delete - 查看/搜索：
todoist view、todoist search "meeting" - 项目：
todoist projects、todoist projects add "New Project" --color blue - 标签：
todoist labels、todoist labels add urgent --color red - 分区：
todoist sections -p Work、todoist sections add "In Progress" -p Work - 评论：
todoist comment <task-id>、todoist comment <task-id> "This is a note" - 已完成任务：
todoist completed、todoist completed --since 2024-01-01 --limit 50
命令参考：
| 命令 | 说明 |
|---|---|
| todoist | 显示今日任务 |
| todoist tasks | 按筛选条件列出任务 |
| todoist add | 创建新任务 |
| todoist complete | 标记任务完成 |
| todoist done | complete 的别名 |
| todoist reopen | 重新打开已完成任务 |
| todoist move | 移动任务到分区/项目 |
| todoist update | 更新任务 |
| todoist delete | 删除任务 |
| todoist view | 查看任务详情 |
| todoist search | 搜索任务 |
| todoist projects | 列出/管理项目 |
| todoist labels | 列出/管理标签 |
| todoist sections | 列出/管理分区 |
| todoist comment | 查看/添加评论 |
| todoist completed | 显示已完成任务 |
优先级映射：
| CLI | Todoist |
|---|---|
| -P 1 | p1（最高） |
| -P 2 | p2 |
| -P 3 | p3 |
| -P 4 | p4（最低） |
适用场景
- 在终端中快速查看今日任务或按优先级、逾期状态、项目筛选任务。
- 通过脚本或自动化流程批量添加、更新、完成、移动或删除任务。
- 管理项目、标签、分区和任务评论。
- 查询已完成任务记录。
限制与说明
- 所有命令支持
--json，用于输出机器可读结果。 - 认证方式：运行
todoist auth或设置TODOIST_API_TOKEN环境变量。 - 资料未提供安装方式、收费模式、平台支持范围及具体版本要求，暂未提供。