@krodak/clickup-cli 1.28.0 → 1.30.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (5) hide show
  1. package/.claude-plugin/plugin.json +1 -1
  2. package/README.md +17 -16
  3. package/dist/index.js +865 -67
  4. package/package.json +1 -1
  5. package/skills/clickup-cli/SKILL.md +21 -4
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@krodak/clickup-cli",
3
- "version": "1.28.0",
3
+ "version": "1.30.0",
4
4
  "description": "ClickUp CLI for AI agents and humans",
5
5
  "type": "module",
6
6
  "license": "MIT",
package/skills/clickup-cli/SKILL.md CHANGED
@@ -3,11 +3,11 @@ name: clickup
3
3
  description: 'Use when managing ClickUp tasks, sprints, or comments via the `cup` CLI tool. Triggers: task queries, status updates, sprint tracking, creating subtasks, posting comments, threaded replies, standup summaries, searching tasks, checking overdue items, assigning tasks, listing spaces and lists, opening tasks in browser, checking auth or config, setting custom fields, deleting tasks, managing tags, managing checklists, editing comments, task links, time tracking, attachments, file uploads, listing members, listing fields, duplicating tasks, bulk operations, goals, key results, saved filters, favorites.'
4
4
  ---
5
5
 
6
- # ClickUp CLI (`cup`) - skill version 1.28.0
6
+ # ClickUp CLI (`cup`) - skill version 1.30.0
7
7
 
8
8
  Reference for AI agents using the `cup` CLI tool. Covers task management, sprint tracking, comments, time tracking, custom fields, goals, docs, and project workflows.
9
9
 
10
- > **Version check:** Run `cup --version`. If your installed version is older than 1.28.0, update with `npm install -g @krodak/clickup-cli` and refresh this skill with `cup skill`.
10
+ > **Version check:** Run `cup --version`. If your installed version is older than 1.30.0, update with `npm install -g @krodak/clickup-cli` and refresh this skill with `cup skill`.
11
11
 
12
12
  ## Install & Configure
13
13
 
@@ -127,6 +127,9 @@ All commands support `--help` for full flag details. All commands support `--jso
127
127
  | `cup time-in-status <id>` | Show how long a task has been in each status |
128
128
  | `cup members` | Workspace members (username, ID, email) |
129
129
  | `cup fields <listId>` | Custom fields on a list (type, required, options) |
130
+ | `cup attachments <taskId>` | List attachments on a task (name, size, URL) |
131
+ | `cup task-members <taskId>` | List members with access to a task |
132
+ | `cup plan` | Show workspace plan and usage |
130
133
  | `cup tags <spaceId>` | Tags available in a space |
131
134
  | `cup goals` | Workspace goals with progress |
132
135
  | `cup key-results <goalId>` | Key results for a goal |
@@ -141,6 +144,10 @@ All commands support `--help` for full flag details. All commands support `--jso
141
144
  | `cup view <viewId>` | Get view details |
142
145
  | `cup open <query>` | Open task in browser by ID or name |
143
146
  | `cup auth` | Check authentication status |
147
+ | `cup list-comments <listId>` | Comments on a list |
148
+ | `cup view-comments <viewId>` | Comments on a view |
149
+ | `cup webhook list` | List webhooks in workspace |
150
+ | `cup shared` | Shared spaces, folders, and lists |
144
151
  | `cup chat channels [--all] [--type type]` | List chat channels |
145
152
  | `cup chat channel <id>` | Show channel details |
146
153
  | `cup chat messages <channelId> [--limit n]` | List channel messages |
@@ -169,6 +176,9 @@ All commands support `--help` for full flag details. All commands support `--jso
169
176
  | `cup link <taskId> <linksTo> [--remove]` | Link/unlink tasks |
170
177
  | `cup attach <taskId> <filePath>` | Upload file attachment |
171
178
  | `cup delete <id> [--confirm]` | Delete task (DESTRUCTIVE) |
179
+ | `cup list-delete <listId> [--confirm]` | Delete list (DESTRUCTIVE, requires --confirm in non-interactive) |
180
+ | `cup folder-delete <folderId> [--confirm]` | Delete folder (DESTRUCTIVE, requires --confirm in non-interactive) |
181
+ | `cup space-delete <spaceId> [--confirm]` | Delete space (DESTRUCTIVE, requires --confirm in non-interactive) |
172
182
  | `cup duplicate <taskId>` | Duplicate a task |
173
183
  | `cup bulk status <status> <taskIds...>` | Bulk update status |
174
184
  | `cup bulk assign <taskIds...> [--to userId\|me] [--remove userId\|me]` | Bulk assign/unassign user from tasks |
@@ -214,6 +224,13 @@ All commands support `--help` for full flag details. All commands support `--jso
214
224
  | `cup view-create <listId> <name> -t <type> [--group-by field]` | Create a view on a list |
215
225
  | `cup view-update <viewId> [-n name] [--group-by field]` | Update a view |
216
226
  | `cup view-delete <viewId> [--confirm]` | Delete a view (DESTRUCTIVE) |
227
+ | `cup list-comment <listId> -m text [--notify-all]` | Post comment on a list |
228
+ | `cup view-comment <viewId> -m text [--notify-all]` | Post comment on a view |
229
+ | `cup webhook create --url <url> --events <events> [--space\|--folder\|--list\|--task <id>]` | Create a webhook |
230
+ | `cup webhook update <webhookId> [--url u] [--events e] [--status s]` | Update a webhook |
231
+ | `cup webhook delete <webhookId> [--confirm]` | Delete a webhook (DESTRUCTIVE) |
232
+ | `cup merge <sourceTaskId> <intoTaskId> [--confirm]` | Merge task into another (DESTRUCTIVE, source deleted) |
233
+ | `cup time estimate-by-user <taskId> <userId> <duration> [--replace]` | Set per-user time estimate |
217
234
  | `cup chat send <channelId> -m <text> [--post --title t]` | Send message to channel |
218
235
  | `cup chat reply <messageId> -m <text>` | Reply to a message |
219
236
  | `cup chat react <messageId> --emoji <name>` | Add reaction |
@@ -282,7 +299,7 @@ When running in a terminal (not piped), task-listing commands (`cup tasks`, `cup
282
299
  - **Enter** to confirm and view details of selected tasks
283
300
  - After viewing details, prompted to open tasks in browser
284
301
 
285
- Other interactive prompts: sprint selection (when multiple match), workspace selection (`cup init`), agent selection (`cup skill`), destructive action confirmations (`cup delete`, `cup archive`, `cup view-delete`).
302
+ Other interactive prompts: sprint selection (when multiple match), workspace selection (`cup init`), agent selection (`cup skill`), destructive action confirmations (`cup delete`, `cup list-delete`, `cup folder-delete`, `cup space-delete`, `cup archive`, `cup view-delete`, `cup merge`, `cup webhook delete`).
286
303
 
287
304
  When piped or called with `--json`, all commands output non-interactive markdown or JSON. Agents should always use `--json` for structured data or pipe for markdown.
288
305
 
@@ -420,4 +437,4 @@ cup summary --hours 48 # wider window
420
437
 
421
438
  ## DELETE SAFETY
422
439
 
423
- IMPORTANT: Always confirm with the user before running `cup delete`. This is a destructive, irreversible operation. Even when using `--confirm` flag, verify the task ID is correct with the user first.
440
+ IMPORTANT: Always confirm with the user before running `cup delete`, `cup list-delete`, `cup folder-delete`, `cup space-delete`, `cup merge`, or `cup webhook delete`. These are destructive, irreversible operations. Even when using `--confirm` flag, verify the ID is correct with the user first.