@krodak/clickup-cli 1.42.0 → 1.43.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.42.0",
+  "version": "1.43.0",
   "author": {
     "name": "Krzysztof Rodak"
   },

package/dist/index.js

@@ -1163,6 +1163,10 @@ var VALID_FAVORITE_TYPES = /* @__PURE__ */ new Set([
   "view",
   "task"
 ]);
+function looksLikeTaskId(value) {
+  if (/^[A-Za-z]+-\d+$/.test(value)) return true;
+  return value.length >= 6 && /^[a-z0-9]+$/i.test(value) && /\d/.test(value);
+}
 function isFilterEntry(v) {
   if (!isRecord(v)) return false;
   if (!Array.isArray(v.command)) return false;
@@ -1370,7 +1374,9 @@ function loadConfig(profileName) {
   const profile = multi.profiles[resolvedProfile];
   if (!profile) {
     const available = Object.keys(multi.profiles).join(", ");
-    throw new Error(`Profile "${resolvedProfile}" not found. Available: ${available}`);
+    throw new Error(
+      `Profile "${resolvedProfile}" not found. Available: ${available}` + (looksLikeTaskId(resolvedProfile) ? `. That looks like a task ID \u2014 note that -p is --profile, not --parent. For a subtask use: cup create --parent ${resolvedProfile} ...` : "")
+    );
   }
   const apiToken = envToken ?? profile.apiToken?.trim();
   if (!apiToken) {
@@ -3466,12 +3472,12 @@ async function runAssignedCommand(config, opts) {
 }
 
 // src/commands/open.ts
-function looksLikeTaskId(query) {
+function looksLikeTaskId2(query) {
   return /^[a-z0-9]+$/i.test(query) && query.length <= 12 || isCustomTaskId(query);
 }
 async function openTask(config, query, opts = {}) {
   const client = new ClickUpClient(config);
-  if (looksLikeTaskId(query)) {
+  if (looksLikeTaskId2(query)) {
     let task;
     try {
       task = await client.getTask(query);
@@ -3952,7 +3958,6 @@ var commandMetadata = [
       "-d",
       "--description",
       "--description-file",
-      "-p",
       "--parent",
       "-s",
       "--status",
@@ -5327,7 +5332,7 @@ ${renderZshTopLevelCommands(name)}
             '(-n --name)'{-n,--name}'[Task name]:name:' \\
             '(-d --description)'{-d,--description}'[Task description]:text:' \\
             '--description-file[Read description from a file (- for stdin)]:path:_files' \\
-            '(-p --parent)'{-p,--parent}'[Parent task ID]:task_id:' \\
+            '--parent[Parent task ID]:task_id:' \\
             '(-s --status)'{-s,--status}'[Initial status]:status:(open "in progress" "in review" done closed)' \\
             '--priority[Priority level]:priority:(urgent high normal low)' \\
             '--due-date[Due date]:date:' \\
@@ -8953,7 +8958,9 @@ function buildProgram(programName = basename(process.argv[1] ?? "cup")) {
     "--description-file <path>",
     'Read description from a file ("-" for stdin); avoids shell quoting. Mutually exclusive with -d'
   ).option(
-    "-p, --parent <taskId>",
+    // No -p short flag: it collides with the global -p, --profile and would be
+    // parsed as the profile name (see the global-option-collision test).
+    "--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>",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@krodak/clickup-cli",
-  "version": "1.42.0",
+  "version": "1.43.0",
   "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.42.0
+# ClickUp CLI (`cup`) - skill version 1.43.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.42.0, 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.43.0, update with `npm install -g @krodak/clickup-cli` and refresh this skill with `cup skill`.
 
 ## Install & Configure
 
@@ -163,7 +163,7 @@ All commands support `--help` for full flag details. All commands support `--jso
 
 | Command                                                                                                                                                                                                                                                                                                                                                | What it does                                                                                                                                                                                                                   |
 | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `cup create -n name [-l listId\|sprint:current] [-p parentId] [-d desc\|--description-file path] [-s status] [--priority p] [--due-date d] [--start-date d] [--time-estimate t] [--assignee id\|me] [--group-assignee uuid\|@handle,...] [--tags t] [--custom-item-id n] [--template id] [--field "Name" val]`                                         | Create task (`--list` accepts `sprint:current`, `--field` sets custom fields inline; `--description-file` reads markdown from a file or `-` for stdin)                                                                         |
+| `cup create -n name [-l listId\|sprint:current] [--parent parentId] [-d desc\|--description-file path] [-s status] [--priority p] [--due-date d] [--start-date d] [--time-estimate t] [--assignee id\|me] [--group-assignee uuid\|@handle,...] [--tags t] [--custom-item-id n] [--template id] [--field "Name" val]`                                   | Create task (`--list` accepts `sprint:current`, `--field` sets custom fields inline; `--description-file` reads markdown from a file or `-` for stdin)                                                                         |
 | `cup update <id> [-n name] [-d desc\|--description-file path] [-s status] [--priority p] [--due-date d\|none] [--start-date d] [--time-estimate t] [--assignee id\|me] [--remove-assignee id\|me] [--group-assignee uuid\|@handle] [--remove-group-assignee uuid\|@handle] [--parent id] [--archive] [--unarchive] [--type type] [--field "Name" val]` | Update task fields (`--description-file` reads markdown from a file or `-` for stdin)                                                                                                                                          |
 | `cup comment <id> -m text\|--message-file path [--notify-all] [--mention user]`                                                                                                                                                                                                                                                                        | Post comment (markdown auto-converted to rich text; `--message-file` reads from a file or `-` for stdin; `--mention` for real @mentions, repeatable)                                                                           |
 | `cup comment-edit <commentId> -m text\|--message-file path [--resolved] [--unresolved] [--mention user]`                                                                                                                                                                                                                                               | Edit a comment (markdown auto-converted to rich text; `--mention` for real @mentions)                                                                                                                                          |
@@ -261,6 +261,10 @@ All commands support `--help` for full flag details. All commands support `--jso
 | `-p, --profile <n>` | Use a specific profile for this command       |
 | `--json`            | Force JSON output (available on all commands) |
 
+> **`-p` is always `--profile`, never `--parent`.** Global short flags win over subcommand
+> ones, so `cup create -p <taskId>` fails with `Profile "<taskId>" not found`. Use
+> `cup create --parent <taskId>`.
+
 ## Flags & Conventions
 
 | Topic                                           | Detail                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
@@ -352,7 +356,7 @@ cup update abc123def -s "done"
 cup update abc123def --priority high --due-date 2025-03-15
 cup update abc123def --due-date 2025-03-15T14:30     # date + time (user's timezone)
 cup update abc123def --due-date 2025-03-15T14:30:00Z # UTC
-cup create -n "Fix the thing" -p abc123def
+cup create -n "Fix the thing" --parent abc123def   # -p is the global --profile, not --parent
 cup create -n "Fix bug" -l <listId> --priority urgent --tags "bug,frontend"
 cup create -n "Bug fix" -l sprint:current         # create in active sprint
 cup create -n "Q3 Roadmap" -l <listId> --custom-item-id 1