@krodak/clickup-cli 1.16.0 → 1.16.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.16.0",
+  "version": "1.16.2",
   "author": {
     "name": "Krzysztof Rodak"
   },

package/dist/index.js

@@ -128,14 +128,22 @@ var ClickUpClient = class {
   }
   async getMe() {
     if (this.meCache) return this.meCache;
-    const data = await this.request("/user");
+    const data = await this.request(
+      "/user"
+    );
     const user = expectRecordField(data, "user", "user");
+    const timezone = typeof user.timezone === "string" && user.timezone ? user.timezone : void 0;
     this.meCache = {
       id: expectNumericField(user, "id", "user"),
-      username: expectStringField(user, "username", "user")
+      username: expectStringField(user, "username", "user"),
+      ...timezone ? { timezone } : {}
     };
     return this.meCache;
   }
+  async getUserTimezone() {
+    const me = await this.getMe();
+    return me.timezone;
+  }
   async paginate(buildPath) {
     const allTasks = [];
     let page = 0;
@@ -304,21 +312,21 @@ var ClickUpClient = class {
   }
   async getView(viewId) {
     const data = await this.request(`/view/${viewId}`);
-    return data.view;
+    return expectRecordField(data, "view", "view");
   }
   async createListView(listId, payload) {
     const data = await this.request(`/list/${listId}/view`, {
       method: "POST",
       body: JSON.stringify(payload)
     });
-    return data.view;
+    return expectRecordField(data, "view", "view");
   }
   async updateView(viewId, payload) {
     const data = await this.request(`/view/${viewId}`, {
       method: "PUT",
       body: JSON.stringify(payload)
     });
-    return data.view;
+    return expectRecordField(data, "view", "view");
   }
   async deleteView(viewId) {
     await this.request(`/view/${viewId}`, { method: "DELETE" });
@@ -676,7 +684,7 @@ var ClickUpClient = class {
   async createGoal(teamId, name, opts) {
     const body = { name, multiple_owners: true };
     if (opts?.description) body.description = opts.description;
-    if (opts?.dueDate) body.due_date = Number(opts.dueDate);
+    if (opts?.dueDate != null) body.due_date = opts.dueDate;
     if (opts?.color) body.color = opts.color;
     const data = await this.request(`/team/${teamId}/goal`, {
       method: "POST",
@@ -965,7 +973,7 @@ function loadConfig(profileName) {
       ...fileConfig.sprintFolderId ? { sprintFolderId: fileConfig.sprintFolderId } : {}
     };
   }
-  const multi = migrateToMultiProfile(parsed, path);
+  const multi = loadMultiProfileConfig();
   const resolvedProfile = profileName ?? process.env.CU_PROFILE?.trim() ?? multi.defaultProfile;
   if (!resolvedProfile) {
     throw new Error("No default profile set. Run: cup profile use <name>");
@@ -1158,9 +1166,9 @@ function formatDuration(ms) {
 }
 function formatDateISO(ms) {
   const d = new Date(Number(ms));
-  const year = d.getFullYear();
-  const month = String(d.getMonth() + 1).padStart(2, "0");
-  const day = String(d.getDate()).padStart(2, "0");
+  const year = d.getUTCFullYear();
+  const month = String(d.getUTCMonth() + 1).padStart(2, "0");
+  const day = String(d.getUTCDate()).padStart(2, "0");
   return `${year}-${month}-${day}`;
 }
 
@@ -1725,14 +1733,40 @@ 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");
 }
-function parseDueDate(value) {
+function parseDueDate(value, timezone) {
   if (!/^\d{4}-\d{2}-\d{2}$/.test(value)) {
     throw new Error("Date must be in YYYY-MM-DD format");
   }
-  const parts = value.split("-");
-  const date = new Date(Number(parts[0]), Number(parts[1]) - 1, Number(parts[2]));
-  if (isNaN(date.getTime())) throw new Error(`Invalid date: ${value}`);
-  return date.getTime();
+  const parts = value.split("-").map(Number);
+  const y = parts[0];
+  const m = parts[1];
+  const d = parts[2];
+  if (timezone) {
+    try {
+      const ms2 = dateToTimezoneMs(y, m, d, timezone);
+      if (!isNaN(ms2)) return ms2;
+    } catch {
+    }
+  }
+  const ms = Date.UTC(y, m - 1, d);
+  if (isNaN(ms)) throw new Error(`Invalid date: ${value}`);
+  return ms;
+}
+function dateToTimezoneMs(year, month, day, timezone) {
+  const approxUtc = new Date(Date.UTC(year, month - 1, day));
+  const tzStr = approxUtc.toLocaleString("en-US", {
+    timeZone: timezone,
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit",
+    hour: "2-digit",
+    minute: "2-digit",
+    second: "2-digit",
+    hour12: false
+  });
+  const tzDate = /* @__PURE__ */ new Date(tzStr + " UTC");
+  const offset = approxUtc.getTime() - tzDate.getTime();
+  return approxUtc.getTime() + offset;
 }
 function parseAssigneeId(value) {
   const id = Number(value);
@@ -1761,7 +1795,7 @@ function parseTimeEstimate(value) {
     'Time estimate must be a duration (e.g. "2h", "30m", "1h30m"), milliseconds, or "0" to clear'
   );
 }
-function buildUpdatePayload(opts) {
+function buildUpdatePayload(opts, timezone) {
   if (opts.archive && opts.unarchive) {
     throw new Error("Cannot use --archive and --unarchive together");
   }
@@ -1780,12 +1814,12 @@ function buildUpdatePayload(opts) {
     if (opts.dueDate === "none" || opts.dueDate === "clear") {
       payload.due_date = null;
     } else {
-      payload.due_date = parseDueDate(opts.dueDate);
+      payload.due_date = parseDueDate(opts.dueDate, timezone);
       payload.due_date_time = false;
     }
   }
   if (opts.startDate !== void 0) {
-    payload.start_date = parseDueDate(opts.startDate);
+    payload.start_date = parseDueDate(opts.startDate, timezone);
     payload.start_date_time = false;
   }
   if (opts.assignee !== void 0 || opts.removeAssignee !== void 0) {
@@ -1832,10 +1866,11 @@ async function updateTask(config, taskId, options) {
       "Provide at least one of: --name, --description, --status, --priority, --due-date, --start-date, --time-estimate, --assignee, --remove-assignee, --parent, --detach, --archive, --unarchive"
     );
   const client = new ClickUpClient(config);
-  if (options.status !== void 0) {
-    options.status = await resolveStatus(client, taskId, options.status);
+  const resolved = { ...options };
+  if (resolved.status !== void 0) {
+    resolved.status = await resolveStatus(client, taskId, resolved.status);
   }
-  const task = await client.updateTask(taskId, options);
+  const task = await client.updateTask(taskId, resolved);
   return { id: task.id, name: task.name };
 }
 
@@ -1855,6 +1890,7 @@ async function createTask(config, options) {
     const task2 = await client.createTaskFromTemplate(listId, options.template, options.name);
     return { id: task2.id, name: task2.name, url: task2.url };
   }
+  const timezone = await client.getUserTimezone();
   const payload = {
     name: options.name,
     ...options.description !== void 0 ? { markdown_content: options.description } : {},
@@ -1865,11 +1901,11 @@ async function createTask(config, options) {
     payload.priority = parsePriority(options.priority);
   }
   if (options.dueDate !== void 0) {
-    payload.due_date = parseDueDate(options.dueDate);
+    payload.due_date = parseDueDate(options.dueDate, timezone);
     payload.due_date_time = false;
   }
   if (options.startDate !== void 0) {
-    payload.start_date = parseDueDate(options.startDate);
+    payload.start_date = parseDueDate(options.startDate, timezone);
     payload.start_date_time = false;
   }
   if (options.assignee !== void 0) {
@@ -4049,6 +4085,10 @@ ${renderZshTopLevelCommands(name)}
                   _arguments \\
                     '--days[Number of days to look back]:days:' \\
                     '--task[Filter by task ID]:task_id:' \\
+                    '--space[Filter by space ID]:space_id:' \\
+                    '--list[Filter by list ID]:list_id:' \\
+                    '--assignee[Filter by assignee user ID]:user_id:' \\
+                    '--all[Show all team entries]' \\
                     '--json[Force JSON output]'
                   ;;
                 update)
@@ -4509,6 +4549,10 @@ complete -c ${name} -n '__fish_seen_subcommand_from start; and __fish_seen_subco
 complete -c ${name} -n '__fish_seen_subcommand_from log; and __fish_seen_subcommand_from time' -s d -l description -d 'Description'
 complete -c ${name} -n '__fish_seen_subcommand_from list; and __fish_seen_subcommand_from time' -l days -d 'Number of days to look back'
 complete -c ${name} -n '__fish_seen_subcommand_from list; and __fish_seen_subcommand_from time' -l task -d 'Filter by task ID'
+complete -c ${name} -n '__fish_seen_subcommand_from list; and __fish_seen_subcommand_from time' -l space -d 'Filter by space ID'
+complete -c ${name} -n '__fish_seen_subcommand_from list; and __fish_seen_subcommand_from time' -l list -d 'Filter by list ID'
+complete -c ${name} -n '__fish_seen_subcommand_from list; and __fish_seen_subcommand_from time' -l assignee -d 'Filter by assignee user ID'
+complete -c ${name} -n '__fish_seen_subcommand_from list; and __fish_seen_subcommand_from time' -l all -d 'Show all team entries'
 complete -c ${name} -n '__fish_seen_subcommand_from update; and __fish_seen_subcommand_from time' -s d -l description -d 'New description'
 complete -c ${name} -n '__fish_seen_subcommand_from update; and __fish_seen_subcommand_from time' -l duration -d 'New duration'
 
@@ -5325,7 +5369,6 @@ function formatFieldsMarkdown(fields) {
 }
 
 // src/commands/duplicate.ts
-var PRIORITY_MAP2 = { urgent: 1, high: 2, normal: 3, low: 4 };
 async function duplicateTask(config, taskId) {
   const client = new ClickUpClient(config);
   const task = await client.getTask(taskId);
@@ -5333,7 +5376,7 @@ async function duplicateTask(config, taskId) {
     name: `${task.name} (copy)`,
     description: task.description,
     markdown_content: task.markdown_content,
-    priority: task.priority ? PRIORITY_MAP2[task.priority.priority.toLowerCase()] : void 0,
+    priority: task.priority ? parsePriority(task.priority.priority.toLowerCase()) : void 0,
     tags: task.tags?.map((t) => t.name),
     time_estimate: task.time_estimate ?? void 0
   });
@@ -5372,7 +5415,8 @@ async function bulkAssign(config, userIdOrMe, taskIds, action) {
 }
 async function bulkDueDate(config, date, taskIds) {
   const client = new ClickUpClient(config);
-  const payload = date === "none" || date === "clear" ? { due_date: null } : { due_date: parseDueDate(date), due_date_time: false };
+  const timezone = await client.getUserTimezone();
+  const payload = date === "none" || date === "clear" ? { due_date: null } : { due_date: parseDueDate(date, timezone), due_date_time: false };
   const failed = [];
   for (const id of taskIds) {
     try {
@@ -5430,7 +5474,12 @@ async function listGoals(config) {
 }
 async function createGoal(config, name, opts) {
   const client = new ClickUpClient(config);
-  return client.createGoal(config.teamId, name, opts);
+  const timezone = await client.getUserTimezone();
+  return client.createGoal(config.teamId, name, {
+    description: opts?.description,
+    color: opts?.color,
+    ...opts?.dueDate ? { dueDate: parseDueDate(opts.dueDate, timezone) } : {}
+  });
 }
 async function updateGoal(config, goalId, updates) {
   const client = new ClickUpClient(config);
@@ -5731,7 +5780,7 @@ function isAllowedFilterCommand(tokens) {
   if (tokens[0] === "time" && tokens[1] === "list") return true;
   return ALLOWED_FILTER_COMMANDS.has(tokens[0]);
 }
-function runFilter(name, entry) {
+function runFilter(_name, entry) {
   const result = spawnSync(process.execPath, [process.argv[1], ...entry.command], {
     stdio: "inherit"
   });
@@ -5755,14 +5804,17 @@ function formatFiltersTable(filters) {
   }));
   return formatTable(rows, FILTER_COLUMNS);
 }
+function escapeMarkdownCell(value) {
+  return value.replace(/\|/g, "\\|");
+}
 function formatFiltersMarkdown(filters) {
   const entries = Object.entries(filters);
   if (entries.length === 0) return "No filters saved";
   const lines = ["| Name | Command | Description |", "| --- | --- | --- |"];
   for (const [name, entry] of entries) {
-    const command = entry.command.join(" ");
-    const description = entry.description ?? "";
-    lines.push(`| ${name} | ${command} | ${description} |`);
+    const command = escapeMarkdownCell(entry.command.join(" "));
+    const description = escapeMarkdownCell(entry.description ?? "");
+    lines.push(`| ${escapeMarkdownCell(name)} | ${command} | ${description} |`);
   }
   return lines.join("\n");
 }
@@ -5786,18 +5838,29 @@ async function createListWithOptions(config, spaceId, name, opts) {
   }
   const list = opts.folder ? await client.createFolderList(opts.folder, name) : await client.createList(spaceId, name);
   if (statuses) {
-    await client.updateList(list.id, { statuses });
+    try {
+      await client.updateList(list.id, { statuses });
+    } catch (err) {
+      const reason = err instanceof Error ? err.message : String(err);
+      throw new Error(`List "${name}" (${list.id}) was created but status copy failed: ${reason}`, {
+        cause: err
+      });
+    }
   }
   return {
     ...list,
     ...statuses ? { statusesCopied: statuses.length } : {}
   };
 }
+function isNotFound(err) {
+  return err instanceof Error && /ClickUp API error 4(04|03)/.test(err.message);
+}
 async function copyStatusesFrom(client, sourceId) {
   try {
     const list = await client.getListWithStatuses(sourceId);
     return list.statuses.map((s) => ({ status: s.status, color: s.color, type: s.type ?? "custom" }));
-  } catch {
+  } catch (err) {
+    if (!isNotFound(err)) throw err;
     try {
       const space = await client.getSpaceWithStatuses(sourceId);
       return space.statuses.map((s) => ({
@@ -5805,9 +5868,11 @@ async function copyStatusesFrom(client, sourceId) {
         color: s.color,
         type: s.type ?? "custom"
       }));
-    } catch {
+    } catch (spaceErr) {
+      if (!isNotFound(spaceErr)) throw spaceErr;
       throw new Error(
-        `Could not find a list or space with ID "${sourceId}". Check the ID and try again.`
+        `Could not find a list or space with ID "${sourceId}". Check the ID and try again.`,
+        { cause: spaceErr }
       );
     }
   }
@@ -5890,15 +5955,17 @@ function buildProgram(programName = basename(process.argv[1] ?? "cup")) {
     wrapAction(
       async (taskId, opts) => {
         const config = loadConfig(getProfileName());
-        if (opts.assignee === "me") {
-          const client = new ClickUpClient(config);
-          opts.assignee = String(await resolveAssigneeId(client, "me"));
-        }
-        if (opts.removeAssignee === "me") {
-          const client = new ClickUpClient(config);
-          opts.removeAssignee = String(await resolveAssigneeId(client, "me"));
-        }
-        const payload = buildUpdatePayload(opts);
+        const client = new ClickUpClient(config);
+        const [timezone] = await Promise.all([
+          client.getUserTimezone(),
+          opts.assignee === "me" ? resolveAssigneeId(client, "me").then((id) => {
+            opts.assignee = String(id);
+          }) : Promise.resolve(),
+          opts.removeAssignee === "me" ? resolveAssigneeId(client, "me").then((id) => {
+            opts.removeAssignee = String(id);
+          }) : Promise.resolve()
+        ]);
+        const payload = buildUpdatePayload(opts, timezone);
         const hasFields = (opts.field?.length ?? 0) > 0;
         if (!hasFields && Object.keys(payload).length === 0) {
           throw new Error(
@@ -5917,8 +5984,8 @@ function buildProgram(programName = basename(process.argv[1] ?? "cup")) {
             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);
+            const client2 = new ClickUpClient(config);
+            const task = await client2.getTask(taskId);
             result = { id: task.id, name: task.name };
           }
         }
@@ -6623,10 +6690,9 @@ function buildProgram(programName = basename(process.argv[1] ?? "cup")) {
       outputBulkResult(result, opts.json ?? false, "due-date");
     })
   );
-  bulkCmd.command("tag <tagName> <taskIds...>").description("Bulk add or remove a tag on tasks").option("--add", "Add tag (default)").option("--remove", "Remove tag instead of adding").option("--json", "Force JSON output even in terminal").action(
+  bulkCmd.command("tag <tagName> <taskIds...>").description("Bulk add or remove a tag on tasks (default: add)").option("--remove", "Remove tag instead of adding").option("--json", "Force JSON output even in terminal").action(
     wrapAction(
       async (tagName, taskIds, opts) => {
-        if (opts.add && opts.remove) throw new Error("Cannot use --add and --remove together");
         const action = opts.remove ? "remove" : "add";
         const config = loadConfig(getProfileName());
         const result = await bulkTag(config, tagName, taskIds, action);
@@ -7104,8 +7170,9 @@ function buildProgram(programName = basename(process.argv[1] ?? "cup")) {
           );
         }
         if (!isAllowedFilterCommand(args)) {
+          const allowed = [...ALLOWED_FILTER_COMMANDS, "time list"].join(", ");
           throw new Error(
-            `Command "${args[0]}" is not allowed in saved filters. Allowed: tasks, search, sprint, assigned, overdue, inbox, summary, views, lists, spaces, folders, members, tags, goals, key-results, task-types, templates, list-templates, folder-templates, docs, time list`
+            `Command "${args[0]}" is not allowed in saved filters. Allowed: ${allowed}`
           );
         }
         const entry = { command: args };

package/package.json

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