dsh-ticktick

dsh-ticktick

English | 中文

Two-way task sync with TickTick / Dida365 (滴答清单) for DeepSeek Harness, built on the official OAuth 2.0 Open API. Pull tasks across every list, create / update / complete / delete tasks, and run a one-shot dedupe sync — from the agent or the web settings panel.

Features

• Official Open API — OAuth 2.0 authorization-code flow against the TickTick / Dida365 open platform (/open/v1), with automatic token refresh on 401.
• Both regions — Dida365 (CN, default) and TickTick (international), selectable in the settings panel or via ticktick_config.
• Pull — ticktick_tasks / ticktick_sync list incomplete (or completed) tasks across all lists (the 收集箱 Inbox included, even though the Open API's project list omits it), sorted by due date, with list names.
• Push — ticktick_add creates one or more tasks (title, list by id or name — inbox / 收集箱 resolve to the Inbox, due date in ISO 8601 or bare YYYY-MM-DD, priority 0-5 or none/low/medium/high, tags, content).
• One-shot sync — ticktick_sync with direction=pull (grouped summary) or direction=push (creates missing tasks, dedupes by title within a list, Inbox included — re-running never duplicates).
• Maintenance — ticktick_update, ticktick_complete, ticktick_delete (project id optional; auto-resolved, Inbox included).
• Settings panel — Settings → TickTick: configure credentials, run the authorize flow (popup + manual code paste), refresh tokens, quick-add a task (list picker shows the Inbox first, archived lists are excluded), and complete today's tasks in place.
• Credentials and tokens persist to ~/.dsh/dsh-ticktick.json with mode 0600; ticktick_status never echoes secrets.
• System-prompt announcement so agents know when to use the plugin.

Install

# after publishing to GitHub (repo tagged with the `dsh-plugin` topic)
dsh plugin --profile web add github:zhengjy01/dsh-ticktick

# or from npm (prebuilt install, no build approval needed)
dsh plugin --profile web add dsh-ticktick

# local development
dsh plugin --profile web add link:/path/to/dsh-ticktick

Restart dsh web. The plugin needs no build step — lib/index.js is plain ESM.

Configuration

• Create an app in the open platform console: https://developer.dida365.com/docs#/openapi (CN) or https://developer.ticktick.com/manage/ (international), and register the redirect URI:

  http://127.0.0.1:3080/api/dsh-ticktick/oauth/callback
  

  (use your actual dsh web port, or set a custom redirectUri — it must match exactly.)

• Give the plugin your client_id / client_secret, either in the settings panel (Settings → TickTick) or by asking the agent:

  帮我配置滴答清单，client_id 是 xxx，client_secret 是 yyy，区域用国内版 Dida365
  

  The agent calls ticktick_config and persists the credentials.

• Authorize: click 开始授权 in the panel (or ticktick_oauth_start) and log in. The callback completes automatically; if it doesn't, paste the code back and call ticktick_oauth_finish.

From then on:

把今天滴答清单里没做完的任务同步给我          → ticktick_sync (pull)
帮我把这些任务同步到滴答清单：买牛奶、写周报   → ticktick_sync (push, dedupes)
明天下午3点提醒我开会，加到「工作」清单       → ticktick_add

The client_secret and OAuth tokens are credentials: anyone holding them can read and change your tasks. They stay in ~/.dsh/dsh-ticktick.json (mode 0600); use ticktick_config(reset: true) to clear them if they leak.

API surface

Tool	Purpose
ticktick_status	connection & authorization status
ticktick_config	set / clear clientId, clientSecret, region (cn/intl), redirectUri
ticktick_oauth_start	build the authorize URL
ticktick_oauth_finish	exchange a pasted code / redirect URL for tokens
ticktick_lists	list all lists (id + name)
ticktick_tasks	pull tasks (by list, completed flag, limit)
ticktick_add	create tasks
ticktick_update	update a task
ticktick_complete	complete a task
ticktick_delete	delete a task
ticktick_sync	pull summary / push with title dedupe

Notes

• Uses Node's built-in fetch (Node 22+) and crypto — zero runtime dependencies.
• The OAuth callback route is loopback-only and verifies the OAuth state; the remaining /api/dsh-ticktick/* routes are loopback + same-origin only.
• Not covered by the open API: smart-list filters and time-triggered reminders (reminders/repeatFlag are passed through when present, but not modeled as tool parameters).
• The web settings panel talks to the host through the loopback-only /api/dsh-ticktick route family.

License

MIT