Todoist CLI

核心功能

Todoist CLI 是一个跨平台的命令行工具，通过 REST API 与 Todoist 官方服务交互，支持完整的任务生命周期管理：创建、更新、完成、删除、搜索及筛选。同时涵盖项目、标签、分区、评论等高级功能，满足 GTD 工作流需求。

显著优点

1. 原生 CLI 体验：单二进制文件，无运行时依赖，响应迅速，适合终端重度用户
2. 自然语言日期：支持 tomorrow 2pm、next monday 等人性化时间表达
3. 灵活筛选系统：支持优先级（p1-p4）、项目、标签、截止日期、逾期状态等多维度组合筛选
4. 结构化输出：--json 参数提供标准化 {success, data, error} 信封格式，便于脚本集成和自动化工作流
5. 快速捕获：支持管道输入 echo "idea" | xargs todoist add，无缝衔接 shell 生态
6. 完整功能覆盖：不仅限于任务，还包括项目分区、评论等 Todoist 高级特性

潜在局限

1. API 依赖：完全依赖 Todoist 官方 API，离线不可用；存在速率限制风险
2. 配置门槛：需手动获取并配置 API Token，对非技术用户不够友好
3. 无双向同步状态显示：不像官方客户端实时显示同步状态，极端网络条件下可能产生延迟感知
4. 功能边界：不支持 Todoist 的看板视图、日历视图等可视化功能，纯文本交互
5. 第三方维护：由社区开发者 buddyh 维护，非 Todoist 官方出品，长期支持存在不确定性

适合人群

• 开发者与运维工程师，习惯终端工作流
• 需要批量操作任务或自动化集成的效率极客
• 追求快速捕获、最小上下文切换的键盘优先用户
• 需要将 Todoist 与 CI/CD、个人脚本联动的场景

常规风险

• Token 泄露风险：API Token 存储于环境变量或本地配置，共享设备或误提交代码可能导致账户被非法访问
• 误操作不可逆：delete --force 等操作无二次确认，脚本执行时需格外谨慎
• API 变更兼容：Todoist API 升级可能导致 CLI 功能异常，需关注上游更新
• 数据隐私：任务内容通过第三方工具传输，敏感信息需评估合规要求

核心用法

Todoist CLI Skill 是 Todoist 官方 REST API 的命令行封装工具，允许用户在不打开网页或应用的情况下完成任务管理操作。核心功能覆盖：

任务管理：创建任务（支持自然语言日期如 "tomorrow 2pm"）、设置四级优先级（P1-P4）、分配项目和标签、标记完成/删除；支持高级过滤语法如 "overdue & p1"。

项目与组织：管理项目、创建分区（Sections）、维护标签体系，支持将任务归档到特定工作流。

查询与导出：查看今日任务、逾期项、按项目筛选、搜索关键词，所有命令支持 --json 机器可读输出。

显著优点

1. 零上下文切换：终端直接操作，无需离开当前工作环境
2. 自然语言解析：-d "next monday 5pm" 等日期表达式降低输入成本
3. 管道友好：支持 stdin 输入和 JSON 输出，便于脚本化集成
4. 跨平台：单一二进制文件，无运行时依赖

局限性与风险

| 维度 | 说明 |

|------|------|

| **外部依赖** | 需独立安装 `todoist` CLI，Skill 本身不封装二进制 |

| **Token 管理** | API Token 以环境变量形式暴露，共享环境存在泄露风险 |

| **T3 来源** | 个人开发者维护，长期更新承诺未明确 |

| **网络隔离** | 所有操作直连 Todoist 服务器，无法离线使用 |

| **误操作不可逆** | `--force` 删除无回收站二次确认 |

适合人群

• 重度终端用户和键盘流效率爱好者
• 需要将任务管理集成到自动化脚本（如 CI/CD、定时备份）的开发者
• 已有 Todoist 付费账户（部分 API 功能需高级版）的现有用户

常规风险提醒

• API Token 属于高敏感凭证，建议配置在 ~/.zshenv 等用户级文件而非全局环境
• todoist-cli 上游由个人开发者维护，建议定期审计 brew info todoist 或 go list -m 来源完整性
• 企业环境使用前需确认 Todoist 服务符合数据合规要求