@krodak/clickup-cli 0.14.0 → 0.16.0

package/dist/index.js

@@ -120,6 +120,9 @@ var ClickUpClient = class {
   async getSpaceWithStatuses(spaceId) {
     return this.request(`/space/${spaceId}`);
   }
+  async getListWithStatuses(listId) {
+    return this.request(`/list/${listId}`);
+  }
   async getSpaces(teamId) {
     const data = await this.request(`/team/${teamId}/space?archived=false`);
     return data.spaces ?? [];
@@ -201,6 +204,25 @@ var ClickUpClient = class {
       body: JSON.stringify(body)
     });
   }
+  async deleteComment(commentId) {
+    await this.request(`/comment/${commentId}`, { method: "DELETE" });
+  }
+  async getThreadedComments(commentId) {
+    const data = await this.request(`/comment/${commentId}/reply`);
+    return data.comments ?? [];
+  }
+  async createThreadedComment(commentId, text) {
+    await this.request(`/comment/${commentId}/reply`, {
+      method: "POST",
+      body: JSON.stringify({ comment_text: text })
+    });
+  }
+  async addTaskLink(taskId, linksTo) {
+    await this.request(`/task/${taskId}/link/${linksTo}`, { method: "POST" });
+  }
+  async deleteTaskLink(taskId, linksTo) {
+    await this.request(`/task/${taskId}/link/${linksTo}`, { method: "DELETE" });
+  }
   async getListCustomFields(listId) {
     const data = await this.request(`/list/${listId}/field`);
     return data.fields ?? [];
@@ -235,6 +257,63 @@ var ClickUpClient = class {
       { method: "DELETE" }
     );
   }
+  async startTimeEntry(teamId, taskId, description) {
+    const body = {
+      tid: taskId,
+      start: Date.now(),
+      duration: -1
+    };
+    if (description) body.description = description;
+    const data = await this.request(`/team/${teamId}/time_entries/start`, {
+      method: "POST",
+      body: JSON.stringify(body)
+    });
+    return data.data;
+  }
+  async stopTimeEntry(teamId) {
+    const data = await this.request(`/team/${teamId}/time_entries/stop`, {
+      method: "POST"
+    });
+    return data.data;
+  }
+  async getRunningTimeEntry(teamId) {
+    const data = await this.request(
+      `/team/${teamId}/time_entries/current`
+    );
+    return data.data ?? null;
+  }
+  async createTimeEntry(teamId, taskId, duration, opts) {
+    const start = opts?.start ?? Date.now() - duration;
+    const body = {
+      tid: taskId,
+      start,
+      duration
+    };
+    if (opts?.description) body.description = opts.description;
+    const data = await this.request(`/team/${teamId}/time_entries`, {
+      method: "POST",
+      body: JSON.stringify(body)
+    });
+    return data.data;
+  }
+  async getTimeEntries(teamId, opts) {
+    const params = new URLSearchParams();
+    if (opts?.startDate != null) params.set("start_date", String(opts.startDate));
+    if (opts?.endDate != null) params.set("end_date", String(opts.endDate));
+    const query = params.toString();
+    const url = `/team/${teamId}/time_entries${query ? `?${query}` : ""}`;
+    const data = await this.request(url);
+    const entries = data.data ?? [];
+    if (opts?.taskId) {
+      return entries.filter((e) => e.task?.id === opts.taskId);
+    }
+    return entries;
+  }
+  async deleteTimeEntry(teamId, timeEntryId) {
+    await this.request(`/team/${teamId}/time_entries/${timeEntryId}`, {
+      method: "DELETE"
+    });
+  }
 };
 
 // src/config.ts
