核心用法
Todoist CLI 是第三方开源命令行工具，通过 Todoist REST API 实现完整的任务管理功能。主要能力包括：
- 任务操作：添加/完成/更新/删除任务，支持自然语言日期（"tomorrow 2pm"）、4 级优先级（-P 1~4）、标签和项目归属
- 查询筛选：今日任务、逾期任务、按项目/优先级过滤，支持 Todoist 过滤语法
- 项目管理：创建和列出项目、分区（sections）
- 批量处理：所有命令支持
--json输出，便于脚本集成和自动化工作流
显著优点
1. 零依赖：单二进制文件，跨平台支持（macOS/Linux/Windows）
2. 开发者友好：统一的 JSON 信封格式 {"success":true,"data":[...]}，错误处理标准化
3. 管道友好：支持 stdin 输入（echo "idea" | xargs todoist add），易于与其他 CLI 工具链整合
4. 功能完整：覆盖官方 API 的大部分功能，包括评论、已完成任务历史查询
潜在局限
- 第三方维护：非 Todoist 官方出品，长期维护依赖社区（buddyh 个人仓库）
- API 限制：受 Todoist API 速率限制约束，高频自动化场景需注意配额
- 无离线能力：纯 API 驱动，网络中断时完全不可用
- 认证单一：仅支持 API Token 方式，无 OAuth 2.0 设备流等更安全的认证选项
适合人群
- 习惯终端工作的开发者和技术用户
- 需要批量任务操作或 CI/CD 集成自动化工作流的团队
- 希望用脚本扩展 Todoist 功能的高级用户
常规风险
- Token 泄露：
TODOIST_API_TOKEN需妥善保管，硬编码在脚本中有暴露风险 - 误操作：
delete --force无二次确认，批量脚本中需谨慎使用 - 数据一致性：API 延迟或网络异常时，本地状态与实际 Todoist 数据可能短暂不一致