@krodak/clickup-cli 1.31.2 → 1.32.0

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "clickup-cli",
   "description": "ClickUp CLI skills for managing tasks, sprints, comments, checklists, custom fields, tags, and time tracking via the cup command",
-  "version": "1.31.2",
+  "version": "1.32.0",
   "author": {
     "name": "Krzysztof Rodak"
   },

package/dist/index.js

@@ -70,6 +70,10 @@ function expectPaginatedCollectionField(data, key, context) {
 function isCustomTaskId(id) {
   return /^[A-Z]+-\d+$/i.test(id);
 }
+function normalizeTaskId(input) {
+  const match = /^https?:\/\/app\.clickup\.com\/t\/(?:[^/?#]+\/)?([^/?#]+)/.exec(input.trim());
+  return match ? match[1] : input;
+}
 var ClickUpClient = class {
   apiToken;
   teamId;
@@ -79,15 +83,16 @@ var ClickUpClient = class {
     this.teamId = config.teamId;
   }
   taskPath(taskId, suffix = "") {
-    const base = `/task/${taskId}${suffix}`;
-    if (isCustomTaskId(taskId) && this.teamId) {
+    const normalized = normalizeTaskId(taskId);
+    const base = `/task/${normalized}${suffix}`;
+    if (isCustomTaskId(normalized) && this.teamId) {
       const sep = base.includes("?") ? "&" : "?";
       return `${base}${sep}custom_task_ids=true&team_id=${this.teamId}`;
     }
     return base;
   }
   customIdQueryParams(taskId) {
-    if (isCustomTaskId(taskId) && this.teamId) {
+    if (isCustomTaskId(normalizeTaskId(taskId)) && this.teamId) {
       return `?custom_task_ids=true&team_id=${this.teamId}`;
     }
     return "";
@@ -402,17 +407,20 @@ var ClickUpClient = class {
     );
   }
   async addTaskToList(taskId, listId) {
-    await this.request(`/list/${listId}/task/${taskId}`, { method: "POST" });
+    const normalized = normalizeTaskId(taskId);
+    await this.request(`/list/${listId}/task/${normalized}`, { method: "POST" });
   }
   async removeTaskFromList(taskId, listId) {
-    await this.request(`/list/${listId}/task/${taskId}`, { method: "DELETE" });
+    const normalized = normalizeTaskId(taskId);
+    await this.request(`/list/${listId}/task/${normalized}`, { method: "DELETE" });
   }
   async moveTaskToList(taskId, listId) {
     if (!this.teamId) {
       throw new Error("teamId is required to move a task to a new home list");
     }
+    const normalized = normalizeTaskId(taskId);
     const [task, destList] = await Promise.all([
-      this.getTask(taskId),
+      this.getTask(normalized),
       this.getListWithStatuses(listId)
     ]);
     const taskStatus = task.status.status.toLowerCase();
@@ -428,7 +436,7 @@ var ClickUpClient = class {
         destination_status: destStatus.status
       });
     }
-    await this.requestV3(`/workspaces/${this.teamId}/tasks/${taskId}/home_list/${listId}`, {
+    await this.requestV3(`/workspaces/${this.teamId}/tasks/${normalized}/home_list/${listId}`, {
       method: "PUT",
       body: JSON.stringify({ status_mappings: statusMappings })
     });
@@ -462,8 +470,9 @@ var ClickUpClient = class {
     return this.request(`/team/${this.teamId}/plan`);
   }
   async getTaskAttachments(taskId) {
+    const normalized = normalizeTaskId(taskId);
     const data = await this.requestV3(
-      `/workspaces/${this.teamId}/tasks/${taskId}/attachments`
+      `/workspaces/${this.teamId}/tasks/${normalized}/attachments`
     );
     return expectArrayField(data, "data", "task attachments");
   }
@@ -518,14 +527,16 @@ var ClickUpClient = class {
     });
   }
   async addTaskLink(taskId, linksTo) {
-    await this.request(this.taskPath(taskId, `/link/${linksTo}`), {
-      method: "POST"
-    });
+    await this.request(
+      this.taskPath(taskId, `/link/${normalizeTaskId(linksTo)}`),
+      { method: "POST" }
+    );
   }
   async deleteTaskLink(taskId, linksTo) {
-    await this.request(this.taskPath(taskId, `/link/${linksTo}`), {
-      method: "DELETE"
-    });
+    await this.request(
+      this.taskPath(taskId, `/link/${normalizeTaskId(linksTo)}`),
+      { method: "DELETE" }
+    );
   }
   async getListCustomFields(listId) {
     const data = await this.request(`/list/${listId}/field`);
@@ -1007,17 +1018,17 @@ var ClickUpClient = class {
   async mergeTasks(taskId, mergeWithTaskIds) {
     await this.request(this.taskPath(taskId, "/merge"), {
       method: "POST",
-      body: JSON.stringify({ merge_with: mergeWithTaskIds })
+      body: JSON.stringify({ merge_with: mergeWithTaskIds.map(normalizeTaskId) })
     });
   }
   async updateTimeEstimatesByUser(taskId, estimates) {
-    return this.requestV3(`/workspaces/${this.teamId}/tasks/${taskId}/time_estimates_by_user`, {
+    return this.requestV3(`/workspaces/${this.teamId}/tasks/${normalizeTaskId(taskId)}/time_estimates_by_user`, {
       method: "PATCH",
       body: JSON.stringify({ time_estimates_by_user: estimates })
     });
   }
   async replaceTimeEstimatesByUser(taskId, estimates) {
-    return this.requestV3(`/workspaces/${this.teamId}/tasks/${taskId}/time_estimates_by_user`, {
+    return this.requestV3(`/workspaces/${this.teamId}/tasks/${normalizeTaskId(taskId)}/time_estimates_by_user`, {
       method: "PUT",
       body: JSON.stringify({ time_estimates_by_user: estimates })
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@krodak/clickup-cli",
-  "version": "1.31.2",
+  "version": "1.32.0",
   "description": "ClickUp CLI for AI agents and humans",
   "type": "module",
   "license": "MIT",
@@ -46,7 +46,7 @@
   "dependencies": {
     "@inquirer/prompts": "^8.3.0",
     "chalk": "^5.6.2",
-    "commander": "^14.0.3"
+    "commander": "^15.0.0"
   },
   "engines": {
     "node": ">=22.0.0"

package/skills/clickup-cli/SKILL.md

@@ -3,11 +3,11 @@ name: clickup
 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.'
 ---
 
-# ClickUp CLI (`cup`) - skill version 1.31.2
+# ClickUp CLI (`cup`) - skill version 1.32.0
 
 Reference for AI agents using the `cup` CLI tool. Covers task management, sprint tracking, comments, time tracking, custom fields, goals, docs, and project workflows.
 
-> **Version check:** Run `cup --version`. If your installed version is older than 1.31.2, update with `npm install -g @krodak/clickup-cli` and refresh this skill with `cup skill`.
+> **Version check:** Run `cup --version`. If your installed version is older than 1.32.0, update with `npm install -g @krodak/clickup-cli` and refresh this skill with `cup skill`.
 
 ## Install & Configure
 
@@ -264,6 +264,7 @@ All commands support `--help` for full flag details. All commands support `--jso
 | Topic                    | Detail                                                                                                                                                                                                                                                                                                                                             |
 | ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | Task IDs                 | Native (`abc123def`) or custom (`PROJ-123`). Custom IDs auto-detected by `PREFIX-DIGITS` format                                                                                                                                                                                                                                                    |
+| Task URLs                | All commands that accept a task ID also accept full ClickUp URLs (`https://app.clickup.com/t/<id>` or `https://app.clickup.com/t/<workspace>/<id>`). The ID is auto-extracted                                                                                                                                                                      |
 | `--status`               | Fuzzy matching: exact > starts-with > contains. Prints match to stderr                                                                                                                                                                                                                                                                             |
 | `--priority`             | Names (`urgent`, `high`, `normal`, `low`) or numbers (1-4)                                                                                                                                                                                                                                                                                         |
 | `--due-date`             | `YYYY-MM-DD` (date only), `YYYY-MM-DDTHH:MM` (with time), or full ISO 8601 with offset. Time-of-day formats set `due_date_time: true` in ClickUp                                                                                                                                                                                                   |