@krodak/clickup-cli 0.13.1 → 0.14.0

package/README.md

@@ -98,7 +98,7 @@ When output is piped (no TTY), all commands output **Markdown** by default - opt
 
 ## Commands
 
-29 commands total. All support `--help` for full flag details.
+31 commands total. All support `--help` for full flag details.
 
 ### `cu init`
 
@@ -170,7 +170,7 @@ cu inbox --json
 
 ### `cu task <id>`
 
-Get task details including custom fields. Pretty summary in terminal, JSON when piped.
+Get task details including custom fields and checklists. Pretty summary in terminal, JSON when piped.
 
 ```bash
 cu task abc123
@@ -201,6 +201,7 @@ cu update abc123 -n "New task name"
 cu update abc123 -d "Updated description with **markdown**"
 cu update abc123 --priority high
 cu update abc123 --due-date 2025-03-15
+cu update abc123 --assignee me
 cu update abc123 --assignee 12345
 cu update abc123 -n "New name" -s "done" --priority urgent
 cu update abc123 --time-estimate 2h
@@ -216,7 +217,7 @@ cu update abc123 -s "in progress" --json
 | `--priority <level>`         | Priority: `urgent`, `high`, `normal`, `low` (or 1-4)                        |
 | `--due-date <date>`          | Due date (`YYYY-MM-DD`)                                                     |
 | `--time-estimate <duration>` | Time estimate (e.g. `"2h"`, `"30m"`, `"1h30m"`)                             |
-| `--assignee <userId>`        | Add assignee by numeric user ID                                             |
+| `--assignee <userId>`        | Add assignee by user ID or `"me"`                                           |
 | `--parent <taskId>`          | Set parent task (makes this a subtask)                                      |
 | `--json`                     | Force JSON output even in terminal                                          |
 
@@ -229,7 +230,7 @@ cu create -n "Fix login bug" -l <listId>
 cu create -n "Subtask name" -p <parentTaskId>    # --list auto-detected
 cu create -n "Task" -l <listId> -d "desc" -s "open"
 cu create -n "Task" -l <listId> --priority high --due-date 2025-06-01
-cu create -n "Task" -l <listId> --assignee 12345 --tags "bug,frontend"
+cu create -n "Task" -l <listId> --assignee me --tags "bug,frontend"
 cu create -n "Initiative" -l <listId> --custom-item-id 1
 cu create -n "Task" -l <listId> --time-estimate 2h
 cu create -n "Fix bug" -l <listId> --json
@@ -245,7 +246,7 @@ cu create -n "Fix bug" -l <listId> --json
 | `--priority <level>`         | no               | Priority: `urgent`, `high`, `normal`, `low` (or 1-4) |
 | `--due-date <date>`          | no               | Due date (`YYYY-MM-DD`)                              |
 | `--time-estimate <duration>` | no               | Time estimate (e.g. `"2h"`, `"30m"`, `"1h30m"`)      |
-| `--assignee <userId>`        | no               | Assignee by numeric user ID                          |
+| `--assignee <userId>`        | no               | Assignee by user ID or `"me"`                        |
 | `--tags <tags>`              | no               | Comma-separated tag names                            |
 | `--custom-item-id <id>`      | no               | Custom task type ID (e.g. for creating initiatives)  |
 | `--json`                     | no               | Force JSON output even in terminal                   |
@@ -310,6 +311,24 @@ cu comments abc123
 cu comments abc123 --json
 ```
 
+### `cu comment-edit <commentId>`
+
+Edit an existing comment on a task.
+
+```bash
+cu comment-edit <commentId> -m "Updated text"
+cu comment-edit <commentId> -m "Fixed" --resolved
+cu comment-edit <commentId> -m "Reopening" --unresolved
+cu comment-edit <commentId> -m "Updated" --json
+```
+
+| Flag            | Required | Description                |
+| --------------- | -------- | -------------------------- |
+| `-m, --message` | yes      | New comment text           |
+| `--resolved`    | no       | Mark comment as resolved   |
+| `--unresolved`  | no       | Mark comment as unresolved |
+| `--json`        | no       | Force JSON output          |
+
 ### `cu activity <id>`
 
 View task details and comment history together. Combines `cu task` and `cu comments` into a single view.
@@ -472,6 +491,32 @@ cu tag abc123 --add "bug" --json
 | `--remove <tags>` | Comma-separated tag names to remove |
 | `--json`          | Force JSON output                   |
 