@@ -865,9 +944,8 @@ function hasUpdateFields(options) {
 }
 async function resolveStatus(client, taskId, statusInput) {
   const task = await client.getTask(taskId);
-  if (!task.space) return statusInput;
-  const space = await client.getSpaceWithStatuses(task.space.id);
-  const available = space.statuses.map((s) => s.status);
+  const list = await client.getListWithStatuses(task.list.id);
+  const available = list.statuses.map((s) => s.status);
   const matched = matchStatus(statusInput, available);
   if (!matched) {
     throw new Error(`No matching status for "${statusInput}". Available: ${available.join(", ")}`);
@@ -1749,7 +1827,7 @@ function bashCompletion() {
     cword=$COMP_CWORD
   fi
 
-  local commands="init auth tasks task update create sprint sprints subtasks comment comment-edit comments activity lists spaces inbox assigned open search summary overdue assign depend move field delete tag checklist config completion"
+  local commands="init auth tasks task update create sprint sprints subtasks comment comment-edit comment-delete comments replies reply activity lists spaces inbox assigned open search summary overdue assign depend link move field delete tag checklist time config completion"
 
   if [[ $cword -eq 1 ]]; then
     COMPREPLY=($(compgen -W "$commands --help --version" -- "$cur"))
@@ -1850,9 +1928,26 @@ function bashCompletion() {
         COMPREPLY=($(compgen -W "view create delete add-item edit-item delete-item" -- "$cur"))
       fi
       ;;
+    time)
+      if [[ $cword -eq 2 ]]; then
+        COMPREPLY=($(compgen -W "start stop status log list" -- "$cur"))
+      fi
+      ;;
     comment-edit)
       COMPREPLY=($(compgen -W "-m --message --resolved --unresolved --json" -- "$cur"))
       ;;
+    comment-delete)
+      COMPREPLY=($(compgen -W "--json" -- "$cur"))
+      ;;
+    replies)
+      COMPREPLY=($(compgen -W "--json" -- "$cur"))
+      ;;
+    reply)
+      COMPREPLY=($(compgen -W "-m --message --json" -- "$cur"))
+      ;;
+    link)
+      COMPREPLY=($(compgen -W "--remove --json" -- "$cur"))
+      ;;
     config)
       if [[ $cword -eq 2 ]]; then
         COMPREPLY=($(compgen -W "get set path" -- "$cur"))
@@ -1906,7 +2001,12 @@ _cu() {
     'delete:Delete a task'
     'tag:Add or remove tags from a task'
     'checklist:Manage checklists on a task'
+    'time:Track time on tasks'
     'comment-edit:Edit an existing comment'
+    'comment-delete:Delete a comment'
+    'replies:List threaded replies on a comment'
+    'reply:Reply to a comment'
+    'link:Add or remove a link between two tasks'
     'config:Manage CLI configuration'
     'completion:Output shell completion script'
   )
@@ -2142,6 +2242,53 @@ _cu() {
               ;;
           esac
           ;;
+        time)
+          local -a time_cmds
+          time_cmds=(
+            'start:Start tracking time on a task'
+            'stop:Stop the running timer'
+            'status:Show the currently running timer'
+            'log:Log a manual time entry'
+            'list:List recent time entries'
+          )
+          _arguments -C \\
+            '1:time command:->time_cmd' \\
+            '*::time_arg:->time_args'
+          case $state in
+            time_cmd)
+              _describe 'time command' time_cmds
+              ;;
+            time_args)
+              case $words[1] in
+                start)
+                  _arguments \\
+                    '1:task_id:' \\
+                    '(-d --description)'{-d,--description}'[Description]:text:' \\
+                    '--json[Force JSON output]'
+                  ;;
+                stop)
+                  _arguments '--json[Force JSON output]'
+                  ;;
+                status)
+                  _arguments '--json[Force JSON output]'
+                  ;;
+                log)
+                  _arguments \\
+                    '1:task_id:' \\
+                    '2:duration:' \\
+                    '(-d --description)'{-d,--description}'[Description]:text:' \\
+                    '--json[Force JSON output]'
+                  ;;
+                list)
+                  _arguments \\
+                    '--days[Number of days to look back]:days:' \\
+                    '--task[Filter by task ID]:task_id:' \\
+                    '--json[Force JSON output]'
+                  ;;
+              esac
+              ;;
+          esac
+          ;;
         comment-edit)
           _arguments \\
             '1:comment_id:' \\
