@krodak/clickup-cli 1.38.1 → 1.38.3

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.38.1",
+  "version": "1.38.3",
   "author": {
     "name": "Krzysztof Rodak"
   },

package/dist/index.js

@@ -291,6 +291,24 @@ var ClickUpClient = class {
   async getTask(taskId) {
     return this.request(this.taskPath(taskId, "?include_markdown_description=true"));
   }
+  /**
+   * Resolve any accepted task-id form to a native ClickUp task id.
+   * - Task URLs are reduced to their id segment.
+   * - Workspace custom ids (e.g. PROD-811) are resolved to the native id via GET.
+   * - Native ids pass through without an API call.
+   *
+   * Use this for task ids that appear in request bodies, query params, or
+   * secondary path segments, where ClickUp's custom_task_ids handling
+   * (applied by taskPath to the primary path id) does not reach.
+   */
+  async resolveTaskId(input) {
+    const normalized = normalizeTaskId(input);
+    if (isCustomTaskId(normalized) && this.teamId) {
+      const task = await this.getTask(normalized);
+      return task.id;
+    }
+    return normalized;
+  }
   async getTimeInStatus(taskId) {
     return this.request(this.taskPath(taskId, "/time_in_status"));
   }
@@ -522,19 +540,21 @@ var ClickUpClient = class {
     });
   }
   async addDependency(taskId, opts) {
+    const primary = await this.resolveTaskId(taskId);
     const body = {};
-    if (opts.dependsOn) body.depends_on = opts.dependsOn;
-    if (opts.dependencyOf) body.dependency_of = opts.dependencyOf;
-    await this.request(this.taskPath(taskId, "/dependency"), {
+    if (opts.dependsOn) body.depends_on = await this.resolveTaskId(opts.dependsOn);
+    if (opts.dependencyOf) body.dependency_of = await this.resolveTaskId(opts.dependencyOf);
+    await this.request(`/task/${primary}/dependency`, {
       method: "POST",
       body: JSON.stringify(body)
     });
   }
   async deleteDependency(taskId, opts) {
+    const primary = await this.resolveTaskId(taskId);
     const params = new URLSearchParams();
-    if (opts.dependsOn) params.set("depends_on", opts.dependsOn);
-    if (opts.dependencyOf) params.set("dependency_of", opts.dependencyOf);
-    await this.request(this.taskPath(taskId, `/dependency?${params.toString()}`), {
+    if (opts.dependsOn) params.set("depends_on", await this.resolveTaskId(opts.dependsOn));
+    if (opts.dependencyOf) params.set("dependency_of", await this.resolveTaskId(opts.dependencyOf));
+    await this.request(`/task/${primary}/dependency?${params.toString()}`, {
       method: "DELETE"
     });
   }
@@ -562,16 +582,12 @@ var ClickUpClient = class {
     });
   }
   async addTaskLink(taskId, linksTo) {
-    await this.request(
-      this.taskPath(taskId, `/link/${normalizeTaskId(linksTo)}`),
-      { method: "POST" }
-    );
+    const [a, b] = await Promise.all([this.resolveTaskId(taskId), this.resolveTaskId(linksTo)]);
+    await this.request(`/task/${a}/link/${b}`, { method: "POST" });
   }
   async deleteTaskLink(taskId, linksTo) {
-    await this.request(
-      this.taskPath(taskId, `/link/${normalizeTaskId(linksTo)}`),
-      { method: "DELETE" }
-    );
+    const [a, b] = await Promise.all([this.resolveTaskId(taskId), this.resolveTaskId(linksTo)]);
+    await this.request(`/task/${a}/link/${b}`, { method: "DELETE" });
   }
   async getListCustomFields(listId) {
     const data = await this.request(`/list/${listId}/field`);
@@ -1012,7 +1028,7 @@ var ClickUpClient = class {
       content,
       content_format: "text/md"
     };
-    if (opts?.postTitle) body.post_data = { title: opts.postTitle };
+    if (opts?.postTitle) body.title = opts.postTitle;
     return this.requestV3(this.chatChannelsPath(`/${channelId}/messages`), {
       method: "POST",
       body: JSON.stringify(body)
@@ -1062,9 +1078,11 @@ var ClickUpClient = class {
     );
   }
   async mergeTasks(taskId, mergeWithTaskIds) {
-    await this.request(this.taskPath(taskId, "/merge"), {
+    const primary = await this.resolveTaskId(taskId);
+    const mergeWith = await Promise.all(mergeWithTaskIds.map((id) => this.resolveTaskId(id)));
+    await this.request(`/task/${primary}/merge`, {
       method: "POST",
-      body: JSON.stringify({ merge_with: mergeWithTaskIds.map(normalizeTaskId) })
+      body: JSON.stringify({ merge_with: mergeWith })
     });
   }
   async updateTimeEstimatesByUser(taskId, estimates) {
@@ -2355,6 +2373,9 @@ async function updateTask(config, taskId, options, typeInput) {
   if (resolved.status !== void 0) {
     resolved.status = await resolveStatus(client, taskId, resolved.status);
   }
+  if (typeof resolved.parent === "string") {
+    resolved.parent = await client.resolveTaskId(resolved.parent);
+  }
   if (resolved.custom_item_id === void 0 && typeInput !== void 0) {
     resolved.custom_item_id = await resolveTaskType2(client, config.teamId, typeInput);
   }
@@ -2367,9 +2388,15 @@ async function createTask(config, options) {
   if (!options.name.trim()) throw new Error("Task name cannot be empty");
   const client = new ClickUpClient(config);
   let listId = options.list;
-  if (!listId && options.parent) {
-    const parentTask = await client.getTask(options.parent);
-    listId = parentTask.list.id;
+  let parentId = options.parent;
+  if (options.parent) {
+    if (!listId) {
+      const parentTask = await client.getTask(options.parent);
+      parentId = parentTask.id;
+      listId = parentTask.list.id;
+    } else {
+      parentId = await client.resolveTaskId(options.parent);
+    }
   }
   if (!listId) {
     throw new Error("Provide --list or --parent (list is auto-detected from parent task)");
@@ -2382,7 +2409,7 @@ async function createTask(config, options) {
   const payload = {
     name: options.name,
     ...options.description !== void 0 ? { markdown_content: options.description } : {},
-    ...options.parent !== void 0 ? { parent: options.parent } : {},
+    ...parentId !== void 0 ? { parent: parentId } : {},
     ...options.status !== void 0 ? { status: options.status } : {}
   };
   if (options.priority !== void 0) {
@@ -8723,7 +8750,10 @@ function buildProgram(programName = basename(process.argv[1] ?? "cup")) {
   ).option(
     "--remove-group-assignee <groupIds...>",
     "Remove group assignee (UUID or @handle, can repeat or comma-separated)"
-  ).option("--parent <taskId>", "Set parent task (makes this a subtask)").option("--archive", "Archive the task").option("--unarchive", "Unarchive the task").option("--type <type>", "Change task type (name or custom_item_id)").option("--field <nameAndValue...>", 'Set custom field: --field "Name" value').option("--json", "Force JSON output even in terminal").action(
+  ).option(
+    "--parent <taskId>",
+    "Set parent task (makes this a subtask): native id, custom id, or task URL"
+  ).option("--archive", "Archive the task").option("--unarchive", "Unarchive the task").option("--type <type>", "Change task type (name or custom_item_id)").option("--field <nameAndValue...>", 'Set custom field: --field "Name" value').option("--json", "Force JSON output even in terminal").action(
     wrapAction(
       async (taskId, opts) => {
         const config = loadConfig(getProfileName());
@@ -8783,7 +8813,10 @@ function buildProgram(programName = basename(process.argv[1] ?? "cup")) {
       }
     )
   );
-  program.command("create").description("Create a new task").option("-l, --list <listId>", 'Target list ID or "sprint:current" for active sprint').requiredOption("-n, --name <name>", "Task name").option("-d, --description <text>", "Task description (markdown supported)").option("-p, --parent <taskId>", "Parent task ID (list auto-detected from parent)").option("-s, --status <status>", "Initial status").option("--priority <level>", "Priority: urgent, high, normal, low (or 1-4)").option(
+  program.command("create").description("Create a new task").option("-l, --list <listId>", 'Target list ID or "sprint:current" for active sprint').requiredOption("-n, --name <name>", "Task name").option("-d, --description <text>", "Task description (markdown supported)").option(
+    "-p, --parent <taskId>",
+    "Parent task: native id, custom id (e.g. PROD-811), or task URL (list auto-detected)"
+  ).option("-s, --status <status>", "Initial status").option("--priority <level>", "Priority: urgent, high, normal, low (or 1-4)").option(
     "--due-date <date>",
     "Due date (YYYY-MM-DD, YYYY-MM-DDTHH:MM[:SS], or full ISO 8601 with offset)"
   ).option(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@krodak/clickup-cli",
-  "version": "1.38.1",
+  "version": "1.38.3",
   "description": "ClickUp CLI for AI agents and humans",
   "type": "module",
   "license": "MIT",

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.38.1
+# ClickUp CLI (`cup`) - skill version 1.38.3
 
 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.38.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.38.3, update with `npm install -g @krodak/clickup-cli` and refresh this skill with `cup skill`.
 
 ## Install & Configure