核心用法
Todoist CLI 是一款面向终端的第三方命令行工具，通过调用 Todoist REST API 实现对官方服务的完整操作封装。核心功能覆盖：
- 任务管理：快速创建（
add）、完成（complete/done）、重新打开（reopen）、更新（update）及删除（delete）任务，支持自然语言日期解析（如tomorrow、today 5pm）、优先级标记（-P 1至-P 4）和标签绑定 - 智能筛选：默认展示今日任务，支持按优先级（
p1）、逾期状态（overdue）、项目（-p Work）等条件过滤，内置搜索（search）和详情查看（view） - 项目管理：支持项目（
projects）、标签（labels）、分区（sections）的创建与查询，可配置颜色标识 - 工作流增强：Kanban 风格的任务移动（
move跨分区/项目）、评论追加（comment）、已完成任务回溯（completed），所有命令均支持--json输出便于脚本集成 - 认证方式：交互式
todoist auth或环境变量TODOIST_API_TOKEN
显著优点
1. 零上下文切换：终端原生体验，适合开发者和效率极客在编码工作流中无缝管理任务
2. 表达力丰富：单行命令即可完成复杂操作（如 todoist add "Urgent" -P 1 -d "today 5pm" -l urgent）
3. 扩展性强：JSON 输出便于与 jq、awk 等工具链集成，支持自动化脚本和 CI/CD 场景
4. 覆盖完整：相比官方 GUI，CLI 提供了对分区（Sections）和评论的直接操作能力
潜在缺点与局限性
- 第三方工具风险：非 Doist 官方出品，功能更新可能滞后于 API 变更，存在维护可持续性风险
- Token 管理负担：API Token 需手动获取并妥善保管，泄露即导致完整账户访问权限暴露
- 无离线能力：纯 API 依赖，网络中断时完全不可用
- 学习曲线：需要记忆命令参数（如优先级数字映射），相比 TUI 工具（如
todoist-tui）交互友好度较低 - 速率限制：受 Todoist API 配额限制，高频自动化场景可能触发限流
适合人群
- 终端重度用户、开发者、DevOps 工程师
- 追求键盘驱动工作流（Vim/Emacs/Tmux 生态）的效率极客
- 需要将任务管理集成到 Shell 脚本或自动化工作流的技术用户
- 对官方 Web/App 界面操作效率不满意的 Todoist 付费用户
常规风险
| 风险类型 | 说明 |
|---------|------|
| 凭据泄露 | `TODOIST_API_TOKEN` 若写入 `.bashrc` 或脚本文件，可能通过版本控制或进程列表暴露 |
| 数据误操作 | `delete` 和 `complete` 无交互确认，脚本批量执行时可能造成不可逆数据丢失 |
| 供应链风险 | Homebrew Tap 和 Go 模块非官方渠道，存在被篡改或投毒可能（建议校验 checksum） |
| 隐私合规 | 所有任务数据经由第三方 CLI 传输至 Todoist 云端，敏感内容需评估合规要求 |