@krodak/clickup-cli 1.6.1 → 1.8.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.6.1",
+  "version": "1.8.0",
   "author": {
     "name": "Krzysztof Rodak"
   },

package/README.md

@@ -150,11 +150,11 @@ 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                                                       |
-| 🏢 **Workspace**     | Spaces, folders, lists, members, task types, templates                                                                  |
+| 🏢 **Workspace**     | Spaces, folders, lists (read + create), members, task types, templates                                                  |
 | 📎 **Attachments**   | Upload files to tasks, shown in detail views                                                                            |
 
 [Full API coverage details](docs/api-coverage.md) | [Command reference](docs/commands.md)

package/dist/index.js

@@ -224,6 +224,12 @@ var ClickUpClient = class {
   async getListWithStatuses(listId) {
     return this.request(`/list/${listId}`);
   }
+  async createSpace(teamId, name) {
+    return this.request(`/team/${teamId}/space`, {
+      method: "POST",
+      body: JSON.stringify({ name, multiple_assignees: true })
+    });
+  }
   async getSpaces(teamId) {
     const data = await this.request(`/team/${teamId}/space?archived=false`);
     return readCollectionField(data, "spaces", "spaces");
@@ -238,6 +244,24 @@ var ClickUpClient = class {
       "custom task types"
     );
   }
+  async createList(spaceId, name) {
+    return this.request(`/space/${spaceId}/list`, {
+      method: "POST",
+      body: JSON.stringify({ name })
+    });
+  }
+  async createFolderList(folderId, name) {
+    return this.request(`/folder/${folderId}/list`, {
+      method: "POST",
+      body: JSON.stringify({ name })
+    });
+  }
+  async createFolder(spaceId, name) {
+    return this.request(`/space/${spaceId}/folder`, {
+      method: "POST",
+      body: JSON.stringify({ name })
+    });
+  }
   async getLists(spaceId) {
     const data = await this.request(`/space/${spaceId}/list?archived=false`);
     return readCollectionField(data, "lists", "space lists");
@@ -673,6 +697,27 @@ var ClickUpClient = class {
       body: JSON.stringify({ name })
     });
   }
+  async createCustomField(teamId, name, type, opts) {
+    const body = {
+      name,
+      type,
+      type_config: {},
+      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
@@ -3024,6 +3069,38 @@ var commandMetadata = [
       { section: "read", usage: "folders <spaceId>", description: "List folders in a space" }
     ]
   },
+  {
+    name: "space-create",
+    description: "Create a new space in your workspace",
+    flags: ["--json"],
+    quickReference: [
+      { section: "write", usage: "space-create <name>", description: "Create a space" }
+    ]
+  },
+  {
+    name: "list-create",
+    description: "Create a new list in a space",
+    flags: ["--folder", "--json"],
+    quickReference: [
+      {
+        section: "write",
+        usage: "list-create <spaceId> <name>",
+        description: "Create a list in a space"
+      }
+    ]
+  },
+  {
+    name: "folder-create",
+    description: "Create a new folder in a space",
+    flags: ["--json"],
+    quickReference: [
+      {
+        section: "write",
+        usage: "folder-create <spaceId> <name>",
+        description: "Create a folder in a space"
+      }
+    ]
+  },
   {
     name: "members",
     description: "List workspace members",
@@ -3038,6 +3115,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", "--required", "--json"],
+    quickReference: [
+      {
+        section: "write",
+        usage: "field-create <name>",
+        description: "Create a custom field in your workspace"
+      }
+    ]
+  },
   {
     name: "duplicate",
     description: "Duplicate a task",
@@ -3725,6 +3814,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:' \\
@@ -3834,6 +3931,24 @@ ${renderZshTopLevelCommands(name)}
             '--name[Filter by folder name]:text:' \\
             '--json[Force JSON output]'
           ;;
+        space-create)
+          _arguments \\
+            '1:name:' \\
+            '--json[Force JSON output]'
+          ;;
+        list-create)
+          _arguments \\
+            '1:space_id:' \\
+            '2:name:' \\
+            '--folder[Create inside a folder]:folder_id:' \\
+            '--json[Force JSON output]'
+          ;;
+        folder-create)
+          _arguments \\
+            '1:space_id:' \\
+            '2:name:' \\
+            '--json[Force JSON output]'
+          ;;
         doc-create)
           _arguments \\
             '1:title:' \\
