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

package/README.md

@@ -171,22 +171,23 @@ npx skills add https://github.com/krodak/clickup-cli
 
 Full CRUD for the core ClickUp workflow:
 
-| Area                 | Capabilities                                                                                                                                                               |
-| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| ✅ **Tasks**         | Create, read, update, delete, duplicate, search, subtasks, assign, dependencies, links, multi-list, bulk operations (status, assign, due-date, tag, priority, field, move) |
-| 💬 **Comments**      | Post, edit, delete by ID or by task scope for your own comments, threaded replies, notify all                                                                              |
-| 🗨️ **Chat**          | List channels, send messages, replies, reactions, channel management                                                                                                       |
-| 📄 **Docs**          | List, read, create, edit, delete (v3 API)                                                                                                                                  |
-| ⏱️ **Time Tracking** | Start/stop timer, log entries, list/update/delete history                                                                                                                  |
-| ☑️ **Checklists**    | View, create, delete, add/edit/delete items                                                                                                                                |
-| 🔧 **Custom Fields** | List, create, set, remove values (text, number, dropdown, labels, date, checkbox, url, email, rating, progress, relationship, people)                                      |
-| 🏷️ **Tags**          | Add/remove on tasks, space-level create/update/delete                                                                                                                      |
-| 🎯 **Goals & OKRs**  | Goals CRUD, key results CRUD                                                                                                                                               |
-| 🏃 **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 (full CRUD + rename + from template), members, task types, templates, plan                                                                          |
-| 📎 **Attachments**   | Upload files to tasks, list task attachments, shown in detail views                                                                                                        |
+| Area                 | Capabilities                                                                                                                                                                      |
+| -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| ✅ **Tasks**         | Create, read, update, delete, duplicate, merge, search, subtasks, assign, dependencies, links, multi-list, bulk operations (status, assign, due-date, tag, priority, field, move) |
+| 💬 **Comments**      | Post, edit, delete by ID or by task scope for your own comments, threaded replies, notify all, list and view comments                                                             |
+| 🗨️ **Chat**          | List channels, send messages, replies, reactions, channel management                                                                                                              |
+| 📄 **Docs**          | List, read, create, edit, delete (v3 API)                                                                                                                                         |
+| ⏱️ **Time Tracking** | Start/stop timer, log entries, list/update/delete history, per-user time estimates                                                                                                |
+| ☑️ **Checklists**    | View, create, delete, add/edit/delete items                                                                                                                                       |
+| 🔧 **Custom Fields** | List, create, set, remove values (text, number, dropdown, labels, date, checkbox, url, email, rating, progress, relationship, people)                                             |
+| 🏷️ **Tags**          | Add/remove on tasks, space-level create/update/delete                                                                                                                             |
+| 🎯 **Goals & OKRs**  | Goals CRUD, key results CRUD                                                                                                                                                      |
+| 🏃 **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                                                                                                                                  |
+| 🔗 **Webhooks**      | List, create, update, delete webhooks; scope to space, folder, list, or task                                                                                                      |
+| 🏢 **Workspace**     | Spaces, folders, lists (full CRUD + rename + from template), members, task types, templates, plan, shared hierarchy                                                               |
+| 📎 **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

@@ -1000,6 +1000,77 @@ var ClickUpClient = class {
       { method: "DELETE" }
     );
   }