@@ -2150,6 +2297,29 @@ _cu() {
             '--unresolved[Mark comment as unresolved]' \\
             '--json[Force JSON output]'
           ;;
+        comment-delete)
+          _arguments \\
+            '1:comment_id:' \\
+            '--json[Force JSON output]'
+          ;;
+        replies)
+          _arguments \\
+            '1:comment_id:' \\
+            '--json[Force JSON output]'
+          ;;
+        reply)
+          _arguments \\
+            '1:comment_id:' \\
+            '(-m --message)'{-m,--message}'[Reply text]:text:' \\
+            '--json[Force JSON output]'
+          ;;
+        link)
+          _arguments \\
+            '1:task_id:' \\
+            '2:links_to:' \\
+            '--remove[Remove the link instead of adding it]' \\
+            '--json[Force JSON output]'
+          ;;
         config)
           local -a config_cmds
           config_cmds=(
@@ -2217,7 +2387,12 @@ complete -c cu -n __fish_use_subcommand -a field -d 'Set or remove a custom fiel
 complete -c cu -n __fish_use_subcommand -a delete -d 'Delete a task'
 complete -c cu -n __fish_use_subcommand -a tag -d 'Add or remove tags from a task'
 complete -c cu -n __fish_use_subcommand -a checklist -d 'Manage checklists on a task'
+complete -c cu -n __fish_use_subcommand -a time -d 'Track time on tasks'
 complete -c cu -n __fish_use_subcommand -a comment-edit -d 'Edit an existing comment'
+complete -c cu -n __fish_use_subcommand -a comment-delete -d 'Delete a comment'
+complete -c cu -n __fish_use_subcommand -a replies -d 'List threaded replies on a comment'
+complete -c cu -n __fish_use_subcommand -a reply -d 'Reply to a comment'
+complete -c cu -n __fish_use_subcommand -a link -d 'Add or remove a link between two tasks'
 complete -c cu -n __fish_use_subcommand -a config -d 'Manage CLI configuration'
 complete -c cu -n __fish_use_subcommand -a completion -d 'Output shell completion script'
 
@@ -2339,6 +2514,27 @@ complete -c cu -n '__fish_seen_subcommand_from edit-item' -l resolved -d 'Mark i
 complete -c cu -n '__fish_seen_subcommand_from edit-item' -l unresolved -d 'Mark item as unresolved'
 complete -c cu -n '__fish_seen_subcommand_from edit-item' -l assignee -d 'Assign user by ID'
 
+complete -c cu -n '__fish_seen_subcommand_from time; and not __fish_seen_subcommand_from start stop status log list' -a start -d 'Start tracking time on a task'
+complete -c cu -n '__fish_seen_subcommand_from time; and not __fish_seen_subcommand_from start stop status log list' -a stop -d 'Stop the running timer'
+complete -c cu -n '__fish_seen_subcommand_from time; and not __fish_seen_subcommand_from start stop status log list' -a status -d 'Show the currently running timer'
+complete -c cu -n '__fish_seen_subcommand_from time; and not __fish_seen_subcommand_from start stop status log list' -a log -d 'Log a manual time entry'
+complete -c cu -n '__fish_seen_subcommand_from time; and not __fish_seen_subcommand_from start stop status log list' -a list -d 'List recent time entries'
+complete -c cu -n '__fish_seen_subcommand_from start stop status log list; and __fish_seen_subcommand_from time' -l json -d 'Force JSON output'
+complete -c cu -n '__fish_seen_subcommand_from start; and __fish_seen_subcommand_from time' -s d -l description -d 'Description'
+complete -c cu -n '__fish_seen_subcommand_from log; and __fish_seen_subcommand_from time' -s d -l description -d 'Description'
+complete -c cu -n '__fish_seen_subcommand_from list; and __fish_seen_subcommand_from time' -l days -d 'Number of days to look back'
+complete -c cu -n '__fish_seen_subcommand_from list; and __fish_seen_subcommand_from time' -l task -d 'Filter by task ID'
+
+complete -c cu -n '__fish_seen_subcommand_from comment-delete' -l json -d 'Force JSON output'
+
+complete -c cu -n '__fish_seen_subcommand_from replies' -l json -d 'Force JSON output'
+
+complete -c cu -n '__fish_seen_subcommand_from reply' -s m -l message -d 'Reply text'
+complete -c cu -n '__fish_seen_subcommand_from reply' -l json -d 'Force JSON output'
+
+complete -c cu -n '__fish_seen_subcommand_from link' -l remove -d 'Remove the link'
+complete -c cu -n '__fish_seen_subcommand_from link' -l json -d 'Force JSON output'
+
 complete -c cu -n '__fish_seen_subcommand_from comment-edit' -s m -l message -d 'New comment text'
 complete -c cu -n '__fish_seen_subcommand_from comment-edit' -l resolved -d 'Mark comment as resolved'
 complete -c cu -n '__fish_seen_subcommand_from comment-edit' -l unresolved -d 'Mark comment as unresolved'
@@ -2651,6 +2847,109 @@ async function editComment(config, commentId, text, resolved) {
   await client.updateComment(commentId, text, resolved);
 }
 
+// src/commands/comment-delete.ts
+async function deleteComment(config, commentId) {
+  const client = new ClickUpClient(config);
+  await client.deleteComment(commentId);
+}
+
+// src/commands/replies.ts
+import chalk6 from "chalk";
+async function getReplies(config, commentId) {
+  const client = new ClickUpClient(config);
+  return client.getThreadedComments(commentId);
+}
+async function createReply(config, commentId, text) {
+  if (!text.trim()) throw new Error("Reply text cannot be empty");
+  const client = new ClickUpClient(config);
+  await client.createThreadedComment(commentId, text);
+}
+function formatReplies(replies) {
+  if (replies.length === 0) return "No replies";
+  return replies.map((r) => {
+    const user = r.user?.username ?? "Unknown";
+    const date = new Date(Number(r.date)).toLocaleString();
+    return `${chalk6.bold(user)} ${chalk6.dim(date)}
+  ${r.comment_text}`;
+  }).join("\n\n");
+}
+
+// src/commands/link.ts
+async function manageTaskLink(config, taskId, linksTo, remove) {
+  const client = new ClickUpClient(config);
+  if (remove) {
+    await client.deleteTaskLink(taskId, linksTo);
+    return `Removed link between ${taskId} and ${linksTo}`;
+  }
+  await client.addTaskLink(taskId, linksTo);
+  return `Linked ${taskId} to ${linksTo}`;
+}
+
+// src/commands/time.ts
+import chalk7 from "chalk";
+function formatDuration2(ms) {
+  const totalMinutes = Math.round(Math.abs(ms) / 6e4);
+  const hours = Math.floor(totalMinutes / 60);
+  const minutes = totalMinutes % 60;
+  if (hours > 0 && minutes > 0) return `${hours}h ${minutes}m`;
+  if (hours > 0) return `${hours}h`;
+  return `${minutes}m`;
+}
+function formatTimestamp2(ms) {
+  return new Date(Number(ms)).toLocaleString("en-US", {
+    month: "short",
+    day: "numeric",
+    hour: "numeric",
+    minute: "2-digit"
+  });
+}
+async function startTimer(config, taskId, description) {
+  const client = new ClickUpClient(config);
+  return client.startTimeEntry(config.teamId, taskId, description);
+}
+async function stopTimer(config) {
+  const client = new ClickUpClient(config);
+  return client.stopTimeEntry(config.teamId);
+}
+async function timerStatus(config) {
+  const client = new ClickUpClient(config);
+  return client.getRunningTimeEntry(config.teamId);
+}
+async function logTime(config, taskId, durationStr, description) {
+  const client = new ClickUpClient(config);
+  const duration = parseTimeEstimate(durationStr);
+  return client.createTimeEntry(config.teamId, taskId, duration, { description });
+}
+async function listTimeEntries(config, opts) {
+  const client = new ClickUpClient(config);
+  const days = opts?.days ?? 7;
+  const endDate = Date.now();
+  const startDate = endDate - days * 24 * 60 * 60 * 1e3;
+  return client.getTimeEntries(config.teamId, {
+    startDate,
+    endDate,
+    taskId: opts?.taskId
+  });
+}
+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 = formatDuration2(elapsed);
+  const status = isRunning ? chalk7.green("RUNNING") : "";
+  lines.push(`${chalk7.bold(taskName)} ${chalk7.dim(taskId)} ${status}`);
+  lines.push(
+    `  ${durationStr} - ${formatTimestamp2(entry.start)}${entry.description ? ` - ${entry.description}` : ""}`
+  );
+  return lines.join("\n");
+}
+function formatTimeEntries(entries) {
+  if (entries.length === 0) return "No time entries";
+  return entries.map(formatTimeEntry).join("\n");
+}
+
 // src/index.ts
 var require2 = createRequire(import.meta.url);
 var { version } = require2("../package.json");