@@ -5423,6 +5538,45 @@ 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("--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 field = await client.createCustomField(config.teamId, name, opts.type, {
+          description: opts.description,
+          required: opts.required
+        });
+        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());
@@ -5632,6 +5786,47 @@ function buildProgram(programName = basename(process.argv[1] ?? "cup")) {
       }
     })
   );
+  program.command("space-create <name>").description("Create a new space in your workspace").option("--json", "Force JSON output even in terminal").action(
+    wrapAction(async (name, opts) => {
+      if (!name.trim()) throw new Error("Space name cannot be empty");
+      const config = loadConfig(getProfileName());
+      const client = new ClickUpClient(config);
+      const space = await client.createSpace(config.teamId, name);
+      if (shouldOutputJson(opts.json ?? false)) {
+        console.log(JSON.stringify(space, null, 2));
+      } else {
+        console.log(`Created space "${space.name}" (${space.id})`);
+      }
+    })
+  );
+  program.command("list-create <spaceId> <name>").description("Create a new list in a space").option("--folder <folderId>", "Create the list inside a folder").option("--json", "Force JSON output even in terminal").action(
+    wrapAction(
+      async (spaceId, name, opts) => {
+        if (!name.trim()) throw new Error("List name cannot be empty");
+        const config = loadConfig(getProfileName());
+        const client = new ClickUpClient(config);
+        const list = opts.folder ? await client.createFolderList(opts.folder, name) : await client.createList(spaceId, name);
+        if (shouldOutputJson(opts.json ?? false)) {
+          console.log(JSON.stringify(list, null, 2));
+        } else {
+          console.log(`Created list "${list.name}" (${list.id})`);
+        }
+      }
+    )
+  );
+  program.command("folder-create <spaceId> <name>").description("Create a new folder in a space").option("--json", "Force JSON output even in terminal").action(
+    wrapAction(async (spaceId, name, opts) => {
+      if (!name.trim()) throw new Error("Folder name cannot be empty");
+      const config = loadConfig(getProfileName());
+      const client = new ClickUpClient(config);
+      const folder = await client.createFolder(spaceId, name);
+      if (shouldOutputJson(opts.json ?? false)) {
+        console.log(JSON.stringify(folder, null, 2));
+      } else {
+        console.log(`Created folder "${folder.name}" (${folder.id})`);
+      }
+    })
+  );
   program.command("doc-create <title>").description("Create a new doc").option("-c, --content <text>", "Initial content (markdown)").option("--json", "Force JSON output even in terminal").action(
     wrapAction(async (title, opts) => {
       const config = loadConfig(getProfileName());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@krodak/clickup-cli",
-  "version": "1.6.1",
+  "version": "1.8.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] [--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              |
@@ -108,6 +109,9 @@ All commands support `--help` for full flag details. All commands support `--jso
 | `cup doc-page-edit <docId> <pageId> [--name text] [-c content]`                                                                                                                            | Edit doc page                       |
 | `cup doc-delete <docId>`                                                                                                                                                                   | Delete a doc                        |
 | `cup doc-page-delete <docId> <pageId>`                                                                                                                                                     | Delete doc page                     |
+| `cup space-create <name>`                                                                                                                                                                  | Create a space                      |
+| `cup list-create <spaceId> <name> [--folder folderId]`                                                                                                                                     | Create a list in a space or folder  |
+| `cup folder-create <spaceId> <name>`                                                                                                                                                       | Create a folder in a space          |
 | `cup tag-create <spaceId> <name> [--fg color] [--bg color]`                                                                                                                                | Create space tag                    |
 | `cup tag-update <spaceId> <tagName> --name <newName> [--fg c] [--bg c]`                                                                                                                    | Update space tag                    |
 | `cup tag-delete <spaceId> <name>`                                                                                                                                                          | Delete space tag                    |
@@ -215,6 +219,10 @@ cup doc-page-edit <docId> <pageId> -c "# Updated"
 cup spaces --name "Engineering"      # find space ID
 cup folders <spaceId>                # folders with their lists
 cup lists <spaceId>                  # lists in a space
+cup space-create "New Space"         # create a space
+cup folder-create <spaceId> "Q2"     # create a folder
+cup list-create <spaceId> "Backlog"  # create a list
+cup list-create <spaceId> "Sprint" --folder <folderId>
 cup members                          # workspace members
 cup fields <listId>                  # custom fields on a list
 cup task-types                       # custom task types