@krodak/clickup-cli 1.3.0 → 1.5.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 +45 -30
  3. package/dist/index.js +883 -33
  4. package/package.json +1 -1
  5. package/skills/clickup-cli/SKILL.md +81 -1
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@krodak/clickup-cli",
3
- "version": "1.3.0",
3
+ "version": "1.5.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
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: clickup
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.'
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.'
4
4
  ---
5
5
 
6
6
  # ClickUp CLI (`cup`)
@@ -54,9 +54,15 @@ All commands support `--help` for full flag details.
54
54
  | `cup auth [--json]` | Check authentication status |
55
55
  | `cup folders <spaceId> [--name partial] [--json]` | Folders in a space (with their lists) |
56
56
  | `cup tags <spaceId> [--json]` | List tags available in a space |
57
+ | `cup members [--json]` | List workspace members |
58
+ | `cup fields <listId> [--json]` | List custom fields for a list |
59
+ | `cup goals [--json]` | List goals in your workspace |
60
+ | `cup key-results <goalId> [--json]` | List key results for a goal |
57
61
  | `cup docs [query] [--json]` | List workspace docs (optionally filter by name) |
58
62
  | `cup doc <docId> [pageId] [--json]` | View doc metadata + page tree, or a specific page |
59
63
  | `cup doc-pages <docId> [--json]` | All pages in a doc with content |
64
+ | `cup task-types [--json]` | List custom task types in your workspace |
65
+ | `cup templates [--json]` | List task templates in your workspace |
60
66
 
61
67
  ### Write
62
68
 
@@ -93,6 +99,20 @@ All commands support `--help` for full flag details.
93
99
  | `cup doc-create <title> [-c content] [--json]` | Create a new doc |
94
100
  | `cup doc-page-create <docId> <name> [-c content] [--parent-page pageId] [--json]` | Create a page in a doc |
95
101
  | `cup doc-page-edit <docId> <pageId> [--name text] [-c content] [--json]` | Edit a doc page |
102
+ | `cup tag-create <spaceId> <name> [--fg color] [--bg color] [--json]` | Create a tag in a space |
103
+ | `cup tag-delete <spaceId> <name> [--json]` | Delete a tag from a space |
104
+ | `cup duplicate <taskId> [--json]` | Duplicate a task (read + create copy) |
105
+ | `cup bulk status <status> <taskIds...> [--json]` | Bulk update status of multiple tasks |
106
+ | `cup goal-create <name> [-d desc] [--color hex] [--json]` | Create a goal |
107
+ | `cup goal-update <goalId> [-n name] [-d desc] [--color hex] [--json]` | Update a goal |
108
+ | `cup key-result-create <goalId> <name> [--type t] [--target n] [--json]` | Create a key result on a goal |
109
+ | `cup key-result-update <keyResultId> [--progress n] [--note text] [--json]` | Update a key result |
110
+ | `cup goal-delete <goalId> [--json]` | Delete a goal |
111
+ | `cup key-result-delete <keyResultId> [--json]` | Delete a key result |
112
+ | `cup doc-delete <docId> [--json]` | Delete a doc |
113
+ | `cup doc-page-delete <docId> <pageId> [--json]` | Delete a doc page |
114
+ | `cup tag-update <spaceId> <tagName> --name <newName> [--fg c] [--bg c] [--json]` | Update a tag in a space |
115
+ | `cup create -n name -l listId --template <templateId> [--json]` | Create task from a template |
96
116
  | `cup config get <key>` / `cup config set <key> <value>` / `cup config path` | Manage CLI config (keys: apiToken, teamId, sprintFolderId) |
97
117
  | `cup completion <shell>` | Shell completions (bash/zsh/fish) |
98
118
 
@@ -127,6 +147,18 @@ All commands support `--help` for full flag details.
127
147
  | `cup open` | Tries task ID first, falls back to name search |
128
148
  | `cup checklist` | Full CRUD for task checklists: view, create, delete, add-item, edit-item, delete-item |
129
149
  | `cup tags` | List available tags in a space. Useful for discovering valid tag names before using `cup tag` |