@@ -2808,6 +3107,39 @@ program.command("comment-edit <commentId>").description("Edit an existing commen
     }
   )
 );
+program.command("comment-delete <commentId>").description("Delete a comment").option("--json", "Force JSON output even in terminal").action(
+  wrapAction(async (commentId, opts) => {
+    const config = loadConfig();
+    await deleteComment(config, commentId);
+    if (shouldOutputJson(opts.json ?? false)) {
+      console.log(JSON.stringify({ success: true, commentId }, null, 2));
+    } else {
+      console.log(`Deleted comment ${commentId}`);
+    }
+  })
+);
+program.command("replies <commentId>").description("List threaded replies on a comment").option("--json", "Force JSON output even in terminal").action(
+  wrapAction(async (commentId, opts) => {
+    const config = loadConfig();
+    const replies = await getReplies(config, commentId);
+    if (shouldOutputJson(opts.json ?? false)) {
+      console.log(JSON.stringify(replies, null, 2));
+    } else {
+      console.log(formatReplies(replies));
+    }
+  })
+);
+program.command("reply <commentId>").description("Reply to a comment").requiredOption("-m, --message <text>", "Reply text").option("--json", "Force JSON output even in terminal").action(
+  wrapAction(async (commentId, opts) => {
+    const config = loadConfig();
+    await createReply(config, commentId, opts.message);
+    if (shouldOutputJson(opts.json ?? false)) {
+      console.log(JSON.stringify({ success: true, commentId }, null, 2));
+    } else {
+      console.log(`Replied to comment ${commentId}`);
+    }
+  })
+);
 program.command("activity <taskId>").description("Show task details and comments combined").option("--json", "Force JSON output even in terminal").action(
   wrapAction(async (taskId, opts) => {
     const config = loadConfig();
@@ -2908,6 +3240,25 @@ program.command("depend <taskId>").description("Add or remove task dependencies"
     }
   })
 );