+### `cu checklist`
+
+Manage checklists on tasks. Six subcommands for full CRUD operations.
+
+```bash
+cu checklist view abc123                           # view all checklists on a task
+cu checklist create abc123 "QA Checklist"           # add a checklist
+cu checklist delete <checklistId>                   # remove a checklist
+cu checklist add-item <checklistId> "Run tests"     # add an item
+cu checklist edit-item <clId> <itemId> --resolved   # mark item done
+cu checklist delete-item <clId> <itemId>            # remove an item
+```
+
+| Subcommand    | Arguments                        | Description           |
+| ------------- | -------------------------------- | --------------------- |
+| `view`        | `<taskId>`                       | Show all checklists   |
+| `create`      | `<taskId> <name>`                | Create a checklist    |
+| `delete`      | `<checklistId>`                  | Delete a checklist    |
+| `add-item`    | `<checklistId> <name>`           | Add checklist item    |
+| `edit-item`   | `<checklistId> <itemId> [flags]` | Edit checklist item   |
+| `delete-item` | `<checklistId> <itemId>`         | Delete checklist item |
+
+`edit-item` flags: `--name <text>`, `--resolved`, `--unresolved`, `--assignee <userId>`. All subcommands support `--json`.
+
+Checklists are also shown inline in `cu task <id>` detail view.
+
 ### `cu auth`
 
 Check authentication status. Validates your API token and shows your user info.

package/dist/index.js

@@ -4,72 +4,6 @@
 import { Command } from "commander";
 import { createRequire } from "module";
 
-// src/config.ts
-import fs from "fs";
-import { homedir } from "os";
-import { join } from "path";
-function configDir() {
-  const xdg = process.env.XDG_CONFIG_HOME;
-  if (xdg) return join(xdg, "cu");
-  return join(homedir(), ".config", "cu");
-}
-function configPath() {
-  return join(configDir(), "config.json");
-}
-function loadConfig() {
-  const envToken = process.env.CU_API_TOKEN?.trim();
-  const envTeamId = process.env.CU_TEAM_ID?.trim();
-  let fileToken;
-  let fileTeamId;
-  const path = configPath();
-  if (fs.existsSync(path)) {
-    const raw = fs.readFileSync(path, "utf-8");
-    let parsed;
-    try {
-      parsed = JSON.parse(raw);
-    } catch {
-      throw new Error(`Config file at ${path} contains invalid JSON. Please check the file syntax.`);
-    }
-    fileToken = parsed.apiToken?.trim();
-    fileTeamId = parsed.teamId?.trim();
-  }
-  const apiToken = envToken || fileToken;
-  if (!apiToken) {
-    throw new Error("Config missing required field: apiToken.\nSet CU_API_TOKEN or run: cu init");
-  }
-  if (!apiToken.startsWith("pk_")) {
-    throw new Error("Config apiToken must start with pk_. The configured token does not.");
-  }
-  const teamId = envTeamId || fileTeamId;
-  if (!teamId) {
-    throw new Error("Config missing required field: teamId.\nSet CU_TEAM_ID or run: cu init");
-  }
-  return { apiToken, teamId };
-}
-function loadRawConfig() {
-  const path = configPath();
-  if (!fs.existsSync(path)) return {};
-  try {
-    return JSON.parse(fs.readFileSync(path, "utf-8"));
-  } catch {
-    return {};
-  }
-}
-function getConfigPath() {
-  return configPath();
-}
-function writeConfig(config) {
-  const dir = configDir();
-  if (!fs.existsSync(dir)) {
-    fs.mkdirSync(dir, { recursive: true, mode: 448 });
-  }
-  const filePath = join(dir, "config.json");
-  fs.writeFileSync(filePath, JSON.stringify(config, null, 2) + "\n", {
-    encoding: "utf-8",
-    mode: 384
-  });
-}
-
 // src/api.ts
 var BASE_URL = "https://api.clickup.com/api/v2";
 var MAX_PAGES = 100;
@@ -259,8 +193,116 @@ var ClickUpClient = class {
       method: "DELETE"
     });
   }
