@krodak/clickup-cli 1.35.0 → 1.36.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.35.0",
+  "version": "1.36.0",
   "author": {
     "name": "Krzysztof Rodak"
   },

package/dist/index.js

@@ -873,7 +873,7 @@ var ClickUpClient = class {
       body: JSON.stringify({ name })
     });
   }
-  async createCustomField(teamId, name, type, opts) {
+  buildCustomFieldBody(name, type, opts) {
     const typeConfig = {};
     if (opts?.options?.length) {
       typeConfig.options = opts.options.map((optName, i) => ({
@@ -881,7 +881,7 @@ var ClickUpClient = class {
         orderindex: i
       }));
     }
-    const body = {
+    return {
       name,
       type,
       type_config: typeConfig,
@@ -895,11 +895,22 @@ var ClickUpClient = class {
       members: [],
       groups: []
     };
+  }
+  async createCustomField(teamId, name, type, opts) {
+    const body = this.buildCustomFieldBody(name, type, opts);
     const data = await this.request(
-      `/field?workspace_id=${teamId}`,
+      `/team/${teamId}/field`,
       { method: "POST", body: JSON.stringify(body) }
     );
-    return data.data;
+    return data.field;
+  }
+  async createListCustomField(listId, name, type, opts) {
+    const body = this.buildCustomFieldBody(name, type, opts);
+    const data = await this.request(
+      `/list/${listId}/field`,
+      { method: "POST", body: JSON.stringify(body) }
+    );
+    return data.field;
   }
   chatChannelsPath(suffix = "") {
     return `/workspaces/${this.teamId}/chat/channels${suffix}`;
@@ -4499,13 +4510,23 @@ var commandMetadata = [
   },
   {
     name: "field-create",
-    description: "Create a custom field in your workspace",
-    flags: ["-t", "--type", "-d", "--description", "--options", "--required", "--json"],
+    description: "Create a custom field in your workspace or on one or more lists",
+    flags: [
+      "-t",
+      "--type",
+      "-d",
+      "--description",
+      "--options",
+      "--required",
+      "--list",
+      "--lists",
+      "--json"
+    ],
     quickReference: [
       {
         section: "write",
         usage: "field-create <name>",
-        description: "Create a custom field in your workspace"
+        description: "Create a custom field in your workspace or on one or more lists"
       }
     ]
   },
@@ -7443,21 +7464,6 @@ function formatFieldsMarkdown(fields) {
   }).join("\n");
 }
 
-// src/commands/duplicate.ts
-async function duplicateTask(config, taskId) {
-  const client = new ClickUpClient(config);
-  const task = await client.getTask(taskId);
-  const created = await client.createTask(task.list.id, {
-    name: `${task.name} (copy)`,
-    description: task.description,
-    markdown_content: task.markdown_content,
-    priority: task.priority ? parsePriority(task.priority.priority.toLowerCase()) : void 0,
-    tags: task.tags?.map((t) => t.name),
-    time_estimate: task.time_estimate ?? void 0
-  });
-  return { id: created.id, name: created.name, url: created.url };
-}
-
 // src/util/batch.ts
 async function runInBatches(items, concurrency, fn) {
   if (!Number.isInteger(concurrency) || concurrency < 1) {
@@ -7480,6 +7486,66 @@ async function runInBatches(items, concurrency, fn) {
   return results;
 }
 
+// src/commands/field-create.ts
+var FIELD_CREATE_CONCURRENCY = 5;
+var VALID_FIELD_TYPES = [
+  "text",
+  "short_text",
+  "number",
+  "date",
+  "checkbox",
+  "drop_down",
+  "labels",
+  "email",
+  "phone",
+  "url",
+  "currency"
+];
+function resolveFieldScope(list, lists) {
+  if (list && lists) throw new Error("Cannot use --list and --lists together");
+  if (list) return { mode: "single", listId: list };
+  if (lists) {
+    const listIds = lists.split(",").map((id) => id.trim()).filter(Boolean);
+    if (listIds.length === 0) throw new Error("--lists requires at least one list ID");
+    return { mode: "bulk", listIds };
+  }
+  return { mode: "workspace" };
+}
+function validateFieldType(type, options) {
+  if (!VALID_FIELD_TYPES.includes(type)) {
+    throw new Error(`Invalid field type "${type}". Valid types: ${VALID_FIELD_TYPES.join(", ")}`);
+  }
+  if ((type === "drop_down" || type === "labels") && !options?.length) {
+    throw new Error(`--options is required for ${type} fields (comma-separated values)`);
+  }
+}
+async function createFieldAcrossLists(config, name, type, listIds, opts) {
+  const client = new ClickUpClient(config);
+  const outcomes = await runInBatches(
+    listIds,
+    FIELD_CREATE_CONCURRENCY,
+    (listId) => client.createListCustomField(listId, name, type, opts)
+  );
+  return outcomes.map(
+    (outcome) => outcome.ok ? { listId: outcome.item, ok: true, fieldId: outcome.result.id } : { listId: outcome.item, ok: false, error: outcome.error.message }
+  );
+}
+
+// src/commands/duplicate.ts
+async function duplicateTask(config, taskId) {
+  const client = new ClickUpClient(config);
+  const task = await client.getTask(taskId);
+  const created = await client.createTask(task.list.id, {
+    name: `${task.name} (copy)`,
+    description: task.description,
+    markdown_content: task.markdown_content,
+    priority: task.priority ? parsePriority(task.priority.priority.toLowerCase()) : void 0,
+    tags: task.tags?.map((t) => t.name),
+    time_estimate: task.time_estimate ?? void 0
+  });
+  return { id: created.id, name: created.name, url: created.url };
+}
+
 // src/commands/bulk.ts
 var BULK_CONCURRENCY = 5;
 function toBulkResult(outcomes) {
@@ -9558,44 +9624,35 @@ function buildProgram(programName = basename(process.argv[1] ?? "cup")) {
       }
     })
   );
-  program.command("field-create <name>").description("Create a custom field in your workspace").requiredOption(
+  program.command("field-create <name>").description("Create a custom field in your workspace or on one or more lists").requiredOption(
     "-t, --type <type>",
     "Field type (text, number, date, checkbox, drop_down, labels, email, phone, url, currency, short_text)"
-  ).option("-d, --description <text>", "Field description").option("--options <items>", "Comma-separated options for drop_down or labels types").option("--required", "Make the field required").option("--json", "Force JSON output even in terminal").action(
+  ).option("-d, --description <text>", "Field description").option("--options <items>", "Comma-separated options for drop_down or labels types").option("--required", "Make the field required").option("--list <listId>", "Create the field scoped to a single list").option("--lists <ids>", "Comma-separated list IDs to create the same field on each").option("--json", "Force JSON output even in terminal").action(
     wrapAction(
       async (name, opts) => {
         if (!name.trim()) throw new Error("Field name cannot be empty");
-        const validTypes = [
-          "text",
-          "short_text",
-          "number",
-          "date",
-          "checkbox",
-          "drop_down",
-          "labels",
-          "email",
-          "phone",
-          "url",
-          "currency"
-        ];
-        if (!validTypes.includes(opts.type)) {
-          throw new Error(
-            `Invalid field type "${opts.type}". Valid types: ${validTypes.join(", ")}`
-          );
-        }
-        const config = loadConfig(getProfileName());
-        const client = new ClickUpClient(config);
+        const scope = resolveFieldScope(opts.list, opts.lists);
         const options = opts.options ? opts.options.split(",").map((o) => o.trim()).filter(Boolean) : void 0;
-        if ((opts.type === "drop_down" || opts.type === "labels") && !options?.length) {
-          throw new Error(
-            `--options is required for ${opts.type} fields (comma-separated values)`
-          );
-        }
-        const field = await client.createCustomField(config.teamId, name, opts.type, {
+        validateFieldType(opts.type, options);
+        const config = loadConfig(getProfileName());
+        const fieldOpts = {
           description: opts.description,
           required: opts.required,
           options
-        });
+        };
+        if (scope.mode === "bulk") {
+          const results = await createFieldAcrossLists(
+            config,
+            name,
+            opts.type,
+            scope.listIds,
+            fieldOpts
+          );
+          outputListFieldResults(results, opts.json ?? false);
+          return;
+        }
+        const client = new ClickUpClient(config);
+        const field = scope.mode === "single" ? await client.createListCustomField(scope.listId, name, opts.type, fieldOpts) : await client.createCustomField(config.teamId, name, opts.type, fieldOpts);
         if (shouldOutputJson(opts.json ?? false)) {
           console.log(JSON.stringify(field, null, 2));
         } else {
@@ -9615,6 +9672,21 @@ function buildProgram(programName = basename(process.argv[1] ?? "cup")) {
       }
     })
   );
+  function outputListFieldResults(results, forceJson) {
+    if (shouldOutputJson(forceJson)) {
+      console.log(JSON.stringify(results, null, 2));
+      return;
+    }
+    for (const result of results) {
+      if (result.ok) {
+        console.log(`\u2713 ${result.listId}: created field ${result.fieldId}`);
+      } else {
+        console.error(`\u2717 ${result.listId}: ${result.error}`);
+      }
+    }
+    const created = results.filter((r) => r.ok).length;
+    console.log(`Created on ${created}/${results.length} lists`);
+  }
   function outputBulkResult(result, forceJson, operation) {
     if (shouldOutputJson(forceJson)) {
       console.log(JSON.stringify(result, null, 2));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@krodak/clickup-cli",
-  "version": "1.35.0",
+  "version": "1.36.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.35.0
+# ClickUp CLI (`cup`) - skill version 1.36.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.35.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.36.0, update with `npm install -g @krodak/clickup-cli` and refresh this skill with `cup skill`.
 
 ## Install & Configure
 
@@ -173,7 +173,7 @@ All commands support `--help` for full flag details. All commands support `--jso
 | `cup depend <id> [--on taskId] [--blocks taskId] [--remove]`                                                                                                                                                                                                                                                                             | Add/remove dependencies                                                                                                                                                                                                        |
 | `cup move <id> [--to listId\|sprint:current] [--remove listId]`                                                                                                                                                                                                                                                                          | Add/remove task from lists. **`--to` + `--remove` together changes the task's _home_ list** (uses v3 `home_list` endpoint with auto status mapping). `--to` alone adds multi-list membership. `--to` accepts `sprint:current`. |
 | `cup field <id> [--set "Name" value] [--remove "Name"]`                                                                                                                                                                                                                                                                                  | Set/remove custom field values                                                                                                                                                                                                 |
-| `cup field-create <name> -t <type> [-d desc] [--options "a,b,c"] [--required]`                                                                                                                                                                                                                                                           | Create a custom field                                                                                                                                                                                                          |
+| `cup field-create <name> -t <type> [-d desc] [--options "a,b,c"] [--required] [--list id] [--lists id1,id2]`                                                                                                                                                                                                                             | Create a custom field — workspace-wide (default), on one list (`--list`), or bulk across lists (`--lists`, parallel, per-list reporting)                                                                                       |
 | `cup tag <id> [--add tags] [--remove tags]`                                                                                                                                                                                                                                                                                              | Add/remove tags on a task                                                                                                                                                                                                      |
 | `cup link <taskId> <linksTo> [--remove]`                                                                                                                                                                                                                                                                                                 | Link/unlink tasks                                                                                                                                                                                                              |
 | `cup attach <taskId> <filePath>`                                                                                                                                                                                                                                                                                                         | Upload file attachment                                                                                                                                                                                                         |