核心用法
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或备份习惯 - 过滤语法复杂时可能误删批量任务，需谨慎测试过滤条件