+  async updateComment(commentId, text, resolved) {
+    const body = { comment_text: text };
+    if (resolved !== void 0) body.resolved = resolved;
+    await this.request(`/comment/${commentId}`, {
+      method: "PUT",
+      body: JSON.stringify(body)
+    });
+  }
+  async getListCustomFields(listId) {
+    const data = await this.request(`/list/${listId}/field`);
+    return data.fields ?? [];
+  }
+  async createChecklist(taskId, name) {
+    const data = await this.request(`/task/${taskId}/checklist`, {
+      method: "POST",
+      body: JSON.stringify({ name })
+    });
+    return data.checklist;
+  }
+  async deleteChecklist(checklistId) {
+    await this.request(`/checklist/${checklistId}`, { method: "DELETE" });
+  }
+  async createChecklistItem(checklistId, name) {
+    const data = await this.request(
+      `/checklist/${checklistId}/checklist_item`,
+      { method: "POST", body: JSON.stringify({ name }) }
+    );
+    return data.checklist;
+  }
+  async editChecklistItem(checklistId, checklistItemId, updates) {
+    const data = await this.request(
+      `/checklist/${checklistId}/checklist_item/${checklistItemId}`,
+      { method: "PUT", body: JSON.stringify(updates) }
+    );
+    return data.checklist;
+  }
+  async deleteChecklistItem(checklistId, checklistItemId) {
+    await this.request(
+      `/checklist/${checklistId}/checklist_item/${checklistItemId}`,
+      { method: "DELETE" }
+    );
+  }
 };
 
+// src/config.ts
+import fs from "fs";
+import { homedir } from "os";
+import { join } from "path";
+function configDir() {
+  const xdg = process.env.XDG_CONFIG_HOME;
+  if (xdg) return join(xdg, "cu");
+  return join(homedir(), ".config", "cu");
+}
+function configPath() {
+  return join(configDir(), "config.json");
+}
+function loadConfig() {
+  const envToken = process.env.CU_API_TOKEN?.trim();
+  const envTeamId = process.env.CU_TEAM_ID?.trim();
+  let fileToken;
+  let fileTeamId;
+  const path = configPath();
+  if (fs.existsSync(path)) {
+    const raw = fs.readFileSync(path, "utf-8");
+    let parsed;
+    try {
+      parsed = JSON.parse(raw);
+    } catch {
+      throw new Error(`Config file at ${path} contains invalid JSON. Please check the file syntax.`);
+    }
+    fileToken = parsed.apiToken?.trim();
+    fileTeamId = parsed.teamId?.trim();
+  }
+  const apiToken = envToken || fileToken;
+  if (!apiToken) {
+    throw new Error("Config missing required field: apiToken.\nSet CU_API_TOKEN or run: cu init");
+  }
+  if (!apiToken.startsWith("pk_")) {
+    throw new Error("Config apiToken must start with pk_. The configured token does not.");
+  }
+  const teamId = envTeamId || fileTeamId;
+  if (!teamId) {
+    throw new Error("Config missing required field: teamId.\nSet CU_TEAM_ID or run: cu init");
+  }
+  return { apiToken, teamId };
+}
+function loadRawConfig() {
+  const path = configPath();
+  if (!fs.existsSync(path)) return {};
+  try {
+    return JSON.parse(fs.readFileSync(path, "utf-8"));
+  } catch {
+    return {};
+  }
+}
+function getConfigPath() {
+  return configPath();
+}
+function writeConfig(config) {
+  const dir = configDir();
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true, mode: 448 });
+  }
+  const filePath = join(dir, "config.json");
+  fs.writeFileSync(filePath, JSON.stringify(config, null, 2) + "\n", {
+    encoding: "utf-8",
+    mode: 384
+  });
+}
+
 // src/date.ts
 function formatDate(ms) {
   const d = new Date(Number(ms));
@@ -414,6 +456,17 @@ function formatTaskDetailMarkdown(task) {
   if (descriptionContent) {
     lines.push("", "## Description", "", descriptionContent);
   }
+  if (task.checklists?.length) {
+    lines.push("", "## Checklists", "");
+    for (const cl of task.checklists) {
+      const resolved = cl.items.filter((i) => i.resolved).length;
+      lines.push(`### ${cl.name} (${resolved}/${cl.items.length})`, "");
+      for (const item of cl.items) {
+        lines.push(`- [${item.resolved ? "x" : " "}] ${item.name}`);
+      }
+      lines.push("");
+    }
+  }
   return lines.join("\n");
 }
 function formatUpdateConfirmation(id, name) {
@@ -548,6 +601,18 @@ function formatTaskDetail(task) {
       }
     }
   }
