@krodak/clickup-cli 1.37.0 → 1.38.1

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

package/dist/index.js

@@ -2263,9 +2263,6 @@ function buildUpdatePayload(opts, timezone) {
   if (opts.archive && opts.unarchive) {
     throw new Error("Cannot use --archive and --unarchive together");
   }
-  if (opts.parent !== void 0 && opts.detach) {
-    throw new Error("Cannot use --parent and --detach together");
-  }
   const payload = {};
   if (opts.name !== void 0) {
     if (!opts.name.trim()) throw new Error("Task name cannot be empty");
@@ -2308,9 +2305,7 @@ function buildUpdatePayload(opts, timezone) {
   if (opts.timeEstimate !== void 0) {
     payload.time_estimate = parseTimeEstimate(opts.timeEstimate);
   }
-  if (opts.detach) {
-    payload.parent = null;
-  } else if (opts.parent !== void 0) {
+  if (opts.parent !== void 0) {
     payload.parent = opts.parent;
   }
   if (opts.archive) payload.archived = true;
@@ -2353,7 +2348,7 @@ async function resolveTaskType2(client, teamId, typeInput) {
 async function updateTask(config, taskId, options, typeInput) {
   if (!hasUpdateFields(options) && typeInput === void 0)
     throw new Error(
-      "Provide at least one of: --name, --description, --status, --priority, --due-date, --start-date, --time-estimate, --assignee, --remove-assignee, --group-assignee, --remove-group-assignee, --parent, --detach, --archive, --unarchive, --type"
+      "Provide at least one of: --name, --description, --status, --priority, --due-date, --start-date, --time-estimate, --assignee, --remove-assignee, --group-assignee, --remove-group-assignee, --parent, --archive, --unarchive, --type"
     );
   const client = new ClickUpClient(config);
   const resolved = { ...options };
@@ -3859,7 +3854,6 @@ var commandMetadata = [
       "--group-assignee",
       "--remove-group-assignee",
       "--parent",
-      "--detach",
       "--archive",
       "--unarchive",
       "--type",
@@ -5229,7 +5223,6 @@ ${renderZshTopLevelCommands(name)}
             '--assignee[Add assignee]:user_id:' \\
             '--remove-assignee[Remove assignee]:user_id:' \\
             '--parent[Set parent task]:task_id:' \\
-            '--detach[Remove parent task]' \\
             '--archive[Archive the task]' \\
             '--unarchive[Unarchive the task]' \\
             '--field[Set custom field]:field_name_and_value:' \\
@@ -7556,7 +7549,9 @@ async function duplicateTask(config, taskId) {
   const created = await client.createTask(task.list.id, {
     name: `${task.name} (copy)`,
     description: task.description,
-    markdown_content: task.markdown_content,
+    // getTask requests include_markdown_description=true, so the source markdown
+    // lives in markdown_description (markdown_content is always null on read).
+    markdown_content: task.markdown_description ?? task.description,
     priority: task.priority ? parsePriority(task.priority.priority.toLowerCase()) : void 0,
     tags: task.tags?.map((t) => t.name),
     time_estimate: task.time_estimate ?? void 0
@@ -8728,7 +8723,7 @@ 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("--detach", "Remove parent task (promote subtask to top-level)").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)").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());
@@ -8884,7 +8879,7 @@ function buildProgram(programName = basename(process.argv[1] ?? "cup")) {
   );
   program.command("comment <taskId>").description("Post a comment on a task").requiredOption("-m, --message <text>", "Comment text").option("--notify-all", "Notify all assignees").option(
     "--mention <user>",
-    'Mention a user (ID, email, username, or "me"). Repeatable.',
+    'Prepend an @mention (ID, email, username, or "me"), repeatable. For a mid-sentence mention, put a <@userId> token in -m instead; bare @Name is not parsed.',
     collect,
     []
   ).option("--json", "Force JSON output even in terminal").action(
@@ -8911,7 +8906,7 @@ function buildProgram(programName = basename(process.argv[1] ?? "cup")) {
   );
   program.command("comment-edit <commentId>").description("Edit an existing comment").option("-m, --message <text>", "New comment text").option("--resolved", "Mark comment as resolved").option("--unresolved", "Mark comment as unresolved").option(
     "--mention <user>",
-    'Mention a user (ID, email, username, or "me"). Repeatable.',
+    'Prepend an @mention (ID, email, username, or "me"), repeatable. For a mid-sentence mention, put a <@userId> token in -m instead; bare @Name is not parsed.',
     collect,
     []
   ).option("--json", "Force JSON output even in terminal").action(
@@ -8984,7 +8979,7 @@ function buildProgram(programName = basename(process.argv[1] ?? "cup")) {
   );
   program.command("reply <commentId>").description("Reply to a comment").requiredOption("-m, --message <text>", "Reply text").option("--notify-all", "Notify all assignees").option(
     "--mention <user>",
-    'Mention a user (ID, email, username, or "me"). Repeatable.',
+    'Prepend an @mention (ID, email, username, or "me"), repeatable. For a mid-sentence mention, put a <@userId> token in -m instead; bare @Name is not parsed.',
     collect,
     []
   ).option("--json", "Force JSON output even in terminal").action(
@@ -10824,7 +10819,7 @@ function buildProgram(programName = basename(process.argv[1] ?? "cup")) {
   );
   program.command("list-comment <listId>").description("Post a comment on a list").requiredOption("-m, --message <text>", "Comment text").option("--notify-all", "Notify all assignees").option(
     "--mention <user>",
-    'Mention a user (ID, email, username, or "me"). Repeatable.',
+    'Prepend an @mention (ID, email, username, or "me"), repeatable. For a mid-sentence mention, put a <@userId> token in -m instead; bare @Name is not parsed.',
     collect,
     []
   ).option("--json", "Force JSON output even in terminal").action(
@@ -10857,7 +10852,7 @@ function buildProgram(programName = basename(process.argv[1] ?? "cup")) {
   );
   program.command("view-comment <viewId>").description("Post a comment on a view").requiredOption("-m, --message <text>", "Comment text").option("--notify-all", "Notify all assignees").option(
     "--mention <user>",
-    'Mention a user (ID, email, username, or "me"). Repeatable.',
+    'Prepend an @mention (ID, email, username, or "me"), repeatable. For a mid-sentence mention, put a <@userId> token in -m instead; bare @Name is not parsed.',
     collect,
     []
   ).option("--json", "Force JSON output even in terminal").action(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@krodak/clickup-cli",
-  "version": "1.37.0",
+  "version": "1.38.1",
   "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.37.0
+# ClickUp CLI (`cup`) - skill version 1.38.1
 
 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.37.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.38.1, update with `npm install -g @krodak/clickup-cli` and refresh this skill with `cup skill`.
 
 ## Install & Configure
 
@@ -164,7 +164,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] [-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)                                                                                                                                           |
-| `cup update <id> [-n name] [-d desc] [-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] [--detach] [--archive] [--unarchive] [--type type] [--field "Name" val]` | Update task fields (including custom fields and group assignees)                                                                                                                                                               |
+| `cup update <id> [-n name] [-d desc] [-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 (including custom fields and group assignees)                                                                                                                                                               |
 | `cup comment <id> -m text [--notify-all] [--mention user]`                                                                                                                                                                                                                                                                               | Post comment (markdown auto-converted to rich text; `--mention` for real @mentions, repeatable)                                                                                                                                |
 | `cup comment-edit <commentId> -m text [--resolved] [--unresolved] [--mention user]`                                                                                                                                                                                                                                                      | Edit a comment (markdown auto-converted to rich text; `--mention` for real @mentions)                                                                                                                                          |
 | `cup comment-delete <commentId>` or `cup comment-delete --task <taskId> --mine [--match text]`                                                                                                                                                                                                                                           | Delete a comment by ID or delete one of your task comments                                                                                                                                                                     |