@krodak/clickup-cli 1.7.0 → 1.9.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.7.0",
+  "version": "1.9.0",
   "author": {
     "name": "Krzysztof Rodak"
   },

package/README.md

@@ -150,7 +150,7 @@ Full CRUD for the core ClickUp workflow:
 | 📄 **Docs**          | List, read, create, edit, delete (v3 API)                                                                               |
 | ⏱️ **Time Tracking** | Start/stop timer, log entries, list/update/delete history                                                               |
 | ☑️ **Checklists**    | View, create, delete, add/edit/delete items                                                                             |
-| 🔧 **Custom Fields** | List, set, remove values (dropdown, date, checkbox, text, etc.)                                                         |
+| 🔧 **Custom Fields** | List, create, set, remove values (dropdown, date, checkbox, text, etc.)                                                 |
 | 🏷️ **Tags**          | Add/remove on tasks, space-level create/update/delete                                                                   |
 | 🎯 **Goals & OKRs**  | Goals CRUD, key results CRUD                                                                                            |
 | 🏃 **Sprints**       | Auto-detect active sprint, flexible date parsing, config override                                                       |

package/dist/index.js

@@ -697,6 +697,34 @@ var ClickUpClient = class {
       body: JSON.stringify({ name })
     });
   }
+  async createCustomField(teamId, name, type, opts) {
+    const typeConfig = {};
+    if (opts?.options?.length) {
+      typeConfig.options = opts.options.map((optName, i) => ({
+        name: optName,
+        orderindex: i
+      }));
+    }
+    const body = {
+      name,
+      type,
+      type_config: typeConfig,
+      description: opts?.description ?? "",
+      required: opts?.required ?? false,
+      pinned: false,
+      hide_from_guests: false,
+      required_on_subtasks: false,
+      private: false,
+      permission_level: null,
+      members: [],
+      groups: []
+    };
+    const data = await this.request(
+      `/field?workspace_id=${teamId}`,
+      { method: "POST", body: JSON.stringify(body) }
+    );
+    return data.data;
+  }
 };
 
 // src/config.ts
@@ -3094,6 +3122,18 @@ var commandMetadata = [
       { section: "read", usage: "fields <listId>", description: "List custom fields for a list" }
     ]
   },
+  {
+    name: "field-create",
+    description: "Create a custom field in your workspace",
+    flags: ["-t", "--type", "-d", "--description", "--options", "--required", "--json"],
+    quickReference: [
+      {
+        section: "write",
+        usage: "field-create <name>",
+        description: "Create a custom field in your workspace"
+      }
+    ]
+  },
   {
     name: "duplicate",
     description: "Duplicate a task",
@@ -3781,6 +3821,14 @@ ${renderZshTopLevelCommands(name)}
             '1:list_id:' \\
             '--json[Force JSON output]'
           ;;
+        field-create)
+          _arguments \\
+            '1:name:' \\
+            '(-t --type)'{-t,--type}'[Field type]:type:(text short_text number date checkbox drop_down labels email phone url currency)' \\
+            '(-d --description)'{-d,--description}'[Field description]:text:' \\
+            '--required[Make the field required]' \\
+            '--json[Force JSON output]'
+          ;;
         duplicate)
           _arguments \\
             '1:task_id:' \\
@@ -5497,6 +5545,52 @@ function buildProgram(programName = basename(process.argv[1] ?? "cup")) {
       }
     })
   );
+  program.command("field-create <name>").description("Create a custom field in your workspace").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(
+    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 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, {
+          description: opts.description,
+          required: opts.required,
+          options
+        });
+        if (shouldOutputJson(opts.json ?? false)) {
+          console.log(JSON.stringify(field, null, 2));
+        } else {
+          console.log(`Created field "${field.name}" (${field.id}) type: ${field.type}`);
+        }
+      }
+    )
+  );
   program.command("duplicate <taskId>").description("Duplicate a task").option("--json", "Force JSON output even in terminal").action(
     wrapAction(async (taskId, opts) => {
       const config = loadConfig(getProfileName());

package/package.json

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

package/skills/clickup-cli/SKILL.md

@@ -78,6 +78,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] [--remove listId]`                                                                                                                                            | Add/remove task from lists          |
 | `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 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              |
@@ -146,6 +147,7 @@ All commands support `--help` for full flag details. All commands support `--jso
 | `--include-closed` | Include closed/done tasks                                                                                                                                                     |
 | `--list` on create | Optional when `--parent` is given (auto-detected)                                                                                                                             |
 | `cup field --set`  | Supports: text, number, checkbox (true/false), dropdown (option name), date (YYYY-MM-DD), url, email. Names resolved case-insensitively; errors list available fields/options |
+| `cup field-create` | Use `--options "a,b,c"` for `drop_down` and `labels` types (required). Other types don't need `--options`                                                                     |
 | `cup sprint`       | Auto-detects active sprint by folder name (sprint/iteration/cycle/scrum), parses multiple date formats. Override with `--folder <id>` or `cup config set sprintFolderId <id>` |
 | `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                                                                                                   |