用途:通过 todoist-cli 命令行管理 Todoist 的任务、项目、评论、提醒与活动,面向智能体场景设计,输出结构化 JSON 并带 next_actions 提示。
认证:令牌自动解析,优先读取 TODOIST_API_TOKEN 环境变量,其次读取 secrets lease todoist_api_token(agent-secrets)。
引用解析:所有 <ref> 参数支持任务名(模糊匹配)、Todoist URL、id:xxx 前缀或原始 ID;--project 也支持按名称解析。匹配不唯一时返回候选列表及 ID 报错。优先级映射:p1(最高)= API 值 4,p2=3,p3=2,p4(默认)=1。
主要能力:日常流程 today、inbox、review;搜索浏览 search、list(支持 --filter、--project、--label)、show;任务增删改查 add、complete、reopen、update、move、delete,add 支持 --due、--deadline、--project、--section、--parent、--priority、--labels、--description;评论 comments、comment-add、comment-update、comment-delete;提醒 reminders、reminder-add(--before 30m 或 --at 时间)、reminder-delete,时长格式 30m、1h、2h30m;活动与历史 activity(--since、--until、--type、--event、--project、--limit)、completed;组织 projects、sections、labels、add-project、add-section。
输出格式:成功为 {ok, command, result, next_actions},错误为 {ok:false, error};可从 result.tasks[].id 取 ID、result.count 取总数。
适用场景:晨间回顾、从对话中捕获任务、智能体与人的异步评论线程、每周回顾等。
限制:资料未提供安装方式、平台支持、收费与价格信息,暂未提供。