用途:这是一个用于管理 Todoist 任务与项目的命令行工具(todoist-ts-cli),基于官方 TypeScript SDK。当需要查询任务、待办、提醒或提升效率时使用。
安装:需 todoist-ts-cli 0.2.0 及以上版本(以支持 --top / --order)。 npm install -g todoist-ts-cli@^0.2.0
配置:从 https://todoist.com/app/settings/integrations/developer 获取 API token,然后执行 todoist auth <your-token>,或设置环境变量 export TODOIST_API_TOKEN="your-token"。
主要能力:
- 任务查看:todoist 或 todoist today(今日任务);todoist tasks(今日+逾期);--all 查看全部;-p "Work" 按项目;-f "p1" 按过滤器;--json 输出 JSON。
- 添加任务:todoist add "Buy groceries";--due 支持自然语言(如 "tomorrow 10am"、"sunday");--priority 设置优先级;--project 指定项目;--order <n>(从 1 开始)或 --order top 指定插入位置;-l 添加标签。
- 任务管理:view <id>、done <id>、reopen <id>、update <id> --due、move <id> -p、delete <id>。
- 搜索:todoist search "meeting"。
- 项目与标签:projects、project-add、labels、label-add。
- 评论:comments <task-id>、comment <task-id> "内容"。
过滤器语法:p1–p4 优先级;today、tomorrow、overdue;@label;#project;search: 关键词。
使用示例:用户问今天要做什么,运行 todoist today;添加任务运行 todoist add "Buy milk" --due "today";标记完成先 todoist search "grocery" 找到 ID,再 todoist done <id>。
限制与说明:任务 ID 会显示在列表中;优先级 1 最高、4 最低;需自行获取并配置 API token,其余平台与定价信息暂未提供。