用途：通过 cup 命令行读写 ClickUp 中的任务、冲刺、评论、时间记录、自定义字段、目标、Docs、Chat、视图、Webhook 与工作区结构，适合 AI 智能体或终端用户批量操作与查询。
主要能力：读取任务、子任务、评论、活动、收件箱、逾期、摘要、空间/列表/文件夹、成员、分组、字段、附件、目标与关键结果、Docs 与页面、视图、Webhook、Chat 频道与消息；写入任务创建/更新/删除、评论与回复、分配、依赖、移动、字段、标签、链接、附件、清单、计时、目标、文档、空间/列表/文件夹、视图、Webhook、Chat 及多种 bulk 批量操作。支持保存过滤器快捷方式、多配置档案、Markdown 或 JSON 输出。
使用方式：需 Node.js 22+。安装：npm install -g @krodak/clickup-cli，或 brew tap krodak/tap && brew install clickup-cli。获取以 pk_ 开头的个人 API Token 后配置：cup init --token pk_USER_TOKEN --team TEAM_ID，也可用环境变量 CU_API_TOKEN、CU_TEAM_ID。验证：cup auth。版本检查：cup --version，低于 1.46.2 时用 npm install -g @krodak/clickup-cli 更新，并用 cup skill 刷新技能。所有命令支持 --help 与 --json。
适用场景：智能体自动化任务管理、冲刺跟踪、批量更新、导出归档、工作区查询与协作操作。
限制：删除任务、列表、文件夹、空间、视图、Webhook、合并任务等为破坏性操作，非交互环境需 --confirm；ClickUp 无删除 Doc 的 API，cup doc-delete 会失败，需在界面删除；-p 始终表示 --profile，不能用于 --parent。其余细节暂未提供。