@krodak/clickup-cli 1.9.2 → 1.11.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.9.2",
+  "version": "1.11.0",
   "author": {
     "name": "Krzysztof Rodak"
   },

package/README.md

@@ -154,7 +154,8 @@ Full CRUD for the core ClickUp workflow:
 | 🏷️ **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 (read + create), members, task types, templates                                                  |
+| 👁️ **Views**         | List, get, create, update, delete views on lists                                                                        |
+| 🏢 **Workspace**     | Spaces, folders, lists (read + create + from template), 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

@@ -277,13 +277,56 @@ var ClickUpClient = class {
     return readCollectionField(data, "lists", "folder lists");
   }
   async getListViews(listId) {
-    return this.request(
-      `/list/${listId}/view`
-    );
+    return this.request(`/list/${listId}/view`);
   }
   async getViewTasks(viewId) {
     return this.paginate((page) => `/view/${viewId}/task?page=${page}`);
   }
+  async getView(viewId) {
+    const data = await this.request(`/view/${viewId}`);
+    return data.view;
+  }
+  async createListView(listId, payload) {
+    const data = await this.request(`/list/${listId}/view`, {
+      method: "POST",
+      body: JSON.stringify(payload)
+    });
+    return data.view;
+  }
+  async updateView(viewId, payload) {
+    const data = await this.request(`/view/${viewId}`, {
+      method: "PUT",
+      body: JSON.stringify(payload)
+    });
+    return data.view;
+  }
+  async deleteView(viewId) {
+    await this.request(`/view/${viewId}`, { method: "DELETE" });
+  }
+  async getListTemplates(teamId) {
+    const data = await this.request(`/team/${teamId}/list_template`);
+    return readCollectionField(
+      data,
+      "templates",
+      "list templates"
+    );
+  }
+  async getFolderTemplates(teamId) {
+    const data = await this.request(
+      `/team/${teamId}/folder_template`
+    );
+    return readCollectionField(
+      data,
+      "templates",
+      "folder templates"
+    );
+  }
+  async createListFromTemplate(containerId, templateId, name, containerType) {
+    return this.request(
+      `/${containerType}/${containerId}/list_template/${templateId}`,
+      { method: "POST", body: JSON.stringify({ name }) }
+    );
+  }
   async addTaskToList(taskId, listId) {
     await this.request(`/list/${listId}/task/${taskId}`, { method: "POST" });
   }
@@ -1308,11 +1351,7 @@ function formatCustomFieldValue(field) {
     case "date": {
       const ts = Number(field.value);
       if (!Number.isFinite(ts)) return stringifyFieldValue(field.value);
-      return new Date(ts).toLocaleDateString("en-US", {
-        month: "short",
-        day: "numeric",
-        year: "numeric"
-      });
+      return formatDate(String(ts));
     }
     case "checkbox":
       return field.value === true || field.value === "true" ? "Yes" : "No";
@@ -2840,6 +2879,14 @@ var commandMetadata = [
       { section: "read", usage: "overdue", description: "Tasks past their due date" }
     ]
   },
