核心用法
todoist CLI 提供对 Todoist 全功能的命令行访问，涵盖任务增删改查、项目管理、标签分类、评论及已完成任务回溯。核心工作流：
- 任务管理：
todoist add快速创建任务，支持自然语言日期（tomorrow 2pm）、优先级标记（-P 1-4）、项目归属（-p）及标签（-l）；complete/done标记完成；update动态调整截止日期与优先级；search全文检索。 - 筛选视图：默认展示今日任务，可通过
--filter组合条件（如today & p1或overdue），JSON 模式（--json）便于脚本集成。 - 项目与组织：
projects管理项目结构，sections实现看板式分栏，labels建立横向标签体系。 - 历史回溯：
completed查看近期完成记录，支持时间范围与项目过滤。
显著优点
- 原生 API 对接：直接调用 Todoist REST API，非屏幕抓取或私有协议，数据一致性与稳定性有保障。
- 开发者友好：
--json统一信封格式（{success, data, error}），stdout 可管道化处理；单二进制文件，无运行时依赖，跨平台支持。 - 效率集成：支持 stdin 管道输入（
echo | xargs todoist add），便于与 shell 脚本、Alfred/Raycast 等工具链整合。 - 自然语言解析：日期时间识别（
today 5pm、next monday）降低认知负担。
潜在缺点与局限性
- 生态规模：相比官方 Python SDK 或社区工具（如
todoist-cli其他 fork），功能迭代依赖单一维护者，长期维护存在不确定性。 - 高级功能缺失：不支持 Karma 系统、生产力趋势查看、团队协作的复杂权限管理，聚焦个人任务管理。
- Token 管理：依赖环境变量
TODOIST_API_TOKEN，多账户切换需手动重载环境或 wrapper 脚本。 - 离线能力：纯在线工具，无本地缓存与离线同步机制，网络中断时完全不可用。
适合人群
- 习惯终端工作的开发者与运维工程师
- 需要批量任务处理或自动化工作流的效率用户
- 已将 Todoist 作为核心 GTD 系统，寻求 CLI 补充的进阶用户
常规风险
- Token 泄露：API Token 存储于环境变量，多用户服务器或 CI 日志中需严格保密，泄露即等同于账户完全访问权限。
- 误操作不可逆：
delete --force无二次确认，脚本自动化时建议先 dry-run 或备份。 - Rate Limit：高频操作可能触发 Todoist API 限流，批量任务建议增加延迟或分片执行。