Todoist CLI

核心用法

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 云端，敏感内容需评估合规要求 |

核心用法

todoist-cli 是一款命令行工具的使用参考文档，本身不包含可执行代码，仅提供完整的 CLI 命令示例和参数说明。用户需先在本地安装 todoist CLI 工具（通过 Homebrew 或 Go 安装），并配置 TODOIST_API_TOKEN 环境变量完成认证。

主要功能覆盖：

• 任务管理：创建（add）、完成（complete/done）、重开（reopen）、更新（update）、删除（delete）、搜索（search）
• 筛选查询：按优先级（-P 1~4）、截止日期（-d）、项目（-p）、标签（-l）、逾期状态（overdue）过滤
• 项目管理：创建项目、指定颜色
• 看板支持：通过 move 命令将任务移至不同分区（section）或项目
• 历史记录：查看已完成任务（completed）并支持时间范围筛选
• 数据导出：所有命令支持 --json 输出机器可读格式

显著优点

1. 零代码风险：纯 Markdown 文档型 Skill，无可执行逻辑，无动态代码注入风险
2. 命令覆盖全面：涵盖 Todoist REST API 的核心操作，从基础 CRUD 到高级筛选、看板移动
3. 优先级映射清晰：明确 CLI 参数 -P 1~4 与 Todoist 原生 p1~p4 的对应关系
4. 多安装渠道：支持 Homebrew 和 Go 两种主流安装方式，适配不同开发者环境
5. 合规性优秀：通过 GDPR/CCPA 隐私合规检查，无用户数据收集行为

潜在缺点与局限性

1. 外部依赖必需：Skill 本身仅为文档，必须额外安装 todoist CLI 工具才能使用，增加环境配置成本
2. 来源可信度 T3：来自 GitHub 个人开发者（buddyh），无企业/基金会背书，长期维护存不确定性
3. 认证配置繁琐：需手动设置 TODOIST_API_TOKEN 环境变量，对新手不够友好
4. 无交互式引导：纯命令参考，无对话式任务创建向导，复杂日期表达式（如 "today 5pm"）需用户自行掌握语法
5. 网络依赖：实际功能依赖 Todoist REST API，离线场景不可用

适合人群

• 命令行重度用户：习惯在终端管理任务的开发者、运维工程师
• 自动化脚本编写者：需要批量操作 Todoist 的 CI/CD 或定时任务场景
• 现有 Todoist 付费用户：已使用 Todoist 且希望扩展 CLI 工作流
• 隐私敏感型用户：倾向于本地工具而非 Web 界面操作

常规风险

| 风险类型 | 说明 |

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

| **供应链风险** | 实际功能依赖外部 `todoist` CLI 工具，需自行验证其安全性 |

| **凭证管理** | `TODOIST_API_TOKEN` 需安全存储，避免泄露至版本控制或日志 |

| **误操作风险** | `delete` 等命令不可逆，建议在关键操作前使用 `--json` 预览 |

| **API 限制** | 受 Todoist REST API 速率限制，批量操作可能触发限流 |