命令行 (CLI)
atd 的 CLI 是脚本化和快速操作的主力。所有命令接受任务 id 的任意长度前缀。
bash
atd <command> [args...]命令总览
| 命令 | 作用 |
|---|---|
atd | 进入全屏 TUI（见 TUI 指南） |
atd add <inputs...> | 添加任务，可一次多个 |
atd list [query...] | 列出任务（支持过滤和 -m 排序模式） |
atd done <ids...> [--with-subtasks] | 完成任务；--with-subtasks 连同还开着的子任务一起完成 |
atd cancel <ids...> | 取消任务（保留记录，不同于删除） |
atd meeting <ids...> | 标记为会议；过了时间同样算逾期 |
atd todo <ids...> | 退回待办，并清掉等待日期 |
atd wait <ids...> [--until 日期] | 押后到指定日期（不带 --until 就是明天） |
atd reopen <ids...> | 重新打开已完成的 |
atd rm <ids...> | 删除（软删除，可撤销） |
atd edit <id> <input...> | 编辑任务 |
atd show <id> | 查看任务详情（默认字段表，--json 输出原始 JSON） |
atd preview <input...> | 预览一行输入的解析结果 |
atd projects / atd tags | 按项目 / 标签汇总未完成 / 已完成 / 逾期数 |
atd stats | 整体状况：各状态数量、逾期、今天与本周到期、重复、备注、子任务、待发提醒、近 7/30 天完成量、最紧急的五条 |
atd export [查询] -f json|csv|markdown -o 文件 | 导出任务，可带查询条件 |
atd undo | 撤销最近一次写操作 |
atd archive [days] | 归档旧任务 |
atd archive-list / atd archive list | 查看归档 |
atd restore <id> | 从归档恢复 |
atd sync [--setup <url>] | git 同步；--setup <url> 直接配置 origin 远程 |
atd sync-status | 查看同步状态 |
atd watch [--once] [--install] [--uninstall] | 提醒守护进程 |
atd snooze <id> <minutes> | 推迟提醒 |
atd hooks | 查看可用 hook |
atd config [action] [key] [value] | 查看/修改配置；config get <key> 读单个配置项 |
atd --help 现在每条命令都有说明，顶层帮助还附了一行输入语法、查询语法和示例。cancelled 和 meeting 这两个状态以前压根没有入口，现在分别有 atd cancel 和 atd meeting。
添加
bash
atd add "后天 14:00 例会 #meeting" "明天 买牛奶 不急 #生活"批量添加时一次给多个参数，每个都会被解析成一条任务。
列出
bash
atd list # 默认档位排序，按分组显示
atd list -m urgency # 换成 urgency 加权排序
atd list 报告 # 关键词过滤
atd list +工作 # 含 #工作 标签
atd list -生活 # 排除 #生活 标签
atd list status:done # 显示已完成$ atd list == 今天 == 0eeadd6a 今天 健身 == 接下来 == 60a2422e 明天 买牛奶 低 #生活 0f4e7b9f 后天 例会 #meeting 72cbb033 周一 交季度报告 高 #工作 == 无日期 == 5b64982b 3天后 取快递 隐藏(等待未到) 0 项
查询语法
list 支持完整的查询语法，见 查询语法。
完成 / 等待 / 重开
bash
atd done 0eeadd6a # 完成
atd done 0eeadd6a --with-subtasks # 连同还开着的子任务一起完成
atd wait 0eeadd6a # 押后到明天
atd wait 0eeadd6a --until 下周一 # 押后到指定日期
atd reopen 0eeadd6a # 重新打开已完成的（done/cancelled → todo）$ atd done 7043d6cf ✓ 完成 例会 $ atd reopen 7043d6cf ↩ 重新打开 例会
完成父任务时会点名报出还没完成的子任务，加 --with-subtasks 才一起完成。
取消 / 会议 / 退回待办
bash
atd cancel 22f45066 # 取消任务（保留记录，不同于删除）
atd meeting 22f45066 # 标记为会议（过了时间同样算逾期）
atd todo 22f45066 # 退回待办，并清掉等待日期删除（软删除）
删除不是真的抹掉数据，而是写入一条 tombstone 标记，为撤销和多端同步保留依据：
$ atd rm 22f45066 已删除 买牛奶和酸奶 $ atd undo 撤销删除：买牛奶和酸奶
删除父任务时会提示哪些子任务变成了孤儿。
编辑
编辑用和添加完全相同的语法，写出来的字段会覆盖，没写的字段保持原值；-due 这类写法还能清空字段（见 一行输入魔法）：
$ atd edit 22f45066 "明天 18:00 买牛奶和酸奶 #生活 @17:30" 已更新 买牛奶和酸奶
查看
bash
atd show <id> # 给人读的字段表：含备注、提醒投递状态、父子任务
atd show <id> --json # 原始 JSON
atd preview <input> # 解析结果汇总与统计
bash
atd projects # 按项目汇总未完成 / 已完成 / 逾期数
atd tags # 按标签汇总
atd stats # 整体状况atd stats 汇总各状态数量、逾期、今天与本周到期、重复、备注、子任务、待发提醒、近 7/30 天完成量和最紧急的五条。
导出
bash
atd export -f markdown -o 任务.md # 导出全部
atd export due:week -f json -o 本周.json # 可带查询条件支持 json / csv / markdown 三种格式。
撤销
每次增/删/改都记录在 undo 日志里，atd undo 回滚最近一次，可连续撤销：
bash
atd undo归档与恢复
归档把终态（done/cancelled/删除）且超过 N 天的行挪去 archive.jsonl，主文件保持轻快：
$ atd done f8aae6b7 ✓ 完成 写学习总结 $ atd archive 0 归档了 1 行 $ atd archive-list f8aae6b7 写学习总结 $ atd restore f8aae6b7 已恢复 写学习总结 $ atd list status:done == 已完成/已取消 == 76d7d504 8/30 写学习总结 [done] #学习 隐藏(等待未到) 0 项
恢复后任务保持
done状态，默认清单不显示，要用list status:done查看。
同步
bash
atd sync --setup <你的私有仓库地址> # 第一次直接配置 origin 远程，不用自己敲 git remote add
atd sync # git 同步
atd sync-status # 查看同步状态atd sync-status 输出分支、远程地址、未提交变更数、领先/落后提交数和最近一次提交，不用联网也能看。
配置远程后：
$ atd sync 远程为空：已推送并建立 master 分支 $ atd sync 同步完成（远端新变更已合并）
提醒守护进程
bash
atd watch # 前台运行，每 30 秒扫一次
atd watch --once # 只扫一轮（调试）
atd watch --install # 开机自启
atd watch --uninstall # 取消自启$ atd watch --once 提醒处理：0，发送：0，重试：0，dead-letter：0
推迟提醒
bash
atd snooze 22f45066 30 # 30 分钟
atd snooze 22f45066 2h # 2 小时推迟的是该任务最后一个未触发的提醒。
Hook
bash
atd hooks$ atd hooks 内置 hook：toast, email 用户 hook：（无）
配置
bash
atd config # 查看当前配置（敏感值打码）
atd config path # 数据目录位置
atd config get priority.mode # 读单个配置项
atd config set priority.mode urgency # 改配置
atd config set priority.urgency.overdue 20 # 任意层级的 key 都行config set 支持任意层级的 key，拼错的 key 和类型不对的值会当场报错，不会写坏配置文件。
$ atd config set priority.mode urgency 已设置 priority.mode = urgency $ atd config set agenda.date_format full 已设置 agenda.date_format = full
错误处理
命令遇到问题会给出明确错误并返回非零退出码：
$ atd show deadbeef 找不到任务：deadbeef $ atd add " " 标题不能为空