+  async mergeTasks(taskId, mergeWithTaskIds) {
+    await this.request(this.taskPath(taskId, "/merge"), {
+      method: "POST",
+      body: JSON.stringify({ merge_with: mergeWithTaskIds })
+    });
+  }
+  async updateTimeEstimatesByUser(taskId, estimates) {
+    return this.requestV3(`/workspaces/${this.teamId}/tasks/${taskId}/time_estimates_by_user`, {
+      method: "PATCH",
+      body: JSON.stringify({ time_estimates_by_user: estimates })
+    });
+  }
+  async replaceTimeEstimatesByUser(taskId, estimates) {
+    return this.requestV3(`/workspaces/${this.teamId}/tasks/${taskId}/time_estimates_by_user`, {
+      method: "PUT",
+      body: JSON.stringify({ time_estimates_by_user: estimates })
+    });
+  }
+  async getSharedHierarchy() {
+    return this.request(`/team/${this.teamId}/shared`);
+  }
+  async getWebhooks() {
+    const data = await this.request(`/team/${this.teamId}/webhook`);
+    return readCollectionField(data, "webhooks", "webhooks");
+  }
+  async createWebhook(endpoint, events, opts) {
+    const body = { endpoint, events };
+    if (opts?.taskId) body.task_id = opts.taskId;
+    if (opts?.listId) body.list_id = opts.listId;
+    if (opts?.folderId) body.folder_id = opts.folderId;
+    if (opts?.spaceId) body.space_id = opts.spaceId;
+    const data = await this.request(`/team/${this.teamId}/webhook`, {
+      method: "POST",
+      body: JSON.stringify(body)
+    });
+    return expectRecordField(data, "webhook", "webhook");
+  }
+  async updateWebhook(webhookId, opts) {
+    const data = await this.request(`/webhook/${webhookId}`, {
+      method: "PUT",
+      body: JSON.stringify(opts)
+    });
+    return expectRecordField(data, "webhook", "webhook");
+  }
+  async deleteWebhook(webhookId) {
+    await this.request(`/webhook/${webhookId}`, { method: "DELETE" });
+  }
+  async getListComments(listId) {
+    const data = await this.request(`/list/${listId}/comment`);
+    return readCollectionField(data, "comments", "list comments");
+  }
+  async postListComment(listId, commentText, notifyAll) {
+    const body = { comment_text: commentText };
+    if (notifyAll) body.notify_all = true;
+    return this.request(`/list/${listId}/comment`, {
+      method: "POST",
+      body: JSON.stringify(body)
+    });
+  }
+  async getViewComments(viewId) {
+    const data = await this.request(`/view/${viewId}/comment`);
+    return readCollectionField(data, "comments", "view comments");
+  }
+  async postViewComment(viewId, commentText, notifyAll) {
+    const body = { comment_text: commentText };
+    if (notifyAll) body.notify_all = true;
+    return this.request(`/view/${viewId}/comment`, {
+      method: "POST",
+      body: JSON.stringify(body)
+    });
+  }
 };
 
 // src/config.ts
@@ -4045,7 +4116,12 @@ var commandMetadata = [
         description: "List my recent time entries (--all for team)"
       },
       { section: "write", usage: "time update <timeEntryId>", description: "Update a time entry" },
-      { section: "write", usage: "time delete <timeEntryId>", description: "Delete a time entry" }
+      { section: "write", usage: "time delete <timeEntryId>", description: "Delete a time entry" },
+      {
+        section: "write",
+        usage: "time estimate-by-user <taskId> <userId> <duration>",
+        description: "Set per-user time estimate"
+      }
     ]
   },
   {
@@ -4501,6 +4577,92 @@ var commandMetadata = [
       { section: "read", usage: "favorite list", description: "List saved favorites" }
     ]
   },
