mcpField
T
ticktick-cli

ticktick-cli

github.com/dcjanus生産性25256 回インストール1 日前に更新
リポジトリ

ticktick-cli について

ticktick-cli は、Agent が TickTick Open API を通じてタスクや習慣を管理するためのコマンドラインスキルです。プロジェクト、タスク、集中記録、習慣を扱い、JSON 出力にも対応します。

主な機能

  1. 01プロジェクトとタスクの管理
  2. 02チェックリスト項目とタグの編集
  3. 03集中記録の確認
  4. 04習慣とチェックインの管理
  5. 05JSON 出力と認証

活用シーン

  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 対応