+program.command("link <taskId> <linksTo>").description("Add or remove a link between two tasks").option("--remove", "Remove the link instead of adding it").option("--json", "Force JSON output even in terminal").action(
+  wrapAction(
+    async (taskId, linksTo, opts) => {
+      const config = loadConfig();
+      const result = await manageTaskLink(config, taskId, linksTo, opts.remove ?? false);
+      if (shouldOutputJson(opts.json ?? false)) {
+        console.log(
+          JSON.stringify(
+            { success: true, taskId, linksTo, action: opts.remove ? "removed" : "added" },
+            null,
+            2
+          )
+        );
+      } else {
+        console.log(result);
+      }
+    }
+  )
+);
 program.command("move <taskId>").description("Add or remove a task from a list").option("--to <listId>", "Add task to this list").option("--remove <listId>", "Remove task from this list").option("--json", "Force JSON output even in terminal").action(
   wrapAction(async (taskId, opts) => {
     const config = loadConfig();
@@ -3049,6 +3400,71 @@ checklistCmd.command("delete-item <checklistId> <checklistItemId>").description(
     }
   })
 );
+var timeCmd = program.command("time").description("Track time on tasks");
+timeCmd.command("start <taskId>").description("Start tracking time on a task").option("-d, --description <text>", "Description for the time entry").option("--json", "Force JSON output even in terminal").action(
+  wrapAction(async (taskId, opts) => {
+    const config = loadConfig();
+    const result = await startTimer(config, taskId, opts.description);
+    if (shouldOutputJson(opts.json ?? false)) {
+      console.log(JSON.stringify(result, null, 2));
+    } else {
+      const taskName = result.task?.name ?? taskId;
+      console.log(`Started timer on "${taskName}"`);
+    }
+  })
+);
+timeCmd.command("stop").description("Stop the running timer").option("--json", "Force JSON output even in terminal").action(
+  wrapAction(async (opts) => {
+    const config = loadConfig();
+    const result = await stopTimer(config);
+    if (shouldOutputJson(opts.json ?? false)) {
+      console.log(JSON.stringify(result, null, 2));
+    } else {
+      console.log(formatTimeEntry(result));
+    }
+  })
+);
+timeCmd.command("status").description("Show the currently running timer").option("--json", "Force JSON output even in terminal").action(
+  wrapAction(async (opts) => {
+    const config = loadConfig();
+    const result = await timerStatus(config);
+    if (shouldOutputJson(opts.json ?? false)) {
+      console.log(JSON.stringify(result, null, 2));
+    } else if (result) {
+      console.log(formatTimeEntry(result));
+    } else {
+      console.log("No timer running");
+    }
+  })
+);
+timeCmd.command("log <taskId> <duration>").description('Log a manual time entry (e.g. "2h", "30m", "1h30m")').option("-d, --description <text>", "Description for the time entry").option("--json", "Force JSON output even in terminal").action(
+  wrapAction(
+    async (taskId, duration, opts) => {
+      const config = loadConfig();
+      const result = await logTime(config, taskId, duration, opts.description);
+      if (shouldOutputJson(opts.json ?? false)) {
+        console.log(JSON.stringify(result, null, 2));
+      } else {
+        console.log(`Logged ${duration} on task ${taskId}`);
+      }
+    }
+  )
+);
+timeCmd.command("list").description("List recent time entries (default: last 7 days)").option("--days <n>", "Number of days to look back", "7").option("--task <taskId>", "Filter by task ID").option("--json", "Force JSON output even in terminal").action(
+  wrapAction(async (opts) => {
+    const config = loadConfig();
+    const days = opts.days ? Number(opts.days) : 7;
+    if (!Number.isFinite(days) || days <= 0) {
+      throw new Error("--days must be a positive number");
+    }
+    const entries = await listTimeEntries(config, { days, taskId: opts.task });
+    if (shouldOutputJson(opts.json ?? false)) {
+      console.log(JSON.stringify(entries, null, 2));
+    } else {
+      console.log(formatTimeEntries(entries));
+    }
+  })
+);
 var configCmd = program.command("config").description("Manage CLI configuration");
 configCmd.command("get <key>").description("Print a config value").action(
   wrapAction(async (key) => {

package/package.json

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

package/skills/clickup-cli/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: clickup
-description: 'Use when managing ClickUp tasks, sprints, or comments via the `cu` CLI tool. Triggers: task queries, status updates, sprint tracking, creating subtasks, posting comments, 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.'
+description: 'Use when managing ClickUp tasks, sprints, or comments via the `cu` 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.'
 ---
 
 # ClickUp CLI (`cu`)
@@ -73,44 +73,57 @@ All commands support `--help` for full flag details.
 | `cu checklist add-item <checklistId> <name> [--json]`                                                                                                                              | Add item to a checklist                     |
 | `cu checklist edit-item <checklistId> <itemId> [--name n] [--resolved] [--unresolved] [--assignee id] [--json]`                                                                    | Edit a checklist item                       |
 | `cu checklist delete-item <checklistId> <itemId> [--json]`                                                                                                                         | Delete a checklist item                     |
+| `cu comment-delete <commentId> [--json]`                                                                                                                                           | Delete a comment                            |
+| `cu replies <commentId> [--json]`                                                                                                                                                  | List threaded replies on a comment          |
+| `cu reply <commentId> -m text [--json]`                                                                                                                                            | Reply to a comment                          |
+| `cu link <taskId> <linksTo> [--remove] [--json]`                                                                                                                                   | Add or remove link between tasks            |
+| `cu time start <taskId> [-d desc] [--json]`                                                                                                                                        | Start tracking time on a task               |
+| `cu time stop [--json]`                                                                                                                                                            | Stop the running timer                      |
+| `cu time status [--json]`                                                                                                                                                          | Show currently running timer                |
+| `cu time log <taskId> <duration> [-d desc] [--json]`                                                                                                                               | Log manual time entry (e.g. "2h", "30m")    |
+| `cu time list [--days n] [--task id] [--json]`                                                                                                                                     | List recent time entries                    |
 | `cu config get <key>` / `cu config set <key> <value>` / `cu config path`                                                                                                           | Manage CLI config                           |
 | `cu completion <shell>`                                                                                                                                                            | Shell completions (bash/zsh/fish)           |
 
 ## Quick Reference
 
-| Topic                   | Detail                                                                                                 |
-| ----------------------- | ------------------------------------------------------------------------------------------------------ |
-| Task IDs                | Stable alphanumeric strings (e.g. `abc123def`)                                                         |
-| `--type`                | Filter by task type: `task` (regular), or custom type name/ID (e.g. `initiative`, `Bug`)               |
-| `--list` on create      | Optional when `--parent` is given (auto-detected)                                                      |
-| `--status`              | Fuzzy matching: exact > starts-with > contains. Prints match to stderr.                                |
-| `--priority`            | Names (`urgent`, `high`, `normal`, `low`) or numbers (1-4)                                             |
-| `--due-date`            | `YYYY-MM-DD` format                                                                                    |
-| `--assignee`            | User ID or `me` (on `cu create`, `cu update`, `cu assign`)                                             |
-| `--tags`                | Comma-separated (e.g. `--tags "bug,frontend"`)                                                         |
-| `--time-estimate`       | Duration format: `"2h"`, `"30m"`, `"1h30m"`, or raw milliseconds                                       |
-| `--custom-item-id`      | Custom task type ID for `cu create` (e.g. `1` for initiative)                                          |
-| `--on` / `--blocks`     | Task dependency direction (used with `cu depend`)                                                      |
-| `--to` / `--remove`     | List ID to add/remove task (used with `cu move`)                                                       |
-| `cu field --set`        | Supports: text, number, checkbox (true/false), dropdown (option name), date (YYYY-MM-DD), url, email   |
-| `cu field`              | Field names resolved case-insensitively; errors list available fields/options                          |
-| `cu delete`             | DESTRUCTIVE. Requires `--confirm` in non-interactive mode. Cannot be undone                            |
-| `cu tag --add/--remove` | Comma-separated tag names (e.g. `--add "bug,frontend"`)                                                |
-| `--space`               | Partial name match or exact ID                                                                         |
-| `--name`                | Partial match, case-insensitive                                                                        |
-| `--include-closed`      | Include closed/done tasks (on `tasks`, `assigned`, `subtasks`, `sprint`, `search`, `inbox`, `overdue`) |
-| `cu assign --to me`     | Shorthand for your own user ID                                                                         |
-| `cu search`             | Matches all query words against task name, case-insensitive                                            |
-| `cu sprint`             | Auto-detects active sprint via view API and date range parsing                                         |
-| `cu summary`            | Categories: completed (done/complete/closed within N hours), in progress, overdue                      |
-| `cu overdue`            | Excludes closed tasks, sorted most overdue first                                                       |
-| `cu open`               | Tries task ID first, falls back to name search                                                         |
-| `cu checklist`          | Full CRUD for task checklists: view, create, delete, add-item, edit-item, delete-item                  |
-| `cu comment-edit`       | Edit comment text and resolution status                                                                |
-| `cu task`               | Shows custom fields and checklists in detail view                                                      |
-| `cu lists`              | Discovers list IDs needed for `--list` and `cu create -l`                                              |
-| Errors                  | stderr with exit code 1                                                                                |
-| Parsing                 | Strict - excess/unknown arguments rejected                                                             |
+| Topic                     | Detail                                                                                                 |
+| ------------------------- | ------------------------------------------------------------------------------------------------------ |
+| Task IDs                  | Stable alphanumeric strings (e.g. `abc123def`)                                                         |
+| `--type`                  | Filter by task type: `task` (regular), or custom type name/ID (e.g. `initiative`, `Bug`)               |
+| `--list` on create        | Optional when `--parent` is given (auto-detected)                                                      |
+| `--status`                | Fuzzy matching: exact > starts-with > contains. Prints match to stderr.                                |
+| `--priority`              | Names (`urgent`, `high`, `normal`, `low`) or numbers (1-4)                                             |
+| `--due-date`              | `YYYY-MM-DD` format                                                                                    |
+| `--assignee`              | User ID or `me` (on `cu create`, `cu update`, `cu assign`)                                             |
+| `--tags`                  | Comma-separated (e.g. `--tags "bug,frontend"`)                                                         |
+| `--time-estimate`         | Duration format: `"2h"`, `"30m"`, `"1h30m"`, or raw milliseconds                                       |
+| `--custom-item-id`        | Custom task type ID for `cu create` (e.g. `1` for initiative)                                          |
+| `--on` / `--blocks`       | Task dependency direction (used with `cu depend`)                                                      |
+| `--to` / `--remove`       | List ID to add/remove task (used with `cu move`)                                                       |
+| `cu field --set`          | Supports: text, number, checkbox (true/false), dropdown (option name), date (YYYY-MM-DD), url, email   |
+| `cu field`                | Field names resolved case-insensitively; errors list available fields/options                          |
+| `cu delete`               | DESTRUCTIVE. Requires `--confirm` in non-interactive mode. Cannot be undone                            |
+| `cu tag --add/--remove`   | Comma-separated tag names (e.g. `--add "bug,frontend"`)                                                |
+| `--space`                 | Partial name match or exact ID                                                                         |
+| `--name`                  | Partial match, case-insensitive                                                                        |
+| `--include-closed`        | Include closed/done tasks (on `tasks`, `assigned`, `subtasks`, `sprint`, `search`, `inbox`, `overdue`) |
+| `cu assign --to me`       | Shorthand for your own user ID                                                                         |
+| `cu search`               | Matches all query words against task name, case-insensitive                                            |
+| `cu sprint`               | Auto-detects active sprint via view API and date range parsing                                         |
+| `cu summary`              | Categories: completed (done/complete/closed within N hours), in progress, overdue                      |
+| `cu overdue`              | Excludes closed tasks, sorted most overdue first                                                       |
+| `cu open`                 | Tries task ID first, falls back to name search                                                         |
+| `cu checklist`            | Full CRUD for task checklists: view, create, delete, add-item, edit-item, delete-item                  |
+| `cu time`                 | Track time: start/stop timer, log entries, list history. Duration format: "2h", "30m", "1h30m"         |
+| `cu comment-edit`         | Edit comment text and resolution status                                                                |
+| `cu comment-delete`       | Delete a comment                                                                                       |
+| `cu replies` / `cu reply` | View and post threaded comment replies                                                                 |
+| `cu link`                 | Link/unlink tasks (different from dependencies)                                                        |
+| `cu task`                 | Shows custom fields and checklists in detail view                                                      |
+| `cu lists`                | Discovers list IDs needed for `--list` and `cu create -l`                                              |
+| Errors                    | stderr with exit code 1                                                                                |
+| Parsing                   | Strict - excess/unknown arguments rejected                                                             |
 
 ## Agent Workflow Examples
 
@@ -164,6 +177,16 @@ cu checklist create abc123def "QA Steps"              # add checklist
 cu checklist add-item <clId> "Run unit tests"         # add item
 cu checklist edit-item <clId> <itemId> --resolved     # check off item
 cu comment-edit <commentId> -m "Updated findings"     # edit a comment
+cu comment-delete <commentId>               # delete a comment
+cu replies <commentId>                      # view threaded replies
+cu reply <commentId> -m "Agreed, fixing"    # reply to a comment
+cu link abc123 def456                       # link two tasks
+cu link abc123 def456 --remove              # unlink two tasks
+cu time start abc123def -d "Working on feature"  # start timer
+cu time status                                    # check running timer
+cu time stop                                      # stop timer
+cu time log abc123def 2h -d "Code review"         # log manual entry
+cu time list --days 7                             # recent entries
 cu delete abc123def --confirm          # irreversible!
 ```