+  if (task.checklists?.length) {
+    lines.push("");
+    lines.push(chalk2.bold("Checklists"));
+    for (const cl of task.checklists) {
+      const resolved = cl.items.filter((i) => i.resolved).length;
+      lines.push(`  ${chalk2.bold(cl.name)} (${resolved}/${cl.items.length})`);
+      for (const item of cl.items) {
+        const check = item.resolved ? chalk2.green("[x]") : chalk2.dim("[ ]");
+        lines.push(`    ${check} ${item.name}`);
+      }
+    }
+  }
   if (task.text_content?.trim()) {
     lines.push("");
     lines.push(descriptionPreview(task.text_content));
@@ -754,9 +819,16 @@ function parseDueDate(value) {
 }
 function parseAssigneeId(value) {
   const id = Number(value);
-  if (!Number.isInteger(id)) throw new Error("Assignee must be a numeric user ID");
+  if (!Number.isInteger(id)) throw new Error('Assignee must be a numeric user ID or "me"');
   return id;
 }
+async function resolveAssigneeId(client, value) {
+  if (value === "me") {
+    const user = await client.getMe();
+    return user.id;
+  }
+  return parseAssigneeId(value);
+}
 function parseTimeEstimate(value) {
   const pattern = /^(?:(\d+)h)?(?:(\d+)m)?$/i;
   const match = value.match(pattern);
@@ -1583,13 +1655,6 @@ function configPath2() {
 }
 
 // src/commands/assign.ts
-async function resolveUserId(client, value) {
-  if (value === "me") {
-    const user = await client.getMe();
-    return user.id;
-  }
-  return parseAssigneeId(value);
-}
 async function assignTask(config, taskId, opts) {
   if (!opts.to && !opts.remove) {
     throw new Error("Provide at least one of: --to, --remove");
@@ -1598,10 +1663,10 @@ async function assignTask(config, taskId, opts) {
   const add = [];
   const rem = [];
   if (opts.to) {
-    add.push(await resolveUserId(client, opts.to));
+    add.push(await resolveAssigneeId(client, opts.to));
   }
   if (opts.remove) {
-    rem.push(await resolveUserId(client, opts.remove));
+    rem.push(await resolveAssigneeId(client, opts.remove));
   }
   return client.updateTask(taskId, {
     assignees: {
@@ -1684,7 +1749,7 @@ function bashCompletion() {
     cword=$COMP_CWORD
   fi
 
-  local commands="init auth tasks task update create sprint sprints subtasks comment comments activity lists spaces inbox assigned open search summary overdue assign depend move field delete tag config completion"
+  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"
 
   if [[ $cword -eq 1 ]]; then
     COMPREPLY=($(compgen -W "$commands --help --version" -- "$cur"))
@@ -1780,6 +1845,14 @@ function bashCompletion() {
     tag)
       COMPREPLY=($(compgen -W "--add --remove --json" -- "$cur"))
       ;;
+    checklist)
+      if [[ $cword -eq 2 ]]; then
+        COMPREPLY=($(compgen -W "view create delete add-item edit-item delete-item" -- "$cur"))
+      fi
+      ;;
+    comment-edit)
+      COMPREPLY=($(compgen -W "-m --message --resolved --unresolved --json" -- "$cur"))
+      ;;
     config)
       if [[ $cword -eq 2 ]]; then
         COMPREPLY=($(compgen -W "get set path" -- "$cur"))
@@ -1832,6 +1905,8 @@ _cu() {
     'field:Set or remove a custom field value on a task'
     'delete:Delete a task'
     'tag:Add or remove tags from a task'
+    'checklist:Manage checklists on a task'
+    'comment-edit:Edit an existing comment'
     'config:Manage CLI configuration'
     'completion:Output shell completion script'
   )
@@ -2019,6 +2094,62 @@ _cu() {
             '--remove[Comma-separated tag names to remove]:tags:' \\
             '--json[Force JSON output]'
           ;;
+        checklist)
+          local -a checklist_cmds
+          checklist_cmds=(
+            'view:View checklists on a task'
+            'create:Create a checklist on a task'
+            'delete:Delete a checklist'
+            'add-item:Add an item to a checklist'
+            'edit-item:Edit a checklist item'
+            'delete-item:Delete a checklist item'
+          )
+          _arguments -C \\
+            '1:checklist command:->checklist_cmd' \\
+            '*::checklist_arg:->checklist_args'
+          case $state in
+            checklist_cmd)
+              _describe 'checklist command' checklist_cmds
+              ;;
+            checklist_args)
+              case $words[1] in
+                view)
+                  _arguments '1:task_id:' '--json[Force JSON output]'
+                  ;;
+                create)
+                  _arguments '1:task_id:' '2:name:' '--json[Force JSON output]'
+                  ;;
+                delete)
+                  _arguments '1:checklist_id:' '--json[Force JSON output]'
+                  ;;
+                add-item)
+                  _arguments '1:checklist_id:' '2:name:' '--json[Force JSON output]'
+                  ;;
+                edit-item)
+                  _arguments \\
+                    '1:checklist_id:' \\
+                    '2:checklist_item_id:' \\
+                    '--name[New item name]:name:' \\
+                    '--resolved[Mark item as resolved]' \\
+                    '--unresolved[Mark item as unresolved]' \\
+                    '--assignee[Assign user by ID]:user_id:' \\
+                    '--json[Force JSON output]'
+                  ;;
+                delete-item)
+                  _arguments '1:checklist_id:' '2:checklist_item_id:' '--json[Force JSON output]'
+                  ;;
+              esac
+              ;;
+          esac
+          ;;
+        comment-edit)
+          _arguments \\
+            '1:comment_id:' \\
+            '(-m --message)'{-m,--message}'[New comment text]:text:' \\
+            '--resolved[Mark comment as resolved]' \\
+            '--unresolved[Mark comment as unresolved]' \\
+            '--json[Force JSON output]'
+          ;;
         config)
           local -a config_cmds
           config_cmds=(
@@ -2085,6 +2216,8 @@ complete -c cu -n __fish_use_subcommand -a move -d 'Add or remove a task from a
 complete -c cu -n __fish_use_subcommand -a field -d 'Set or remove a custom field value on a task'
 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 comment-edit -d 'Edit an existing comment'
 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'
 
@@ -2194,6 +2327,23 @@ complete -c cu -n '__fish_seen_subcommand_from tag' -l add -d 'Comma-separated t
 complete -c cu -n '__fish_seen_subcommand_from tag' -l remove -d 'Comma-separated tag names to remove'
 complete -c cu -n '__fish_seen_subcommand_from tag' -l json -d 'Force JSON output'
 
+complete -c cu -n '__fish_seen_subcommand_from checklist; and not __fish_seen_subcommand_from view create delete add-item edit-item delete-item' -a view -d 'View checklists on a task'
+complete -c cu -n '__fish_seen_subcommand_from checklist; and not __fish_seen_subcommand_from view create delete add-item edit-item delete-item' -a create -d 'Create a checklist on a task'
+complete -c cu -n '__fish_seen_subcommand_from checklist; and not __fish_seen_subcommand_from view create delete add-item edit-item delete-item' -a delete -d 'Delete a checklist'
+complete -c cu -n '__fish_seen_subcommand_from checklist; and not __fish_seen_subcommand_from view create delete add-item edit-item delete-item' -a add-item -d 'Add an item to a checklist'
+complete -c cu -n '__fish_seen_subcommand_from checklist; and not __fish_seen_subcommand_from view create delete add-item edit-item delete-item' -a edit-item -d 'Edit a checklist item'
+complete -c cu -n '__fish_seen_subcommand_from checklist; and not __fish_seen_subcommand_from view create delete add-item edit-item delete-item' -a delete-item -d 'Delete a checklist item'
+complete -c cu -n '__fish_seen_subcommand_from view create delete add-item edit-item delete-item' -l json -d 'Force JSON output'
+complete -c cu -n '__fish_seen_subcommand_from edit-item' -l name -d 'New item name'
+complete -c cu -n '__fish_seen_subcommand_from edit-item' -l resolved -d 'Mark item as resolved'
+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 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'
+complete -c cu -n '__fish_seen_subcommand_from comment-edit' -l json -d 'Force JSON output'
+
 complete -c cu -n '__fish_seen_subcommand_from config; and not __fish_seen_subcommand_from get set path' -a get -d 'Print a config value'
 complete -c cu -n '__fish_seen_subcommand_from config; and not __fish_seen_subcommand_from get set path' -a set -d 'Set a config value'
 complete -c cu -n '__fish_seen_subcommand_from config; and not __fish_seen_subcommand_from get set path' -a path -d 'Print config file path'
@@ -2448,6 +2598,59 @@ async function manageTags(config, taskId, opts) {
   return { taskId, added, removed };
 }
 
+// src/commands/checklist.ts
+import chalk5 from "chalk";
+async function viewChecklists(config, taskId) {
+  const client = new ClickUpClient(config);
+  const task = await client.getTask(taskId);
+  return task.checklists ?? [];
+}
+async function createChecklist(config, taskId, name) {
+  const client = new ClickUpClient(config);
+  return client.createChecklist(taskId, name);
+}
+async function deleteChecklist(config, checklistId) {
+  const client = new ClickUpClient(config);
+  await client.deleteChecklist(checklistId);
+  return { checklistId };
+}
+async function addChecklistItem(config, checklistId, name) {
+  const client = new ClickUpClient(config);
+  return client.createChecklistItem(checklistId, name);
+}
+async function editChecklistItem(config, checklistId, checklistItemId, updates) {
+  const client = new ClickUpClient(config);
+  return client.editChecklistItem(checklistId, checklistItemId, updates);
+}
+async function deleteChecklistItem(config, checklistId, checklistItemId) {
+  const client = new ClickUpClient(config);
+  await client.deleteChecklistItem(checklistId, checklistItemId);
+  return { checklistId, checklistItemId };
+}
+function formatChecklists(checklists) {
+  if (checklists.length === 0) return "No 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}`));
+    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}`));
+    }
+  }
+  return lines.join("\n");
+}
+
+// src/commands/comment-edit.ts
+async function editComment(config, commentId, text, resolved) {
+  if (!text.trim()) throw new Error("Comment text cannot be empty");
+  const client = new ClickUpClient(config);
+  await client.updateComment(commentId, text, resolved);
+}
+
 // src/index.ts
 var require2 = createRequire(import.meta.url);
 var { version } = require2("../package.json");
@@ -2509,9 +2712,13 @@ program.command("task <taskId>").description("Get task details").option("--json"
     }
   })
 );
-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").option("--parent <taskId>", "Set parent task (makes this a subtask)").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("--json", "Force JSON output even in terminal").action(
   wrapAction(async (taskId, opts) => {
     const config = loadConfig();
+    if (opts.assignee === "me") {
+      const client = new ClickUpClient(config);
+      opts.assignee = String(await resolveAssigneeId(client, "me"));
+    }
     const payload = buildUpdatePayload(opts);
     const result = await updateTask(config, taskId, payload);
     if (shouldOutputJson(opts.json ?? false)) {
@@ -2521,9 +2728,13 @@ program.command("update <taskId>").description("Update a task").option("-n, --na
     }
   })
 );
-program.command("create").description("Create a new task").option("-l, --list <listId>", "Target list ID (auto-detected from --parent if omitted)").requiredOption("-n, --name <name>", "Task name").option("-d, --description <text>", "Task description (markdown supported)").option("-p, --parent <taskId>", "Parent task ID (list auto-detected from parent)").option("-s, --status <status>", "Initial status").option("--priority <level>", "Priority: urgent, high, normal, low (or 1-4)").option("--due-date <date>", "Due date (YYYY-MM-DD)").option("--assignee <userId>", "Assignee user ID").option("--tags <tags>", "Comma-separated tag names").option("--custom-item-id <id>", "Custom task type ID (use to create initiatives)").option("--time-estimate <duration>", 'Time estimate (e.g. "2h", "30m", "1h30m")').option("--json", "Force JSON output even in terminal").action(
+program.command("create").description("Create a new task").option("-l, --list <listId>", "Target list ID (auto-detected from --parent if omitted)").requiredOption("-n, --name <name>", "Task name").option("-d, --description <text>", "Task description (markdown supported)").option("-p, --parent <taskId>", "Parent task ID (list auto-detected from parent)").option("-s, --status <status>", "Initial status").option("--priority <level>", "Priority: urgent, high, normal, low (or 1-4)").option("--due-date <date>", "Due date (YYYY-MM-DD)").option("--assignee <userId>", 'Assignee user ID or "me"').option("--tags <tags>", "Comma-separated tag names").option("--custom-item-id <id>", "Custom task type ID (use to create initiatives)").option("--time-estimate <duration>", 'Time estimate (e.g. "2h", "30m", "1h30m")').option("--json", "Force JSON output even in terminal").action(
   wrapAction(async (opts) => {
     const config = loadConfig();
+    if (opts.assignee === "me") {
+      const client = new ClickUpClient(config);
+      opts.assignee = String(await resolveAssigneeId(client, "me"));
+    }
     const result = await createTask(config, opts);
     if (shouldOutputJson(opts.json ?? false)) {
       console.log(JSON.stringify(result, null, 2));
@@ -2581,6 +2792,22 @@ program.command("comments <taskId>").description("List comments on a task").opti
     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(
+  wrapAction(
+    async (commentId, opts) => {
+      const config = loadConfig();
+      let resolved;
+      if (opts.resolved) resolved = true;
+      if (opts.unresolved) resolved = false;
+      await editComment(config, commentId, opts.message, resolved);
+      if (shouldOutputJson(opts.json ?? false)) {
+        console.log(JSON.stringify({ success: true, commentId }, null, 2));
+      } else {
+        console.log(`Comment ${commentId} updated`);
+      }
+    }
+  )
+);
 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();
@@ -2746,6 +2973,82 @@ program.command("tag <taskId>").description("Add or remove tags from a task").op
     }
   })
 );
+var checklistCmd = program.command("checklist").description("Manage checklists on a task");
+checklistCmd.command("view <taskId>").description("View checklists on a task").option("--json", "Force JSON output even in terminal").action(
+  wrapAction(async (taskId, opts) => {
+    const config = loadConfig();
+    const checklists = await viewChecklists(config, taskId);
+    if (shouldOutputJson(opts.json ?? false)) {
+      console.log(JSON.stringify(checklists, null, 2));
+    } else {
+      console.log(formatChecklists(checklists));
+    }
+  })
+);
+checklistCmd.command("create <taskId> <name>").description("Create a checklist on a task").option("--json", "Force JSON output even in terminal").action(
+  wrapAction(async (taskId, name, opts) => {
+    const config = loadConfig();
+    const result = await createChecklist(config, taskId, name);
+    if (shouldOutputJson(opts.json ?? false)) {
+      console.log(JSON.stringify(result, null, 2));
+    } else {
+      console.log(`Created checklist "${result.name}" (id: ${result.id})`);
+    }
+  })
+);
+checklistCmd.command("delete <checklistId>").description("Delete a checklist").option("--json", "Force JSON output even in terminal").action(
+  wrapAction(async (checklistId, opts) => {
+    const config = loadConfig();
+    const result = await deleteChecklist(config, checklistId);
+    if (shouldOutputJson(opts.json ?? false)) {
+      console.log(JSON.stringify(result, null, 2));
+    } else {
+      console.log(`Deleted checklist ${result.checklistId}`);
+    }
+  })
+);
+checklistCmd.command("add-item <checklistId> <name>").description("Add an item to a checklist").option("--json", "Force JSON output even in terminal").action(
+  wrapAction(async (checklistId, name, opts) => {
+    const config = loadConfig();
+    const result = await addChecklistItem(config, checklistId, name);
+    if (shouldOutputJson(opts.json ?? false)) {
+      console.log(JSON.stringify(result, null, 2));
+    } else {
+      console.log(`Added item "${name}" to checklist ${checklistId}`);
+    }
+  })
+);
+checklistCmd.command("edit-item <checklistId> <checklistItemId>").description("Edit a checklist item").option("--name <name>", "New item name").option("--resolved", "Mark item as resolved").option("--unresolved", "Mark item as unresolved").option("--assignee <userId>", 'Assign user by ID (use "null" to unassign)').option("--json", "Force JSON output even in terminal").action(
+  wrapAction(
+    async (checklistId, checklistItemId, opts) => {
+      const config = loadConfig();
+      const updates = {};
+      if (opts.name) updates.name = opts.name;
+      if (opts.resolved) updates.resolved = true;
+      if (opts.unresolved) updates.resolved = false;
+      if (opts.assignee !== void 0) {
+        updates.assignee = opts.assignee === "null" ? null : Number(opts.assignee);
+      }
+      const result = await editChecklistItem(config, checklistId, checklistItemId, updates);
+      if (shouldOutputJson(opts.json ?? false)) {
+        console.log(JSON.stringify(result, null, 2));
+      } else {
+        console.log(`Updated checklist item ${checklistItemId}`);
+      }
+    }
+  )
+);
+checklistCmd.command("delete-item <checklistId> <checklistItemId>").description("Delete a checklist item").option("--json", "Force JSON output even in terminal").action(
+  wrapAction(async (checklistId, checklistItemId, opts) => {
+    const config = loadConfig();
+    const result = await deleteChecklistItem(config, checklistId, checklistItemId);
+    if (shouldOutputJson(opts.json ?? false)) {
+      console.log(JSON.stringify(result, null, 2));
+    } else {
+      console.log(`Deleted checklist item ${result.checklistItemId}`);
+    }
+  })
+);
 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.13.1",
+  "version": "0.14.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.'
+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.'
 ---
 
 # ClickUp CLI (`cu`)
@@ -55,19 +55,26 @@ All commands support `--help` for full flag details.
 
 ### Write
 
-| Command                                                                                                                                                                        | What it does                                |
-| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------- |
-| `cu update <id> [-n name] [-d desc] [-s status] [--priority p] [--due-date d] [--time-estimate t] [--assignee id] [--parent id] [--json]`                                      | Update task fields (desc supports markdown) |
-| `cu create -n name [-l listId] [-p parentId] [-d desc] [-s status] [--priority p] [--due-date d] [--time-estimate t] [--assignee id] [--tags t] [--custom-item-id n] [--json]` | Create task (desc supports markdown)        |
-| `cu comment <id> -m text [--json]`                                                                                                                                             | Post comment on task                        |
-| `cu assign <id> [--to userId\|me] [--remove userId\|me] [--json]`                                                                                                              | Assign/unassign users                       |
-| `cu depend <id> [--on taskId] [--blocks taskId] [--remove] [--json]`                                                                                                           | Add/remove task dependencies                |
-| `cu move <id> [--to listId] [--remove listId] [--json]`                                                                                                                        | Add/remove task from lists                  |
-| `cu field <id> [--set "Name" value] [--remove "Name"] [--json]`                                                                                                                | Set/remove custom field values              |
-| `cu delete <id> [--confirm] [--json]`                                                                                                                                          | Delete a task (DESTRUCTIVE, irreversible)   |
-| `cu tag <id> [--add tags] [--remove tags] [--json]`                                                                                                                            | Add/remove tags on a task                   |
-| `cu config get <key>` / `cu config set <key> <value>` / `cu config path`                                                                                                       | Manage CLI config                           |
-| `cu completion <shell>`                                                                                                                                                        | Shell completions (bash/zsh/fish)           |
+| Command                                                                                                                                                                            | What it does                                |
+| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------- |
+| `cu update <id> [-n name] [-d desc] [-s status] [--priority p] [--due-date d] [--time-estimate t] [--assignee id\|me] [--parent id] [--json]`                                      | Update task fields (desc supports markdown) |
+| `cu 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] [--json]` | Create task (desc supports markdown)        |
+| `cu comment <id> -m text [--json]`                                                                                                                                                 | Post comment on task                        |
+| `cu comment-edit <commentId> -m text [--resolved] [--unresolved] [--json]`                                                                                                         | Edit an existing comment                    |
+| `cu assign <id> [--to userId\|me] [--remove userId\|me] [--json]`                                                                                                                  | Assign/unassign users                       |
+| `cu depend <id> [--on taskId] [--blocks taskId] [--remove] [--json]`                                                                                                               | Add/remove task dependencies                |
+| `cu move <id> [--to listId] [--remove listId] [--json]`                                                                                                                            | Add/remove task from lists                  |
+| `cu field <id> [--set "Name" value] [--remove "Name"] [--json]`                                                                                                                    | Set/remove custom field values              |
+| `cu delete <id> [--confirm] [--json]`                                                                                                                                              | Delete a task (DESTRUCTIVE, irreversible)   |
+| `cu tag <id> [--add tags] [--remove tags] [--json]`                                                                                                                                | Add/remove tags on a task                   |
+| `cu checklist view <id> [--json]`                                                                                                                                                  | View checklists on a task                   |
+| `cu checklist create <id> <name> [--json]`                                                                                                                                         | Create a checklist                          |
+| `cu checklist delete <checklistId> [--json]`                                                                                                                                       | Delete a checklist                          |
+| `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 config get <key>` / `cu config set <key> <value>` / `cu config path`                                                                                                           | Manage CLI config                           |
+| `cu completion <shell>`                                                                                                                                                            | Shell completions (bash/zsh/fish)           |
 
 ## Quick Reference
 
@@ -79,7 +86,7 @@ All commands support `--help` for full flag details.
 | `--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`            | Numeric user ID (find via `cu task <id> --json`)                                                       |
+| `--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)                                          |
@@ -98,7 +105,9 @@ All commands support `--help` for full flag details.
 | `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 task`               | Shows custom fields in detail view                                                                     |
+| `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                                                             |
@@ -150,6 +159,11 @@ cu field abc123def --set "Category" "Bug Fix"
 cu field abc123def --remove "Old Field"
 cu tag abc123def --add "bug,frontend"
 cu tag abc123def --remove "triage"
+cu checklist view abc123def                           # view checklists
+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 delete abc123def --confirm          # irreversible!
 ```