@krodak/clickup-cli 1.14.0 → 1.14.2

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

package/dist/index.js

@@ -1225,7 +1225,7 @@ function formatTasksMarkdown(tasks) {
 }
 function formatCommentsMarkdown(comments) {
   if (comments.length === 0) return "No comments found.";
-  return comments.map((c) => `**${c.user}** (${c.date})
+  return comments.map((c) => `**${c.user}** (${formatDateISO(c.date)})
 
 ${c.text}`).join("\n\n---\n\n");
 }
@@ -1279,6 +1279,10 @@ function formatTaskDetailMarkdown(task) {
       task.time_spent != null && task.time_spent > 0 ? formatDuration(task.time_spent) : void 0
     ],
     ["Tags", task.tags && task.tags.length > 0 ? task.tags.map((t) => t.name).join(", ") : void 0],
+    [
+      "Lists",
+      task.locations && task.locations.length > 0 ? task.locations.map((l) => l.name).join(", ") : void 0
+    ],
     ["Created", task.date_created ? formatDateISO(task.date_created) : void 0],
     ["Updated", task.date_updated ? formatDateISO(task.date_updated) : void 0]
   ];
@@ -1420,6 +1424,7 @@ function formatTaskDetail(task) {
     ["Estimate", task.time_estimate ? formatDuration(task.time_estimate) : void 0],
     ["Tracked", task.time_spent ? formatDuration(task.time_spent) : void 0],
     ["Tags", task.tags?.length ? task.tags.map((t) => t.name).join(", ") : void 0],
+    ["Lists", task.locations?.length ? task.locations.map((l) => l.name).join(", ") : void 0],
     ["Parent", task.parent || void 0],
     ["URL", task.url]
   ];
@@ -1708,6 +1713,9 @@ function parseTimeEstimate(value) {
   );
 }
 function buildUpdatePayload(opts) {
+  if (opts.archive && opts.unarchive) {
+    throw new Error("Cannot use --archive and --unarchive together");
+  }
   const payload = {};
   if (opts.name !== void 0) {
     if (!opts.name.trim()) throw new Error("Task name cannot be empty");
@@ -1727,10 +1735,12 @@ function buildUpdatePayload(opts) {
     payload.time_estimate = parseTimeEstimate(opts.timeEstimate);
   }
   if (opts.parent !== void 0) payload.parent = opts.parent;
+  if (opts.archive) payload.archived = true;
+  if (opts.unarchive) payload.archived = false;
   return payload;
 }
 function hasUpdateFields(options) {
-  return options.name !== void 0 || options.description !== void 0 || options.markdown_content !== void 0 || options.status !== void 0 || options.priority !== void 0 || options.due_date !== void 0 || options.time_estimate !== void 0 || options.assignees !== void 0 || options.parent !== void 0;
+  return options.name !== void 0 || options.description !== void 0 || options.markdown_content !== void 0 || options.status !== void 0 || options.priority !== void 0 || options.due_date !== void 0 || options.time_estimate !== void 0 || options.assignees !== void 0 || options.parent !== void 0 || options.archived !== void 0;
 }
 async function resolveStatus(client, taskId, statusInput) {
   const task = await client.getTask(taskId);
@@ -1749,7 +1759,7 @@ async function resolveStatus(client, taskId, statusInput) {
 async function updateTask(config, taskId, options) {
   if (!hasUpdateFields(options))
     throw new Error(
-      "Provide at least one of: --name, --description, --status, --priority, --due-date, --time-estimate, --assignee, --parent"
+      "Provide at least one of: --name, --description, --status, --priority, --due-date, --time-estimate, --assignee, --parent, --archive, --unarchive"
     );
   const client = new ClickUpClient(config);
   if (options.status !== void 0) {
@@ -2758,6 +2768,8 @@ var commandMetadata = [
       "--time-estimate",
       "--assignee",
       "--parent",
+      "--archive",
+      "--unarchive",
       "--field",
       "--json"
     ],
@@ -3671,6 +3683,9 @@ ${renderZshTopLevelCommands(name)}
             '--time-estimate[Time estimate]:duration:' \\
             '--assignee[Add assignee]:user_id:' \\
             '--parent[Set parent task]:task_id:' \\
+            '--archive[Archive the task]' \\
+            '--unarchive[Unarchive the task]' \\
+            '--field[Set custom field]:field_name_and_value:' \\
             '--json[Force JSON output]'
           ;;
         create)
@@ -3761,6 +3776,7 @@ ${renderZshTopLevelCommands(name)}
             '1:query:' \\
             '--status[Filter by status]:status:(open "in progress" "in review" done closed)' \\
             '--include-closed[Include done/closed tasks in search]' \\
+            '--all[Search all workspace tasks, not just mine]' \\
             '--json[Force JSON output]'
           ;;
         summary)
@@ -3771,6 +3787,7 @@ ${renderZshTopLevelCommands(name)}
         overdue)
           _arguments \\
             '--include-closed[Include done/closed overdue tasks]' \\
+            '--all[Check all workspace tasks, not just mine]' \\
             '--json[Force JSON output]'
           ;;
         assign)
@@ -4448,7 +4465,18 @@ async function moveTask(config, taskId, opts) {
 }
 
 // src/commands/field.ts
-var SUPPORTED_TYPES = /* @__PURE__ */ new Set(["text", "number", "drop_down", "checkbox", "date", "url", "email"]);
+var SUPPORTED_TYPES = /* @__PURE__ */ new Set([
+  "text",
+  "short_text",
+  "number",
+  "currency",
+  "phone",
+  "drop_down",
+  "checkbox",
+  "date",
+  "url",
+  "email"
+]);
 function findFieldByName(fields, name) {
   const lower = name.toLowerCase();
   const match = fields.find((f) => f.name.toLowerCase() === lower);
@@ -4662,9 +4690,12 @@ function formatChecklistsMarkdown(checklists) {
 
 // src/commands/comment-edit.ts
 async function editComment(config, commentId, text, resolved) {
-  if (!text.trim()) throw new Error("Comment text cannot be empty");
+  if (text === void 0 && resolved === void 0) {
+    throw new Error("Provide at least one of: --message, --resolved, --unresolved");
+  }
+  if (text !== void 0 && !text.trim()) throw new Error("Comment text cannot be empty");
   const client = new ClickUpClient(config);
-  await client.updateComment(commentId, text, resolved);
+  await client.updateComment(commentId, text ?? "", resolved);
 }
 
 // src/commands/comment-delete.ts
@@ -4981,6 +5012,11 @@ function formatTimeEntriesMarkdown(entries) {
 
 // src/commands/tags.ts
 import chalk12 from "chalk";
+var TAG_COLUMNS = [
+  { key: "name", label: "Name", maxWidth: 40 },
+  { key: "fg", label: "FG", maxWidth: 10 },
+  { key: "bg", label: "BG", maxWidth: 10 }
+];
 async function listSpaceTags(config, spaceId) {
   const client = new ClickUpClient(config);
   return client.getSpaceTags(spaceId);
@@ -5003,11 +5039,22 @@ async function updateSpaceTag(config, spaceId, tagName, updates) {
 }
 function formatTags(tags) {
   if (tags.length === 0) return "No tags found";
+  if (isTTY()) {
+    const rows = tags.map((t) => ({
+      name: t.tag_bg ? chalk12.bgHex(t.tag_bg).hex(t.tag_fg || "#ffffff")(` ${t.name} `) : chalk12.bold(t.name),
+      fg: t.tag_fg || "",
+      bg: t.tag_bg || ""
+    }));
+    return formatTable(rows, TAG_COLUMNS);
+  }
   return tags.map((t) => chalk12.bold(t.name)).join(", ");
 }
 function formatTagsMarkdown(tags) {
   if (tags.length === 0) return "No tags found";
-  return tags.map((t) => `- ${t.name}`).join("\n");
+  return tags.map((t) => {
+    const colors = t.tag_bg ? ` (bg: ${t.tag_bg}${t.tag_fg ? `, fg: ${t.tag_fg}` : ""})` : "";
+    return `- ${t.name}${colors}`;
+  }).join("\n");
 }
 
 // src/commands/members.ts
@@ -5037,6 +5084,7 @@ function formatMembersMarkdown(members) {
 // src/commands/fields.ts
 import chalk13 from "chalk";
 var FIELD_COLUMNS = [
+  { key: "id", label: "ID", maxWidth: 20 },
   { key: "name", label: "Name", maxWidth: 30 },
   { key: "type", label: "Type", maxWidth: 15 },
   {
@@ -5054,6 +5102,7 @@ async function listFields(config, listId) {
 function formatFields(fields) {
   if (fields.length === 0) return "No custom fields";
   const rows = fields.map((f) => ({
+    id: f.id,
     name: f.name,
     type: f.type,
     required: f.required ? "yes" : "no",
@@ -5066,7 +5115,7 @@ function formatFieldsMarkdown(fields) {
   return fields.map((f) => {
     const options = f.type_config?.options?.map((o) => o.name).join(", ");
     const optStr = options ? ` [${options}]` : "";
-    return `- **${f.name}** (${f.type})${f.required ? " - required" : ""}${optStr}`;
+    return `- **${f.name}** \`${f.id}\` (${f.type})${f.required ? " - required" : ""}${optStr}`;
   }).join("\n");
 }
 
