/install dida365-cli
说明:以下调用方式均以 dida365 为 CLI 入口。
安装后直接使用:
# npx(推荐)
npx dida365 \x3Ccommand> [options]
# 或全局安装后
npm install -g dida365-ai-tools
dida365 \x3Ccommand> [options]
1. 认证
使用前必须先设置 Cookie 认证。
dida365 auth cookie \x3Ctoken> # 设置 Cookie token 完成认证
dida365 auth status # 检查当前认证状态
2. 项目管理
dida365 project list # 列出所有项目
dida365 project list --json # JSON 格式输出
dida365 project show \x3CprojectId> # 查看项目详情和任务列表
dida365 project show \x3CprojectId> --json
3. 任务管理
# 创建任务
dida365 task create \x3Ctitle> -p \x3CprojectId>
dida365 task create \x3Ctitle> -p \x3CprojectId> -c \x3Ccontent> --priority \x3C0|1|3|5> -d \x3CdueDate>
# 查看任务
dida365 task show \x3CtaskId>
dida365 task show \x3CtaskId> --json
# 更新任务
dida365 task update \x3CtaskId> -p \x3CprojectId> -t \x3CnewTitle>
dida365 task update \x3CtaskId> -p \x3CprojectId> -c \x3Ccontent> --priority \x3C0|1|3|5> -d \x3CdueDate>
# 完成任务
dida365 task complete \x3CprojectId> \x3CtaskId>
# 删除任务(危险操作,删除前需确认)
dida365 task delete \x3CprojectId> \x3CtaskId>
参数说明:
-p, --project \x3CprojectId>— 项目 ID(必填)-t, --title \x3Ctitle>— 任务标题(update 时可选)-c, --content \x3Ccontent>— 任务内容-d, --due \x3Cdate>— 截止日期(ISO 8601)--priority \x3Cn>— 优先级:0=无, 1=低, 3=中, 5=高-j, --json— JSON 格式输出
4. 已完成任务查询
dida365 completed today # 今天完成的
dida365 completed yesterday # 昨天完成的
dida365 completed week # 本周完成的
dida365 completed date \x3CYYYY-MM-DD> # 指定日期
dida365 completed range \x3CstartDate> \x3CendDate> # 日期范围
dida365 completed today --timezone "Asia/Shanghai" # 指定时区
dida365 completed today --json # JSON 输出
5. 全量同步与用户设置
dida365 sync all # 一次拉取所有项目、任务、标签、文件夹
dida365 sync all --json
dida365 sync settings # 查看用户设置(时区、日期格式等)
dida365 sync settings --json
dida365 sync timezone # 快速获取用户时区
sync all 返回的数据结构:
projects— 项目列表tasks— 所有未完成任务tags— 标签列表projectGroups— 项目文件夹inboxId— 收件箱项目 ID
6. 标签管理
dida365 tag list # 列出所有标签
dida365 tag list --json
dida365 tag create \x3Cname> # 创建标签
dida365 tag create \x3Cname> --color "#ff0000" --parent \x3CparentTag>
dida365 tag rename \x3ColdName> \x3CnewName> # 重命名
dida365 tag color \x3Cname> \x3Ccolor> # 修改颜色
dida365 tag nest \x3Cname> \x3CparentTag> # 设置父标签(层级关系)
dida365 tag merge \x3CfromTag> \x3CtoTag> # 合并标签(fromTag 任务归入 toTag)
dida365 tag delete \x3Cname1> [name2...] # 删除(支持多个)
7. 批量操作
任务批量操作
# 移动任务到其他项目
dida365 batch move-task \x3CtaskId> \x3CfromProjectId> \x3CtoProjectId>
# 设置子任务关系
dida365 batch set-subtask \x3CtaskId> \x3CparentId> \x3CprojectId>
# 批量删除任务(格式:taskId:projectId)
dida365 batch delete-tasks \x3CtaskId1:projectId1> [taskId2:projectId2 ...]
项目批量操作
dida365 batch create-project \x3Cname> # 创建项目
dida365 batch create-project \x3Cname> --color "#ff0000" --group \x3CgroupId> --view kanban
dida365 batch delete-projects \x3CprojectId1> [projectId2 ...] # 危险,需确认
项目文件夹操作
dida365 batch create-folder \x3Cname> # 创建文件夹
dida365 batch delete-folders \x3CgroupId1> [groupId2 ...]
Dida365 概念模型
- Project:项目,任务的容器。
- 常用字段:
id,name,color,viewMode(list/kanban/timeline),kind(TASK/NOTE),groupId,closed,permission,sortOrder
- 常用字段:
- Task:任务,隶属于某个 Project。
- 常用字段:
id,projectId,title,content,desc,tags,priority(0/1/3/5),status(0=未完成,2=已完成),startDate,dueDate,timeZone,reminders,repeatFlag,items(子任务),completedTime,parentId
- 常用字段:
- SubTask / ChecklistItem:子任务。
- 常用字段:
id,title,status(0/1),completedTime,sortOrder
- 常用字段:
- Tag:标签,可嵌套。
- 常用字段:
name,color,parent,sortOrder,sortType
- 常用字段:
- ProjectGroup:项目文件夹,用于组织项目。
- 常用字段:
id,name,sortOrder
- 常用字段:
- Column:看板列,用于 kanban 视图。
- 常用字段:
id,projectId,name,sortOrder
- 常用字段:
私有 API 端点参考
以下端点基于 https://api.dida365.com/api/v2,非官方,可能随时变更:
| HTTP | Endpoint | 功能 |
|---|---|---|
| GET | /user/preferences/settings |
用户设置 |
| GET | /batch/check/0 |
全量同步 |
| GET | /project/all/completed?from=&to=&limit= |
按日期查询已完成任务 |
| POST | /batch/task |
批量任务操作 |
| POST | /batch/taskParent |
设置子任务关系 |
| POST | /batch/taskProject |
移动任务 |
| POST | /batch/project |
批量项目操作 |
| POST | /batch/projectGroup |
项目文件夹操作 |
| POST | /batch/tag |
批量标签操作 |
| PUT | /tag/rename |
重命名标签 |
| PUT | /tag/merge |
合并标签 |
| DELETE | /tag?name= |
删除标签 |
为什么不用 Open API
Dida365 提供了 Open API,但其功能是私有 API 的子集,且需要注册开发者应用。本项目选择使用私有 API + Cookie 认证,覆盖更全面、配置更简单。
资源
- 项目源码:GitHub
- 私有 API 实现参考:ticktick-py
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install dida365-cli - After installation, invoke the skill by name or use
/dida365-cli - Provide required inputs per the skill's parameter spec and get structured output
What is Dida365 Cli?
使用 Node.js CLI 管理滴答清单(Dida365)的任务、项目、标签等,支持已完成任务按日期查询、全量同步、标签管理、批量操作等,适用于日常任务管理与自动化场景。 It is an AI Agent Skill for Claude Code / OpenClaw, with 1020 downloads so far.
How do I install Dida365 Cli?
Run "/install dida365-cli" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Dida365 Cli free?
Yes, Dida365 Cli is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Dida365 Cli support?
Dida365 Cli is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Dida365 Cli?
It is built and maintained by oymy (@oymy); the current version is v3.0.3.