命令行掌控你的任务世界

通过OAuth2认证的TickTick命令行工具，支持任务批量操作、智能日期解析与API限流处理，适合开发者与自动化工作流。

基本信息

• 技能名称?TickTick CLI
• 中文名称?命令行掌控你的任务世界
• 作者?manuelhettich
• 分类?其他
• 版本?1.0.0
• 标签?ticktick, task-management, cli, oauth2, productivity, api-client, batch-operations, automation

使用方法

使用说明
核心功能
TickTick CLI Skill 是一款面向开发者的命令行任务管理工具，基于官方 Open API v1 构建，提供完整的 TickTick 账号操作能力。
核心用法
认证体系 ：采用标准 OAuth2 授权码模式，支持浏览器自动回调与无头服务器手动模式。令牌自动刷新机制确保长期可用性，凭证以明文形式存储于 ~/.clawdbot/credentials/ticktick-cli/config.json （权限尝试设置为 700/600）。
任务管理 ：覆盖任务全生命周期——创建（支持自然语言日期如 "in 7 days"、优先级标记、标签）、查询（按项目/状态过滤、JSON 输出）、更新、完成及废弃（won't do）。特别提供 batch-abandon 批量废弃接口，单次 API 调用可处理多任务。
项目管理 ：项目列表获取、创建（支持自定义颜色）、重命名与颜色修改，推荐使用项目 ID 而非名称以确保可靠性。
显著优点
开发者友好 ： --json 全局选项支持结构化输出，便于脚本化与 AI Agent 集成
智能解析 ：内置自然语言日期解析器（today/tomorrow/in N days/next monday）
批量效率 ：利用 TickTick 批处理端点减少 API 调用次数
自动恢复 ：令牌过期自动刷新，降低人工干预
潜在局限
凭证安全 ：OAuth 凭证以明文存储，依赖文件系统权限保护
速率限制 ：100 req/min 与 300 req/5min 的严格限流，批量操作易触发
功能边界 ：不支持专注计时、习惯追踪等高级功能；单项目任务上限 500
ID 依赖 ：批量废弃等操作要求 24 位十六进制任务 ID，无法直接通过名称操作
适合人群
开发者、自动化工程师、AI Agent 集成场景，以及偏好终端工作流的重度 TickTick 用户。
常规风险
凭证文件若权限配置失败或备份不当可能导致令牌泄露；批量操作前建议通过 lists --json 确认项目存在，避免 "Project not found" 错误。