Todoist Task Manager

核心用法

Todoist CLI（todoist）是一款开源命令行工具，让用户无需离开终端即可完成 Todoist 任务的全生命周期管理。安装后配置 API Token 即可开始使用，支持任务列表查询、新增、修改、完成、删除等基础操作，并提供丰富的过滤语法（如 today、overdue、p1、@label、#Project）快速定位任务。

显著优点

1. 高效工作流：终端原生操作，配合 shell 脚本和别名可大幅提升效率，适合键盘优先用户
2. 强大过滤系统：完整支持 Todoist 官方过滤语法，支持布尔组合（& | !），复杂查询一键完成
3. 自然语言支持：todoist quick 命令支持类似 "Buy eggs tomorrow p1 #Shopping @errands" 的快速录入
4. 输出灵活：支持 CSV、彩色输出、层级缩进等多种格式，便于脚本集成
5. 跨平台：基于 Homebrew 分发，macOS/Linux 均可安装

潜在缺点与局限

• 配置门槛：需手动获取 API Token 并创建 JSON 配置文件，对非技术用户不够友好
• 本地缓存机制：需手动执行 todoist sync 同步远程变更，存在数据不一致风险
• 功能边界：不支持 Todoist 的部分高级功能（如团队协作评论、附件上传、看板视图）
• 依赖外部服务：完全依赖 Todoist 官方 API，服务中断时无法使用

适合人群

开发者、运维工程师、终端重度用户，以及希望将任务管理集成到 shell 工作流中的效率爱好者。

常规风险

• API Token 以明文存储在 ~/.config/todoist/config.json，需确保文件权限安全（建议 chmod 600）
• 误操作 delete 或 close 命令可能导致任务不可逆丢失，建议配合 --dry-run 或备份习惯
• 过滤语法复杂时可能误删批量任务，需谨慎测试过滤条件

核心用法

Todoist CLI Skill 是一份详尽的命令行工具使用手册，帮助用户通过终端高效管理 Todoist 任务。核心功能涵盖六大模块：

任务查询：支持多种过滤条件组合，包括按日期（today/tomorrow/overdue）、优先级（p1-p4）、标签（@label）、项目（#Project）筛选，还支持布尔运算组合复杂查询。

任务管理：完整覆盖增删改查生命周期——add 创建任务（支持自然语言快捷添加）、modify 修改属性、close 标记完成、delete 彻底删除。

数据同步：通过 todoist sync 保持本地缓存与云端一致，解决多端协作场景下的数据一致性问题。

输出格式：提供 --csv 脚本友好输出、--color 彩色终端、--indent 子任务缩进等多种格式选项。

显著优点

• 纯文档零风险：无任何可执行代码，仅为命令参考手册，从根本上杜绝代码注入、权限滥用等安全问题
• 权威来源：源自 GitHub 知名开源项目 sachaos/todoist（3200+ stars，180+ forks），MIT 许可证，社区活跃维护
• 功能全面：覆盖 Todoist 官方 Filter 语法，支持复杂查询表达式如 (today | overdue) & p1
• 终端原生体验：无需离开命令行即可完成全部任务操作，极客友好
• 跨平台兼容：基于标准 CLI 设计，兼容 macOS、Linux 等主流系统

潜在局限

• 依赖外部工具：需手动安装 todoist-cli（Homebrew 提供），Skill 本身不包含安装逻辑
• 需配置 API Token：首次使用需获取并配置 Todoist 开发者 Token，对非技术用户有一定门槛
• 纯文档限制：Skill 仅提供命令参考，无法直接执行命令或验证用户环境配置
• 网络依赖：所有操作需连接 Todoist 云服务，离线场景无法使用

适合人群

• 习惯终端工作流的开发者、运维工程师
• 需要批量处理任务或自动化脚本的高级用户
• 已使用 Todoist 且希望提升操作效率的现有用户
• 追求键盘驱动工作流的效率极客

常规风险

• Token 泄露风险：API Token 存储于本地明文配置文件 ~/.config/todoist/config.json，需注意文件权限保护
• 误操作不可逆：delete 命令直接永久删除任务，无回收站确认机制
• 同步冲突：多端同时修改可能导致数据冲突，需遵循先 sync 后操作的工作流