+  {
+    name: "archive",
+    description: "Archive a task (or unarchive with --unarchive)",
+    flags: ["--unarchive", "--confirm", "--json"],
+    quickReference: [
+      { section: "write", usage: "archive <taskId>", description: "Archive or unarchive a task" }
+    ]
+  },
   {
     name: "assign",
     description: "Assign or unassign users from a task",
@@ -3250,6 +3297,76 @@ var commandMetadata = [
     flags: ["--json"],
     quickReference: [{ section: "read", usage: "templates", description: "List task templates" }]
   },
+  {
+    name: "list-templates",
+    description: "List list templates in your workspace",
+    flags: ["--json"],
+    quickReference: [
+      { section: "read", usage: "list-templates", description: "List list templates" }
+    ]
+  },
+  {
+    name: "folder-templates",
+    description: "List folder templates in your workspace",
+    flags: ["--json"],
+    quickReference: [
+      { section: "read", usage: "folder-templates", description: "List folder templates" }
+    ]
+  },
+  {
+    name: "list-from-template",
+    description: "Create a list from a list template",
+    flags: ["--template", "--space", "--folder", "--json"],
+    quickReference: [
+      {
+        section: "write",
+        usage: "list-from-template <name>",
+        description: "Create a list from a template"
+      }
+    ]
+  },
+  {
+    name: "views",
+    description: "List views on a list",
+    flags: ["--json"],
+    quickReference: [
+      { section: "read", usage: "views <listId>", description: "List views on a list" }
+    ]
+  },
+  {
+    name: "view",
+    description: "Get view details",
+    flags: ["--json"],
+    quickReference: [{ section: "read", usage: "view <viewId>", description: "Get view details" }]
+  },
+  {
+    name: "view-create",
+    description: "Create a view on a list",
+    flags: ["-t", "--type", "--group-by", "--json"],
+    quickReference: [
+      {
+        section: "write",
+        usage: "view-create <listId> <name>",
+        description: "Create a view on a list"
+      }
+    ]
+  },
+  {
+    name: "view-update",
+    description: "Update a view",
+    flags: ["-n", "--name", "--group-by", "--json"],
+    quickReference: [
+      { section: "write", usage: "view-update <viewId>", description: "Update a view" }
+    ]
+  },
+  {
+    name: "view-delete",
+    description: "Delete a view (requires confirmation)",
+    flags: ["--confirm", "--json"],
+    quickReference: [
+      { section: "write", usage: "view-delete <viewId>", description: "Delete a view" }
+    ]
+  },
   {
     name: "profile",
     description: "Manage profiles",
@@ -3935,6 +4052,53 @@ ${renderZshTopLevelCommands(name)}
           _arguments \\
             '--json[Force JSON output]'
           ;;
+        list-templates)
+          _arguments \\
+            '--json[Force JSON output]'
+          ;;
+        folder-templates)
+          _arguments \\
+            '--json[Force JSON output]'
+          ;;
+        list-from-template)
+          _arguments \\
+            '1:name:' \\
+            '--template[Template ID]:template_id:' \\
+            '--space[Create in this space]:space_id:' \\
+            '--folder[Create in this folder]:folder_id:' \\
+            '--json[Force JSON output]'
+          ;;
+        views)
+          _arguments \\
+            '1:list_id:' \\
+            '--json[Force JSON output]'
+          ;;
+        view)
+          _arguments \\
+            '1:view_id:' \\
+            '--json[Force JSON output]'
+          ;;
+        view-create)
+          _arguments \\
+            '1:list_id:' \\
+            '2:name:' \\
+            '(-t --type)'{-t,--type}'[View type]:type:(list board calendar gantt table timeline)' \\
+            '--group-by[Group by field]:field:(status assignee priority due_date tag sprint)' \\
+            '--json[Force JSON output]'
+          ;;
+        view-update)
+          _arguments \\
+            '1:view_id:' \\
+            '(-n --name)'{-n,--name}'[New view name]:text:' \\
+            '--group-by[Group by field]:field:(status assignee priority due_date tag sprint)' \\
+            '--json[Force JSON output]'
+          ;;
+        view-delete)
+          _arguments \\
+            '1:view_id:' \\
+            '--confirm[Skip confirmation prompt]' \\
+            '--json[Force JSON output]'
+          ;;
         folders)
           _arguments \\
             '1:space_id:' \\
@@ -4310,6 +4474,27 @@ async function deleteTaskCommand(config, taskId, opts) {
   return { taskId, deleted: true };
 }
 
