mcpField
T
ticktick-cli

ticktick-cli

github.com/dcjanus生产力25256 次安装1 天前更新
代码仓库

关于 ticktick-cli

ticktick-cli 是一个通过滴答清单 / TickTick Open API 管理任务与习惯的命令行 skill，供 Agent 执行日常清单操作。它支持项目、任务、专注记录和习惯等数据，并可输出 JSON。

主要功能

  1. 01管理项目与任务
  2. 02维护任务子项和标签
  3. 03查看专注记录
  4. 04管理习惯及打卡
  5. 05支持 JSON 输出与认证

适用场景

  1. 01查询项目及未完成任务
  2. 02创建或更新带子项的任务
  3. 03完成、移动或删除任务
  4. 04记录习惯打卡

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/dcjanus/prompts --skill ticktick-cli

安装后在 Claude Code 中输入/ticktick-cli确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

scripts/
ticktick_api_client.py
ticktick_auth.py
ticktick_cli.py

详细介绍

来自项目 README

ticktick-cli

通过本 skill 调用滴答清单 / TickTick Open API。默认中国区 Dida365；国际版只在登录时显式选择。

执行约定

  • 给 Agent 解析的输出一律加 --json，并且全局参数必须放在子命令前。
  • 删除项目或任务前先确认用户意图；delete 会真实删除远端数据。
  • 参数不确定时先查 ./scripts/ticktick_cli.py <command> --help。

认证

默认假设本地 token 有效，直接执行用户请求的操作；不要在每次操作前先跑 auth doctor。

只有命令失败且报错指向认证、token、权限、区域或 API base URL 问题时，再诊断当前本地 token：

./scripts/ticktick_cli.py --json auth doctor

确实没有 token、token 失效或用户要求重新登录时再登录：

./scripts/ticktick_cli.py auth login
  • 国际版登录用 ./scripts/ticktick_cli.py auth login --region ticktick。
  • 默认只输出授权链接，不自动打开浏览器；需要自动打开时加 --open。
  • 登录会启动 localhost callback，默认等待 5 分钟；看到链接后应尽快完成授权。
  • token 默认保存到 ~/.config/ticktick-cli/token.json，可用 TICKTICK_TOKEN_FILE 覆盖。
  • 后续命令只读本地 token 文件，并从 token 元数据推断区域和 API base URL。
  • 远程 SSH 场景下，浏览器 callback 必须能访问运行 CLI 的机器；必要时在目标机器本地登录，或自行做端口转发。

日常操作

常用命令族：

  • auth login|doctor|logout
  • project list|get|data|create|update|delete
  • task get|create|update|complete|delete|move|completed|filter
  • focus get|list|delete
  • habit list|get|create|update|checkin|checkins

常见入口：

./scripts/ticktick_cli.py --json project list
./scripts/ticktick_cli.py --json project data --project-id <project-id>
./scripts/ticktick_cli.py --json task get --project-id <project-id> --task-id <task-id>
./scripts/ticktick_cli.py --json task filter --project-id <project-id> --status 0

创建或更新 checklist 子任务：

  • 简单标题：重复传 --item。
  • 复杂字段：用 --item-json 传 JSON 数组，或传 @path 读取文件。
  • 任务标签：创建/更新任务时重复传 --tag。
  • 复杂 habit payload：用 --payload-json 传 JSON 对象，或传 @path 读取文件。

如果 JSON 文件由 Agent 为当前单次写操作临时创建，且成功后不再复用，在同一次 shell 调用中把写操作与 rm -- <明确路径> 用 && 串行执行。写操作失败时保留文件，不要 使用 ; 无条件删除，也不要用变量、通配符或目录作为清理目标。用户提供的 JSON 和 后续更新或校验仍需复用的文件不得自动清理。例如：

./scripts/ticktick_cli.py --json task create \
  --project-id <project-id> \
  --title "任务标题" \
  --item-json @/tmp/ticktick-items.json \
  && rm -- /tmp/ticktick-items.json

数据模型

  • Project：任务容器，支持 list / kanban / timeline 等视图。
  • Task：隶属于 Project，可包含时间、提醒、优先级、重复规则、标签与子任务。
  • ChecklistItem：Task 下的子任务项。
  • Column：看板列，仅在 kanban 场景常用。
  • ProjectData：项目详情聚合，包含项目、未完成任务和列信息。
  • Focus：专注/番茄钟记录。
  • Habit：习惯与打卡记录。

参考

评论

支持 Markdown