@krodak/clickup-cli 1.33.0 → 1.34.0

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "clickup-cli",
   "description": "ClickUp CLI skills for managing tasks, sprints, comments, checklists, custom fields, tags, and time tracking via the cup command",
-  "version": "1.33.0",
+  "version": "1.34.0",
   "author": {
     "name": "Krzysztof Rodak"
   },

package/dist/index.js

@@ -97,10 +97,38 @@ var ClickUpClient = class {
     }
     return "";
   }
+  sleep(ms) {
+    return new Promise((resolve2) => setTimeout(resolve2, ms));
+  }
+  retryDelayMs(res, attempt) {
+    const retryAfter = res.headers.get("retry-after");
+    if (retryAfter) {
+      const seconds = Number(retryAfter);
+      if (Number.isFinite(seconds) && seconds > 0) {
+        return Math.min(seconds, 60) * 1e3;
+      }
+    }
+    return Math.min(2 ** (attempt - 1) * 1e3, 6e4);
+  }
+  async fetchWithRetry(url, init) {
+    const maxRetries = 3;
+    let attempt = 0;
+    for (; ; ) {
+      const res = await fetch(url, { ...init, signal: AbortSignal.timeout(3e4) });
+      const retryable = res.status === 429 || res.status === 502 || res.status === 503 || res.status === 504;
+      if (!retryable || attempt >= maxRetries) return res;
+      attempt++;
+      const delayMs = this.retryDelayMs(res, attempt);
+      process.stderr.write(
+        `Rate limited (${res.status}). Retrying in ${Math.round(delayMs / 1e3)}s... (attempt ${attempt}/${maxRetries})
+`
+      );
+      await this.sleep(delayMs);
+    }
+  }
   async _fetch(baseUrl, path, options = {}) {
-    const res = await fetch(`${baseUrl}${path}`, {
+    const res = await this.fetchWithRetry(`${baseUrl}${path}`, {
       ...options,
-      signal: AbortSignal.timeout(3e4),
       headers: {
         Authorization: this.apiToken,
         ...options.body ? { "Content-Type": "application/json" } : {},
@@ -134,8 +162,7 @@ var ClickUpClient = class {
     return this._fetch(BASE_URL_V3, path, options);
   }
   async requestV3Array(path) {
-    const res = await fetch(`${BASE_URL_V3}${path}`, {
-      signal: AbortSignal.timeout(3e4),
+    const res = await this.fetchWithRetry(`${BASE_URL_V3}${path}`, {
       headers: { Authorization: this.apiToken }
     });
     if (res.status === 204 || res.headers.get("content-length") === "0") {

package/package.json

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

package/skills/clickup-cli/SKILL.md

@@ -3,11 +3,11 @@ name: clickup
 description: 'Use when managing ClickUp tasks, sprints, or comments via the `cup` 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, listing members, listing fields, duplicating tasks, bulk operations, goals, key results, saved filters, favorites.'
 ---
 
-# ClickUp CLI (`cup`) - skill version 1.33.0
+# ClickUp CLI (`cup`) - skill version 1.34.0
 
 Reference for AI agents using the `cup` CLI tool. Covers task management, sprint tracking, comments, time tracking, custom fields, goals, docs, and project workflows.
 
-> **Version check:** Run `cup --version`. If your installed version is older than 1.33.0, update with `npm install -g @krodak/clickup-cli` and refresh this skill with `cup skill`.
+> **Version check:** Run `cup --version`. If your installed version is older than 1.34.0, update with `npm install -g @krodak/clickup-cli` and refresh this skill with `cup skill`.
 
 ## Install & Configure
 
@@ -288,6 +288,7 @@ All commands support `--help` for full flag details. All commands support `--jso
 | `cup link`               | Both IDs must be the same type (both custom or both native)                                                                                                                                                                                                                                                                                        |
 | `cup delete`             | DESTRUCTIVE. Requires `--confirm` in non-interactive mode. Cannot be undone                                                                                                                                                                                                                                                                        |
 | Errors                   | stderr with exit code 1. Strict parsing - excess/unknown arguments rejected                                                                                                                                                                                                                                                                        |
+| Rate limiting            | The client auto-retries on HTTP 429 and transient 5xx (502/503/504) with `Retry-After`-aware backoff (up to 3 retries). Retry warnings go to stderr. No action needed by callers                                                                                                                                                                   |
 | Description quoting      | Use `$'...'` quoting for `-d` / `-m` values containing backticks or newlines: `-d $'Use \`init()\` first.\n\n- Step 1'`. Heredocs and double quotes strip backticks                                                                                                                                                                                |
 | `--mention <user>`       | Real ClickUp @mention (notifies the user). Accepts ID, email, username, or `me`. Repeatable. Also: `<@userId>` inline token in `-m` for mid-sentence mentions. Bare `@Name` is NOT parsed (ambiguous). On `comment`, `reply`, `comment-edit`, `list-comment`, `view-comment`                                                                       |
 | Comment links            | In comment messages, bare URLs (`https://...`) and markdown links (`[text](url)`) both render as clickable links. Unfurled preview cards are not supported (web-UI only)                                                                                                                                                                           |