@krodak/clickup-cli 1.35.0 → 1.37.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.37.0",
   "author": {
     "name": "Krzysztof Rodak"
   },

package/dist/index.js

@@ -74,6 +74,10 @@ function normalizeTaskId(input) {
   const match = /^https?:\/\/app\.clickup\.com\/t\/(?:[^/?#]+\/)?([^/?#]+)/.exec(input.trim());
   return match ? match[1] : input;
 }
+function normalizeViewId(input) {
+  const match = /^https?:\/\/app\.clickup\.com\/[^/]+\/v\/[^/]+\/([^/?#]+)/.exec(input.trim());
+  return match ? match[1] : input;
+}
 var ClickUpClient = class {
   apiToken;
   teamId;
@@ -394,10 +398,12 @@ var ClickUpClient = class {
     return readCollectionField(data, "views", "views");
   }
   async getViewTasks(viewId) {
-    return this.paginate((page) => `/view/${viewId}/task?page=${page}`);
+    const id = normalizeViewId(viewId);
+    return this.paginate((page) => `/view/${id}/task?page=${page}`);
   }
   async getView(viewId) {
-    const data = await this.request(`/view/${viewId}`);
+    const id = normalizeViewId(viewId);
+    const data = await this.request(`/view/${id}`);
     return expectRecordField(data, "view", "view");
   }
   async createListView(listId, payload) {
@@ -408,14 +414,16 @@ var ClickUpClient = class {
     return expectRecordField(data, "view", "view");
   }
   async updateView(viewId, payload) {
-    const data = await this.request(`/view/${viewId}`, {
+    const id = normalizeViewId(viewId);
+    const data = await this.request(`/view/${id}`, {
       method: "PUT",
       body: JSON.stringify(payload)
     });
     return expectRecordField(data, "view", "view");
   }
   async deleteView(viewId) {
-    await this.request(`/view/${viewId}`, { method: "DELETE" });
+    const id = normalizeViewId(viewId);
+    await this.request(`/view/${id}`, { method: "DELETE" });
   }
   async getListTemplates(teamId) {
     const data = await this.request(`/team/${teamId}/list_template`);
@@ -873,7 +881,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 +889,7 @@ var ClickUpClient = class {
         orderindex: i
       }));
     }
-    const body = {
+    return {
       name,
       type,
       type_config: typeConfig,
@@ -895,11 +903,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}`;
@@ -1102,13 +1121,15 @@ var ClickUpClient = class {
     });
   }
   async getViewComments(viewId) {
-    const data = await this.request(`/view/${viewId}/comment`);
+    const id = normalizeViewId(viewId);
+    const data = await this.request(`/view/${id}/comment`);
     return readCollectionField(data, "comments", "view comments");
   }
   async postViewComment(viewId, commentText, notifyAll, richBlocks) {
+    const id = normalizeViewId(viewId);
     const body = richBlocks ? { comment: richBlocks } : { comment_text: commentText };
     if (notifyAll) body.notify_all = true;
-    return this.request(`/view/${viewId}/comment`, {
+    return this.request(`/view/${id}/comment`, {
       method: "POST",
       body: JSON.stringify(body)
     });
@@ -4499,13 +4520,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"
       }
     ]
   },
@@ -4698,6 +4729,14 @@ var commandMetadata = [
     flags: ["--json"],
     quickReference: [{ section: "read", usage: "view <viewId>", description: "Get view details" }]
   },
+  {
+    name: "view-tasks",
+    description: "List tasks in a view",
+    flags: ["--me", "--json"],
+    quickReference: [
+      { section: "read", usage: "view-tasks <viewId>", description: "List tasks in a view" }
+    ]
+  },
   {
     name: "view-create",
     description: "Create a view on a list",
@@ -7443,21 +7482,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 +7504,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) {
@@ -7967,6 +8051,22 @@ function formatViewMarkdown(view) {
   return lines.join("\n");
 }
 
+// src/commands/view-tasks.ts
+async function listViewTasks(config, viewId, opts) {
+  const client = new ClickUpClient(config);
+  const [tasks, customTypes] = await Promise.all([
+    client.getViewTasks(viewId),
+    client.getCustomTaskTypes(config.teamId)
+  ]);
+  const typeMap = buildTypeMap(customTypes);
+  let filtered = tasks;
+  if (opts.me) {
+    const me = await client.getMe();
+    filtered = tasks.filter((t) => t.assignees.some((a) => Number(a.id) === me.id));
+  }
+  return filtered.map((t) => summarize(t, typeMap));
+}
+
 // src/commands/view-create.ts
 var VALID_VIEW_TYPES = ["list", "board", "calendar", "gantt", "table", "timeline"];
 var VALID_GROUP_BY_FIELDS = [
@@ -9558,44 +9658,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 +9706,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));
@@ -10136,6 +10242,13 @@ function buildProgram(programName = basename(process.argv[1] ?? "cup")) {
       }
     })
   );
+  program.command("view-tasks <viewId>").description("List tasks in a view").option("--me", "Only tasks assigned to the current user").option("--json", "Force JSON output even in terminal").action(
+    wrapAction(async (viewId, opts) => {
+      const config = loadConfig(getProfileName());
+      const tasks = await listViewTasks(config, viewId, { me: opts.me });
+      await printTasks(tasks, opts.json ?? false, config);
+    })
+  );
   program.command("view-create <listId> <name>").description("Create a view on a list").requiredOption(
     "-t, --type <type>",
     "View type (list, board, calendar, gantt, table, timeline)"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@krodak/clickup-cli",
-  "version": "1.35.0",
+  "version": "1.37.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.37.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.37.0, update with `npm install -g @krodak/clickup-cli` and refresh this skill with `cup skill`.
 
 ## Install & Configure
 
@@ -144,6 +144,7 @@ All commands support `--help` for full flag details. All commands support `--jso
 | `cup folder-templates`                                                                                                                                                                                                          | Folder templates                                                                                                                                             |
 | `cup views <listId>`                                                                                                                                                                                                            | List views on a list                                                                                                                                         |
 | `cup view <viewId>`                                                                                                                                                                                                             | Get view details                                                                                                                                             |
+| `cup view-tasks <viewId> [--me]`                                                                                                                                                                                                | List tasks in a view (`--me` filters to you)                                                                                                                 |
 | `cup open <query>`                                                                                                                                                                                                              | Open task in browser by ID or name                                                                                                                           |
 | `cup auth`                                                                                                                                                                                                                      | Check authentication status                                                                                                                                  |
 | `cup list-comments <listId>`                                                                                                                                                                                                    | Comments on a list                                                                                                                                           |
@@ -173,7 +174,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                                                                                                                                                                                                         |
@@ -266,6 +267,7 @@ All commands support `--help` for full flag details. All commands support `--jso
 | ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | Task IDs                 | Native (`abc123def`) or custom (`PROJ-123`). Custom IDs auto-detected by `PREFIX-DIGITS` format                                                                                                                                                                                                                                                    |
 | Task URLs                | All commands that accept a task ID also accept full ClickUp URLs (`https://app.clickup.com/t/<id>` or `https://app.clickup.com/t/<workspace>/<id>`). The ID is auto-extracted                                                                                                                                                                      |
+| View URLs                | All commands that accept a view ID also accept full ClickUp view URLs (`https://app.clickup.com/<workspace>/v/<type>/<viewId>`). The ID is auto-extracted                                                                                                                                                                                          |
 | `--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` (date only), `YYYY-MM-DDTHH:MM` (with time), or full ISO 8601 with offset. Time-of-day formats set `due_date_time: true` in ClickUp                                                                                                                                                                                                   |