@krodak/clickup-cli 1.27.1 → 1.29.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.27.1",
+  "version": "1.29.0",
   "author": {
     "name": "Krzysztof Rodak"
   },

package/README.md

@@ -185,8 +185,8 @@ Full CRUD for the core ClickUp workflow:
 | 🏃 **Sprints**       | Auto-detect active sprint, `sprint:current` pseudo-ID for move/create, flexible date parsing, config override, favorite sprint folders                                     |
 | ⭐ **Favorites**     | Local favorites for quick access to sprint folders, spaces, lists, folders, views, tasks                                                                                   |
 | 👁️ **Views**         | List, get, create, update, delete views on lists                                                                                                                           |
-| 🏢 **Workspace**     | Spaces, folders, lists (read + create + rename + from template), members, task types, templates                                                                            |
-| 📎 **Attachments**   | Upload files to tasks, shown in detail views                                                                                                                               |
+| 🏢 **Workspace**     | Spaces, folders, lists (full CRUD + rename + from template), members, task types, templates, plan                                                                          |
+| 📎 **Attachments**   | Upload files to tasks, list task attachments, shown in detail views                                                                                                        |
 
 [Full API coverage details](docs/api-coverage.md) | [Command reference](docs/commands.md)
 

package/dist/index.js

@@ -445,6 +445,28 @@ var ClickUpClient = class {
   async deleteTask(taskId) {
     await this.request(this.taskPath(taskId), { method: "DELETE" });
   }
+  async deleteList(listId) {
+    await this.request(`/list/${listId}`, { method: "DELETE" });
+  }
+  async deleteFolder(folderId) {
+    await this.request(`/folder/${folderId}`, { method: "DELETE" });
+  }
+  async deleteSpace(spaceId) {
+    await this.request(`/space/${spaceId}`, { method: "DELETE" });
+  }
+  async getTaskMembers(taskId) {
+    const data = await this.request(this.taskPath(taskId, "/member"));
+    return readCollectionField(data, "members", "task members");
+  }
+  async getWorkspacePlan() {
+    return this.request(`/team/${this.teamId}/plan`);
+  }
+  async getTaskAttachments(taskId) {
+    const data = await this.requestV3(
+      `/workspaces/${this.teamId}/tasks/${taskId}/attachments`
+    );
+    return expectArrayField(data, "data", "task attachments");
+  }
   async addTagToTask(taskId, tagName) {
     await this.request(this.taskPath(taskId, `/tag/${encodeURIComponent(tagName)}`), {
       method: "POST"
@@ -1993,27 +2015,54 @@ function parsePriority(value) {
   if (Number.isInteger(num) && num >= 1 && num <= 4) return num;
   throw new Error("Priority must be urgent, high, normal, low, or 1-4");
 }
+var DATE_ONLY_RE = /^\d{4}-\d{2}-\d{2}$/;
+var LOCAL_DATETIME_RE = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2})(?::(\d{2}))?$/;
+var ISO_WITH_OFFSET_RE = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(?::\d{2})?(?:\.\d+)?(?:Z|[+-]\d{2}:?\d{2})$/;
 function parseDueDate(value, timezone) {
-  if (!/^\d{4}-\d{2}-\d{2}$/.test(value)) {
-    throw new Error("Date must be in YYYY-MM-DD format");
+  if (DATE_ONLY_RE.test(value)) {
+    const parts = value.split("-").map(Number);
+    const y = parts[0];
+    const m = parts[1];
+    const d = parts[2];
+    return { ms: wallClockToMs(y, m, d, 0, 0, 0, timezone, value), hasTime: false };
+  }
+  const localMatch = LOCAL_DATETIME_RE.exec(value);
+  if (localMatch) {
+    const y = Number(localMatch[1]);
+    const m = Number(localMatch[2]);
+    const d = Number(localMatch[3]);
+    const hh = Number(localMatch[4]);
+    const mm = Number(localMatch[5]);
+    const ss = localMatch[6] !== void 0 ? Number(localMatch[6]) : 0;
+    if (hh > 23 || mm > 59 || ss > 59) {
+      throw new Error(
+        "Date must be in YYYY-MM-DD, YYYY-MM-DDTHH:MM[:SS], or full ISO 8601 format (time component out of range)"
+      );
+    }
+    return { ms: wallClockToMs(y, m, d, hh, mm, ss, timezone, value), hasTime: true };
   }
-  const parts = value.split("-").map(Number);
-  const y = parts[0];
-  const m = parts[1];
-  const d = parts[2];
+  if (ISO_WITH_OFFSET_RE.test(value)) {
+    const ms = Date.parse(value);
+    if (!isNaN(ms)) return { ms, hasTime: true };
+  }
+  throw new Error(
+    "Date must be in YYYY-MM-DD, YYYY-MM-DDTHH:MM[:SS], or full ISO 8601 format (e.g. 2025-03-15T14:30 or 2025-03-15T14:30:00+08:00)"
+  );
+}
+function wallClockToMs(year, month, day, hour, minute, second, timezone, rawValue) {
   if (timezone) {
     try {
-      const ms2 = dateToTimezoneMs(y, m, d, timezone);
+      const ms2 = wallClockToTimezoneMs(year, month, day, hour, minute, second, timezone);
       if (!isNaN(ms2)) return ms2;
     } catch {
     }
   }
-  const ms = Date.UTC(y, m - 1, d);
-  if (isNaN(ms)) throw new Error(`Invalid date: ${value}`);
+  const ms = Date.UTC(year, month - 1, day, hour, minute, second);
+  if (isNaN(ms)) throw new Error(`Invalid date: ${rawValue}`);
   return ms;
 }
-function dateToTimezoneMs(year, month, day, timezone) {
-  const approxUtc = new Date(Date.UTC(year, month - 1, day));
+function wallClockToTimezoneMs(year, month, day, hour, minute, second, timezone) {
+  const approxUtc = new Date(Date.UTC(year, month - 1, day, hour, minute, second));
   const tzStr = approxUtc.toLocaleString("en-US", {
     timeZone: timezone,
     year: "numeric",
@@ -2074,13 +2123,15 @@ function buildUpdatePayload(opts, timezone) {
     if (opts.dueDate === "none" || opts.dueDate === "clear") {
       payload.due_date = null;
     } else {
-      payload.due_date = parseDueDate(opts.dueDate, timezone);
-      payload.due_date_time = false;
+      const parsed = parseDueDate(opts.dueDate, timezone);
+      payload.due_date = parsed.ms;
+      payload.due_date_time = parsed.hasTime;
     }
   }
   if (opts.startDate !== void 0) {
-    payload.start_date = parseDueDate(opts.startDate, timezone);
-    payload.start_date_time = false;
+    const parsed = parseDueDate(opts.startDate, timezone);
+    payload.start_date = parsed.ms;
+    payload.start_date_time = parsed.hasTime;
   }
   if (opts.assignee !== void 0 || opts.removeAssignee !== void 0) {
     payload.assignees = {};
@@ -2180,12 +2231,14 @@ async function createTask(config, options) {
     payload.priority = parsePriority(options.priority);
   }
   if (options.dueDate !== void 0) {
-    payload.due_date = parseDueDate(options.dueDate, timezone);
-    payload.due_date_time = false;
+    const parsed = parseDueDate(options.dueDate, timezone);
+    payload.due_date = parsed.ms;
+    payload.due_date_time = parsed.hasTime;
   }
   if (options.startDate !== void 0) {
-    payload.start_date = parseDueDate(options.startDate, timezone);
-    payload.start_date_time = false;
+    const parsed = parseDueDate(options.startDate, timezone);
+    payload.start_date = parsed.ms;
+    payload.start_date_time = parsed.hasTime;
   }
   if (options.assignee !== void 0) {
     payload.assignees = [parseAssigneeId(options.assignee)];
@@ -3857,6 +3910,60 @@ var commandMetadata = [
     flags: ["--confirm", "--json"],
     quickReference: [{ section: "write", usage: "delete <taskId>", description: "Delete a task" }]
   },
+  {
+    name: "list-delete",
+    description: "Delete a list (requires confirmation)",
+    flags: ["--confirm", "--json"],
+    quickReference: [
+      { section: "write", usage: "list-delete <listId>", description: "Delete a list" }
+    ]
+  },
+  {
+    name: "folder-delete",
+    description: "Delete a folder (requires confirmation)",
+    flags: ["--confirm", "--json"],
+    quickReference: [
+      { section: "write", usage: "folder-delete <folderId>", description: "Delete a folder" }
+    ]
+  },
+  {
+    name: "space-delete",
+    description: "Delete a space (requires confirmation)",
+    flags: ["--confirm", "--json"],
+    quickReference: [
+      { section: "write", usage: "space-delete <spaceId>", description: "Delete a space" }
+    ]
+  },
+  {
+    name: "attachments",
+    description: "List attachments on a task",
+    flags: ["--json"],
+    quickReference: [
+      {
+        section: "read",
+        usage: "attachments <taskId>",
+        description: "List attachments on a task"
+      }
+    ]
+  },
+  {
+    name: "task-members",
+    description: "List members with access to a task",
+    flags: ["--json"],
+    quickReference: [
+      {
+        section: "read",
+        usage: "task-members <taskId>",
+        description: "List members with access to a task"
+      }
+    ]
+  },
+  {
+    name: "plan",
+    description: "Show workspace plan",
+    flags: ["--json"],
+    quickReference: [{ section: "read", usage: "plan", description: "Show workspace plan" }]
+  },
   {
     name: "tag",
     description: "Add or remove tags from a task",
@@ -6119,6 +6226,144 @@ async function deleteTaskCommand(config, taskId, opts) {
   return { taskId, deleted: true };
 }
 
+// src/commands/list-delete.ts
+async function deleteListCommand(config, listId, opts) {
+  const client = new ClickUpClient(config);
+  if (!opts.confirm) {
+    if (!isTTY()) {
+      throw new Error("Destructive operation requires --confirm flag in non-interactive mode");
+    }
+    const list = await client.getListWithStatuses(listId);
+    const { confirm: confirm3 } = await import("@inquirer/prompts");
+    const confirmed = await confirm3({
+      message: `Delete list "${list.name}" (${listId})? This cannot be undone.`,
+      default: false
+    });
+    if (!confirmed) {
+      throw new Error("Cancelled");
+    }
+  }
+  await client.deleteList(listId);
+  return { listId, deleted: true };
+}
+
+// src/commands/folder-delete.ts
+async function deleteFolderCommand(config, folderId, opts) {
+  const client = new ClickUpClient(config);
+  if (!opts.confirm) {
+    if (!isTTY()) {
+      throw new Error("Destructive operation requires --confirm flag in non-interactive mode");
+    }
+    const { confirm: confirm3 } = await import("@inquirer/prompts");
+    const confirmed = await confirm3({
+      message: `Delete folder ${folderId}? This cannot be undone.`,
+      default: false
+    });
+    if (!confirmed) {
+      throw new Error("Cancelled");
+    }
+  }
+  await client.deleteFolder(folderId);
+  return { folderId, deleted: true };
+}
+
+// src/commands/space-delete.ts
+async function deleteSpaceCommand(config, spaceId, opts) {
+  const client = new ClickUpClient(config);
+  if (!opts.confirm) {
+    if (!isTTY()) {
+      throw new Error("Destructive operation requires --confirm flag in non-interactive mode");
+    }
+    const space = await client.getSpaceWithStatuses(spaceId);
+    const { confirm: confirm3 } = await import("@inquirer/prompts");
+    const confirmed = await confirm3({
+      message: `Delete space "${space.name}" (${spaceId})? This cannot be undone.`,
+      default: false
+    });
+    if (!confirmed) {
+      throw new Error("Cancelled");
+    }
+  }
+  await client.deleteSpace(spaceId);
+  return { spaceId, deleted: true };
+}
+
+// src/commands/attachments.ts
+function formatSize(size) {
+  if (size < 1024) return `${size} B`;
+  if (size < 1048576) return `${(size / 1024).toFixed(1)} KB`;
+  return `${(size / 1048576).toFixed(1)} MB`;
+}
+var ATTACHMENT_COLUMNS = [
+  { key: "title", label: "Title", maxWidth: 40 },
+  { key: "extension", label: "Ext", maxWidth: 10 },
+  { key: "size", label: "Size", maxWidth: 10 },
+  { key: "date", label: "Date", maxWidth: 12 },
+  { key: "url", label: "URL", maxWidth: 60 }
+];
+function toRow(a) {
+  return {
+    title: a.title,
+    extension: a.extension,
+    size: formatSize(a.size),
+    date: new Date(a.date_created).toLocaleDateString(),
+    url: a.url
+  };
+}
+async function listTaskAttachments(config, taskId) {
+  const client = new ClickUpClient(config);
+  return client.getTaskAttachments(taskId);
+}
+function formatAttachmentsTable(attachments) {
+  if (attachments.length === 0) return "No attachments found";
+  const rows = attachments.map(toRow);
+  return formatTable(rows, ATTACHMENT_COLUMNS);
+}
+function formatAttachmentsMarkdown(attachments) {
+  if (attachments.length === 0) return "No attachments found";
+  return attachments.map((a) => `- **${a.title}** (${a.extension}, ${formatSize(a.size)}) \u2014 ${a.url}`).join("\n");
+}
+
+// src/commands/task-members.ts
+var TASK_MEMBER_COLUMNS = [
+  { key: "username", label: "Username", maxWidth: 25 },
+  { key: "id", label: "ID", maxWidth: 15 },
+  { key: "email", label: "Email", maxWidth: 40 }
+];
+async function listTaskMembers(config, taskId) {
+  const client = new ClickUpClient(config);
+  return client.getTaskMembers(taskId);
+}
+function formatTaskMembers(members) {
+  if (members.length === 0) return "No task members found";
+  const rows = members.map((m) => ({
+    username: m.username,
+    id: String(m.id),
+    email: m.email
+  }));
+  return formatTable(rows, TASK_MEMBER_COLUMNS);
+}
+function formatTaskMembersMarkdown(members) {
+  if (members.length === 0) return "No task members found";
+  return members.map((m) => `- **${m.username}** (${m.id}) - ${m.email}`).join("\n");
+}
+
+// src/commands/plan.ts
+import chalk9 from "chalk";
+async function getWorkspacePlanCommand(config) {
+  const client = new ClickUpClient(config);
+  return client.getWorkspacePlan();
+}
+function formatPlan(plan) {
+  return [
+    `${chalk9.bold("Plan:")}    ${plan.name}`,
+    `${chalk9.bold("Plan ID:")} ${plan.plan_id}`
+  ].join("\n");
+}
+function formatPlanMarkdown(plan) {
+  return [`**Plan:** ${plan.name}`, `**Plan ID:** ${plan.plan_id}`].join("\n");
+}
+
 // src/commands/archive.ts
 async function archiveTaskCommand(config, taskId, opts) {
   const client = new ClickUpClient(config);
@@ -6179,7 +6424,7 @@ async function manageTags(config, taskId, opts) {
 }
 
 // src/commands/checklist.ts
-import chalk9 from "chalk";
+import chalk10 from "chalk";
 async function viewChecklists(config, taskId) {
   const client = new ClickUpClient(config);
   const task = await client.getTask(taskId);
@@ -6229,19 +6474,19 @@ function formatChecklists(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}`) : "";
+    const check = item.resolved ? chalk10.green("[x]") : chalk10.dim("[ ]");
+    const name = item.resolved ? chalk10.dim(item.name) : item.name;
+    const assignee = item.assignee ? chalk10.dim(` @${item.assignee.username}`) : "";
     lines.push(`${indent}${check} ${name}${assignee}`);
-    lines.push(chalk9.dim(`${indent}    item-id: ${item.id}`));
+    lines.push(chalk10.dim(`${indent}    item-id: ${item.id}`));
     for (const child of sortByOrder(item.children ?? [])) {
       renderItem(child, depth + 1);
     }
   };
   for (const cl of checklists) {
     const { total, resolved } = countItems(cl.items);
-    lines.push(chalk9.bold(`${cl.name} (${resolved}/${total})`));
-    lines.push(chalk9.dim(`  ID: ${cl.id}`));
+    lines.push(chalk10.bold(`${cl.name} (${resolved}/${total})`));
+    lines.push(chalk10.dim(`  ID: ${cl.id}`));
     for (const item of sortByOrder(cl.items)) renderItem(item, 0);
   }
   return lines.join("\n");
@@ -6307,7 +6552,7 @@ async function deleteCommentByTaskSelection(config, taskId, options) {
 }
 
 // src/commands/replies.ts
-import chalk10 from "chalk";
+import chalk11 from "chalk";
 async function getReplies(config, commentId) {
   const client = new ClickUpClient(config);
   return client.getThreadedComments(commentId);
@@ -6323,7 +6568,7 @@ function formatReplies(replies) {
   return replies.map((r) => {
     const user = r.user?.username ?? "Unknown";
     const date = formatTimestamp(Number(r.date));
-    return `${chalk10.bold(user)} ${chalk10.dim(date)}
+    return `${chalk11.bold(user)} ${chalk11.dim(date)}
   ${r.comment_text}`;
   }).join("\n\n");
 }
@@ -6386,7 +6631,7 @@ function formatDocsMarkdown(docs) {
 }
 
 // src/commands/doc.ts
-import chalk11 from "chalk";
+import chalk12 from "chalk";
 async function getDocInfo(config, docId) {
   const client = new ClickUpClient(config);
   const [doc, pages] = await Promise.all([
@@ -6398,14 +6643,14 @@ async function getDocInfo(config, docId) {
 function formatDocInfo(doc, pages, indent = 0) {
   const lines = [];
   if (indent === 0) {
-    lines.push(`${chalk11.bold(doc.name)} ${chalk11.dim(doc.id)}`);
+    lines.push(`${chalk12.bold(doc.name)} ${chalk12.dim(doc.id)}`);
     if (pages.length === 0) {
       lines.push("  (no pages)");
     }
   }
   for (const page of pages) {
     const prefix = "  ".repeat(indent + 1);
-    lines.push(`${prefix}${page.name} ${chalk11.dim(page.id)}`);
+    lines.push(`${prefix}${page.name} ${chalk12.dim(page.id)}`);
     if (page.pages && page.pages.length > 0) {
       lines.push(formatDocInfo(doc, page.pages, indent + 1));
     }
@@ -6484,7 +6729,7 @@ async function deleteDocPage(config, docId, pageId) {
 }
 
 // src/commands/folders.ts
-import chalk12 from "chalk";
+import chalk13 from "chalk";
 async function listFolders(config, spaceId, nameFilter, archived) {
   const client = new ClickUpClient(config);
   const folders = await client.getFolders(spaceId, archived);
@@ -6503,9 +6748,9 @@ async function listFolders(config, spaceId, nameFilter, archived) {
 function formatFolders(folders) {
   if (folders.length === 0) return "No folders found";
   return folders.map((f) => {
-    const header = `${chalk12.bold(f.name)} ${chalk12.dim(f.id)}`;
+    const header = `${chalk13.bold(f.name)} ${chalk13.dim(f.id)}`;
     if (f.lists.length === 0) return header;
-    const listLines = f.lists.map((l) => `  ${chalk12.dim(">")} ${l.name} ${chalk12.dim(l.id)}`);
+    const listLines = f.lists.map((l) => `  ${chalk13.dim(">")} ${l.name} ${chalk13.dim(l.id)}`);
     return [header, ...listLines].join("\n");
   }).join("\n\n");
 }
@@ -6520,13 +6765,13 @@ function formatFoldersMarkdown(folders) {
 }
 
 // src/commands/time.ts
-import chalk13 from "chalk";
+import chalk14 from "chalk";
 var TIME_COLUMNS = [
   { key: "task", label: "Task", maxWidth: 35 },
   { key: "duration", label: "Duration", maxWidth: 10 },
   { key: "date", label: "Date", maxWidth: 20 },
   { key: "description", label: "Description", maxWidth: 30 },
-  { key: "status", label: "", maxWidth: 10, format: (v) => v === "RUNNING" ? chalk13.green(v) : "" }
+  { key: "status", label: "", maxWidth: 10, format: (v) => v === "RUNNING" ? chalk14.green(v) : "" }
 ];
 async function startTimer(config, taskId, description) {
   const client = new ClickUpClient(config);
@@ -6622,7 +6867,7 @@ function formatTimeEntriesMarkdown(entries) {
 }
 
 // src/commands/tags.ts
-import chalk14 from "chalk";
+import chalk15 from "chalk";
 var TAG_COLUMNS = [
   { key: "name", label: "Name", maxWidth: 40 },
   { key: "fg", label: "FG", maxWidth: 10 },
@@ -6655,13 +6900,13 @@ function formatTags(tags) {
   if (tags.length === 0) return "No tags found";
   if (isTTY()) {
     const rows = tags.map((t) => ({
-      name: t.tag_bg ? chalk14.bgHex(t.tag_bg).hex(t.tag_fg || "#ffffff")(` ${t.name} `) : chalk14.bold(t.name),
+      name: t.tag_bg ? chalk15.bgHex(t.tag_bg).hex(t.tag_fg || "#ffffff")(` ${t.name} `) : chalk15.bold(t.name),
       fg: t.tag_fg || "",
       bg: t.tag_bg || ""
     }));
     return formatTable(rows, TAG_COLUMNS);
   }
-  return tags.map((t) => chalk14.bold(t.name)).join(", ");
+  return tags.map((t) => chalk15.bold(t.name)).join(", ");
 }
 function formatTagsMarkdown(tags) {
   if (tags.length === 0) return "No tags found";
@@ -6696,7 +6941,7 @@ function formatMembersMarkdown(members) {
 }
 
 // src/commands/fields.ts
-import chalk15 from "chalk";
+import chalk16 from "chalk";
 var FIELD_COLUMNS = [
   { key: "id", label: "ID", maxWidth: 20 },
   { key: "name", label: "Name", maxWidth: 30 },
@@ -6705,7 +6950,7 @@ var FIELD_COLUMNS = [
     key: "required",
     label: "Required",
     maxWidth: 10,
-    format: (v) => v === "yes" ? chalk15.yellow(v) : chalk15.dim(v)
+    format: (v) => v === "yes" ? chalk16.yellow(v) : chalk16.dim(v)
   },
   { key: "options", label: "Options", maxWidth: 40 }
 ];
@@ -6804,7 +7049,13 @@ async function bulkAssign(config, userIdOrMe, taskIds, action) {
 async function bulkDueDate(config, date, taskIds) {
   const client = new ClickUpClient(config);
   const timezone = await client.getUserTimezone();
-  const payload = date === "none" || date === "clear" ? { due_date: null } : { due_date: parseDueDate(date, timezone), due_date_time: false };
+  let payload;
+  if (date === "none" || date === "clear") {
+    payload = { due_date: null };
+  } else {
+    const parsed = parseDueDate(date, timezone);
+    payload = { due_date: parsed.ms, due_date_time: parsed.hasTime };
+  }
   const outcomes = await runInBatches(
     taskIds,
     BULK_CONCURRENCY,
@@ -6857,13 +7108,13 @@ async function bulkMove(config, listId, taskIds) {
 }
 
 // src/commands/goals.ts
-import chalk16 from "chalk";
+import chalk17 from "chalk";
 function colorProgress(value) {
   const num = parseInt(value, 10);
   if (isNaN(num)) return value;
-  if (num >= 75) return chalk16.green(value);
-  if (num >= 25) return chalk16.yellow(value);
-  return chalk16.red(value);
+  if (num >= 75) return chalk17.green(value);
+  if (num >= 25) return chalk17.yellow(value);
+  return chalk17.red(value);
 }
 var GOAL_COLUMNS = [
   { key: "id", label: "ID", maxWidth: 15 },
@@ -6888,7 +7139,7 @@ async function createGoal(config, name, opts) {
   return client.createGoal(config.teamId, name, {
     description: opts?.description,
     color: opts?.color,
-    ...opts?.dueDate ? { dueDate: parseDueDate(opts.dueDate, timezone) } : {}
+    ...opts?.dueDate ? { dueDate: parseDueDate(opts.dueDate, timezone).ms } : {}
   });
 }
 async function updateGoal(config, goalId, updates) {
@@ -6957,14 +7208,14 @@ function formatKeyResultsMarkdown(keyResults) {
 }
 
 // src/commands/task-types.ts
-import chalk17 from "chalk";
+import chalk18 from "chalk";
 async function listTaskTypes(config) {
   const client = new ClickUpClient(config);
   return client.getCustomTaskTypes(config.teamId);
 }
 function formatTaskTypes(types) {
   if (types.length === 0) return "No custom task types";
-  return types.map((t) => `${chalk17.bold(t.name)} ${chalk17.dim(`(${t.id})`)}`).join("\n");
+  return types.map((t) => `${chalk18.bold(t.name)} ${chalk18.dim(`(${t.id})`)}`).join("\n");
 }
 function formatTaskTypesMarkdown(types) {
   if (types.length === 0) return "No custom task types";
@@ -6972,14 +7223,14 @@ function formatTaskTypesMarkdown(types) {
 }
 
 // src/commands/templates.ts
-import chalk18 from "chalk";
+import chalk19 from "chalk";
 async function listTemplates(config) {
   const client = new ClickUpClient(config);
   return client.getTaskTemplates(config.teamId);
 }
 function formatTemplates(templates) {
   if (templates.length === 0) return "No task templates";
-  return templates.map((t) => `${chalk18.bold(t.name)} ${chalk18.dim(`(${t.id})`)}`).join("\n");
+  return templates.map((t) => `${chalk19.bold(t.name)} ${chalk19.dim(`(${t.id})`)}`).join("\n");
 }
 function formatTemplatesMarkdown(templates) {
   if (templates.length === 0) return "No task templates";
@@ -6987,14 +7238,14 @@ function formatTemplatesMarkdown(templates) {
 }
 
 // src/commands/list-templates.ts
-import chalk19 from "chalk";
+import chalk20 from "chalk";
 async function listListTemplates(config) {
   const client = new ClickUpClient(config);
   return client.getListTemplates(config.teamId);
 }
 function formatListTemplates(templates) {
   if (templates.length === 0) return "No list templates";
-  return templates.map((t) => `${chalk19.bold(t.name)} ${chalk19.dim(`(${t.id})`)}`).join("\n");
+  return templates.map((t) => `${chalk20.bold(t.name)} ${chalk20.dim(`(${t.id})`)}`).join("\n");
 }
 function formatListTemplatesMarkdown(templates) {
   if (templates.length === 0) return "No list templates";
@@ -7002,14 +7253,14 @@ function formatListTemplatesMarkdown(templates) {
 }
 
 // src/commands/folder-templates.ts
-import chalk20 from "chalk";
+import chalk21 from "chalk";
 async function listFolderTemplates(config) {
   const client = new ClickUpClient(config);
   return client.getFolderTemplates(config.teamId);
 }
 function formatFolderTemplates(templates) {
   if (templates.length === 0) return "No folder templates";
-  return templates.map((t) => `${chalk20.bold(t.name)} ${chalk20.dim(`(${t.id})`)}`).join("\n");
+  return templates.map((t) => `${chalk21.bold(t.name)} ${chalk21.dim(`(${t.id})`)}`).join("\n");
 }
 function formatFolderTemplatesMarkdown(templates) {
   if (templates.length === 0) return "No folder templates";
@@ -7032,7 +7283,7 @@ async function createListFromTemplate(config, name, opts) {
 }
 
 // src/commands/views.ts
-import chalk21 from "chalk";
+import chalk22 from "chalk";
 async function listViews(config, id, container = "list") {
   const client = new ClickUpClient(config);
   if (container === "space") return client.getSpaceViews(id);
@@ -7043,7 +7294,7 @@ async function listViews(config, id, container = "list") {
 }
 function formatViews(views) {
   if (views.length === 0) return "No views";
-  return views.map((v) => `${chalk21.bold(v.name)} ${chalk21.dim(`(${v.id})`)} ${chalk21.dim(v.type)}`).join("\n");
+  return views.map((v) => `${chalk22.bold(v.name)} ${chalk22.dim(`(${v.id})`)} ${chalk22.dim(v.type)}`).join("\n");
 }
 function formatViewsMarkdown(views) {
   if (views.length === 0) return "No views";
@@ -7051,23 +7302,23 @@ function formatViewsMarkdown(views) {
 }
 
 // src/commands/chat.ts
-import chalk22 from "chalk";
+import chalk23 from "chalk";
 function channelName(c) {
   return c.name || "DM";
 }
 function colorChannelType(type) {
-  if (type === "CHANNEL") return chalk22.cyan(type);
-  if (type === "DM") return chalk22.dim(type);
-  if (type === "GROUP_DM") return chalk22.blue(type);
+  if (type === "CHANNEL") return chalk23.cyan(type);
+  if (type === "DM") return chalk23.dim(type);
+  if (type === "GROUP_DM") return chalk23.blue(type);
   return type;
 }
 function colorVisibility(v) {
-  if (v === "PUBLIC") return chalk22.green(v);
-  return chalk22.dim(v);
+  if (v === "PUBLIC") return chalk23.green(v);
+  return chalk23.dim(v);
 }
 var CHANNEL_COLUMNS = [
-  { key: "name", label: "Name", maxWidth: 40, format: (v) => chalk22.bold(v) },
-  { key: "id", label: "ID", maxWidth: 20, format: (v) => chalk22.dim(v) },
+  { key: "name", label: "Name", maxWidth: 40, format: (v) => chalk23.bold(v) },
+  { key: "id", label: "ID", maxWidth: 20, format: (v) => chalk23.dim(v) },
   { key: "type", label: "Type", maxWidth: 12, format: (v) => colorChannelType(v) },
   { key: "visibility", label: "Visibility", maxWidth: 10, format: (v) => colorVisibility(v) },
   { key: "topic", label: "Topic", maxWidth: 40 }
@@ -7092,26 +7343,26 @@ function formatChannelsMarkdown(channels) {
 }
 function formatChannelDetail(channel) {
   const lines = [];
-  lines.push(chalk22.bold.underline(channelName(channel)));
+  lines.push(chalk23.bold.underline(channelName(channel)));
   lines.push("");
   const fields = [
-    ["ID", chalk22.dim(channel.id)],
+    ["ID", chalk23.dim(channel.id)],
     ["Type", colorChannelType(channel.type)],
     ["Visibility", colorVisibility(channel.visibility)]
   ];
   if (channel.topic) fields.push(["Topic", channel.topic]);
   if (channel.description) fields.push(["Description", channel.description]);
-  fields.push(["Archived", channel.archived ? chalk22.yellow("Yes") : "No"]);
+  fields.push(["Archived", channel.archived ? chalk23.yellow("Yes") : "No"]);
   fields.push(["Created", formatDate(channel.created_at)]);
   const maxLabel = Math.max(...fields.map(([k]) => k.length));
   for (const [label, value] of fields) {
-    lines.push(`  ${chalk22.bold(label.padEnd(maxLabel + 1))} ${value}`);
+    lines.push(`  ${chalk23.bold(label.padEnd(maxLabel + 1))} ${value}`);
   }
   return lines.join("\n");
 }
 var CHAT_MEMBER_COLUMNS = [
-  { key: "name", label: "Name", maxWidth: 30, format: (v) => chalk22.bold(v) },
-  { key: "id", label: "ID", maxWidth: 15, format: (v) => chalk22.dim(v) },
+  { key: "name", label: "Name", maxWidth: 30, format: (v) => chalk23.bold(v) },
+  { key: "id", label: "ID", maxWidth: 15, format: (v) => chalk23.dim(v) },
   { key: "email", label: "Email", maxWidth: 40 },
   { key: "type", label: "Type", maxWidth: 12 }
 ];
@@ -7134,22 +7385,22 @@ function formatChatMembersMarkdown(members) {
 }
 
 // src/commands/chat-message.ts
-import chalk23 from "chalk";
-var separator = chalk23.dim("-".repeat(60));
+import chalk24 from "chalk";
+var separator = chalk24.dim("-".repeat(60));
 function formatMessages(messages) {
   if (messages.length === 0) return "No messages";
   const lines = [];
   for (let i = 0; i < messages.length; i++) {
     const msg = messages[i];
     if (i > 0) lines.push(separator);
-    const meta = [chalk23.bold(`@${msg.user_id}`), chalk23.dim(formatTimestamp(msg.date))];
+    const meta = [chalk24.bold(`@${msg.user_id}`), chalk24.dim(formatTimestamp(msg.date))];
     if (msg.replies_count) {
-      meta.push(chalk23.dim(`${msg.replies_count} replies`));
+      meta.push(chalk24.dim(`${msg.replies_count} replies`));
     }
-    meta.push(chalk23.dim(`(${msg.id})`));
+    meta.push(chalk24.dim(`(${msg.id})`));
     lines.push(meta.join("  "));
     if (msg.type === "post" && msg.post_data?.title) {
-      lines.push(chalk23.cyan.bold(msg.post_data.title));
+      lines.push(chalk24.cyan.bold(msg.post_data.title));
     }
     lines.push(msg.content);
   }
@@ -7168,7 +7419,7 @@ ${msg.content}`;
 }
 
 // src/commands/chat-reaction.ts
-import chalk24 from "chalk";
+import chalk25 from "chalk";
 var EMOJI_MAP = {
   thumbsup: "\u{1F44D}",
   thumbsdown: "\u{1F44E}",
@@ -7207,8 +7458,8 @@ function formatReactions(reactions) {
   const lines = [];
   for (const [emoji, users] of groups) {
     const icon = emojiChar(emoji);
-    const userList = users.map((u) => chalk24.bold(`@${u}`)).join(", ");
-    lines.push(`${icon} ${chalk24.dim(emoji)} ${chalk24.dim(`(${users.length})`)} \u2014 ${userList}`);
+    const userList = users.map((u) => chalk25.bold(`@${u}`)).join(", ");
+    lines.push(`${icon} ${chalk25.dim(emoji)} ${chalk25.dim(`(${users.length})`)} \u2014 ${userList}`);
   }
   return lines.join("\n");
 }
@@ -7223,20 +7474,20 @@ function formatReactionsMarkdown(reactions) {
 }
 
 // src/commands/view.ts
-import chalk25 from "chalk";
+import chalk26 from "chalk";
 async function getView(config, viewId) {
   const client = new ClickUpClient(config);
   return client.getView(viewId);
 }
 function formatView(view) {
   const lines = [];
-  lines.push(chalk25.bold.underline(view.name));
+  lines.push(chalk26.bold.underline(view.name));
   lines.push("");
-  lines.push(`  ${chalk25.bold("ID")}     ${view.id}`);
-  lines.push(`  ${chalk25.bold("Type")}   ${view.type}`);
-  if (view.visibility) lines.push(`  ${chalk25.bold("Visibility")} ${view.visibility}`);
-  if (view.date_created) lines.push(`  ${chalk25.bold("Created")} ${formatDate(view.date_created)}`);
-  if (view.protected !== void 0) lines.push(`  ${chalk25.bold("Protected")} ${view.protected}`);
+  lines.push(`  ${chalk26.bold("ID")}     ${view.id}`);
+  lines.push(`  ${chalk26.bold("Type")}   ${view.type}`);
+  if (view.visibility) lines.push(`  ${chalk26.bold("Visibility")} ${view.visibility}`);
+  if (view.date_created) lines.push(`  ${chalk26.bold("Created")} ${formatDate(view.date_created)}`);
+  if (view.protected !== void 0) lines.push(`  ${chalk26.bold("Protected")} ${view.protected}`);
   return lines.join("\n");
 }
 function formatViewMarkdown(view) {
@@ -7654,7 +7905,13 @@ function buildProgram(programName = basename(process.argv[1] ?? "cup")) {
   program.command("update <taskId>").description("Update a task").option("-n, --name <text>", "New task name").option("-d, --description <text>", "New description (markdown supported)").option(
     "-s, --status <status>",
     'New status (fuzzy matched, e.g. "prog" matches "in progress")'
-  ).option("--priority <level>", "Priority: urgent, high, normal, low (or 1-4)").option("--due-date <date>", 'Due date (YYYY-MM-DD, or "none"/"clear" to remove)').option("--start-date <date>", "Start date (YYYY-MM-DD)").option(
+  ).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; or "none"/"clear" to remove)'
+  ).option(
+    "--start-date <date>",
+    "Start date (YYYY-MM-DD, YYYY-MM-DDTHH:MM[:SS], or full ISO 8601 with offset)"
+  ).option(
     "--time-estimate <duration>",
     'Time estimate (e.g. "2h", "30m", "1h30m", "0" or "none" to clear)'
   ).option("--assignee <userId>", 'Add assignee by user ID or "me"').option("--remove-assignee <userId>", 'Remove assignee by user ID or "me"').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(
@@ -7704,7 +7961,13 @@ 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("--due-date <date>", "Due date (YYYY-MM-DD)").option("--start-date <date>", "Start date (YYYY-MM-DD)").option("--assignee <userId>", 'Assignee user ID or "me"').option("--tags <tags>", "Comma-separated tag names").option("--custom-item-id <id>", "Custom task type ID (use to create initiatives)").option("--time-estimate <duration>", 'Time estimate (e.g. "2h", "30m", "1h30m")').option("--template <id>", "Create from a task template (find IDs with cup templates)").option("--field <nameAndValue...>", 'Set custom field: --field "Name" value (can repeat)').option("--json", "Force JSON output even in terminal").action(
+  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(
+    "--due-date <date>",
+    "Due date (YYYY-MM-DD, YYYY-MM-DDTHH:MM[:SS], or full ISO 8601 with offset)"
+  ).option(
+    "--start-date <date>",
+    "Start date (YYYY-MM-DD, YYYY-MM-DDTHH:MM[:SS], or full ISO 8601 with offset)"
+  ).option("--assignee <userId>", 'Assignee user ID or "me"').option("--tags <tags>", "Comma-separated tag names").option("--custom-item-id <id>", "Custom task type ID (use to create initiatives)").option("--time-estimate <duration>", 'Time estimate (e.g. "2h", "30m", "1h30m")').option("--template <id>", "Create from a task template (find IDs with cup templates)").option("--field <nameAndValue...>", 'Set custom field: --field "Name" value (can repeat)').option("--json", "Force JSON output even in terminal").action(
     wrapAction(async (opts) => {
       const config = loadConfig(getProfileName());
       if (opts.list === "sprint:current") {
@@ -8138,6 +8401,78 @@ function buildProgram(programName = basename(process.argv[1] ?? "cup")) {
       }
     })
   );
+  program.command("list-delete <listId>").description("Delete a list (requires confirmation)").option("--confirm", "Skip confirmation prompt (required in non-interactive mode)").option("--json", "Force JSON output even in terminal").action(
+    wrapAction(async (listId, opts) => {
+      const config = loadConfig(getProfileName());
+      const result = await deleteListCommand(config, listId, opts);
+      if (shouldOutputJson(opts.json ?? false)) {
+        console.log(JSON.stringify(result, null, 2));
+      } else {
+        console.log(`Deleted list ${result.listId}`);
+      }
+    })
+  );
+  program.command("folder-delete <folderId>").description("Delete a folder (requires confirmation)").option("--confirm", "Skip confirmation prompt (required in non-interactive mode)").option("--json", "Force JSON output even in terminal").action(
+    wrapAction(async (folderId, opts) => {
+      const config = loadConfig(getProfileName());
+      const result = await deleteFolderCommand(config, folderId, opts);
+      if (shouldOutputJson(opts.json ?? false)) {
+        console.log(JSON.stringify(result, null, 2));
+      } else {
+        console.log(`Deleted folder ${result.folderId}`);
+      }
+    })
+  );
+  program.command("space-delete <spaceId>").description("Delete a space (requires confirmation)").option("--confirm", "Skip confirmation prompt (required in non-interactive mode)").option("--json", "Force JSON output even in terminal").action(
+    wrapAction(async (spaceId, opts) => {
+      const config = loadConfig(getProfileName());
+      const result = await deleteSpaceCommand(config, spaceId, opts);
+      if (shouldOutputJson(opts.json ?? false)) {
+        console.log(JSON.stringify(result, null, 2));
+      } else {
+        console.log(`Deleted space ${result.spaceId}`);
+      }
+    })
+  );
+  program.command("attachments <taskId>").description("List attachments on a task").option("--json", "Force JSON output even in terminal").action(
+    wrapAction(async (taskId, opts) => {
+      const config = loadConfig(getProfileName());
+      const attachments = await listTaskAttachments(config, taskId);
+      if (shouldOutputJson(opts.json ?? false)) {
+        console.log(JSON.stringify(attachments, null, 2));
+      } else if (isTTY()) {
+        console.log(formatAttachmentsTable(attachments));
+      } else {
+        console.log(formatAttachmentsMarkdown(attachments));
+      }
+    })
+  );
+  program.command("task-members <taskId>").description("List members with access to a task").option("--json", "Force JSON output even in terminal").action(
+    wrapAction(async (taskId, opts) => {
+      const config = loadConfig(getProfileName());
+      const members = await listTaskMembers(config, taskId);
+      if (shouldOutputJson(opts.json ?? false)) {
+        console.log(JSON.stringify(members, null, 2));
+      } else if (isTTY()) {
+        console.log(formatTaskMembers(members));
+      } else {
+        console.log(formatTaskMembersMarkdown(members));
+      }
+    })
+  );
+  program.command("plan").description("Show workspace plan").option("--json", "Force JSON output even in terminal").action(
+    wrapAction(async (opts) => {
+      const config = loadConfig(getProfileName());
+      const plan = await getWorkspacePlanCommand(config);
+      if (shouldOutputJson(opts.json ?? false)) {
+        console.log(JSON.stringify(plan, null, 2));
+      } else if (isTTY()) {
+        console.log(formatPlan(plan));
+      } else {
+        console.log(formatPlanMarkdown(plan));
+      }
+    })
+  );
   program.command("archive <taskId>").description("Archive a task (or unarchive with --unarchive)").option("--unarchive", "Unarchive instead of archiving").option("--confirm", "Skip confirmation prompt (required in non-interactive mode)").option("--json", "Force JSON output even in terminal").action(
     wrapAction(
       async (taskId, opts) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@krodak/clickup-cli",
-  "version": "1.27.1",
+  "version": "1.29.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.27.1
+# ClickUp CLI (`cup`) - skill version 1.29.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.27.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.29.0, update with `npm install -g @krodak/clickup-cli` and refresh this skill with `cup skill`.
 
 ## Install & Configure
 
@@ -127,6 +127,9 @@ All commands support `--help` for full flag details. All commands support `--jso
 | `cup time-in-status <id>`                                                                                                                                                                                                       | Show how long a task has been in each status                                                                                      |
 | `cup members`                                                                                                                                                                                                                   | Workspace members (username, ID, email)                                                                                           |
 | `cup fields <listId>`                                                                                                                                                                                                           | Custom fields on a list (type, required, options)                                                                                 |
+| `cup attachments <taskId>`                                                                                                                                                                                                      | List attachments on a task (name, size, URL)                                                                                      |
+| `cup task-members <taskId>`                                                                                                                                                                                                     | List members with access to a task                                                                                                |
+| `cup plan`                                                                                                                                                                                                                      | Show workspace plan and usage                                                                                                     |
 | `cup tags <spaceId>`                                                                                                                                                                                                            | Tags available in a space                                                                                                         |
 | `cup goals`                                                                                                                                                                                                                     | Workspace goals with progress                                                                                                     |
 | `cup key-results <goalId>`                                                                                                                                                                                                      | Key results for a goal                                                                                                            |
@@ -169,6 +172,9 @@ All commands support `--help` for full flag details. All commands support `--jso
 | `cup link <taskId> <linksTo> [--remove]`                                                                                                                                                                                                                        | Link/unlink tasks                                                                    |
 | `cup attach <taskId> <filePath>`                                                                                                                                                                                                                                | Upload file attachment                                                               |
 | `cup delete <id> [--confirm]`                                                                                                                                                                                                                                   | Delete task (DESTRUCTIVE)                                                            |
+| `cup list-delete <listId> [--confirm]`                                                                                                                                                                                                                          | Delete list (DESTRUCTIVE, requires --confirm in non-interactive)                     |
+| `cup folder-delete <folderId> [--confirm]`                                                                                                                                                                                                                      | Delete folder (DESTRUCTIVE, requires --confirm in non-interactive)                   |
+| `cup space-delete <spaceId> [--confirm]`                                                                                                                                                                                                                        | Delete space (DESTRUCTIVE, requires --confirm in non-interactive)                    |
 | `cup duplicate <taskId>`                                                                                                                                                                                                                                        | Duplicate a task                                                                     |
 | `cup bulk status <status> <taskIds...>`                                                                                                                                                                                                                         | Bulk update status                                                                   |
 | `cup bulk assign <taskIds...> [--to userId\|me] [--remove userId\|me]`                                                                                                                                                                                          | Bulk assign/unassign user from tasks                                                 |
@@ -248,7 +254,7 @@ All commands support `--help` for full flag details. All commands support `--jso
 | Task IDs                 | Native (`abc123def`) or custom (`PROJ-123`). Custom IDs auto-detected by `PREFIX-DIGITS` format                                                                                                                                                                                                                                                    |
 | `--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` format                                                                                                                                                                                                                                                                                                                                |
+| `--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                                                                                                                                                                                                   |
 | `--assignee`             | User ID or `me`                                                                                                                                                                                                                                                                                                                                    |
 | `--tags`                 | Comma-separated (e.g. `--tags "bug,frontend"`)                                                                                                                                                                                                                                                                                                     |
 | `--time-estimate`        | Duration: `"2h"`, `"30m"`, `"1h30m"`, or raw milliseconds                                                                                                                                                                                                                                                                                          |
@@ -282,7 +288,7 @@ When running in a terminal (not piped), task-listing commands (`cup tasks`, `cup
 - **Enter** to confirm and view details of selected tasks
 - After viewing details, prompted to open tasks in browser
 
-Other interactive prompts: sprint selection (when multiple match), workspace selection (`cup init`), agent selection (`cup skill`), destructive action confirmations (`cup delete`, `cup archive`, `cup view-delete`).
+Other interactive prompts: sprint selection (when multiple match), workspace selection (`cup init`), agent selection (`cup skill`), destructive action confirmations (`cup delete`, `cup list-delete`, `cup folder-delete`, `cup space-delete`, `cup archive`, `cup view-delete`).
 
 When piped or called with `--json`, all commands output non-interactive markdown or JSON. Agents should always use `--json` for structured data or pipe for markdown.
 
@@ -323,6 +329,8 @@ cup inbox --days 7                   # recently updated
 ```bash
 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 bug" -l <listId> --priority urgent --tags "bug,frontend"
 cup create -n "Bug fix" -l sprint:current         # create in active sprint
@@ -418,4 +426,4 @@ cup summary --hours 48               # wider window
 
 ## DELETE SAFETY
 
-IMPORTANT: Always confirm with the user before running `cup delete`. This is a destructive, irreversible operation. Even when using `--confirm` flag, verify the task ID is correct with the user first.
+IMPORTANT: Always confirm with the user before running `cup delete`, `cup list-delete`, `cup folder-delete`, or `cup space-delete`. These are destructive, irreversible operations. Even when using `--confirm` flag, verify the ID is correct with the user first.