Microsoft To Do CLI

使用 todo 命令管理 Microsoft To Do 中的任务。

参考资料

• references/setup.md（Azure 应用注册 + OAuth 配置）

前提条件

1. 已安装 todo CLI（pip install microsoft-todo-cli）
2. 已在 Microsoft Azure 中注册应用（参见 references/setup.md）
3. 凭据已配置在 ~/.config/microsoft-todo-cli/keys.yml
4. 首次运行时将在浏览器中完成 OAuth 流程

命令

任务

# 列出任务
todo tasks --json                        # 默认列表
todo tasks Work --json                   # 指定列表
todo tasks --due-today --json            # 今日到期
todo tasks --overdue --json              # 已逾期
todo tasks --important --json            # 高优先级
todo tasks --completed --json            # 已完成任务
todo tasks --all --json                  # 所有任务

# 创建任务
todo new "任务名称" --json              # 基础创建
todo new "任务" -l Work --json           # 添加到指定列表
todo new "任务" -d tomorrow --json       # 设置截止日期
todo new "任务" -r 2h --json             # 设置提醒
todo new "任务" -d mon -r 9am --json     # 周一截止，上午 9 点提醒
todo new "任务" -I --json                # 标记为重要
todo new "任务" -R daily --json          # 每日重复
todo new "任务" -R weekly:mon,fri --json # 指定星期几重复
todo new "任务" -S "步骤 1" -S "步骤 2" --json  # 添加子任务
todo new "任务" -N "备注内容" --json      # 添加备注

# 更新任务
todo update "任务" --title "新标题" --json
todo update "任务" -d friday -I --json

# 完成 / 取消完成
todo complete "任务" --json
todo complete 0 1 2 --json               # 按索引批量操作
todo uncomplete "任务" --json

# 删除
todo rm "任务" -y --json

子任务（步骤）

todo new-step "任务" "步骤文本" --json
todo list-steps "任务" --json
todo complete-step "任务" "步骤" --json
todo uncomplete-step "任务" "步骤" --json
todo rm-step "任务" 0 --json

备注

todo note "任务" "备注内容"
todo show-note "任务"
todo clear-note "任务"

列表

todo lists --json
todo new-list "项目 X" --json
todo rename-list "旧名称" "新名称" --json
todo rm-list "项目 X" -y --json

任务标识方式

多步操作推荐使用 ID：

ID=$(todo new "任务" -l Work --json | jq -r '.id')
todo complete --id "$ID" -l Work --json

日期与时间格式

重复模式

别名

注意事项

• 所有命令请始终使用 --json 以获得结构化输出
• 执行 rm 命令时请始终使用 -y 跳过确认提示
• 使用 --id 时建议配合 -l ListName 明确列表上下文
• 首次运行将自动打开浏览器完成 OAuth 认证