+// src/commands/archive.ts
+async function archiveTaskCommand(config, taskId, opts) {
+  const client = new ClickUpClient(config);
+  if (!opts.confirm) {
+    if (!isTTY()) {
+      throw new Error(`Destructive operation requires --confirm flag in non-interactive mode`);
+    }
+    const task = await client.getTask(taskId);
+    const { confirm: confirm3 } = await import("@inquirer/prompts");
+    const confirmed = await confirm3({
+      message: `${opts.unarchive ? "Unarchive" : "Archive"} task "${task.name}" (${task.id})?`,
+      default: false
+    });
+    if (!confirmed) {
+      throw new Error("Cancelled");
+    }
+  }
+  await client.updateTask(taskId, { archived: !opts.unarchive });
+  return { taskId, archived: !opts.unarchive };
+}
+
 // src/commands/tag.ts
 function parseTags(input) {
   return input.split(",").map((t) => t.trim()).filter((t) => t.length > 0);
@@ -4900,6 +5085,175 @@ function formatTemplatesMarkdown(templates) {
   return templates.map((t) => `- **${t.name}** (${t.id})`).join("\n");
 }
 
+// src/commands/list-templates.ts
+import chalk17 from "chalk";
+async function listListTemplates(config) {
+  const client = new ClickUpClient(config);
+  return client.getListTemplates(config.teamId);
+}
+function formatListTemplates(templates) {
+  if (templates.length === 0) return "No list templates";
+  return templates.map((t) => `${chalk17.bold(t.name)} ${chalk17.dim(`(${t.id})`)}`).join("\n");
+}
+function formatListTemplatesMarkdown(templates) {
+  if (templates.length === 0) return "No list templates";
+  return templates.map((t) => `- **${t.name}** (${t.id})`).join("\n");
+}
+
+// src/commands/folder-templates.ts
+import chalk18 from "chalk";
+async function listFolderTemplates(config) {
+  const client = new ClickUpClient(config);
+  return client.getFolderTemplates(config.teamId);
+}
+function formatFolderTemplates(templates) {
+  if (templates.length === 0) return "No folder templates";
+  return templates.map((t) => `${chalk18.bold(t.name)} ${chalk18.dim(`(${t.id})`)}`).join("\n");
+}
+function formatFolderTemplatesMarkdown(templates) {
+  if (templates.length === 0) return "No folder templates";
+  return templates.map((t) => `- **${t.name}** (${t.id})`).join("\n");
+}
+
+// src/commands/list-from-template.ts
+async function createListFromTemplate(config, name, opts) {
+  if (!name.trim()) throw new Error("List name cannot be empty");
+  if (!opts.space && !opts.folder) {
+    throw new Error("Provide --space or --folder to specify where to create the list");
+  }
+  if (opts.space && opts.folder) {
+    throw new Error("Provide either --space or --folder, not both");
+  }
+  const client = new ClickUpClient(config);
+  const containerType = opts.folder ? "folder" : "space";
+  const containerId = opts.folder ?? opts.space;
+  return client.createListFromTemplate(containerId, opts.template, name, containerType);
+}
+
+// src/commands/views.ts
+import chalk19 from "chalk";
+async function listViews(config, listId) {
+  const client = new ClickUpClient(config);
+  const data = await client.getListViews(listId);
+  return data.views;
+}
+function formatViews(views) {
+  if (views.length === 0) return "No views";
+  return views.map((v) => `${chalk19.bold(v.name)} ${chalk19.dim(`(${v.id})`)} ${chalk19.dim(v.type)}`).join("\n");
+}
+function formatViewsMarkdown(views) {
+  if (views.length === 0) return "No views";
+  return views.map((v) => `- **${v.name}** (${v.id}) - ${v.type}`).join("\n");
+}
+
+// src/commands/view.ts
+import chalk20 from "chalk";
+async function getView(config, viewId) {
+  const client = new ClickUpClient(config);
+  return client.getView(viewId);
+}
+function formatView(view) {
+  const lines = [];
+  lines.push(chalk20.bold.underline(view.name));
+  lines.push("");
+  lines.push(`  ${chalk20.bold("ID")}     ${view.id}`);
+  lines.push(`  ${chalk20.bold("Type")}   ${view.type}`);
+  if (view.visibility) lines.push(`  ${chalk20.bold("Visibility")} ${view.visibility}`);
+  if (view.date_created) lines.push(`  ${chalk20.bold("Created")} ${formatDate(view.date_created)}`);
+  if (view.protected !== void 0) lines.push(`  ${chalk20.bold("Protected")} ${view.protected}`);
+  return lines.join("\n");
+}
+function formatViewMarkdown(view) {
+  const lines = [];
+  lines.push(`# ${view.name}`);
+  lines.push("");
+  lines.push(`- **ID:** ${view.id}`);
+  lines.push(`- **Type:** ${view.type}`);
+  if (view.visibility) lines.push(`- **Visibility:** ${view.visibility}`);
+  if (view.date_created) lines.push(`- **Created:** ${formatDate(view.date_created)}`);
+  if (view.protected !== void 0) lines.push(`- **Protected:** ${view.protected}`);
+  return lines.join("\n");
+}
+
+// src/commands/view-create.ts
+var VALID_VIEW_TYPES = ["list", "board", "calendar", "gantt", "table", "timeline"];
+var VALID_GROUP_BY_FIELDS = [
+  "status",
+  "assignee",
+  "priority",
+  "due_date",
+  "tag",
+  "sprint"
+];
+async function createView(config, listId, name, opts) {
+  if (!name.trim()) throw new Error("View name cannot be empty");
+  if (!VALID_VIEW_TYPES.includes(opts.type)) {
+    throw new Error(`Invalid view type "${opts.type}". Valid types: ${VALID_VIEW_TYPES.join(", ")}`);
+  }
+  const payload = {
+    name,
+    type: opts.type
+  };
+  if (opts.groupBy) {
+    if (!VALID_GROUP_BY_FIELDS.includes(opts.groupBy)) {
+      throw new Error(
+        `Invalid group-by field "${opts.groupBy}". Valid fields: ${VALID_GROUP_BY_FIELDS.join(", ")}`
+      );
+    }
+    payload.grouping = { field: opts.groupBy };
+  }
+  const client = new ClickUpClient(config);
+  return client.createListView(listId, payload);
+}
+
+// src/commands/view-update.ts
+var VALID_GROUP_BY_FIELDS2 = [
+  "status",
+  "assignee",
+  "priority",
+  "due_date",
+  "tag",
+  "sprint"
+];
+async function updateView(config, viewId, opts) {
+  if (opts.name !== void 0 && !opts.name.trim()) {
+    throw new Error("View name cannot be empty");
+  }
+  const payload = {};
+  if (opts.name) payload.name = opts.name;
+  if (opts.groupBy) {
+    if (!VALID_GROUP_BY_FIELDS2.includes(opts.groupBy)) {
+      throw new Error(
+        `Invalid group-by field "${opts.groupBy}". Valid fields: ${VALID_GROUP_BY_FIELDS2.join(", ")}`
+      );
+    }
+    payload.grouping = { field: opts.groupBy };
+  }
+  const client = new ClickUpClient(config);
+  return client.updateView(viewId, payload);
+}
+
+// src/commands/view-delete.ts
+async function deleteViewCommand(config, viewId, opts) {
+  const client = new ClickUpClient(config);
+  if (!opts.confirm) {
+    if (!isTTY()) {
+      throw new Error("Destructive operation requires --confirm flag in non-interactive mode");
+    }
+    const view = await client.getView(viewId);
+    const { confirm: confirm3 } = await import("@inquirer/prompts");
+    const confirmed = await confirm3({
+      message: `Delete view "${view.name}" (${viewId})? This cannot be undone.`,
+      default: false
+    });
+    if (!confirmed) {
+      throw new Error("Cancelled");
+    }
+  }
+  await client.deleteView(viewId);
+  return { viewId, deleted: true };
+}
+
 // src/index.ts
 var require2 = createRequire(import.meta.url);
 var { version } = require2("../package.json");
@@ -5291,6 +5645,19 @@ function buildProgram(programName = basename(process.argv[1] ?? "cup")) {
       }
     })
   );