+  {
+    name: "list-comments",
+    description: "List comments on a list",
+    flags: ["--json"],
+    quickReference: [
+      {
+        section: "read",
+        usage: "list-comments <listId>",
+        description: "List comments on a list"
+      }
+    ]
+  },
+  {
+    name: "list-comment",
+    description: "Post a comment on a list",
+    flags: ["-m", "--message", "--notify-all", "--json"],
+    quickReference: [
+      {
+        section: "write",
+        usage: "list-comment <listId>",
+        description: "Post a comment on a list"
+      }
+    ]
+  },
+  {
+    name: "view-comments",
+    description: "List comments on a view",
+    flags: ["--json"],
+    quickReference: [
+      {
+        section: "read",
+        usage: "view-comments <viewId>",
+        description: "List comments on a view"
+      }
+    ]
+  },
+  {
+    name: "view-comment",
+    description: "Post a comment on a view",
+    flags: ["-m", "--message", "--notify-all", "--json"],
+    quickReference: [
+      {
+        section: "write",
+        usage: "view-comment <viewId>",
+        description: "Post a comment on a view"
+      }
+    ]
+  },
+  {
+    name: "webhook",
+    description: "Manage webhooks",
+    quickReference: [
+      { section: "read", usage: "webhook list", description: "List webhooks" },
+      {
+        section: "write",
+        usage: "webhook create",
+        description: "Create a webhook"
+      },
+      { section: "write", usage: "webhook update <webhookId>", description: "Update a webhook" },
+      { section: "write", usage: "webhook delete <webhookId>", description: "Delete a webhook" }
+    ]
+  },
+  {
+    name: "merge",
+    description: "Merge a task into another (source becomes subtask of target)",
+    flags: ["--confirm", "--json"],
+    quickReference: [
+      {
+        section: "write",
+        usage: "merge <sourceTaskId> <intoTaskId>",
+        description: "Merge a task into another"
+      }
+    ]
+  },
+  {
+    name: "shared",
+    description: "Show shared spaces, folders, and lists",
+    flags: ["--json"],
+    quickReference: [
+      {
+        section: "read",
+        usage: "shared",
+        description: "Show shared spaces, folders, and lists"
+      }
+    ]
+  },
   {
     name: "chat",
     description: "Chat channels and messaging",
@@ -7776,6 +7938,222 @@ function formatFavoritesMarkdown(favorites) {
   return lines.join("\n");
 }
 
+// src/commands/merge.ts
+async function mergeCommand(config, sourceTaskId, intoTaskId, 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: `Merge task ${sourceTaskId} into ${intoTaskId}? The source task becomes a subtask of the target.`,
+      default: false
+    });
+    if (!confirmed) {
+      throw new Error("Cancelled");
+    }
+  }
+  await client.mergeTasks(intoTaskId, [sourceTaskId]);
+  return { sourceTaskId, intoTaskId, merged: true };
+}
+
+// src/commands/webhook.ts
+import chalk27 from "chalk";
+var WEBHOOK_COLUMNS = [
+  { key: "id", label: "ID" },
+  { key: "endpoint", label: "Endpoint", maxWidth: 45 },
+  { key: "events", label: "Events", maxWidth: 30 },
+  {
+    key: "status",
+    label: "Status",
+    maxWidth: 10,
+    format: (v) => v === "active" ? chalk27.green(v) : chalk27.dim(v)
+  },
+  { key: "scope", label: "Scope", maxWidth: 15 }
+];
+function webhookScope(w) {
+  if (w.task_id) return `task:${w.task_id}`;
+  if (w.list_id) return `list:${w.list_id}`;
+  if (w.folder_id) return `folder:${w.folder_id}`;
+  if (w.space_id) return `space:${w.space_id}`;
+  return "workspace";
+}
+async function fetchWebhooks(config) {
+  const client = new ClickUpClient(config);
+  return client.getWebhooks();
+}
+async function createWebhookCommand(config, opts) {
+  const client = new ClickUpClient(config);
+  const events = opts.events.split(",").map((e) => e.trim());
+  const scopeOpts = {};
+  if (opts.space) scopeOpts.spaceId = opts.space;
+  if (opts.folder) scopeOpts.folderId = opts.folder;
+  if (opts.list) scopeOpts.listId = opts.list;
+  if (opts.task) scopeOpts.taskId = opts.task;
+  return client.createWebhook(opts.url, events, scopeOpts);
+}
+async function updateWebhookCommand(config, webhookId, opts) {
+  const client = new ClickUpClient(config);
+  const payload = {};
+  if (opts.url) payload.endpoint = opts.url;
+  if (opts.events) payload.events = opts.events.split(",").map((e) => e.trim());
+  if (opts.status) payload.status = opts.status;
+  return client.updateWebhook(webhookId, payload);
+}
+async function deleteWebhookCommand(config, webhookId, 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 webhook ${webhookId}? This cannot be undone.`,
+      default: false
+    });
+    if (!confirmed) {
+      throw new Error("Cancelled");
+    }
+  }
+  await client.deleteWebhook(webhookId);
+  return { webhookId, deleted: true };
+}
+function formatWebhooks(webhooks) {
+  if (webhooks.length === 0) return "No webhooks found.";
+  const rows = webhooks.map((w) => ({
+    id: w.id,
+    endpoint: w.endpoint,
+    events: w.events.join(", "),
+    status: w.status,
+    scope: webhookScope(w)
+  }));
+  return formatTable(rows, WEBHOOK_COLUMNS);
+}
+function formatWebhooksMarkdown(webhooks) {
+  if (webhooks.length === 0) return "No webhooks found.";
+  const lines = [];
+  for (const w of webhooks) {
+    lines.push(`## ${w.id}`);
+    lines.push("");
+    lines.push(`- **Endpoint:** ${w.endpoint}`);
+    lines.push(`- **Events:** ${w.events.join(", ")}`);
+    lines.push(`- **Status:** ${w.status}`);
+    lines.push(`- **Scope:** ${webhookScope(w)}`);
+    lines.push("");
+  }
+  return lines.join("\n");
+}
+
+// src/commands/time-estimate-by-user.ts
+async function timeEstimateByUserCommand(config, taskId, userId, duration, opts) {
+  const client = new ClickUpClient(config);
+  const timeMs = parseTimeEstimate(duration);
+  const estimates = [{ assignee: userId, time: timeMs }];
+  if (opts.replace) {
+    return client.replaceTimeEstimatesByUser(taskId, estimates);
+  }
+  return client.updateTimeEstimatesByUser(taskId, estimates);
+}
+
+// src/commands/shared.ts
+import chalk28 from "chalk";
+async function fetchSharedHierarchy(config) {
+  const client = new ClickUpClient(config);
+  return client.getSharedHierarchy();
+}
+function formatSharedHierarchy(hierarchy) {
+  const { spaces, folders, lists } = hierarchy.shared;
+  if (spaces.length === 0 && folders.length === 0 && lists.length === 0) {
+    return "No shared items found.";
+  }
+  const lines = [];
+  if (spaces.length > 0) {
+    lines.push(chalk28.bold("Spaces"));
+    for (const s of spaces) {
+      lines.push(`  ${s.name}  ${chalk28.dim(s.id)}`);
+    }
+  }
+  if (folders.length > 0) {
+    if (lines.length > 0) lines.push("");
+    lines.push(chalk28.bold("Folders"));
+    for (const f of folders) {
+      lines.push(`  ${f.name}  ${chalk28.dim(f.id)}`);
+    }
+  }
+  if (lists.length > 0) {
+    if (lines.length > 0) lines.push("");
+    lines.push(chalk28.bold("Lists"));
+    for (const l of lists) {
+      lines.push(`  ${l.name}  ${chalk28.dim(l.id)}`);
+    }
+  }
+  return lines.join("\n");
+}
+function formatSharedHierarchyMarkdown(hierarchy) {
+  const { spaces, folders, lists } = hierarchy.shared;
+  if (spaces.length === 0 && folders.length === 0 && lists.length === 0) {
+    return "No shared items found.";
+  }
+  const lines = ["# Shared Hierarchy", ""];
+  if (spaces.length > 0) {
+    lines.push("## Spaces", "");
+    for (const s of spaces) {
+      lines.push(`- **${s.name}** (${s.id})`);
+    }
+    lines.push("");
+  }
+  if (folders.length > 0) {
+    lines.push("## Folders", "");
+    for (const f of folders) {
+      lines.push(`- **${f.name}** (${f.id})`);
+    }
+    lines.push("");
+  }
+  if (lists.length > 0) {
+    lines.push("## Lists", "");
+    for (const l of lists) {
+      lines.push(`- **${l.name}** (${l.id})`);
+    }
+    lines.push("");
+  }
+  return lines.join("\n");
+}
+
+// src/commands/list-comments.ts
+async function fetchListComments(config, listId) {
+  const client = new ClickUpClient(config);
+  const comments = await client.getListComments(listId);
+  return comments.map((c) => ({
+    id: c.id,
+    user: c.user.username,
+    date: c.date,
+    text: c.comment_text
+  }));
+}
+async function postListCommentCommand(config, listId, text, notifyAll) {
+  if (!text.trim()) throw new Error("Comment text cannot be empty");
+  const client = new ClickUpClient(config);
+  return client.postListComment(listId, text, notifyAll);
+}
+
+// src/commands/view-comments.ts
+async function fetchViewComments(config, viewId) {
+  const client = new ClickUpClient(config);
+  const comments = await client.getViewComments(viewId);
+  return comments.map((c) => ({
+    id: c.id,
+    user: c.user.username,
+    date: c.date,
+    text: c.comment_text
+  }));
+}
+async function postViewCommentCommand(config, viewId, text, notifyAll) {
+  if (!text.trim()) throw new Error("Comment text cannot be empty");
+  const client = new ClickUpClient(config);
+  return client.postViewComment(viewId, text, notifyAll);
+}
+
 // src/index.ts
 var require2 = createRequire(import.meta.url);
 var { version } = require2("../package.json");