@@ -5114,7 +5163,8 @@ var GOAL_COLUMNS = [
   { key: "id", label: "ID", maxWidth: 15 },
   { key: "name", label: "Name", maxWidth: 40 },
   { key: "progress", label: "Progress", maxWidth: 10, format: (v) => colorProgress(v) },
-  { key: "owner", label: "Owner", maxWidth: 20 }
+  { key: "owner", label: "Owner", maxWidth: 20 },
+  { key: "due_date", label: "Due", maxWidth: 12 }
 ];
 var KEY_RESULT_COLUMNS = [
   { key: "id", label: "ID", maxWidth: 15 },
@@ -5163,7 +5213,8 @@ function formatGoals(goals) {
     name: g.name,
     id: g.id,
     progress: `${Math.round(g.percent_completed * 100)}%`,
-    owner: g.owner ? `@${g.owner.username}` : ""
+    owner: g.owner ? `@${g.owner.username}` : "",
+    due_date: g.due_date ? formatDateISO(g.due_date) : ""
   }));
   return formatTable(rows, GOAL_COLUMNS);
 }
@@ -5172,7 +5223,8 @@ function formatGoalsMarkdown(goals) {
   return goals.map((g) => {
     const pct = Math.round(g.percent_completed * 100);
     const owner = g.owner ? ` - @${g.owner.username}` : "";
-    return `- **${g.name}** (${g.id}) - ${pct}%${owner}`;
+    const due = g.due_date ? ` - due ${formatDateISO(g.due_date)}` : "";
+    return `- **${g.name}** (${g.id}) - ${pct}%${owner}${due}`;
   }).join("\n");
 }
 function formatKeyResults(keyResults) {
@@ -5354,6 +5406,9 @@ var VALID_GROUP_BY_FIELDS2 = [
   "sprint"
 ];
 async function updateView(config, viewId, opts) {
+  if (opts.name === void 0 && opts.groupBy === void 0) {
+    throw new Error("Provide at least one of: --name, --group-by");
+  }
   if (opts.name !== void 0 && !opts.name.trim()) {
     throw new Error("View name cannot be empty");
   }
@@ -5465,7 +5520,7 @@ 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 (e.g. "in progress", "done")').option("--priority <level>", "Priority: urgent, high, normal, low (or 1-4)").option("--due-date <date>", "Due date (YYYY-MM-DD)").option("--time-estimate <duration>", 'Time estimate (e.g. "2h", "30m", "1h30m")').option("--assignee <userId>", 'Add assignee by user ID or "me"').option("--parent <taskId>", "Set parent task (makes this a subtask)").option("--field <nameAndValue...>", 'Set custom field: --field "Name" value').option("--json", "Force JSON output even in terminal").action(
+  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 (e.g. "in progress", "done")').option("--priority <level>", "Priority: urgent, high, normal, low (or 1-4)").option("--due-date <date>", "Due date (YYYY-MM-DD)").option("--time-estimate <duration>", 'Time estimate (e.g. "2h", "30m", "1h30m")').option("--assignee <userId>", 'Add assignee by user ID or "me"').option("--parent <taskId>", "Set parent task (makes this a subtask)").option("--archive", "Archive the task").option("--unarchive", "Unarchive the task").option("--field <nameAndValue...>", 'Set custom field: --field "Name" value').option("--json", "Force JSON output even in terminal").action(
     wrapAction(
       async (taskId, opts) => {
         const config = loadConfig(getProfileName());
@@ -5474,14 +5529,28 @@ function buildProgram(programName = basename(process.argv[1] ?? "cup")) {
           opts.assignee = String(await resolveAssigneeId(client, "me"));
         }
         const payload = buildUpdatePayload(opts);
-        const result = await updateTask(config, taskId, payload);
-        if (opts.field?.length) {
-          if (opts.field.length % 2 !== 0) {
+        const hasFields = (opts.field?.length ?? 0) > 0;
+        if (!hasFields && Object.keys(payload).length === 0) {
+          throw new Error(
+            "Provide at least one of: --name, --description, --status, --priority, --due-date, --time-estimate, --assignee, --parent, --archive, --unarchive, --field"
+          );
+        }
+        let result;
+        if (Object.keys(payload).length > 0) {
+          result = await updateTask(config, taskId, payload);
+        }
+        if (hasFields) {
+          if ((opts.field?.length ?? 0) % 2 !== 0) {
             throw new Error('--field requires pairs: --field "Name" value');
           }
-          for (let i = 0; i < opts.field.length; i += 2) {
+          for (let i = 0; i < (opts.field?.length ?? 0); i += 2) {
             await setCustomField(config, taskId, { set: [opts.field[i], opts.field[i + 1]] });
           }
+          if (!result) {
+            const client = new ClickUpClient(config);
+            const task = await client.getTask(taskId);
+            result = { id: task.id, name: task.name };
+          }
         }
         if (shouldOutputJson(opts.json ?? false)) {
           console.log(JSON.stringify(result, null, 2));
@@ -5557,7 +5626,7 @@ function buildProgram(programName = basename(process.argv[1] ?? "cup")) {
       printComments(comments, opts.json ?? false);
     })
   );
-  program.command("comment-edit <commentId>").description("Edit an existing comment").requiredOption("-m, --message <text>", "New comment text").option("--resolved", "Mark comment as resolved").option("--unresolved", "Mark comment as unresolved").option("--json", "Force JSON output even in terminal").action(
+  program.command("comment-edit <commentId>").description("Edit an existing comment").option("-m, --message <text>", "New comment text").option("--resolved", "Mark comment as resolved").option("--unresolved", "Mark comment as unresolved").option("--json", "Force JSON output even in terminal").action(
     wrapAction(
       async (commentId, opts) => {
         const config = loadConfig(getProfileName());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@krodak/clickup-cli",
-  "version": "1.14.0",
+  "version": "1.14.2",
   "description": "ClickUp CLI for AI agents and humans",
   "type": "module",
   "license": "MIT",

package/skills/clickup-cli/SKILL.md

@@ -72,7 +72,7 @@ All commands support `--help` for full flag details. All commands support `--jso
 | Command                                                                                                                                                                                    | What it does                                 |
 | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------- |
 | `cup create -n name [-l listId] [-p parentId] [-d desc] [-s status] [--priority p] [--due-date d] [--time-estimate t] [--assignee id\|me] [--tags t] [--custom-item-id n] [--template id]` | Create task                                  |
-| `cup update <id> [-n name] [-d desc] [-s status] [--priority p] [--due-date d] [--time-estimate t] [--assignee id\|me] [--parent id] [--field "Name" val]`                                 | Update task fields (including custom fields) |
+| `cup update <id> [-n name] [-d desc] [-s status] [--priority p] [--due-date d] [--time-estimate t] [--assignee id\|me] [--parent id] [--archive] [--unarchive] [--field "Name" val]`       | Update task fields (including custom fields) |
 | `cup comment <id> -m text [--notify-all]`                                                                                                                                                  | Post comment on task                         |
 | `cup comment-edit <commentId> -m text [--resolved] [--unresolved]`                                                                                                                         | Edit a comment                               |
 | `cup comment-delete <commentId>`                                                                                                                                                           | Delete a comment                             |