+  program.command("archive <taskId>").description("Archive a task (or unarchive with --unarchive)").option("--unarchive", "Unarchive instead of archiving").option("--confirm", "Skip confirmation prompt (required in non-interactive mode)").option("--json", "Force JSON output even in terminal").action(
+    wrapAction(
+      async (taskId, opts) => {
+        const config = loadConfig(getProfileName());
+        const result = await archiveTaskCommand(config, taskId, opts);
+        if (shouldOutputJson(opts.json ?? false)) {
+          console.log(JSON.stringify(result, null, 2));
+        } else {
+          console.log(`${result.archived ? "Archived" : "Unarchived"} task ${result.taskId}`);
+        }
+      }
+    )
+  );
   program.command("tag <taskId>").description("Add or remove tags from a task").option("--add <tags>", "Comma-separated tag names to add").option("--remove <tags>", "Comma-separated tag names to remove").option("--json", "Force JSON output even in terminal").action(
     wrapAction(
       async (taskId, opts) => {
@@ -5955,6 +6322,123 @@ function buildProgram(programName = basename(process.argv[1] ?? "cup")) {
       }
     })
   );
+  program.command("list-templates").description("List list templates in your workspace").option("--json", "Force JSON output even in terminal").action(
+    wrapAction(async (opts) => {
+      const config = loadConfig(getProfileName());
+      const templates = await listListTemplates(config);
+      if (shouldOutputJson(opts.json ?? false)) {
+        console.log(JSON.stringify(templates, null, 2));
+      } else if (isTTY()) {
+        console.log(formatListTemplates(templates));
+      } else {
+        console.log(formatListTemplatesMarkdown(templates));
+      }
+    })
+  );
+  program.command("folder-templates").description("List folder templates in your workspace").option("--json", "Force JSON output even in terminal").action(
+    wrapAction(async (opts) => {
+      const config = loadConfig(getProfileName());
+      const templates = await listFolderTemplates(config);
+      if (shouldOutputJson(opts.json ?? false)) {
+        console.log(JSON.stringify(templates, null, 2));
+      } else if (isTTY()) {
+        console.log(formatFolderTemplates(templates));
+      } else {
+        console.log(formatFolderTemplatesMarkdown(templates));
+      }
+    })
+  );
+  program.command("list-from-template <name>").description("Create a list from a list template").requiredOption("--template <id>", "Template ID (find with list-templates)").option("--space <spaceId>", "Create in this space").option("--folder <folderId>", "Create in this folder").option("--json", "Force JSON output even in terminal").action(
+    wrapAction(
+      async (name, opts) => {
+        const config = loadConfig(getProfileName());
+        const result = await createListFromTemplate(config, name, opts);
+        if (shouldOutputJson(opts.json ?? false)) {
+          console.log(JSON.stringify(result, null, 2));
+        } else {
+          console.log(`Created list "${name}" (${result.id}) from template`);
+        }
+      }
+    )
+  );
+  program.command("views <listId>").description("List views on a list").option("--json", "Force JSON output even in terminal").action(
+    wrapAction(async (listId, opts) => {
+      const config = loadConfig(getProfileName());
+      const views = await listViews(config, listId);
+      if (shouldOutputJson(opts.json ?? false)) {
+        console.log(JSON.stringify(views, null, 2));
+      } else if (isTTY()) {
+        console.log(formatViews(views));
+      } else {
+        console.log(formatViewsMarkdown(views));
+      }
+    })
+  );
+  program.command("view <viewId>").description("Get view details").option("--json", "Force JSON output even in terminal").action(
+    wrapAction(async (viewId, opts) => {
+      const config = loadConfig(getProfileName());
+      const view = await getView(config, viewId);
+      if (shouldOutputJson(opts.json ?? false)) {
+        console.log(JSON.stringify(view, null, 2));
+      } else if (!isTTY()) {
+        console.log(formatViewMarkdown(view));
+      } else {
+        console.log(formatView(view));
+      }
+    })
+  );
+  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)"
+  ).option(
+    "--group-by <field>",
+    "Group by field (status, assignee, priority, due_date, tag, sprint)"
+  ).option("--json", "Force JSON output even in terminal").action(
+    wrapAction(
+      async (listId, name, opts) => {
+        const config = loadConfig(getProfileName());
+        const view = await createView(config, listId, name, {
+          type: opts.type,
+          groupBy: opts.groupBy
+        });
+        if (shouldOutputJson(opts.json ?? false)) {
+          console.log(JSON.stringify(view, null, 2));
+        } else {
+          console.log(`Created view "${view.name}" (${view.id}) type: ${view.type}`);
+        }
+      }
+    )
+  );
+  program.command("view-update <viewId>").description("Update a view").option("-n, --name <text>", "New view name").option(
+    "--group-by <field>",
+    "Group by field (status, assignee, priority, due_date, tag, sprint)"
+  ).option("--json", "Force JSON output even in terminal").action(
+    wrapAction(
+      async (viewId, opts) => {
+        const config = loadConfig(getProfileName());
+        const view = await updateView(config, viewId, {
+          name: opts.name,
+          groupBy: opts.groupBy
+        });
+        if (shouldOutputJson(opts.json ?? false)) {
+          console.log(JSON.stringify(view, null, 2));
+        } else {
+          console.log(`Updated view "${view.name}" (${view.id})`);
+        }
+      }
+    )
+  );
+  program.command("view-delete <viewId>").description("Delete a view (requires confirmation)").option("--confirm", "Skip confirmation prompt (required in non-interactive mode)").option("--json", "Force JSON output even in terminal").action(
+    wrapAction(async (viewId, opts) => {
+      const config = loadConfig(getProfileName());
+      const result = await deleteViewCommand(config, viewId, opts);
+      if (shouldOutputJson(opts.json ?? false)) {
+        console.log(JSON.stringify(result, null, 2));
+      } else {
+        console.log(`Deleted view ${result.viewId}`);
+      }
+    })
+  );
   const profileCmd = program.command("profile").description("Manage profiles");
   profileCmd.command("list").description("List all profiles").option("--json", "Force JSON output even in terminal").action(
     wrapAction(async (opts) => {

package/package.json

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

package/skills/clickup-cli/SKILL.md

@@ -60,6 +60,10 @@ All commands support `--help` for full flag details. All commands support `--jso
 | `cup doc-pages <docId>`                                                                    | All pages in a doc with content                                           |
 | `cup task-types`                                                                           | Custom task types (for `--custom-item-id`)                                |
 | `cup templates`                                                                            | Task templates (for `--template`)                                         |
+| `cup list-templates`                                                                       | List templates (for `list-from-template`)                                 |
+| `cup folder-templates`                                                                     | Folder templates                                                          |
+| `cup views <listId>`                                                                       | List views on a list                                                      |
+| `cup view <viewId>`                                                                        | Get view details                                                          |
 | `cup open <query>`                                                                         | Open task in browser by ID or name                                        |
 | `cup auth`                                                                                 | Check authentication status                                               |
 
@@ -115,6 +119,10 @@ All commands support `--help` for full flag details. All commands support `--jso
 | `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                    |
+| `cup list-from-template <name> --template <id> [--space id] [--folder id]`                                                                                                                 | Create list from template           |
+| `cup view-create <listId> <name> -t <type> [--group-by field]`                                                                                                                             | Create a view on a list             |
+| `cup view-update <viewId> [-n name] [--group-by field]`                                                                                                                                    | Update a view                       |
+| `cup view-delete <viewId> [--confirm]`                                                                                                                                                     | Delete a view (DESTRUCTIVE)         |
 | `cup profile list [--json]`                                                                                                                                                                | List all profiles                   |
 | `cup profile add <name>`                                                                                                                                                                   | Add a new profile (interactive)     |
 | `cup profile remove <name>`                                                                                                                                                                | Remove a profile                    |