@@ -9861,6 +10239,140 @@ function buildProgram(programName = basename(process.argv[1] ?? "cup")) {
       }
     })
   );
+  program.command("merge <sourceTaskId> <intoTaskId>").description("Merge a task into another (source becomes subtask of target)").option("--confirm", "Skip confirmation prompt (required in non-interactive mode)").option("--json", "Force JSON output even in terminal").action(
+    wrapAction(
+      async (sourceTaskId, intoTaskId, opts) => {
+        const config = loadConfig(getProfileName());
+        const result = await mergeCommand(config, sourceTaskId, intoTaskId, opts);
+        if (shouldOutputJson(opts.json ?? false)) {
+          console.log(JSON.stringify(result, null, 2));
+        } else {
+          console.log(`Merged task ${result.sourceTaskId} into ${result.intoTaskId}`);
+        }
+      }
+    )
+  );
+  timeCmd.command("estimate-by-user <taskId> <userId> <duration>").description(
+    'Set per-user time estimate (e.g. "2h", "30m"). Use --replace to overwrite all estimates.'
+  ).option("--replace", "Replace all estimates (PUT) instead of updating (PATCH)").option("--json", "Force JSON output even in terminal").action(
+    wrapAction(
+      async (taskId, userId, duration, opts) => {
+        const config = loadConfig(getProfileName());
+        const result = await timeEstimateByUserCommand(config, taskId, userId, duration, opts);
+        if (shouldOutputJson(opts.json ?? false)) {
+          console.log(JSON.stringify(result, null, 2));
+        } else {
+          console.log(
+            `${opts.replace ? "Replaced" : "Updated"} time estimate for user ${userId} on task ${taskId}`
+          );
+        }
+      }
+    )
+  );
+  program.command("shared").description("Show shared spaces, folders, and lists").option("--json", "Force JSON output even in terminal").action(
+    wrapAction(async (opts) => {
+      const config = loadConfig(getProfileName());
+      const hierarchy = await fetchSharedHierarchy(config);
+      if (shouldOutputJson(opts.json ?? false)) {
+        console.log(JSON.stringify(hierarchy, null, 2));
+      } else if (isTTY()) {
+        console.log(formatSharedHierarchy(hierarchy));
+      } else {
+        console.log(formatSharedHierarchyMarkdown(hierarchy));
+      }
+    })
+  );
+  program.command("list-comments <listId>").description("List comments on a list").option("--json", "Force JSON output even in terminal").action(
+    wrapAction(async (listId, opts) => {
+      const config = loadConfig(getProfileName());
+      const comments = await fetchListComments(config, listId);
+      printComments(comments, opts.json ?? false);
+    })
+  );
+  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("--json", "Force JSON output even in terminal").action(
+    wrapAction(
+      async (listId, opts) => {
+        const config = loadConfig(getProfileName());
+        const result = await postListCommentCommand(config, listId, opts.message, opts.notifyAll);
+        if (shouldOutputJson(opts.json ?? false)) {
+          console.log(JSON.stringify(result, null, 2));
+        } else {
+          console.log(formatCommentConfirmation(result.id));
+        }
+      }
+    )
+  );
+  program.command("view-comments <viewId>").description("List comments on a view").option("--json", "Force JSON output even in terminal").action(
+    wrapAction(async (viewId, opts) => {
+      const config = loadConfig(getProfileName());
+      const comments = await fetchViewComments(config, viewId);
+      printComments(comments, opts.json ?? false);
+    })
+  );
+  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("--json", "Force JSON output even in terminal").action(
+    wrapAction(
+      async (viewId, opts) => {
+        const config = loadConfig(getProfileName());
+        const result = await postViewCommentCommand(config, viewId, opts.message, opts.notifyAll);
+        if (shouldOutputJson(opts.json ?? false)) {
+          console.log(JSON.stringify(result, null, 2));
+        } else {
+          console.log(formatCommentConfirmation(result.id));
+        }
+      }
+    )
+  );
+  const webhookCmd = program.command("webhook").description("Manage webhooks");
+  webhookCmd.command("list").description("List webhooks in your workspace").option("--json", "Force JSON output even in terminal").action(
+    wrapAction(async (opts) => {
+      const config = loadConfig(getProfileName());
+      const webhooks = await fetchWebhooks(config);
+      if (shouldOutputJson(opts.json ?? false)) {
+        console.log(JSON.stringify(webhooks, null, 2));
+      } else if (isTTY()) {
+        console.log(formatWebhooks(webhooks));
+      } else {
+        console.log(formatWebhooksMarkdown(webhooks));
+      }
+    })
+  );
+  webhookCmd.command("create").description("Create a webhook").requiredOption("--url <url>", "Webhook endpoint URL").requiredOption("--events <events>", "Comma-separated event names").option("--space <id>", "Scope to a space").option("--folder <id>", "Scope to a folder").option("--list <id>", "Scope to a list").option("--task <id>", "Scope to a task").option("--json", "Force JSON output even in terminal").action(
+    wrapAction(
+      async (opts) => {
+        const config = loadConfig(getProfileName());
+        const result = await createWebhookCommand(config, opts);
+        if (shouldOutputJson(opts.json ?? false)) {
+          console.log(JSON.stringify(result, null, 2));
+        } else {
+          console.log(`Created webhook ${result.id} \u2192 ${result.endpoint}`);
+        }
+      }
+    )
+  );
+  webhookCmd.command("update <webhookId>").description("Update a webhook").option("--url <url>", "New endpoint URL").option("--events <events>", "New comma-separated event names").option("--status <status>", "New status (active or inactive)").option("--json", "Force JSON output even in terminal").action(
+    wrapAction(
+      async (webhookId, opts) => {
+        const config = loadConfig(getProfileName());
+        const result = await updateWebhookCommand(config, webhookId, opts);
+        if (shouldOutputJson(opts.json ?? false)) {
+          console.log(JSON.stringify(result, null, 2));
+        } else {
+          console.log(`Updated webhook ${result.id}`);
+        }
+      }
+    )
+  );
+  webhookCmd.command("delete <webhookId>").description("Delete a webhook (requires confirmation)").option("--confirm", "Skip confirmation prompt (required in non-interactive mode)").option("--json", "Force JSON output even in terminal").action(
+    wrapAction(async (webhookId, opts) => {
+      const config = loadConfig(getProfileName());
+      const result = await deleteWebhookCommand(config, webhookId, opts);
+      if (shouldOutputJson(opts.json ?? false)) {
+        console.log(JSON.stringify(result, null, 2));
+      } else {
+        console.log(`Deleted webhook ${result.webhookId}`);
+      }
+    })
+  );
   program.command("completion <shell>").description("Output shell completion script (bash, zsh, fish)").action(
     wrapAction(async (shell) => {
       const script = generateCompletion(shell, programName);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@krodak/clickup-cli",
-  "version": "1.29.0",
+  "version": "1.30.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.29.0
+# ClickUp CLI (`cup`) - skill version 1.30.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.29.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.30.0, update with `npm install -g @krodak/clickup-cli` and refresh this skill with `cup skill`.
 
 ## Install & Configure
 
@@ -144,6 +144,10 @@ All commands support `--help` for full flag details. All commands support `--jso
 | `cup view <viewId>`                                                                                                                                                                                                             | Get view details                                                                                                                  |
 | `cup open <query>`                                                                                                                                                                                                              | Open task in browser by ID or name                                                                                                |
 | `cup auth`                                                                                                                                                                                                                      | Check authentication status                                                                                                       |
+| `cup list-comments <listId>`                                                                                                                                                                                                    | Comments on a list                                                                                                                |
+| `cup view-comments <viewId>`                                                                                                                                                                                                    | Comments on a view                                                                                                                |
+| `cup webhook list`                                                                                                                                                                                                              | List webhooks in workspace                                                                                                        |
+| `cup shared`                                                                                                                                                                                                                    | Shared spaces, folders, and lists                                                                                                 |
 | `cup chat channels [--all] [--type type]`                                                                                                                                                                                       | List chat channels                                                                                                                |
 | `cup chat channel <id>`                                                                                                                                                                                                         | Show channel details                                                                                                              |
 | `cup chat messages <channelId> [--limit n]`                                                                                                                                                                                     | List channel messages                                                                                                             |
@@ -220,6 +224,13 @@ All commands support `--help` for full flag details. All commands support `--jso
 | `cup view-create <listId> <name> -t <type> [--group-by field]`                                                                                                                                                                                                  | Create a view on a list                                                              |
 | `cup view-update <viewId> [-n name] [--group-by field]`                                                                                                                                                                                                         | Update a view                                                                        |
 | `cup view-delete <viewId> [--confirm]`                                                                                                                                                                                                                          | Delete a view (DESTRUCTIVE)                                                          |
+| `cup list-comment <listId> -m text [--notify-all]`                                                                                                                                                                                                              | Post comment on a list                                                               |
+| `cup view-comment <viewId> -m text [--notify-all]`                                                                                                                                                                                                              | Post comment on a view                                                               |
+| `cup webhook create --url <url> --events <events> [--space\|--folder\|--list\|--task <id>]`                                                                                                                                                                     | Create a webhook                                                                     |
+| `cup webhook update <webhookId> [--url u] [--events e] [--status s]`                                                                                                                                                                                            | Update a webhook                                                                     |
+| `cup webhook delete <webhookId> [--confirm]`                                                                                                                                                                                                                    | Delete a webhook (DESTRUCTIVE)                                                       |
+| `cup merge <sourceTaskId> <intoTaskId> [--confirm]`                                                                                                                                                                                                             | Merge task into another (DESTRUCTIVE, source deleted)                                |
+| `cup time estimate-by-user <taskId> <userId> <duration> [--replace]`                                                                                                                                                                                            | Set per-user time estimate                                                           |
 | `cup chat send <channelId> -m <text> [--post --title t]`                                                                                                                                                                                                        | Send message to channel                                                              |
 | `cup chat reply <messageId> -m <text>`                                                                                                                                                                                                                          | Reply to a message                                                                   |
 | `cup chat react <messageId> --emoji <name>`                                                                                                                                                                                                                     | Add reaction                                                                         |
@@ -288,7 +299,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 list-delete`, `cup folder-delete`, `cup space-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`, `cup merge`, `cup webhook 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.
 
@@ -426,4 +437,4 @@ cup summary --hours 48               # wider window
 
 ## DELETE SAFETY
 
-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.
+IMPORTANT: Always confirm with the user before running `cup delete`, `cup list-delete`, `cup folder-delete`, `cup space-delete`, `cup merge`, or `cup webhook delete`. These are destructive, irreversible operations. Even when using `--confirm` flag, verify the ID is correct with the user first.