@krodak/clickup-cli 0.16.0 → 0.17.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 cu command",
-  "version": "0.16.0",
+  "version": "0.17.0",
   "author": {
     "name": "Krzysztof Rodak"
   },

package/README.md

@@ -246,10 +246,10 @@ Status: :white_check_mark: implemented | :construction: planned | :no_entry_sign
 
 ### Attachments
 
-| Feature          | Command                 | Status         |
-| ---------------- | ----------------------- | -------------- |
-| Upload file      | `cu attach <id> <file>` | :construction: |
-| List attachments |                         | :construction: |
+| Feature          | Command                   | Status             |
+| ---------------- | ------------------------- | ------------------ |
+| Upload file      | `cu attach <id> <file>`   | :white_check_mark: |
+| List attachments | shown inline in `cu task` | :white_check_mark: |
 
 ### :no_entry_sign: Won't add
 

package/dist/index.js

@@ -314,6 +314,37 @@ var ClickUpClient = class {
       method: "DELETE"
     });
   }
+  async createTaskAttachment(taskId, filePath) {
+    const { readFile } = await import("fs/promises");
+    const { basename } = await import("path");
+    const fileBuffer = await readFile(filePath);
+    const fileName = basename(filePath);
+    const formData = new FormData();
+    formData.append("attachment", new Blob([fileBuffer]), fileName);
+    const res = await fetch(`${BASE_URL}/task/${taskId}/attachment`, {
+      method: "POST",
+      headers: { Authorization: this.apiToken },
+      body: formData,
+      signal: AbortSignal.timeout(6e4)
+    });
+    if (!res.ok) {
+      let msg;
+      try {
+        const data2 = await res.json();
+        msg = data2.err ?? `HTTP ${res.status}`;
+      } catch {
+        msg = `HTTP ${res.status}`;
+      }
+      throw new Error(`ClickUp API error ${res.status}: ${msg}`);
+    }
+    let data;
+    try {
+      data = await res.json();
+    } catch {
+      throw new Error(`ClickUp API error ${res.status}: response was not valid JSON`);
+    }
+    return data;
+  }
 };
 
 // src/config.ts
@@ -546,6 +577,12 @@ function formatTaskDetailMarkdown(task) {
       lines.push("");
     }
   }
+  if (task.attachments?.length) {
+    lines.push("", "## Attachments", "");
+    for (const att of task.attachments) {
+      lines.push(`- [${att.title}](${att.url})`);
+    }
+  }
   return lines.join("\n");
 }
 function formatUpdateConfirmation(id, name) {
@@ -692,6 +729,13 @@ function formatTaskDetail(task) {
       }
     }
   }
+  if (task.attachments?.length) {
+    lines.push("");
+    lines.push(chalk2.bold("Attachments"));
+    for (const att of task.attachments) {
+      lines.push(`  ${att.title} ${chalk2.dim(att.url)}`);
+    }
+  }
   if (task.text_content?.trim()) {
     lines.push("");
     lines.push(descriptionPreview(task.text_content));
@@ -1827,7 +1871,7 @@ function bashCompletion() {
     cword=$COMP_CWORD
   fi
 
-  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"
+  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 attach move field delete tag checklist time config completion"
 
   if [[ $cword -eq 1 ]]; then
     COMPREPLY=($(compgen -W "$commands --help --version" -- "$cur"))
@@ -1948,6 +1992,9 @@ function bashCompletion() {
     link)
       COMPREPLY=($(compgen -W "--remove --json" -- "$cur"))
       ;;
+    attach)
+      COMPREPLY=($(compgen -f -- "$cur"))
+      ;;
     config)
       if [[ $cword -eq 2 ]]; then
         COMPREPLY=($(compgen -W "get set path" -- "$cur"))
@@ -2007,6 +2054,7 @@ _cu() {
     'replies:List threaded replies on a comment'
     'reply:Reply to a comment'
     'link:Add or remove a link between two tasks'
+    'attach:Upload a file attachment to a task'
     'config:Manage CLI configuration'
     'completion:Output shell completion script'
   )
@@ -2320,6 +2368,12 @@ _cu() {
             '--remove[Remove the link instead of adding it]' \\
             '--json[Force JSON output]'
           ;;
+        attach)
+          _arguments \\
+            '1:task_id:' \\
+            '2:file_path:_files' \\
+            '--json[Force JSON output]'
+          ;;
         config)
           local -a config_cmds
           config_cmds=(
@@ -2393,6 +2447,7 @@ 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 attach -d 'Upload a file attachment to a task'
 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'
 
@@ -2535,6 +2590,9 @@ complete -c cu -n '__fish_seen_subcommand_from reply' -l json -d 'Force JSON out
 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 attach' -l json -d 'Force JSON output'
+complete -c cu -n '__fish_seen_subcommand_from attach' -F
+
 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'
@@ -2885,6 +2943,18 @@ async function manageTaskLink(config, taskId, linksTo, remove) {
   return `Linked ${taskId} to ${linksTo}`;
 }
 
+// src/commands/attach.ts
+async function attachFile(config, taskId, filePath) {
+  const { access } = await import("fs/promises");
+  try {
+    await access(filePath);
+  } catch {
+    throw new Error(`File not found: ${filePath}`);
+  }
+  const client = new ClickUpClient(config);
+  return client.createTaskAttachment(taskId, filePath);
+}
+
 // src/commands/time.ts
 import chalk7 from "chalk";
 function formatDuration2(ms) {
@@ -3259,6 +3329,18 @@ program.command("link <taskId> <linksTo>").description("Add or remove a link bet
     }
   )
 );
+program.command("attach <taskId> <filePath>").description("Upload a file attachment to a task").option("--json", "Force JSON output even in terminal").action(
+  wrapAction(async (taskId, filePath, opts) => {
+    const config = loadConfig();
+    const result = await attachFile(config, taskId, filePath);
+    if (shouldOutputJson(opts.json ?? false)) {
+      console.log(JSON.stringify(result, null, 2));
+    } else {
+      console.log(`Uploaded "${result.title}" to task ${taskId}`);
+      console.log(`  ${result.url}`);
+    }
+  })
+);
 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();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@krodak/clickup-cli",
-  "version": "0.16.0",
+  "version": "0.17.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, 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.'
+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, attachments, file uploads.'
 ---
 
 # ClickUp CLI (`cu`)
@@ -77,6 +77,7 @@ All commands support `--help` for full flag details.
 | `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 attach <taskId> <filePath> [--json]`                                                                                                                                           | Upload file attachment to a task            |
 | `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                |
@@ -120,7 +121,8 @@ All commands support `--help` for full flag details.
 | `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 attach`               | Upload files to tasks. Attachments shown in `cu task` detail view                                      |
+| `cu task`                 | Shows custom fields, checklists, and attachments 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                                                             |
@@ -182,6 +184,7 @@ 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 attach abc123def ./screenshot.png        # upload file to task
 cu time start abc123def -d "Working on feature"  # start timer
 cu time status                                    # check running timer
 cu time stop                                      # stop timer