核心功能
Todoist via td CLI 是由 Doist 官方维护的命令行工具,将主流任务管理器 Todoist 完整映射到终端环境。支持通过自然语言快速创建任务(如 "Call dentist tomorrow 10am p2 #Personal")、查看今日/逾期/未来日程、批量编辑优先级标签与截止日期,以及完成任务归档等全生命周期管理。
显著优点
- 官方背书:Doist 官方仓库维护,与 Todoist 生态无缝同步,数据可靠性高
- 自然语言支持:
td add支持智能解析时间、优先级、项目标签,操作效率远超 GUI - 结构化输出:
--json/--ndjson输出便于自动化脚本和 AI 工具链集成 - 零上下文切换:终端内完成从查看日程到修改任务的全流程,适合开发者工作流
- 精确引用机制:
id:<taskId>与模糊搜索双模式,兼顾批量脚本与交互式场景
潜在局限
- Node.js 依赖:需 npm 环境构建安装,对非开发环境不够友好
- 学习成本:需记忆 CLI 参数语法,新手可能依赖
--help频繁查阅 - OAuth 配置:首次使用需完成 Todoist API Token 配置,有一定初始门槛
- 无离线模式:纯云端同步,断网时无法操作(与 Todoist 本身一致)
适合人群
终端重度用户、开发者、GTD 效率极客、需批量处理任务的项目管理者,以及希望将任务管理嵌入脚本工作流的自动化爱好者。
常规风险
- 误操作覆盖:
--labels会替换而非追加现有标签,批量更新需谨慎 - 删除不可逆:
td task delete永久移除任务,建议优先用complete或归档 - 时区歧义:自然语言解析依赖 Todoist 账户时区设置,跨时区协作需注意
- Token 安全:API Token 存储于本地配置,共享环境需防范泄露风险
使用建议
建议搭配 shell alias 或 wrapper 脚本封装常用查询(如 td-today),并配合 jq 处理 JSON 输出以定制个人看板。对于高频场景,可考虑将 td 集成到 Git hooks 或 CI 流程中实现自动化任务同步。