DIDA CLI（滴答清单）

使用 TypeScript 编写的滴答清单（DIDA）命令行工具，封装 DIDA Open API v1，提供更便捷的 CLI。

安装

从源码（构建并全局 link）：

cd dida-cli
npm install
npm run build
npm link

完成后，终端中会有 dida 命令。

登录认证

推荐使用 OAuth（PKCE，无需 client secret）：

dida auth login

浏览器会打开进行授权。

认证相关子命令：

dida auth status   # 查看是否已登录
dida auth logout   # 清除本地 token

常用命令

任务

# 获取任务
dida task get <projectId> <taskId>

# 创建任务
dida task create --title "买牛奶" --project <projectId>
dida task create --title "开会" --project <projectId> --priority 5 --due-date "2026-03-10T09:00:00+0000"

# 更新任务
dida task update <taskId> --id <taskId> --project <projectId> --title "新标题"

# 完成任务
dida task complete <projectId> <taskId>

# 删除任务
dida task delete <projectId> <taskId>

# 在清单间移动任务
dida task move --from <sourceProjectId> --to <destProjectId> --task <taskId>

# 列出已完成任务
dida task completed --projects <projectId> --start-date "2026-03-01T00:00:00+0000" --end-date "2026-03-09T23:59:59+0000"

# 过滤任务
dida task filter --projects <projectId> --priority 3,5 --status 0

清单

dida project list                    # 列出清单
dida project get <projectId>         # 清单详情
dida project data <projectId>        # 清单 + 任务 + 分组
dida project create --name "工作" --color "#F18181" --view-mode list --kind TASK
dida project update <projectId> --name "新名字" --color "#4AB8A9"
dida project delete <projectId>

JSON 输出

任意命令加 --json 可输出原始 API JSON：

dida project list --json
dida task get <projectId> <taskId> --json

更多选项：dida --help 与 dida <command> --help。

API mapping

| 命令 | Endpoint | |---|---| | task get | GET /project/{projectId}/task/{taskId} | | task create | POST /task | | task update | POST /task/{taskId} | | task complete | POST /project/{projectId}/task/{taskId}/complete | | task delete | DELETE /project/{projectId}/task/{taskId} | | task move | POST /task/move | | task completed | POST /task/completed | | task filter | POST /task/filter | | project list | GET /project | | project get | GET /project/{projectId} | | project data | GET /project/{projectId}/data | | project create | POST /project | | project update | POST /project/{projectId} | | project delete | DELETE /project/{projectId} |

开发

npm install
npm run build       # 编译
npm run dev         # watch 模式
npm run type-check  # 类型检查
npm test            # 运行测试

License

MIT