@krodak/clickup-cli 1.12.0 → 1.14.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.12.0",
+  "version": "1.14.0",
   "author": {
     "name": "Krzysztof Rodak"
   },

package/dist/index.js

@@ -1143,19 +1143,57 @@ function computeWidths(rows, columns) {
 function formatTable(rows, columns) {
   const widths = computeWidths(rows, columns);
   const header = columns.map((c, i) => cell(c.label, widths[i])).join("  ");
-  const divider = "-".repeat(header.replace(/\x1b\[[0-9;]*m/g, "").length);
+  const divider = chalk.dim("-".repeat(header.replace(/\x1b\[[0-9;]*m/g, "").length));
   const lines = [chalk.bold(header), divider];
   for (const row of rows) {
-    lines.push(columns.map((c, i) => cell(String(row[c.key] ?? ""), widths[i])).join("  "));
+    lines.push(
+      columns.map((c, i) => {
+        const raw = String(row[c.key] ?? "");
+        const width = widths[i];
+        const truncated = raw.length > width ? raw.slice(0, width - 1) + "\u2026" : raw;
+        const padding = " ".repeat(Math.max(0, width - truncated.length));
+        return c.format ? c.format(truncated, row) + padding : truncated + padding;
+      }).join("  ")
+    );
   }
   return lines.join("\n");
 }
+function colorStatus(status) {
+  const lower = status.toLowerCase();
+  if (lower.includes("done") || lower.includes("complete") || lower.includes("closed"))
+    return chalk.green(status);
+  if (lower.includes("progress") || lower.includes("review") || lower.includes("active"))
+    return chalk.yellow(status);
+  if (lower.includes("block") || lower.includes("stuck")) return chalk.red(status);
+  return chalk.dim(status);
+}
+function colorPriority(priority) {
+  const lower = priority.toLowerCase();
+  if (lower === "urgent") return chalk.red(priority);
+  if (lower === "high") return chalk.yellow(priority);
+  if (lower === "normal") return priority;
+  if (lower === "low") return chalk.dim(priority);
+  return priority;
+}
+function colorDueDate(dateStr, rawTimestamp) {
+  if (!dateStr) return dateStr;
+  if (rawTimestamp) {
+    const ts = Number(rawTimestamp);
+    if (Number.isFinite(ts) && ts < Date.now()) return chalk.red(dateStr);
+  }
+  return dateStr;
+}
 var TASK_COLUMNS = [
   { key: "id", label: "ID" },
   { key: "name", label: "NAME", maxWidth: 60 },
-  { key: "status", label: "STATUS" },
-  { key: "priority", label: "PRIORITY" },
-  { key: "due_date", label: "DUE" },
+  { key: "status", label: "STATUS", maxWidth: 20, format: (v) => colorStatus(v) },
+  { key: "priority", label: "PRIORITY", maxWidth: 10, format: (v) => colorPriority(v) },
+  {
+    key: "due_date",
+    label: "DUE",
+    maxWidth: 15,
+    format: (v, row) => v ? colorDueDate(v, row.dueRaw) : ""
+  },
   { key: "list", label: "LIST" }
 ];
 
@@ -1369,16 +1407,16 @@ function formatTaskDetail(task) {
   lines.push("");
   const fields = [
     ["ID", task.id],
-    ["Status", task.status?.status],
+    ["Status", task.status?.status ? colorStatus(task.status.status) : void 0],
     ["Type", typeLabel],
     ["List", task.list?.name],
     [
       "Assignees",
       task.assignees?.length ? task.assignees.map((a) => a.username).join(", ") : void 0
     ],
-    ["Priority", task.priority?.priority],
+    ["Priority", task.priority?.priority ? colorPriority(task.priority.priority) : void 0],
     ["Start", task.start_date ? formatDate(task.start_date) : void 0],
-    ["Due", task.due_date ? formatDate(task.due_date) : void 0],
+    ["Due", task.due_date ? colorDueDate(formatDate(task.due_date), task.due_date) : void 0],
     ["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],
@@ -1444,8 +1482,9 @@ function formatTaskDetail(task) {
 function formatChoiceName(task) {
   const id = task.id.padEnd(12);
   const name = task.name.length > 50 ? task.name.slice(0, 49) + "\u2026" : task.name.padEnd(50);
-  const status = task.status;
-  return `${id}  ${name}  ${chalk2.dim(status)}`;
+  const status = colorStatus(task.status);
+  const priority = task.priority !== "none" ? colorPriority(task.priority) : "";
+  return `${id}  ${name}  ${status}${priority ? "  " + priority : ""}`;
 }
 async function interactiveTaskPicker(tasks) {
   if (tasks.length === 0) return [];
@@ -1541,6 +1580,7 @@ function summarize(task, typeMap) {
     task_type: resolveTaskType(task, typeMap ?? /* @__PURE__ */ new Map()),
     priority: task.priority?.priority ?? "none",
     due_date: formatDueDate(task.due_date),
+    ...task.due_date ? { dueRaw: task.due_date } : {},
     list: task.list.name,
     url: task.url,
     ...task.parent ? { parent: task.parent } : {}
@@ -1994,9 +2034,15 @@ Using: ${sprintLists[sprintLists.length - 1].name}
 }
 
 // src/commands/sprints.ts
+import chalk3 from "chalk";
 var SPRINT_COLUMNS = [
   { key: "id", label: "ID" },
-  { key: "sprint", label: "SPRINT", maxWidth: 60 },
+  {
+    key: "sprint",
+    label: "SPRINT",
+    maxWidth: 60,
+    format: (v, row) => row.active ? chalk3.green(v) : v
+  },
   { key: "dates", label: "DATES" }
 ];
 function formatSprintDate(d) {
@@ -2067,7 +2113,8 @@ async function listSprints(config, opts = {}) {
     return {
       id: s.id,
       sprint: s.active ? `* ${s.name}` : s.name,
-      dates: dateStr
+      dates: dateStr,
+      active: s.active
     };
   });
   if (!isTTY()) {
@@ -2106,7 +2153,7 @@ async function postComment(config, taskId, text, notifyAll) {
 }
 
 // src/commands/comments.ts
-import chalk3 from "chalk";
+import chalk4 from "chalk";
 async function fetchComments(config, taskId) {
   const client = new ClickUpClient(config);
   const comments = await client.getTaskComments(taskId);
@@ -2130,11 +2177,11 @@ function printComments(comments, forceJson) {
     console.log("No comments found.");
     return;
   }
-  const separator = chalk3.dim("-".repeat(60));
+  const separator = chalk4.dim("-".repeat(60));
   for (let i = 0; i < comments.length; i++) {
     const c = comments[i];
     if (i > 0) console.log(separator);
-    console.log(`${chalk3.bold(c.user)}  ${chalk3.dim(formatTimestamp(c.date))}`);
+    console.log(`${chalk4.bold(c.user)}  ${chalk4.dim(formatTimestamp(c.date))}`);
     console.log(c.text);
     if (i < comments.length - 1) console.log("");
   }
@@ -2444,6 +2491,7 @@ async function openTask(config, query, opts = {}) {
 }
 
 // src/commands/summary.ts
+import chalk5 from "chalk";
 var IN_PROGRESS_PATTERNS = ["in progress", "in review", "code review", "doing"];
 function isCompletedRecently(task, cutoff) {
   if (!isDoneStatus(task.status.status)) return false;
@@ -2479,9 +2527,16 @@ function categorizeTasks(tasks, hoursBack, typeMap) {
   }
   return { completed, inProgress, overdue };
 }
+function colorSectionLabel(label) {
+  const lower = label.toLowerCase();
+  if (lower.includes("completed")) return chalk5.green(label);
+  if (lower.includes("progress")) return chalk5.yellow(label);
+  if (lower.includes("overdue")) return chalk5.red(label);
+  return label;
+}
 function printSection(label, tasks) {
   console.log(`
-${label} (${tasks.length})`);
+${colorSectionLabel(label)} (${tasks.length})`);
   if (tasks.length === 0) {
     console.log("  None");
   } else {
@@ -2601,7 +2656,7 @@ async function assignTask(config, taskId, opts) {
 }
 
 // src/commands/activity.ts
-import chalk4 from "chalk";
+import chalk6 from "chalk";
 async function fetchActivity(config, taskId) {
   const client = new ClickUpClient(config);
   const [task, rawComments] = await Promise.all([
@@ -2633,8 +2688,8 @@ ${commentsMd}`);
   }
   console.log(formatTaskDetail(result.task));
   console.log("");
-  console.log(chalk4.bold("Comments"));
-  console.log(chalk4.dim("-".repeat(60)));
+  console.log(chalk6.bold("Comments"));
+  console.log(chalk6.dim("-".repeat(60)));
   if (result.comments.length === 0) {
     console.log("No comments.");
     return;
@@ -2643,9 +2698,9 @@ ${commentsMd}`);
     const c = result.comments[i];
     if (i > 0) {
       console.log("");
-      console.log(chalk4.dim("-".repeat(60)));
+      console.log(chalk6.dim("-".repeat(60)));
     }
-    console.log(`${chalk4.bold(c.user)}  ${chalk4.dim(formatTimestamp(c.date))}`);
+    console.log(`${chalk6.bold(c.user)}  ${chalk6.dim(formatTimestamp(c.date))}`);
     console.log(c.text);
   }
 }
@@ -4548,7 +4603,7 @@ async function manageTags(config, taskId, opts) {
 }
 
 // src/commands/checklist.ts
-import chalk5 from "chalk";
+import chalk7 from "chalk";
 async function viewChecklists(config, taskId) {
   const client = new ClickUpClient(config);
   const task = await client.getTask(taskId);
@@ -4581,13 +4636,14 @@ function formatChecklists(checklists) {
   const lines = [];
   for (const cl of checklists) {
     const resolved = cl.items.filter((i) => i.resolved).length;
-    lines.push(chalk5.bold(`${cl.name} (${resolved}/${cl.items.length})`));
-    lines.push(chalk5.dim(`  ID: ${cl.id}`));
+    lines.push(chalk7.bold(`${cl.name} (${resolved}/${cl.items.length})`));
+    lines.push(chalk7.dim(`  ID: ${cl.id}`));
     for (const item of cl.items) {
-      const check = item.resolved ? chalk5.green("[x]") : chalk5.dim("[ ]");
-      const assignee = item.assignee ? chalk5.dim(` @${item.assignee.username}`) : "";
-      lines.push(`  ${check} ${item.name}${assignee}`);
-      lines.push(chalk5.dim(`      item-id: ${item.id}`));
+      const check = item.resolved ? chalk7.green("[x]") : chalk7.dim("[ ]");
+      const name = item.resolved ? chalk7.dim(item.name) : item.name;
+      const assignee = item.assignee ? chalk7.dim(` @${item.assignee.username}`) : "";
+      lines.push(`  ${check} ${name}${assignee}`);
+      lines.push(chalk7.dim(`      item-id: ${item.id}`));
     }
   }
   return lines.join("\n");
@@ -4618,7 +4674,7 @@ async function deleteComment(config, commentId) {
 }
 
 // src/commands/replies.ts
-import chalk6 from "chalk";
+import chalk8 from "chalk";
 async function getReplies(config, commentId) {
   const client = new ClickUpClient(config);
   return client.getThreadedComments(commentId);
@@ -4633,7 +4689,7 @@ function formatReplies(replies) {
   return replies.map((r) => {
     const user = r.user?.username ?? "Unknown";
     const date = formatTimestamp(Number(r.date));
-    return `${chalk6.bold(user)} ${chalk6.dim(date)}
+    return `${chalk8.bold(user)} ${chalk8.dim(date)}
   ${r.comment_text}`;
   }).join("\n\n");
 }
@@ -4672,7 +4728,10 @@ async function attachFile(config, taskId, filePath) {
 }
 
 // src/commands/docs.ts
-import chalk7 from "chalk";
+var DOC_COLUMNS = [
+  { key: "id", label: "ID", maxWidth: 15 },
+  { key: "name", label: "Name", maxWidth: 60 }
+];
 async function listDocs(config, query) {
   const client = new ClickUpClient(config);
   const docs = await client.getDocs(config.teamId);
@@ -4684,7 +4743,8 @@ async function listDocs(config, query) {
 }
 function formatDocs(docs) {
   if (docs.length === 0) return "No docs found";
-  return docs.map((d) => `${chalk7.bold(d.name)} ${chalk7.dim(d.id)}`).join("\n");
+  const rows = docs.map((d) => ({ name: d.name, id: d.id }));
+  return formatTable(rows, DOC_COLUMNS);
 }
 function formatDocsMarkdown(docs) {
   if (docs.length === 0) return "No docs found";
@@ -4692,7 +4752,7 @@ function formatDocsMarkdown(docs) {
 }
 
 // src/commands/doc.ts
-import chalk8 from "chalk";
+import chalk9 from "chalk";
 async function getDocInfo(config, docId) {
   const client = new ClickUpClient(config);
   const [doc, pages] = await Promise.all([
@@ -4704,14 +4764,14 @@ async function getDocInfo(config, docId) {
 function formatDocInfo(doc, pages, indent = 0) {
   const lines = [];
   if (indent === 0) {
-    lines.push(`${chalk8.bold(doc.name)} ${chalk8.dim(doc.id)}`);
+    lines.push(`${chalk9.bold(doc.name)} ${chalk9.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} ${chalk8.dim(page.id)}`);
+    lines.push(`${prefix}${page.name} ${chalk9.dim(page.id)}`);
     if (page.pages && page.pages.length > 0) {
       lines.push(formatDocInfo(doc, page.pages, indent + 1));
     }
@@ -4790,7 +4850,7 @@ async function deleteDocPage(config, docId, pageId) {
 }
 
 // src/commands/folders.ts
-import chalk9 from "chalk";
+import chalk10 from "chalk";
 async function listFolders(config, spaceId, nameFilter) {
   const client = new ClickUpClient(config);
   const folders = await client.getFolders(spaceId);
@@ -4809,9 +4869,9 @@ async function listFolders(config, spaceId, nameFilter) {
 function formatFolders(folders) {
   if (folders.length === 0) return "No folders found";
   return folders.map((f) => {
-    const header = `${chalk9.bold(f.name)} ${chalk9.dim(f.id)}`;
+    const header = `${chalk10.bold(f.name)} ${chalk10.dim(f.id)}`;
     if (f.lists.length === 0) return header;
-    const listLines = f.lists.map((l) => `  ${l.name} ${chalk9.dim(l.id)}`);
+    const listLines = f.lists.map((l) => `  ${chalk10.dim(">")} ${l.name} ${chalk10.dim(l.id)}`);
     return [header, ...listLines].join("\n");
   }).join("\n\n");
 }
@@ -4826,7 +4886,14 @@ function formatFoldersMarkdown(folders) {
 }
 
 // src/commands/time.ts
-import chalk10 from "chalk";
+import chalk11 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" ? chalk11.green(v) : "" }
+];
 async function startTimer(config, taskId, description) {
   const client = new ClickUpClient(config);
   return client.startTimeEntry(config.teamId, taskId, description);
@@ -4870,22 +4937,33 @@ async function deleteTimeEntry(config, timeEntryId) {
   await client.deleteTimeEntry(config.teamId, timeEntryId);
 }
 function formatTimeEntry(entry) {
-  const lines = [];
   const taskName = entry.task?.name ?? "No task";
-  const taskId = entry.task?.id ?? "";
   const isRunning = entry.duration < 0;
   const elapsed = isRunning ? Date.now() - Number(entry.start) : entry.duration;
-  const durationStr = formatDuration(elapsed);
-  const status = isRunning ? chalk10.green("RUNNING") : "";
-  lines.push(`${chalk10.bold(taskName)} ${chalk10.dim(taskId)} ${status}`);
-  lines.push(
-    `  ${durationStr} - ${formatTimestamp(entry.start)}${entry.description ? ` - ${entry.description}` : ""}`
-  );
-  return lines.join("\n");
+  const row = {
+    task: taskName,
+    duration: formatDuration(elapsed),
+    date: formatTimestamp(entry.start),
+    description: entry.description ?? "",
+    status: isRunning ? "RUNNING" : ""
+  };
+  return formatTable([row], TIME_COLUMNS);
 }
 function formatTimeEntries(entries) {
   if (entries.length === 0) return "No time entries";
-  return entries.map(formatTimeEntry).join("\n");
+  const rows = entries.map((entry) => {
+    const taskName = entry.task?.name ?? "No task";
+    const isRunning = entry.duration < 0;
+    const elapsed = isRunning ? Date.now() - Number(entry.start) : entry.duration;
+    return {
+      task: taskName,
+      duration: formatDuration(elapsed),
+      date: formatTimestamp(entry.start),
+      description: entry.description ?? "",
+      status: isRunning ? "RUNNING" : ""
+    };
+  });
+  return formatTable(rows, TIME_COLUMNS);
 }
 function formatTimeEntryMarkdown(entry) {
   const taskName = entry.task?.name ?? "No task";
@@ -4902,7 +4980,7 @@ function formatTimeEntriesMarkdown(entries) {
 }
 
 // src/commands/tags.ts
-import chalk11 from "chalk";
+import chalk12 from "chalk";
 async function listSpaceTags(config, spaceId) {
   const client = new ClickUpClient(config);
   return client.getSpaceTags(spaceId);
@@ -4925,7 +5003,7 @@ async function updateSpaceTag(config, spaceId, tagName, updates) {
 }
 function formatTags(tags) {
   if (tags.length === 0) return "No tags found";
-  return tags.map((t) => chalk11.bold(t.name)).join(", ");
+  return tags.map((t) => chalk12.bold(t.name)).join(", ");
 }
 function formatTagsMarkdown(tags) {
   if (tags.length === 0) return "No tags found";
@@ -4933,14 +5011,23 @@ function formatTagsMarkdown(tags) {
 }
 
 // src/commands/members.ts
-import chalk12 from "chalk";
+var MEMBER_COLUMNS = [
+  { key: "username", label: "Username", maxWidth: 25 },
+  { key: "id", label: "ID", maxWidth: 15 },
+  { key: "email", label: "Email", maxWidth: 40 }
+];
 async function listMembers(config) {
   const client = new ClickUpClient(config);
   return client.getWorkspaceMembers(config.teamId);
 }
 function formatMembers(members) {
   if (members.length === 0) return "No members found";
-  return members.map((m) => `${chalk12.bold(m.username)} ${chalk12.dim(`(${m.id})`)} ${m.email}`).join("\n");
+  const rows = members.map((m) => ({
+    username: m.username,
+    id: String(m.id),
+    email: m.email
+  }));
+  return formatTable(rows, MEMBER_COLUMNS);
 }
 function formatMembersMarkdown(members) {
   if (members.length === 0) return "No members found";
@@ -4949,17 +5036,30 @@ function formatMembersMarkdown(members) {
 
 // src/commands/fields.ts
 import chalk13 from "chalk";
+var FIELD_COLUMNS = [
+  { key: "name", label: "Name", maxWidth: 30 },
+  { key: "type", label: "Type", maxWidth: 15 },
+  {
+    key: "required",
+    label: "Required",
+    maxWidth: 10,
+    format: (v) => v === "yes" ? chalk13.yellow(v) : chalk13.dim(v)
+  },
+  { key: "options", label: "Options", maxWidth: 40 }
+];
 async function listFields(config, listId) {
   const client = new ClickUpClient(config);
   return client.getListCustomFields(listId);
 }
 function formatFields(fields) {
   if (fields.length === 0) return "No custom fields";
-  return fields.map((f) => {
-    const options = f.type_config?.options?.map((o) => o.name).join(", ");
-    const optStr = options ? ` ${chalk13.dim(`[${options}]`)}` : "";
-    return `${chalk13.bold(f.name)} ${chalk13.dim(f.type)}${f.required ? chalk13.yellow(" (required)") : ""}${optStr}`;
-  }).join("\n");
+  const rows = fields.map((f) => ({
+    name: f.name,
+    type: f.type,
+    required: f.required ? "yes" : "no",
+    options: f.type_config?.options?.map((o) => o.name).join(", ") ?? ""
+  }));
+  return formatTable(rows, FIELD_COLUMNS);
 }
 function formatFieldsMarkdown(fields) {
   if (fields.length === 0) return "No custom fields";
@@ -5003,6 +5103,25 @@ async function bulkUpdateStatus(config, taskIds, status) {
 
 // src/commands/goals.ts
 import chalk14 from "chalk";
+function colorProgress(value) {
+  const num = parseInt(value, 10);
+  if (isNaN(num)) return value;
+  if (num >= 75) return chalk14.green(value);
+  if (num >= 25) return chalk14.yellow(value);
+  return chalk14.red(value);
+}
+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 }
+];
+var KEY_RESULT_COLUMNS = [
+  { key: "id", label: "ID", maxWidth: 15 },
+  { key: "name", label: "Name", maxWidth: 40 },
+  { key: "progress", label: "Progress", maxWidth: 10, format: (v) => colorProgress(v) },
+  { key: "current", label: "Current/Target", maxWidth: 15 }
+];
 async function listGoals(config) {
   const client = new ClickUpClient(config);
   return client.getGoals(config.teamId);
@@ -5040,11 +5159,13 @@ async function updateKeyResult(config, keyResultId, updates) {
 }
 function formatGoals(goals) {
   if (goals.length === 0) return "No goals found";
-  return goals.map((g) => {
-    const pct = Math.round(g.percent_completed * 100);
-    const owner = g.owner ? ` ${chalk14.dim(`@${g.owner.username}`)}` : "";
-    return `${chalk14.bold(g.name)} ${chalk14.dim(`(${g.id})`)} ${chalk14.cyan(`${pct}%`)}${owner}`;
-  }).join("\n");
+  const rows = goals.map((g) => ({
+    name: g.name,
+    id: g.id,
+    progress: `${Math.round(g.percent_completed * 100)}%`,
+    owner: g.owner ? `@${g.owner.username}` : ""
+  }));
+  return formatTable(rows, GOAL_COLUMNS);
 }
 function formatGoalsMarkdown(goals) {
   if (goals.length === 0) return "No goals found";
@@ -5056,10 +5177,13 @@ function formatGoalsMarkdown(goals) {
 }
 function formatKeyResults(keyResults) {
   if (keyResults.length === 0) return "No key results found";
-  return keyResults.map((kr) => {
-    const pct = Math.round(kr.percent_completed * 100);
-    return `${chalk14.bold(kr.name)} ${chalk14.dim(`(${kr.id})`)} ${chalk14.cyan(`${kr.steps_current}/${kr.steps_end}`)} ${chalk14.dim(`${pct}%`)}`;
-  }).join("\n");
+  const rows = keyResults.map((kr) => ({
+    name: kr.name,
+    id: kr.id,
+    progress: `${Math.round(kr.percent_completed * 100)}%`,
+    current: `${kr.steps_current}/${kr.steps_end}`
+  }));
+  return formatTable(rows, KEY_RESULT_COLUMNS);
 }
 function formatKeyResultsMarkdown(keyResults) {
   if (keyResults.length === 0) return "No key results found";

package/package.json

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