Ticktick Cli
A Python CLI for automating TickTick task management through their Open API, with proper support for both the Chinese Dida365 and international versions. It handles the full lifecycle: projects, tasks, checklists, habits, and focus records. The auth flow is smart about not re-authenticating on every call, only when tokens actually fail. Useful if you're scripting task creation from other tools or need programmatic access to your lists without clicking through a UI. The documentation is thorough about execution details like using the uv shebang directly instead of wrapping it in python calls, and it warns you that delete operations are real and permanent. Remote SSH scenarios need some thought around the OAuth callback, but the token file approach keeps it straightforward for local automation.
- skills.sh installs
- 258
- GitHub stars
- 25
- last updated
- Aug 21, 2026
Install
$ npx -y skills add dcjanus/prompts --skill ticktick-cli --agent claude-codeInstalls into .claude/skills of the current project.
Files
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|logoutproject list|get|data|create|update|deletetask get|create|update|complete|delete|move|completed|filterfocus get|list|deletehabit list|get|create|update|checkin|checkins
常见入口：
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageDetails
- Repository
- github.com/dcjanus/prompts
- Categories
- Backend & APIs, Python, CLI & Terminal
- First seen
- Jun 3, 2026
Recommended
More Backend & APIs
zustand-stateexistential-birds/beagleZustand state management for React and vanilla JavaScript. Use when creating stores, using selectors, persisting state to localStorage, integrating devtools, or258skills.sh installs
jina-cligeekjourneyx/jina-cliReads web content and searches the web using Jina AI Reader API. Use when extracting content from URLs, reading social media posts (X/Twitter), or web searching255skills.sh installs
hwc-stimulus-fundamentalsthehotwireclub/hotwire_club-skillsCover Stimulus controller fundamentals: lifecycle hooks, values and valueChanged callbacks, targets and target callbacks, outlets, action parameters, keyboard e254skills.sh installs
pp-open-meteomvanhorn/printing-press-libraryEvery Open-Meteo endpoint family in one CLI — forecast, archive, marine, air quality, flood, climate, ensemble, seasonal, geocoding, elevation. Trigger phrases:253skills.sh installs
og-image-generationandrelandgraf/fullstackrecipesGenerate dynamic social preview images using Next.js file conventions and the next/og library. Server-rendered JSX images cached at build time.245skills.sh installspp-seats-aeromvanhorn/printing-press-libraryPrinting Press CLI for Seats Aero. Seats.aero Partner API for award travel availability, cached search, route lists, and trip revalidation details.241skills.sh installs