@krodak/clickup-cli 1.31.1 → 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.1",
+  "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 })
     });
@@ -1792,6 +1803,12 @@ function stringifyFieldValue(value) {
   if (typeof value === "number" || typeof value === "boolean") return String(value);
   return JSON.stringify(value);
 }
+function optionDisplayName(option) {
+  return option.label ?? option.name;
+}
+function dropdownOptionName(option) {
+  return option.name ?? option.label;
+}
 function formatCustomFieldValue(field) {
   if (field.value === null || field.value === void 0) return null;
   const options = field.type_config?.options;
@@ -1799,11 +1816,14 @@ function formatCustomFieldValue(field) {
     case "drop_down": {
       if (!options) return stringifyFieldValue(field.value);
       const match = options.find((o) => o.orderindex === Number(field.value));
-      return match?.name ?? stringifyFieldValue(field.value);
+      return match ? dropdownOptionName(match) ?? stringifyFieldValue(field.value) : stringifyFieldValue(field.value);
     }
     case "labels": {
       if (!Array.isArray(field.value) || !options) return stringifyFieldValue(field.value);
-      const names = field.value.map((id) => options.find((o) => o.id === id)?.name).filter((n) => n !== void 0);
+      const names = field.value.map((id) => {
+        const match = options.find((o) => o.id === id);
+        return match ? optionDisplayName(match) : void 0;
+      }).filter((n) => n !== void 0);
       return names.length > 0 ? names.join(", ") : null;
     }
     case "date": {
@@ -6330,6 +6350,15 @@ var SUPPORTED_TYPES = /* @__PURE__ */ new Set([
   "tasks",
   "users"
 ]);
+function labelOptionName(option) {
+  return option.label ?? option.name;
+}
+function dropdownOptionName2(option) {
+  return option.name ?? option.label;
+}
+function availableOptionNames(options, getOptionName) {
+  return options.map((option) => getOptionName(option) ?? option.id).join(", ");
+}
 function findFieldByName(fields, name) {
   const lower = name.toLowerCase();
   const match = fields.find((f) => f.name.toLowerCase() === lower);
@@ -6360,13 +6389,15 @@ function parseFieldValue(field, rawValue) {
       const options = field.type_config?.options;
       if (!options?.length) throw new Error("Dropdown field has no configured options");
       const lower = rawValue.toLowerCase();
-      const option = options.find((o) => o.name.toLowerCase() === lower);
+      const option = options.find((o) => dropdownOptionName2(o)?.toLowerCase() === lower);
       if (!option) {
-        const available = options.map((o) => o.name).join(", ");
+        const available = availableOptionNames(options, dropdownOptionName2);
         throw new Error(`Option "${rawValue}" not found. Available options: ${available}`);
       }
       if (option.orderindex === void 0) {
-        throw new Error(`Dropdown option "${option.name}" has no orderindex`);
+        throw new Error(
+          `Dropdown option "${dropdownOptionName2(option) ?? option.id}" has no orderindex`
+        );
       }
       return option.orderindex;
     }
@@ -6378,9 +6409,9 @@ function parseFieldValue(field, rawValue) {
       const ids = [];
       for (const name of names) {
         const lower = name.toLowerCase();
-        const option = options.find((o) => o.name.toLowerCase() === lower);
+        const option = options.find((o) => labelOptionName(o)?.toLowerCase() === lower);
         if (!option) {
-          const available = options.map((o) => o.name).join(", ");
+          const available = availableOptionNames(options, labelOptionName);
           throw new Error(`Label "${name}" not found. Available: ${available}`);
         }
         ids.push(option.id);
@@ -7223,6 +7254,9 @@ var FIELD_COLUMNS = [
   },
   { key: "options", label: "Options", maxWidth: 40 }
 ];
+function optionDisplayName2(option) {
+  return option.label ?? option.name ?? option.id;
+}
 async function listFields(config, listId) {
   const client = new ClickUpClient(config);
   return client.getListCustomFields(listId);
@@ -7234,14 +7268,14 @@ function formatFields(fields) {
     name: f.name,
     type: f.type,
     required: f.required ? "yes" : "no",
-    options: f.type_config?.options?.map((o) => o.name).join(", ") ?? ""
+    options: f.type_config?.options?.map(optionDisplayName2).join(", ") ?? ""
   }));
   return formatTable(rows, FIELD_COLUMNS);
 }
 function formatFieldsMarkdown(fields) {
   if (fields.length === 0) return "No custom fields";
   return fields.map((f) => {
-    const options = f.type_config?.options?.map((o) => o.name).join(", ");
+    const options = f.type_config?.options?.map(optionDisplayName2).join(", ");
     const optStr = options ? ` [${options}]` : "";
     return `- **${f.name}** \`${f.id}\` (${f.type})${f.required ? " - required" : ""}${optStr}`;
   }).join("\n");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@krodak/clickup-cli",
-  "version": "1.31.1",
+  "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.1
+# 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.1, 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                                                                                                                                                                                                   |