@krodak/clickup-cli 1.5.0 → 1.5.1

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 +27 -182
  3. package/dist/index.js +1817 -1420
  4. package/package.json +2 -1
  5. package/skills/clickup-cli/SKILL.md +126 -232
package/.claude-plugin/plugin.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "clickup-cli",
3
3
  "description": "ClickUp CLI skills for managing tasks, sprints, comments, checklists, custom fields, tags, and time tracking via the cup command",
4
- "version": "1.5.0",
4
+ "version": "1.5.1",
5
5
  "author": {
6
6
  "name": "Krzysztof Rodak"
7
7
  },
package/README.md CHANGED
@@ -126,188 +126,33 @@ The skill file follows the [Agent Skills](https://agentskills.io) open standard.
126
126
 
127
127
  </details>
128
128
 
129
- ## API Coverage
130
-
131
- [Full command reference with examples and flags](docs/commands.md).
132
-
133
- Status: :white_check_mark: implemented | :construction: planned | :no_entry_sign: won't add
134
-
135
- ### Tasks
136
-
137
- | Feature | Command | Status |
138
- | -------------------- | ----------------------- | ------------------ |
139
- | List my tasks | `cup tasks` | :white_check_mark: |
140
- | Get task details | `cup task <id>` | :white_check_mark: |
141
- | Create task | `cup create` | :white_check_mark: |
142
- | Update task | `cup update <id>` | :white_check_mark: |
143
- | Delete task | `cup delete <id>` | :white_check_mark: |
144
- | Search tasks | `cup search <query>` | :white_check_mark: |
145
- | Open in browser | `cup open <query>` | :white_check_mark: |
146
- | List subtasks | `cup subtasks <id>` | :white_check_mark: |
147
- | Assign / unassign | `cup assign <id>` | :white_check_mark: |
148
- | Duplicate task | `cup duplicate <id>` | :white_check_mark: |
149
- | Create from template | `cup create --template` | :white_check_mark: |
150
- | Bulk operations | `cup bulk status` | :white_check_mark: |
151
-
152
- ### Dependencies & Relations
153
-
154
- | Feature | Command | Status |
155
- | -------------------- | -------------------------- | ------------------ |
156
- | Add dependency | `cup depend <id>` | :white_check_mark: |
157
- | Remove dependency | `cup depend <id> --remove` | :white_check_mark: |
158
- | Add/remove task link | `cup link <id> <linksTo>` | :white_check_mark: |
159
-
160
- ### Multi-list
161
-
162
- | Feature | Command | Status |
163
- | ---------------- | ------------------------ | ------------------ |
164
- | Add task to list | `cup move <id> --add` | :white_check_mark: |
165
- | Remove from list | `cup move <id> --remove` | :white_check_mark: |
166
-
167
- ### Sprints & Planning
168
-
169
- | Feature | Command | Status |
170
- | ------------------------ | ----------------------- | ------------------ |
171
- | Active sprint tasks | `cup sprint [--folder]` | :white_check_mark: |
172
- | List all sprints | `cup sprints` | :white_check_mark: |
173
- | Assigned tasks by status | `cup assigned` | :white_check_mark: |
174
- | Standup summary | `cup summary` | :white_check_mark: |
175
- | Overdue tasks | `cup overdue` | :white_check_mark: |
176
- | Recently updated | `cup inbox` | :white_check_mark: |
177
-
178
- ### Comments
179
-
180
- | Feature | Command | Status |
181
- | ------------------------ | ------------------------------------- | ------------------ |
182
- | List comments | `cup comments <id>` | :white_check_mark: |
183
- | Post comment | `cup comment <id>` | :white_check_mark: |
184
- | Edit comment | `cup comment-edit <id>` | :white_check_mark: |
185
- | Task + comments combined | `cup activity <id>` | :white_check_mark: |
186
- | Delete comment | `cup comment-delete <id>` | :white_check_mark: |
187
- | Threaded replies | `cup replies <id>` / `cup reply <id>` | :white_check_mark: |
188
-
189
- ### Checklists
190
-
191
- | Feature | Command | Status |
192
- | ---------------- | ----------------------------------------- | ------------------ |
193
- | View checklists | `cup checklist view <id>` | :white_check_mark: |
194
- | Create checklist | `cup checklist create <id> <name>` | :white_check_mark: |
195
- | Delete checklist | `cup checklist delete <id>` | :white_check_mark: |
196
- | Add item | `cup checklist add-item <id> <name>` | :white_check_mark: |
197
- | Edit item | `cup checklist edit-item <id> <itemId>` | :white_check_mark: |
198
- | Delete item | `cup checklist delete-item <id> <itemId>` | :white_check_mark: |
199
-
200
- ### Custom Fields
201
-
202
- | Feature | Command | Status |
203
- | --------------------- | ------------------------- | ------------------ |
204
- | Set field value | `cup field <id> --set` | :white_check_mark: |
205
- | Remove field value | `cup field <id> --remove` | :white_check_mark: |
206
- | List available fields | `cup fields <listId>` | :white_check_mark: |
207
-
208
- ### Tags
209
-
210
- | Feature | Command | Status |
211
- | ---------------------- | --------------------------------- | ------------------ |
212
- | Add/remove tag on task | `cup tag <id>` | :white_check_mark: |
213
- | List space tags | `cup tags <spaceId>` | :white_check_mark: |
214
- | Create space tag | `cup tag-create <spaceId> <name>` | :white_check_mark: |
215
- | Update space tag | `cup tag-update <spaceId> <name>` | :white_check_mark: |
216
- | Delete space tag | `cup tag-delete <spaceId> <name>` | :white_check_mark: |
217
-
218
- ### Time Tracking
219
-
220
- | Feature | Command | Status |
221
- | -------------- | ------------------------------ | ------------------ |
222
- | Start timer | `cup time start <id>` | :white_check_mark: |
223
- | Stop timer | `cup time stop` | :white_check_mark: |
224
- | Timer status | `cup time status` | :white_check_mark: |
225
- | Log time entry | `cup time log <id> <duration>` | :white_check_mark: |
226
- | List entries | `cup time list` | :white_check_mark: |
227
- | Update entry | `cup time update <id>` | :white_check_mark: |
228
- | Delete entry | `cup time delete <id>` | :white_check_mark: |
229
-
230
- ### Workspace
231
-
232
- | Feature | Command | Status |
233
- | -------------- | ----------------------- | ------------------ |
234
- | List spaces | `cup spaces` | :white_check_mark: |
235
- | List lists | `cup lists <spaceId>` | :white_check_mark: |
236
- | Check auth | `cup auth` | :white_check_mark: |
237
- | List folders | `cup folders <spaceId>` | :white_check_mark: |
238
- | List members | `cup members` | :white_check_mark: |
239
- | Task types | `cup task-types` | :white_check_mark: |
240
- | Task templates | `cup templates` | :white_check_mark: |
241
-
242
- ### Goals & Key Results
243
-
244
- | Feature | Command | Status |
245
- | ----------------- | ------------------------------------ | ------------------ |
246
- | List goals | `cup goals` | :white_check_mark: |
247
- | Create goal | `cup goal-create <name>` | :white_check_mark: |
248
- | Update goal | `cup goal-update <goalId>` | :white_check_mark: |
249
- | Delete goal | `cup goal-delete <goalId>` | :white_check_mark: |
250
- | List key results | `cup key-results <goalId>` | :white_check_mark: |
251
- | Create key result | `cup key-result-create <goalId> <n>` | :white_check_mark: |
252
- | Update key result | `cup key-result-update <krId>` | :white_check_mark: |
253
- | Delete key result | `cup key-result-delete <krId>` | :white_check_mark: |
254
-
255
- ### Docs
256
-
257
- | Feature | Command | Status |
258
- | ---------------- | ------------------------------------ | ------------------ |
259
- | Search docs | `cup docs [query]` | :white_check_mark: |
260
- | View doc / page | `cup doc <docId> [pageId]` | :white_check_mark: |
261
- | All page content | `cup doc-pages <docId>` | :white_check_mark: |
262
- | Create doc | `cup doc-create <title>` | :white_check_mark: |
263
- | Create page | `cup doc-page-create <docId> <name>` | :white_check_mark: |
264
- | Edit page | `cup doc-page-edit <docId> <pageId>` | :white_check_mark: |
265
- | Delete doc | `cup doc-delete <docId>` | :white_check_mark: |
266
- | Delete page | `cup doc-page-delete <docId> <pId>` | :white_check_mark: |
267
-
268
- ### Attachments
269
-
270
- | Feature | Command | Status |
271
- | ---------------- | -------------------------- | ------------------ |
272
- | Upload file | `cup attach <id> <file>` | :white_check_mark: |
273
- | List attachments | shown inline in `cup task` | :white_check_mark: |
274
-
275
- ### :no_entry_sign: Won't add
276
-
277
- | Feature | Why |
278
- | ----------------------- | --------------------------------------------------------------------------- |
279
- | Webhooks | Server-side. A CLI can't listen for events. |
280
- | OAuth flow | `cup init` already handles auth with API tokens. |
281
- | Guest/ACL | Enterprise admin. Not what you reach for in a terminal. |
282
- | Chat/DM | Use the ClickUp app. Chat doesn't belong in a CLI. |
283
- | Audit logs | Enterprise admin. |
284
- | User/group management | Too destructive for a CLI - removing someone from a workspace is permanent. |
285
- | View CRUD | Views are visual layouts. Configure them in the UI. |
286
- | List/Folder/Space CRUD | Structural changes. Set these up in the UI. |
287
- | View/List/Chat comments | API only supports task-level comments. |
288
- | User Groups | Enterprise admin feature. |
289
- | Shared Hierarchy | Enterprise admin feature. |
290
-
291
- ### API Limitations
292
-
293
- These features exist in the ClickUp UI but aren't possible through the API:
294
-
295
- | Feature | Limitation |
296
- | ------------------------- | ---------------------------------------------------------------------------------- |
297
- | Comment attachments | API only supports task-level attachments (`cup attach`), not files within comments |
298
- | @mention individual users | API provides `--notify-all` but no way to target specific users via @syntax |
299
- | Comment reactions | No API endpoint for adding or viewing reactions |
300
- | ClickUp Brain / AI | No public API |
301
- | In-comment checklists | Only task-level checklists are supported via API |
302
- | Voice notes / Video | Recording is a UI-only feature |
303
-
304
- ### Setup
305
-
306
- | Feature | Command | Status |
307
- | ----------------- | ------------------------ | ------------------ |
308
- | First-time setup | `cup init` | :white_check_mark: |
309
- | Get/set config | `cup config` | :white_check_mark: |
310
- | Shell completions | `cup completion <shell>` | :white_check_mark: |
129
+ ## What it covers
130
+
131
+ Full CRUD for the core ClickUp workflow:
132
+
133
+ **Tasks** - create, read, update, delete, duplicate, search, subtasks, assign, dependencies, links, multi-list, bulk status updates
134
+
135
+ **Comments** - post, edit, delete, threaded replies, notify all
136
+
137
+ **Docs** - list, read, create, edit, delete (v3 API)
138
+
139
+ **Time Tracking** - start/stop timer, log entries, list/update/delete history
140
+
141
+ **Checklists** - view, create, delete, add/edit/delete items
142
+
143
+ **Custom Fields** - list, set, remove values (dropdown, date, checkbox, text, etc.)
144
+
145
+ **Tags** - add/remove on tasks, space-level create/update/delete
146
+
147
+ **Goals & OKRs** - goals CRUD, key results CRUD
148
+
149
+ **Sprints** - auto-detect active sprint, flexible date parsing, config override
150
+
151
+ **Workspace** - spaces, folders, lists, members, task types, templates
152
+
153
+ **Attachments** - upload files to tasks, shown in detail views
154
+
155
+ [Full API coverage details](docs/api-coverage.md) | [Command reference](docs/commands.md)
311
156
 
312
157
  ## Output Modes
313
158