Todoist CLI

核心用法

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 数据可能短暂不一致

核心用法

该 Skill 为纯文档型（T-MD）设计，提供完整的 todoist CLI 工具使用指南，涵盖任务生命周期管理、项目/标签/分区组织、评论互动及历史任务查询。核心命令包括：

• 任务管理：todoist / todoist tasks --today 查看今日任务；todoist add "任务名" -d tomorrow -P 1 -p 项目 创建带优先级、截止日期、项目的任务；todoist complete <id> 或 done <id> 完成任务
• 筛选与搜索：支持 --filter "p1"、--filter "overdue"、-p 项目名 等多维度筛选，以及 todoist search 全文搜索
• 项目管理：todoist projects 列表与创建，todoist sections -p 项目 管理看板分区
• JSON 输出：所有命令支持 --json 返回标准化 {success, data, error} 格式，便于脚本集成

显著优点

1. 安全架构简洁：纯文档无代码，无 eval/exec 等危险函数，敏感凭证通过 TODOIST_API_TOKEN 环境变量注入，零硬编码风险
2. 跨平台兼容：依赖的 todoist CLI 为单二进制文件，支持 macOS/Linux/Windows，brew/go 双渠道安装
3. 功能覆盖完整：对接 Todoist REST API 全能力，从快速捕获到高级筛选、从个人任务到团队协作场景均覆盖
4. 输出标准化：统一的 JSON 信封格式，易于与 Alfred、Raycast、自动化脚本等工具链集成

潜在局限

1. 外部依赖必需： Skill 本身无可执行代码，必须用户自行安装 todoist CLI，首次配置需完成 API Token 获取（需访问 Todoist 开发者设置页面）
2. 来源可信度 T2：维护者为 GitHub 个人账号（buddyh），非企业/组织级背书，长期维护稳定性需社区观察
3. 无离线能力：完全依赖 Todoist 云服务，网络中断时无法同步或查询
4. 功能边界：作为文档型 Skill，不提供智能提醒、自然语言日期解析增强等高级交互，仅为命令参考

适合人群

• 已有 Todoist 付费/免费账户，希望在终端/脚本中高效管理任务的用户
• 开发者、运维人员偏好命令行工作流，需要将任务管理集成到 Shell/自动化流程
• 对安全性敏感，希望避免嵌入代码、仅使用外部可信 CLI 工具的用户
• 多平台切换（本地终端 + 远程服务器）需要一致任务管理体验的场景

常规风险

• Token 泄露风险：TODOIST_API_TOKEN 如被写入 shell history 或误提交至版本控制，可能导致账户数据暴露；建议配合 export 后及时 unset 或使用专用 secret 管理工具
• CLI 工具供应链风险：todoist 二进制来自第三方仓库（buddyh/tap），虽经审计无恶意，但仍建议通过 checksum 验证或源码编译确保完整性
• API 速率限制：高频脚本调用可能触发 Todoist API 限制，建议批量操作添加延迟或缓存机制
• 数据同步冲突：多客户端同时修改任务时可能产生冲突，重要操作建议先在官方客户端确认状态