ai-todo 是一个供 AI 代理使用的命令行任务管理工具，围绕待办、进度跟踪与工作日志展开，连接 ai-todo.stringzhao.life 实现跨会话的持久化任务管理。
使用前需先检查认证状态：cat ~/.config/ai-todo/credentials.json 2>/dev/null；未认证则执行 ai-todo login；未安装则执行 npm install -g ai-todo-cli。命令从服务端动态加载，不应硬编码，首次使用前先用 ai-todo --help 与 ai-todo <command> --help 查看参数。默认输出 JSON，tasks:tree 输出树形纯文本；参数格式为 --key <value>（snake_case，如 --parent_id）；命名空间 tasks:* 用于任务操作，spaces:* 用于空间操作；退出码 0 表示成功，1 表示错误，2 表示未认证。
核心工作流要求先执行 ai-todo tasks:tree 了解任务结构，找到合适的项目空间或父任务，避免重复创建。查看任务可用 tasks:tree、tasks:list --filter today、tasks:list --filter assigned。创建任务示例：ai-todo tasks:create --title "实现支付功能" --priority P1；子任务用 --parent_id 指定父任务并可用 --tags 打标签。进度更新用 tasks:update --id <ID> --progress 20，阶段性进展配合 tasks:add-log --id <ID> --content "完成了XX"，明确完成时用 tasks:complete --id <ID>（会级联完成子任务）。在 git commit/push/deploy 后，可查找相关任务更新进度、添加日志或完成，无关联任务时建议新建记录；规划阶段可从讨论中提取事项，构建父子任务层级并按依赖设置优先级。
其适用场景包括任务与项目管理、sprint 排期、standup 日报，以及 git-tools、vercel:deploy、brainstorming 等技能的协作记录。限制方面：资料未说明服务端稳定性、并发冲突处理、数据导出或定价等具体信息，暂未提供相关说明。