@krodak/clickup-cli 1.23.1 → 1.24.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.23.1",
+  "version": "1.24.0",
   "author": {
     "name": "Krzysztof Rodak"
   },

package/dist/index.js

@@ -551,10 +551,12 @@ var ClickUpClient = class {
   async deleteChecklist(checklistId) {
     await this.request(`/checklist/${checklistId}`, { method: "DELETE" });
   }
-  async createChecklistItem(checklistId, name) {
+  async createChecklistItem(checklistId, name, parent) {
+    const body = { name };
+    if (parent !== void 0) body.parent = parent;
     const data = await this.request(
       `/checklist/${checklistId}/checklist_item`,
-      { method: "POST", body: JSON.stringify({ name }) }
+      { method: "POST", body: JSON.stringify(body) }
     );
     return expectRecordField(
       data,
@@ -5638,9 +5640,9 @@ async function deleteChecklist(config, checklistId) {
   await client.deleteChecklist(checklistId);
   return { checklistId };
 }
-async function addChecklistItem(config, checklistId, name) {
+async function addChecklistItem(config, checklistId, name, parent) {
   const client = new ClickUpClient(config);
-  return client.createChecklistItem(checklistId, name);
+  return client.createChecklistItem(checklistId, name, parent);
 }
 async function editChecklistItem(config, checklistId, checklistItemId, updates) {
   const client = new ClickUpClient(config);
@@ -5651,31 +5653,59 @@ async function deleteChecklistItem(config, checklistId, checklistItemId) {
   await client.deleteChecklistItem(checklistId, checklistItemId);
   return { checklistId, checklistItemId };
 }
+function sortByOrder(items) {
+  return [...items].sort((a, b) => (a.orderindex ?? 0) - (b.orderindex ?? 0));
+}
+function countItems(items) {
+  let total = 0;
+  let resolved = 0;
+  for (const item of items) {
+    total++;
+    if (item.resolved) resolved++;
+    if (item.children?.length) {
+      const nested = countItems(item.children);
+      total += nested.total;
+      resolved += nested.resolved;
+    }
+  }
+  return { total, resolved };
+}
 function formatChecklists(checklists) {
   if (checklists.length === 0) return "No checklists";
   const lines = [];
+  const renderItem = (item, depth) => {
+    const indent = "  ".repeat(depth + 1);
+    const check = item.resolved ? chalk9.green("[x]") : chalk9.dim("[ ]");
+    const name = item.resolved ? chalk9.dim(item.name) : item.name;
+    const assignee = item.assignee ? chalk9.dim(` @${item.assignee.username}`) : "";
+    lines.push(`${indent}${check} ${name}${assignee}`);
+    lines.push(chalk9.dim(`${indent}    item-id: ${item.id}`));
+    for (const child of sortByOrder(item.children ?? [])) {
+      renderItem(child, depth + 1);
+    }
+  };
   for (const cl of checklists) {
-    const resolved = cl.items.filter((i) => i.resolved).length;
-    lines.push(chalk9.bold(`${cl.name} (${resolved}/${cl.items.length})`));
+    const { total, resolved } = countItems(cl.items);
+    lines.push(chalk9.bold(`${cl.name} (${resolved}/${total})`));
     lines.push(chalk9.dim(`  ID: ${cl.id}`));
-    for (const item of cl.items) {
-      const check = item.resolved ? chalk9.green("[x]") : chalk9.dim("[ ]");
-      const name = item.resolved ? chalk9.dim(item.name) : item.name;
-      const assignee = item.assignee ? chalk9.dim(` @${item.assignee.username}`) : "";
-      lines.push(`  ${check} ${name}${assignee}`);
-      lines.push(chalk9.dim(`      item-id: ${item.id}`));
-    }
+    for (const item of sortByOrder(cl.items)) renderItem(item, 0);
   }
   return lines.join("\n");
 }
 function formatChecklistsMarkdown(checklists) {
   if (checklists.length === 0) return "No checklists";
+  const renderItem = (item, depth) => {
+    const indent = "  ".repeat(depth);
+    const lines = [`${indent}- [${item.resolved ? "x" : " "}] ${item.name}`];
+    for (const child of sortByOrder(item.children ?? [])) {
+      lines.push(...renderItem(child, depth + 1));
+    }
+    return lines;
+  };
   return checklists.map((cl) => {
-    const resolved = cl.items.filter((i) => i.resolved).length;
-    const header = `### ${cl.name} (${resolved}/${cl.items.length})`;
-    const items = cl.items.map(
-      (item) => `- [${item.resolved ? "x" : " "}] ${item.name}`
-    );
+    const { total, resolved } = countItems(cl.items);
+    const header = `### ${cl.name} (${resolved}/${total})`;
+    const items = sortByOrder(cl.items).flatMap((item) => renderItem(item, 0));
     return [header, "", ...items].join("\n");
   }).join("\n\n");
 }
@@ -7435,18 +7465,23 @@ function buildProgram(programName = basename(process.argv[1] ?? "cup")) {
       }
     })
   );
-  checklistCmd.command("add-item <checklistId> <name>").description("Add an item to a checklist").option("--json", "Force JSON output even in terminal").action(
-    wrapAction(async (checklistId, name, opts) => {
-      const config = loadConfig(getProfileName());
-      const result = await addChecklistItem(config, checklistId, name);
-      if (shouldOutputJson(opts.json ?? false)) {
-        console.log(JSON.stringify(result, null, 2));
-      } else {
-        console.log(`Added item "${name}" to checklist ${checklistId}`);
+  checklistCmd.command("add-item <checklistId> <name>").description("Add an item to a checklist").option("--parent <itemId>", "Nest under a parent checklist item ID").option("--json", "Force JSON output even in terminal").action(
+    wrapAction(
+      async (checklistId, name, opts) => {
+        const config = loadConfig(getProfileName());
+        const result = await addChecklistItem(config, checklistId, name, opts.parent);
+        if (shouldOutputJson(opts.json ?? false)) {
+          console.log(JSON.stringify(result, null, 2));
+        } else {
+          console.log(`Added item "${name}" to checklist ${checklistId}`);
+        }
       }
-    })
+    )
   );
-  checklistCmd.command("edit-item <checklistId> <checklistItemId>").description("Edit a checklist item").option("--name <name>", "New item name").option("--resolved", "Mark item as resolved").option("--unresolved", "Mark item as unresolved").option("--assignee <userId>", 'Assign user by ID (use "null" to unassign)').option("--json", "Force JSON output even in terminal").action(
+  checklistCmd.command("edit-item <checklistId> <checklistItemId>").description("Edit a checklist item").option("--name <name>", "New item name").option("--resolved", "Mark item as resolved").option("--unresolved", "Mark item as unresolved").option("--assignee <userId>", 'Assign user by ID (use "null" to unassign)').option(
+    "--parent <itemId>",
+    'Reparent item under another checklist item ID (use "null" to unnest)'
+  ).option("--json", "Force JSON output even in terminal").action(
     wrapAction(
       async (checklistId, checklistItemId, opts) => {
         const config = loadConfig(getProfileName());
@@ -7457,6 +7492,9 @@ function buildProgram(programName = basename(process.argv[1] ?? "cup")) {
         if (opts.assignee !== void 0) {
           updates.assignee = opts.assignee === "null" ? null : parseOptionalNumberOption(opts.assignee, "--assignee");
         }
+        if (opts.parent !== void 0) {
+          updates.parent = opts.parent === "null" ? null : opts.parent;
+        }
         const result = await editChecklistItem(config, checklistId, checklistItemId, updates);
         if (shouldOutputJson(opts.json ?? false)) {
           console.log(JSON.stringify(result, null, 2));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@krodak/clickup-cli",
-  "version": "1.23.1",
+  "version": "1.24.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.23.1
+# ClickUp CLI (`cup`) - skill version 1.24.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.23.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.24.0, update with `npm install -g @krodak/clickup-cli` and refresh this skill with `cup skill`.
 
 ## Install & Configure
 
@@ -173,8 +173,8 @@ All commands support `--help` for full flag details. All commands support `--jso
 | `cup checklist view <id>`                                                                                                                                                                                                                                       | View checklists on a task                                                            |
 | `cup checklist create <id> <name>`                                                                                                                                                                                                                              | Create a checklist                                                                   |
 | `cup checklist delete <checklistId>`                                                                                                                                                                                                                            | Delete a checklist                                                                   |
-| `cup checklist add-item <checklistId> <name>`                                                                                                                                                                                                                   | Add item to checklist                                                                |
-| `cup checklist edit-item <checklistId> <itemId> [--name n] [--resolved] [--unresolved] [--assignee id]`                                                                                                                                                         | Edit checklist item                                                                  |
+| `cup checklist add-item <checklistId> <name> [--parent itemId]`                                                                                                                                                                                                 | Add item to checklist (nest under parent via `--parent`)                             |
+| `cup checklist edit-item <checklistId> <itemId> [--name n] [--resolved] [--unresolved] [--assignee id] [--parent itemId\|null]`                                                                                                                                 | Edit checklist item (reparent with `--parent`, use `"null"` to unnest)               |
 | `cup checklist delete-item <checklistId> <itemId>`                                                                                                                                                                                                              | Delete checklist item                                                                |
 | `cup time start <taskId> [-d desc]`                                                                                                                                                                                                                             | Start timer                                                                          |
 | `cup time stop`                                                                                                                                                                                                                                                 | Stop running timer                                                                   |
@@ -305,7 +305,9 @@ cup field abc123def --set "Story Points" 5
 cup tag abc123def --add "bug,frontend"
 cup checklist create abc123def "QA Steps"
 cup checklist add-item <clId> "Run unit tests"
+cup checklist add-item <clId> "Sub step" --parent <itemId>           # nest under parent
 cup checklist edit-item <clId> <itemId> --resolved
+cup checklist edit-item <clId> <itemId> --parent <newParent>         # reparent (use "null" to unnest)
 cup link abc123 def456
 cup attach abc123def ./screenshot.png
 cup time start abc123def -d "Working on feature"