150
+ | `cup tag-create` | Create a new tag in a space. Optional `--fg` and `--bg` for colors |
151
+ | `cup tag-delete` | Delete a tag from a space |
152
+ | `cup members` | List workspace members with username, ID, and email |
153
+ | `cup fields` | List custom fields on a list. Shows field type, required status, and dropdown options |
154
+ | `cup duplicate` | Duplicate a task. Creates a copy with name, description, priority, tags, and time estimate |
155
+ | `cup bulk status` | Update status of multiple tasks at once. Reports failures without stopping |
156
+ | `cup goals` | List goals with progress percentage and owner |
157
+ | `cup goal-create` | Create a goal with optional description and color |
158
+ | `cup goal-update` | Update goal name, description, or color |
159
+ | `cup key-results` | List key results for a goal with progress tracking |
160
+ | `cup key-result-create` | Create a key result (number or percentage type) with a target value |
161
+ | `cup key-result-update` | Update key result progress or add a note |
130
162
  | `cup time` | Track time: start/stop timer, log entries, list history, update/delete entries. Duration format: "2h", "30m", "1h30m" |
131
163
  | `cup time update` | Update a time entry description or duration |
132
164
  | `cup time delete` | Delete a time entry |
@@ -144,6 +176,14 @@ All commands support `--help` for full flag details.
144
176
  | `cup doc-create` | Create a new doc with optional initial content |
145
177
  | `cup doc-page-create` | Create a page in a doc, optionally nested under a parent page |
146
178
  | `cup doc-page-edit` | Edit a doc page name or content |
179
+ | `cup doc-delete` | Delete a doc |
180
+ | `cup doc-page-delete` | Delete a doc page |
181
+ | `cup goal-delete` | Delete a goal |
182
+ | `cup key-result-delete` | Delete a key result |
183
+ | `cup tag-update` | Rename a tag in a space, optionally update colors |
184
+ | `cup task-types` | List custom task types (useful for discovering `--custom-item-id` values) |
185
+ | `cup templates` | List task templates (useful for `cup create --template`) |
186
+ | `--template` | On `cup create`, create task from a template instead of from scratch |
147
187
  | `cup task` | Shows custom fields, checklists, attachments, dependencies, and linked tasks in detail view |
148
188
  | `cup lists` | Discovers list IDs needed for `--list` and `cup create -l` |
149
189
  | Errors | stderr with exit code 1 |
@@ -240,10 +280,50 @@ cup folders <spaceId> # folders with their lists
240
280
  cup folders <spaceId> --name "sprint" # filter folders by name
241
281
  cup lists <spaceId> # lists in a space (needs ID from cup spaces)
242
282
  cup sprints # all sprints across folders
283
+ cup members # workspace members
284
+ cup fields <listId> # custom fields on a list
243
285
  cup auth # verify token works
244
286
  cup config set sprintFolderId <id> # pin sprint detection to a folder
245
287
  ```
246
288
 
289
+ ### Bulk operations
290
+
291
+ ```bash
292
+ cup duplicate abc123 # duplicate a task
293
+ cup bulk status "done" t1 t2 t3 # mark multiple tasks done
294
+ cup tag-create <spaceId> "urgent" # create a space tag
295
+ cup tag-update <spaceId> "urgent" --name "critical" # rename a tag
296
+ cup tag-delete <spaceId> "old-tag" # delete a space tag
297
+ ```
298
+
299
+ ### Templates and task types
300
+
301
+ ```bash
302
+ cup task-types # list custom task types
303
+ cup templates # list task templates
304
+ cup create -n "Bug" -l <listId> --template <templateId> # create from template
305
+ ```
306
+
307
+ ### Delete operations
308
+
309
+ ```bash
310
+ cup goal-delete <goalId> # delete a goal
311
+ cup key-result-delete <krId> # delete a key result
312
+ cup doc-delete <docId> # delete a doc
313
+ cup doc-page-delete <docId> <pageId> # delete a doc page
314
+ ```
315
+
316
+ ### Goals and key results
317
+
318
+ ```bash
319
+ cup goals # list all goals
320
+ cup goal-create "Ship v2" -d "Release version 2"
321
+ cup goal-update g123 -n "Updated name"
322
+ cup key-results g123 # key results for a goal
323
+ cup key-result-create g123 "API coverage" --type percentage --target 80
324
+ cup key-result-update kr456 --progress 60 --note "On track"
325
+ ```
326
+
247
327
  ### Standup
248
328
 
249
329
  ```bash