@krodak/clickup-cli 1.4.0 → 1.5.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.4.0",
+  "version": "1.5.0",
   "author": {
     "name": "Krzysztof Rodak"
   },

package/README.md

@@ -134,20 +134,20 @@ Status: :white_check_mark: implemented | :construction: planned | :no_entry_sign
 
 ### Tasks
 
-| Feature              | Command              | Status             |
-| -------------------- | -------------------- | ------------------ |
-| List my tasks        | `cup tasks`          | :white_check_mark: |
-| Get task details     | `cup task <id>`      | :white_check_mark: |
-| Create task          | `cup create`         | :white_check_mark: |
-| Update task          | `cup update <id>`    | :white_check_mark: |
-| Delete task          | `cup delete <id>`    | :white_check_mark: |
-| Search tasks         | `cup search <query>` | :white_check_mark: |
-| Open in browser      | `cup open <query>`   | :white_check_mark: |
-| List subtasks        | `cup subtasks <id>`  | :white_check_mark: |
-| Assign / unassign    | `cup assign <id>`    | :white_check_mark: |
-| Duplicate task       | `cup duplicate <id>` | :white_check_mark: |
-| Create from template |                      | :no_entry_sign:    |
-| Bulk operations      | `cup bulk status`    | :white_check_mark: |
+| Feature              | Command                 | Status             |
+| -------------------- | ----------------------- | ------------------ |
+| List my tasks        | `cup tasks`             | :white_check_mark: |
+| Get task details     | `cup task <id>`         | :white_check_mark: |
+| Create task          | `cup create`            | :white_check_mark: |
+| Update task          | `cup update <id>`       | :white_check_mark: |
+| Delete task          | `cup delete <id>`       | :white_check_mark: |
+| Search tasks         | `cup search <query>`    | :white_check_mark: |
+| Open in browser      | `cup open <query>`      | :white_check_mark: |
+| List subtasks        | `cup subtasks <id>`     | :white_check_mark: |
+| Assign / unassign    | `cup assign <id>`       | :white_check_mark: |
+| Duplicate task       | `cup duplicate <id>`    | :white_check_mark: |
+| Create from template | `cup create --template` | :white_check_mark: |
+| Bulk operations      | `cup bulk status`       | :white_check_mark: |
 
 ### Dependencies & Relations
 
@@ -212,6 +212,7 @@ Status: :white_check_mark: implemented | :construction: planned | :no_entry_sign
 | Add/remove tag on task | `cup tag <id>`                    | :white_check_mark: |
 | List space tags        | `cup tags <spaceId>`              | :white_check_mark: |
 | Create space tag       | `cup tag-create <spaceId> <name>` | :white_check_mark: |
+| Update space tag       | `cup tag-update <spaceId> <name>` | :white_check_mark: |
 | Delete space tag       | `cup tag-delete <spaceId> <name>` | :white_check_mark: |
 
 ### Time Tracking
@@ -228,13 +229,15 @@ Status: :white_check_mark: implemented | :construction: planned | :no_entry_sign
 
 ### Workspace
 
-| Feature      | Command                 | Status             |
-| ------------ | ----------------------- | ------------------ |
-| List spaces  | `cup spaces`            | :white_check_mark: |
-| List lists   | `cup lists <spaceId>`   | :white_check_mark: |
-| Check auth   | `cup auth`              | :white_check_mark: |
-| List folders | `cup folders <spaceId>` | :white_check_mark: |
-| List members | `cup members`           | :white_check_mark: |
+| Feature        | Command                 | Status             |
+| -------------- | ----------------------- | ------------------ |
+| List spaces    | `cup spaces`            | :white_check_mark: |
+| List lists     | `cup lists <spaceId>`   | :white_check_mark: |
+| Check auth     | `cup auth`              | :white_check_mark: |
+| List folders   | `cup folders <spaceId>` | :white_check_mark: |
+| List members   | `cup members`           | :white_check_mark: |
+| Task types     | `cup task-types`        | :white_check_mark: |
+| Task templates | `cup templates`         | :white_check_mark: |
 
 ### Goals & Key Results
 
@@ -243,9 +246,11 @@ Status: :white_check_mark: implemented | :construction: planned | :no_entry_sign
 | List goals        | `cup goals`                          | :white_check_mark: |
 | Create goal       | `cup goal-create <name>`             | :white_check_mark: |
 | Update goal       | `cup goal-update <goalId>`           | :white_check_mark: |
+| Delete goal       | `cup goal-delete <goalId>`           | :white_check_mark: |
 | List key results  | `cup key-results <goalId>`           | :white_check_mark: |
 | Create key result | `cup key-result-create <goalId> <n>` | :white_check_mark: |
 | Update key result | `cup key-result-update <krId>`       | :white_check_mark: |
+| Delete key result | `cup key-result-delete <krId>`       | :white_check_mark: |
 
 ### Docs
 
@@ -257,6 +262,8 @@ Status: :white_check_mark: implemented | :construction: planned | :no_entry_sign
 | Create doc       | `cup doc-create <title>`             | :white_check_mark: |
 | Create page      | `cup doc-page-create <docId> <name>` | :white_check_mark: |
 | Edit page        | `cup doc-page-edit <docId> <pageId>` | :white_check_mark: |
+| Delete doc       | `cup doc-delete <docId>`             | :white_check_mark: |
+| Delete page      | `cup doc-page-delete <docId> <pId>`  | :white_check_mark: |
 
 ### Attachments
 
@@ -267,16 +274,19 @@ Status: :white_check_mark: implemented | :construction: planned | :no_entry_sign
 
 ### :no_entry_sign: Won't add
 
-| Feature               | Why                                                                         |
-| --------------------- | --------------------------------------------------------------------------- |
-| Create from template  | No public API for task templates.                                           |
-| Webhooks              | Server-side. A CLI can't listen for events.                                 |
-| OAuth flow            | `cup init` already handles auth with API tokens.                            |
-| Guest/ACL             | Enterprise admin. Not what you reach for in a terminal.                     |
-| Chat/DM               | Use the ClickUp app. Chat doesn't belong in a CLI.                          |
-| Audit logs            | Enterprise admin.                                                           |
-| User/group management | Too destructive for a CLI - removing someone from a workspace is permanent. |
-| View CRUD             | Views are visual layouts. Configure them in the UI.                         |
+| Feature                 | Why                                                                         |
+| ----------------------- | --------------------------------------------------------------------------- |
+| Webhooks                | Server-side. A CLI can't listen for events.                                 |
+| OAuth flow              | `cup init` already handles auth with API tokens.                            |
+| Guest/ACL               | Enterprise admin. Not what you reach for in a terminal.                     |
+| Chat/DM                 | Use the ClickUp app. Chat doesn't belong in a CLI.                          |
+| Audit logs              | Enterprise admin.                                                           |
+| User/group management   | Too destructive for a CLI - removing someone from a workspace is permanent. |
+| View CRUD               | Views are visual layouts. Configure them in the UI.                         |
+| List/Folder/Space CRUD  | Structural changes. Set these up in the UI.                                 |
+| View/List/Chat comments | API only supports task-level comments.                                      |
+| User Groups             | Enterprise admin feature.                                                   |
+| Shared Hierarchy        | Enterprise admin feature.                                                   |
 
 ### API Limitations
 

package/dist/index.js

@@ -34,8 +34,8 @@ var ClickUpClient = class {
     }
     return "";
   }
-  async request(path, options = {}) {
-    const res = await fetch(`${BASE_URL}${path}`, {
+  async _fetch(baseUrl, path, options = {}) {
+    const res = await fetch(`${baseUrl}${path}`, {
       ...options,
       signal: AbortSignal.timeout(3e4),
       headers: {
@@ -57,28 +57,11 @@ var ClickUpClient = class {
     }
     return data;
   }
+  async request(path, options = {}) {
+    return this._fetch(BASE_URL, path, options);
+  }
   async requestV3(path, options = {}) {
-    const res = await fetch(`${BASE_URL_V3}${path}`, {
-      ...options,
-      signal: AbortSignal.timeout(3e4),
-      headers: {
-        Authorization: this.apiToken,
-        ...options.body ? { "Content-Type": "application/json" } : {},
-        ...options.headers
-      }
-    });
-    let data;
-    try {
-      data = await res.json();
-    } catch {
-      throw new Error(`ClickUp API error ${res.status}: response was not valid JSON`);
-    }
-    if (!res.ok) {
-      const raw = data.err ?? data.error ?? data.ECODE ?? res.statusText;
-      const msg = typeof raw === "string" ? raw : JSON.stringify(raw);
-      throw new Error(`ClickUp API error ${res.status}: ${msg}`);
-    }
-    return data;
+    return this._fetch(BASE_URL_V3, path, options);
   }
   async getMe() {
     if (this.meCache) return this.meCache;
@@ -534,6 +517,50 @@ var ClickUpClient = class {
     });
     return data.key_result;
   }
+  async deleteGoal(goalId) {
+    await this.request(`/goal/${goalId}`, { method: "DELETE" });
+  }
+  async deleteKeyResult(keyResultId) {
+    await this.request(`/key_result/${keyResultId}`, { method: "DELETE" });
+  }
+  async deleteDoc(workspaceId, docId) {
+    await this.requestV3(`/workspaces/${workspaceId}/docs/${docId}`, {
+      method: "DELETE"
+    });
+  }
+  async deleteDocPage(workspaceId, docId, pageId) {
+    await this.requestV3(
+      `/workspaces/${workspaceId}/docs/${docId}/pages/${pageId}`,
+      { method: "DELETE" }
+    );
+  }
+  async updateSpaceTag(spaceId, tagName, updates) {
+    await this.request(
+      `/space/${spaceId}/tag/${encodeURIComponent(tagName)}`,
+      {
+        method: "PUT",
+        body: JSON.stringify({
+          tag: {
+            name: updates.name,
+            tag_fg: updates.tag_fg ?? "#000000",
+            tag_bg: updates.tag_bg ?? "#04A9F4"
+          }
+        })
+      }
+    );
+  }
+  async getTaskTemplates(teamId) {
+    const data = await this.request(
+      `/team/${teamId}/taskTemplate?page=0`
+    );
+    return data.templates ?? [];
+  }
+  async createTaskFromTemplate(listId, templateId, name) {
+    return this.request(`/list/${listId}/taskTemplate/${templateId}`, {
+      method: "POST",
+      body: JSON.stringify({ name })
+    });
+  }
 };
 
 // src/config.ts
@@ -1268,6 +1295,10 @@ async function createTask(config, options) {
   if (!listId) {
     throw new Error("Provide --list or --parent (list is auto-detected from parent task)");
   }
+  if (options.template) {
+    const task2 = await client.createTaskFromTemplate(listId, options.template, options.name);
+    return { id: task2.id, name: task2.name, url: task2.url };
+  }
   const payload = {
     name: options.name,
     ...options.description !== void 0 ? { markdown_content: options.description } : {},
@@ -2182,7 +2213,7 @@ function bashCompletion(name) {
     cword=$COMP_CWORD
   fi
 
-  local commands="init auth tasks task update create sprint sprints subtasks comment comment-edit comment-delete comments replies reply activity lists spaces inbox assigned open search summary overdue assign depend link attach move field delete tag tags tag-create tag-delete checklist time docs doc doc-create doc-pages doc-page-create doc-page-edit folders members fields duplicate bulk goals goal-create goal-update key-results key-result-create key-result-update config completion"
+  local commands="init auth tasks task update create sprint sprints subtasks comment comment-edit comment-delete comments replies reply activity lists spaces inbox assigned open search summary overdue assign depend link attach move field delete tag tags tag-create tag-delete tag-update checklist time docs doc doc-create doc-pages doc-page-create doc-page-edit doc-delete doc-page-delete folders members fields duplicate bulk goals goal-create goal-update goal-delete key-results key-result-create key-result-update key-result-delete task-types templates config completion"
 
   if [[ $cword -eq 1 ]]; then
     COMPREPLY=($(compgen -W "$commands --help --version" -- "$cur"))
@@ -2213,7 +2244,7 @@ function bashCompletion(name) {
       COMPREPLY=($(compgen -W "-n --name -d --description -s --status --priority --due-date --time-estimate --assignee --parent --json" -- "$cur"))
       ;;
     create)
-      COMPREPLY=($(compgen -W "-l --list -n --name -d --description -p --parent -s --status --priority --due-date --assignee --tags --custom-item-id --time-estimate --json" -- "$cur"))
+      COMPREPLY=($(compgen -W "-l --list -n --name -d --description -p --parent -s --status --priority --due-date --assignee --tags --custom-item-id --time-estimate --template --json" -- "$cur"))
       ;;
     sprint)
       COMPREPLY=($(compgen -W "--status --space --folder --include-closed --json" -- "$cur"))
@@ -2285,7 +2316,7 @@ function bashCompletion(name) {
       ;;
     time)
       if [[ $cword -eq 2 ]]; then
-        COMPREPLY=($(compgen -W "start stop status log list" -- "$cur"))
+        COMPREPLY=($(compgen -W "start stop status log list update delete" -- "$cur"))
       fi
       ;;
     comment-edit)
@@ -2347,6 +2378,9 @@ function bashCompletion(name) {
     goal-update)
       COMPREPLY=($(compgen -W "-n --name -d --description --color --json" -- "$cur"))
       ;;
+    goal-delete)
+      COMPREPLY=($(compgen -W "--json" -- "$cur"))
+      ;;
     key-results)
       COMPREPLY=($(compgen -W "--json" -- "$cur"))
       ;;
@@ -2356,6 +2390,9 @@ function bashCompletion(name) {
     key-result-update)
       COMPREPLY=($(compgen -W "--progress --note --json" -- "$cur"))
       ;;
+    key-result-delete)
+      COMPREPLY=($(compgen -W "--json" -- "$cur"))
+      ;;
     folders)
       COMPREPLY=($(compgen -W "--name --json" -- "$cur"))
       ;;
@@ -2368,6 +2405,21 @@ function bashCompletion(name) {
     doc-page-edit)
       COMPREPLY=($(compgen -W "--name -c --content --json" -- "$cur"))
       ;;
+    doc-delete)
+      COMPREPLY=($(compgen -W "--json" -- "$cur"))
+      ;;
+    doc-page-delete)
+      COMPREPLY=($(compgen -W "--json" -- "$cur"))
+      ;;
+    tag-update)
+      COMPREPLY=($(compgen -W "--name --fg --bg --json" -- "$cur"))
+      ;;
+    task-types)
+      COMPREPLY=($(compgen -W "--json" -- "$cur"))
+      ;;
+    templates)
+      COMPREPLY=($(compgen -W "--json" -- "$cur"))
+      ;;
     config)
       if [[ $cword -eq 2 ]]; then
         COMPREPLY=($(compgen -W "get set path" -- "$cur"))
@@ -2444,9 +2496,16 @@ _${name}() {
     'goals:List goals in your workspace'
     'goal-create:Create a goal'
     'goal-update:Update a goal'
+    'goal-delete:Delete a goal'
     'key-results:List key results for a goal'
     'key-result-create:Create a key result on a goal'
     'key-result-update:Update a key result'
+    'key-result-delete:Delete a key result'
+    'doc-delete:Delete a doc'
+    'doc-page-delete:Delete a doc page'
+    'tag-update:Update a tag in a space'
+    'task-types:List custom task types'
+    'templates:List task templates'
     'folders:List folders in a space'
     'config:Manage CLI configuration'
     'completion:Output shell completion script'
@@ -2505,6 +2564,7 @@ _${name}() {
             '--tags[Comma-separated tag names]:tags:' \\
             '--custom-item-id[Custom task type ID]:id:' \\
             '--time-estimate[Time estimate]:duration:' \\
+            '--template[Create from a task template]:template_id:' \\
             '--json[Force JSON output]'
           ;;
         sprint)
@@ -2693,6 +2753,8 @@ _${name}() {
             'status:Show the currently running timer'
             'log:Log a manual time entry'
             'list:List recent time entries'
+            'update:Update a time entry'
+            'delete:Delete a time entry'
           )
           _arguments -C \\
             '1:time command:->time_cmd' \\
@@ -2728,6 +2790,18 @@ _${name}() {
                     '--task[Filter by task ID]:task_id:' \\
                     '--json[Force JSON output]'
                   ;;
+                update)
+                  _arguments \\
+                    '1:time_entry_id:' \\
+                    '(-d --description)'{-d,--description}'[New description]:text:' \\
+                    '--duration[New duration]:duration:' \\
+                    '--json[Force JSON output]'
+                  ;;
+                delete)
+                  _arguments \\
+                    '1:time_entry_id:' \\
+                    '--json[Force JSON output]'
+                  ;;
               esac
               ;;
           esac
@@ -2879,6 +2953,44 @@ _${name}() {
             '--note[Progress note]:text:' \\
             '--json[Force JSON output]'
           ;;
+        key-result-delete)
+          _arguments \\
+            '1:key_result_id:' \\
+            '--json[Force JSON output]'
+          ;;
+        goal-delete)
+          _arguments \\
+            '1:goal_id:' \\
+            '--json[Force JSON output]'
+          ;;
+        doc-delete)
+          _arguments \\
+            '1:doc_id:' \\
+            '--json[Force JSON output]'
+          ;;
+        doc-page-delete)
+          _arguments \\
+            '1:doc_id:' \\
+            '2:page_id:' \\
+            '--json[Force JSON output]'
+          ;;
+        tag-update)
+          _arguments \\
+            '1:space_id:' \\
+            '2:tag_name:' \\
+            '--name[New tag name]:text:' \\
+            '--fg[New foreground color]:color:' \\
+            '--bg[New background color]:color:' \\
+            '--json[Force JSON output]'
+          ;;
+        task-types)
+          _arguments \\
+            '--json[Force JSON output]'
+          ;;
+        templates)
+          _arguments \\
+            '--json[Force JSON output]'
+          ;;
         folders)
           _arguments \\
             '1:space_id:' \\
@@ -3000,6 +3112,13 @@ complete -c ${name} -n __fish_use_subcommand -a goal-update -d 'Update a goal'
 complete -c ${name} -n __fish_use_subcommand -a key-results -d 'List key results for a goal'
 complete -c ${name} -n __fish_use_subcommand -a key-result-create -d 'Create a key result on a goal'
 complete -c ${name} -n __fish_use_subcommand -a key-result-update -d 'Update a key result'
+complete -c ${name} -n __fish_use_subcommand -a goal-delete -d 'Delete a goal'
+complete -c ${name} -n __fish_use_subcommand -a key-result-delete -d 'Delete a key result'
+complete -c ${name} -n __fish_use_subcommand -a doc-delete -d 'Delete a doc'
+complete -c ${name} -n __fish_use_subcommand -a doc-page-delete -d 'Delete a doc page'
+complete -c ${name} -n __fish_use_subcommand -a tag-update -d 'Update a tag in a space'
+complete -c ${name} -n __fish_use_subcommand -a task-types -d 'List custom task types'
+complete -c ${name} -n __fish_use_subcommand -a templates -d 'List task templates'
 complete -c ${name} -n __fish_use_subcommand -a folders -d 'List folders in a space'
 complete -c ${name} -n __fish_use_subcommand -a config -d 'Manage CLI configuration'
 complete -c ${name} -n __fish_use_subcommand -a completion -d 'Output shell completion script'
@@ -3037,6 +3156,7 @@ complete -c ${name} -n '__fish_seen_subcommand_from create' -l assignee -d 'Assi
 complete -c ${name} -n '__fish_seen_subcommand_from create' -l tags -d 'Comma-separated tag names'
 complete -c ${name} -n '__fish_seen_subcommand_from create' -l custom-item-id -d 'Custom task type ID'
 complete -c ${name} -n '__fish_seen_subcommand_from create' -l time-estimate -d 'Time estimate'
+complete -c ${name} -n '__fish_seen_subcommand_from create' -l template -d 'Create from a task template'
 complete -c ${name} -n '__fish_seen_subcommand_from create' -l json -d 'Force JSON output'
 
 complete -c ${name} -n '__fish_seen_subcommand_from sprint' -l status -d 'Filter by status'
@@ -3124,16 +3244,20 @@ complete -c ${name} -n '__fish_seen_subcommand_from edit-item' -l resolved -d 'M
 complete -c ${name} -n '__fish_seen_subcommand_from edit-item' -l unresolved -d 'Mark item as unresolved'
 complete -c ${name} -n '__fish_seen_subcommand_from edit-item' -l assignee -d 'Assign user by ID'
 
-complete -c ${name} -n '__fish_seen_subcommand_from time; and not __fish_seen_subcommand_from start stop status log list' -a start -d 'Start tracking time on a task'
-complete -c ${name} -n '__fish_seen_subcommand_from time; and not __fish_seen_subcommand_from start stop status log list' -a stop -d 'Stop the running timer'
-complete -c ${name} -n '__fish_seen_subcommand_from time; and not __fish_seen_subcommand_from start stop status log list' -a status -d 'Show the currently running timer'
-complete -c ${name} -n '__fish_seen_subcommand_from time; and not __fish_seen_subcommand_from start stop status log list' -a log -d 'Log a manual time entry'
-complete -c ${name} -n '__fish_seen_subcommand_from time; and not __fish_seen_subcommand_from start stop status log list' -a list -d 'List recent time entries'
-complete -c ${name} -n '__fish_seen_subcommand_from start stop status log list; and __fish_seen_subcommand_from time' -l json -d 'Force JSON output'
+complete -c ${name} -n '__fish_seen_subcommand_from time; and not __fish_seen_subcommand_from start stop status log list update delete' -a start -d 'Start tracking time on a task'
+complete -c ${name} -n '__fish_seen_subcommand_from time; and not __fish_seen_subcommand_from start stop status log list update delete' -a stop -d 'Stop the running timer'
+complete -c ${name} -n '__fish_seen_subcommand_from time; and not __fish_seen_subcommand_from start stop status log list update delete' -a status -d 'Show the currently running timer'
+complete -c ${name} -n '__fish_seen_subcommand_from time; and not __fish_seen_subcommand_from start stop status log list update delete' -a log -d 'Log a manual time entry'
+complete -c ${name} -n '__fish_seen_subcommand_from time; and not __fish_seen_subcommand_from start stop status log list update delete' -a list -d 'List recent time entries'
+complete -c ${name} -n '__fish_seen_subcommand_from time; and not __fish_seen_subcommand_from start stop status log list update delete' -a update -d 'Update a time entry'
+complete -c ${name} -n '__fish_seen_subcommand_from time; and not __fish_seen_subcommand_from start stop status log list update delete' -a delete -d 'Delete a time entry'
+complete -c ${name} -n '__fish_seen_subcommand_from start stop status log list update delete; and __fish_seen_subcommand_from time' -l json -d 'Force JSON output'
 complete -c ${name} -n '__fish_seen_subcommand_from start; and __fish_seen_subcommand_from time' -s d -l description -d 'Description'
 complete -c ${name} -n '__fish_seen_subcommand_from log; and __fish_seen_subcommand_from time' -s d -l description -d 'Description'
 complete -c ${name} -n '__fish_seen_subcommand_from list; and __fish_seen_subcommand_from time' -l days -d 'Number of days to look back'
 complete -c ${name} -n '__fish_seen_subcommand_from list; and __fish_seen_subcommand_from time' -l task -d 'Filter by task ID'
+complete -c ${name} -n '__fish_seen_subcommand_from update; and __fish_seen_subcommand_from time' -s d -l description -d 'New description'
+complete -c ${name} -n '__fish_seen_subcommand_from update; and __fish_seen_subcommand_from time' -l duration -d 'New duration'
 
 complete -c ${name} -n '__fish_seen_subcommand_from comment-delete' -l json -d 'Force JSON output'
 
@@ -3198,6 +3322,23 @@ complete -c ${name} -n '__fish_seen_subcommand_from key-result-update' -l progre
 complete -c ${name} -n '__fish_seen_subcommand_from key-result-update' -l note -d 'Progress note'
 complete -c ${name} -n '__fish_seen_subcommand_from key-result-update' -l json -d 'Force JSON output'
 
+complete -c ${name} -n '__fish_seen_subcommand_from goal-delete' -l json -d 'Force JSON output'
+
+complete -c ${name} -n '__fish_seen_subcommand_from key-result-delete' -l json -d 'Force JSON output'
+
+complete -c ${name} -n '__fish_seen_subcommand_from doc-delete' -l json -d 'Force JSON output'
+
+complete -c ${name} -n '__fish_seen_subcommand_from doc-page-delete' -l json -d 'Force JSON output'
+
+complete -c ${name} -n '__fish_seen_subcommand_from tag-update' -l name -d 'New tag name'
+complete -c ${name} -n '__fish_seen_subcommand_from tag-update' -l fg -d 'New foreground color'
+complete -c ${name} -n '__fish_seen_subcommand_from tag-update' -l bg -d 'New background color'
+complete -c ${name} -n '__fish_seen_subcommand_from tag-update' -l json -d 'Force JSON output'
+
+complete -c ${name} -n '__fish_seen_subcommand_from task-types' -l json -d 'Force JSON output'
+
+complete -c ${name} -n '__fish_seen_subcommand_from templates' -l json -d 'Force JSON output'
+
 complete -c ${name} -n '__fish_seen_subcommand_from folders' -l name -d 'Filter by folder name'
 complete -c ${name} -n '__fish_seen_subcommand_from folders' -l json -d 'Force JSON output'
 
@@ -3699,6 +3840,14 @@ async function editDocPage(config, docId, pageId, updates) {
   const client = new ClickUpClient(config);
   return client.editDocPage(config.teamId, docId, pageId, updates);
 }
+async function deleteDoc(config, docId) {
+  const client = new ClickUpClient(config);
+  await client.deleteDoc(config.teamId, docId);
+}
+async function deleteDocPage(config, docId, pageId) {
+  const client = new ClickUpClient(config);
+  await client.deleteDocPage(config.teamId, docId, pageId);
+}
 
 // src/commands/folders.ts
 import chalk9 from "chalk";
@@ -3826,6 +3975,14 @@ async function deleteSpaceTag(config, spaceId, tagName) {
   const client = new ClickUpClient(config);
   await client.deleteSpaceTag(spaceId, tagName);
 }
+async function updateSpaceTag(config, spaceId, tagName, updates) {
+  const client = new ClickUpClient(config);
+  await client.updateSpaceTag(spaceId, tagName, {
+    name: updates.name,
+    tag_fg: updates.fg,
+    tag_bg: updates.bg
+  });
+}
 function formatTags(tags) {
   if (tags.length === 0) return "No tags found";
   return tags.map((t) => chalk11.bold(t.name)).join(", ");
@@ -3874,6 +4031,7 @@ function formatFieldsMarkdown(fields) {
 }
 
 // src/commands/duplicate.ts
+var PRIORITY_MAP2 = { urgent: 1, high: 2, normal: 3, low: 4 };
 async function duplicateTask(config, taskId) {
   const client = new ClickUpClient(config);
   const task = await client.getTask(taskId);
@@ -3881,7 +4039,7 @@ async function duplicateTask(config, taskId) {
     name: `${task.name} (copy)`,
     description: task.description,
     markdown_content: task.markdown_content,
-    priority: task.priority ? Number(task.priority.priority) : void 0,
+    priority: task.priority ? PRIORITY_MAP2[task.priority.priority.toLowerCase()] : void 0,
     tags: task.tags?.map((t) => t.name),
     time_estimate: task.time_estimate ?? void 0
   });
@@ -3895,8 +4053,9 @@ async function bulkUpdateStatus(config, taskIds, status) {
   for (const id of taskIds) {
     try {
       await client.updateTask(id, { status });
-    } catch {
-      failed.push(id);
+    } catch (err) {
+      const reason = err instanceof Error ? err.message : String(err);
+      failed.push({ id, reason });
     }
   }
   return { updated: taskIds.length - failed.length, failed };
@@ -3916,6 +4075,14 @@ async function updateGoal(config, goalId, updates) {
   const client = new ClickUpClient(config);
   return client.updateGoal(goalId, updates);
 }
+async function deleteGoal(config, goalId) {
+  const client = new ClickUpClient(config);
+  await client.deleteGoal(goalId);
+}
+async function deleteKeyResult(config, keyResultId) {
+  const client = new ClickUpClient(config);
+  await client.deleteKeyResult(keyResultId);
+}
 async function listKeyResults(config, goalId) {
   const client = new ClickUpClient(config);
   return client.getKeyResults(goalId);
@@ -3962,6 +4129,36 @@ function formatKeyResultsMarkdown(keyResults) {
   }).join("\n");
 }
 
+// src/commands/task-types.ts
+import chalk15 from "chalk";
+async function listTaskTypes(config) {
+  const client = new ClickUpClient(config);
+  return client.getCustomTaskTypes(config.teamId);
+}
+function formatTaskTypes(types) {
+  if (types.length === 0) return "No custom task types";
+  return types.map((t) => `${chalk15.bold(t.name)} ${chalk15.dim(`(${t.id})`)}`).join("\n");
+}
+function formatTaskTypesMarkdown(types) {
+  if (types.length === 0) return "No custom task types";
+  return types.map((t) => `- **${t.name}** (${t.id})`).join("\n");
+}
+
+// src/commands/templates.ts
+import chalk16 from "chalk";
+async function listTemplates(config) {
+  const client = new ClickUpClient(config);
+  return client.getTaskTemplates(config.teamId);
+}
+function formatTemplates(templates) {
+  if (templates.length === 0) return "No task templates";
+  return templates.map((t) => `${chalk16.bold(t.name)} ${chalk16.dim(`(${t.id})`)}`).join("\n");
+}
+function formatTemplatesMarkdown(templates) {
+  if (templates.length === 0) return "No task templates";
+  return templates.map((t) => `- **${t.name}** (${t.id})`).join("\n");
+}
+
 // src/index.ts
 var require2 = createRequire(import.meta.url);
 var { version } = require2("../package.json");
@@ -4040,7 +4237,7 @@ program.command("update <taskId>").description("Update a task").option("-n, --na
     }
   })
 );
-program.command("create").description("Create a new task").option("-l, --list <listId>", "Target list ID (auto-detected from --parent if omitted)").requiredOption("-n, --name <name>", "Task name").option("-d, --description <text>", "Task description (markdown supported)").option("-p, --parent <taskId>", "Parent task ID (list auto-detected from parent)").option("-s, --status <status>", "Initial status").option("--priority <level>", "Priority: urgent, high, normal, low (or 1-4)").option("--due-date <date>", "Due date (YYYY-MM-DD)").option("--assignee <userId>", 'Assignee user ID or "me"').option("--tags <tags>", "Comma-separated tag names").option("--custom-item-id <id>", "Custom task type ID (use to create initiatives)").option("--time-estimate <duration>", 'Time estimate (e.g. "2h", "30m", "1h30m")').option("--json", "Force JSON output even in terminal").action(
+program.command("create").description("Create a new task").option("-l, --list <listId>", "Target list ID (auto-detected from --parent if omitted)").requiredOption("-n, --name <name>", "Task name").option("-d, --description <text>", "Task description (markdown supported)").option("-p, --parent <taskId>", "Parent task ID (list auto-detected from parent)").option("-s, --status <status>", "Initial status").option("--priority <level>", "Priority: urgent, high, normal, low (or 1-4)").option("--due-date <date>", "Due date (YYYY-MM-DD)").option("--assignee <userId>", 'Assignee user ID or "me"').option("--tags <tags>", "Comma-separated tag names").option("--custom-item-id <id>", "Custom task type ID (use to create initiatives)").option("--time-estimate <duration>", 'Time estimate (e.g. "2h", "30m", "1h30m")').option("--template <id>", "Create from a task template").option("--json", "Force JSON output even in terminal").action(
   wrapAction(async (opts) => {
     const config = loadConfig();
     if (opts.assignee === "me") {
@@ -4617,7 +4814,9 @@ bulkCmd.command("status <status> <taskIds...>").description("Update status of mu
     } else {
       console.log(`Updated ${result.updated} tasks to "${status}"`);
       if (result.failed.length > 0) {
-        console.log(`Failed: ${result.failed.join(", ")}`);
+        for (const f of result.failed) {
+          console.log(`  Failed ${f.id}: ${f.reason}`);
+        }
       }
     }
   })
@@ -4668,6 +4867,17 @@ program.command("goal-update <goalId>").description("Update a goal").option("-n,
     }
   )
 );
+program.command("goal-delete <goalId>").description("Delete a goal").option("--json", "Force JSON output even in terminal").action(
+  wrapAction(async (goalId, opts) => {
+    const config = loadConfig();
+    await deleteGoal(config, goalId);
+    if (shouldOutputJson(opts.json ?? false)) {
+      console.log(JSON.stringify({ success: true, goalId }, null, 2));
+    } else {
+      console.log(`Deleted goal ${goalId}`);
+    }
+  })
+);
 program.command("key-results <goalId>").description("List key results for a goal").option("--json", "Force JSON output even in terminal").action(
   wrapAction(async (goalId, opts) => {
     const config = loadConfig();
@@ -4718,6 +4928,17 @@ program.command("key-result-update <keyResultId>").description("Update a key res
     }
   )
 );
+program.command("key-result-delete <keyResultId>").description("Delete a key result").option("--json", "Force JSON output even in terminal").action(
+  wrapAction(async (keyResultId, opts) => {
+    const config = loadConfig();
+    await deleteKeyResult(config, keyResultId);
+    if (shouldOutputJson(opts.json ?? false)) {
+      console.log(JSON.stringify({ success: true, keyResultId }, null, 2));
+    } else {
+      console.log(`Deleted key result ${keyResultId}`);
+    }
+  })
+);
 program.command("docs [query]").description("List workspace docs (optionally filter by name)").option("--json", "Force JSON output even in terminal").action(
   wrapAction(async (query, opts) => {
     const config = loadConfig();
@@ -4821,6 +5042,77 @@ program.command("doc-page-edit <docId> <pageId>").description("Edit a doc page")
     }
   )
 );
+program.command("doc-delete <docId>").description("Delete a doc").option("--json", "Force JSON output even in terminal").action(
+  wrapAction(async (docId, opts) => {
+    const config = loadConfig();
+    await deleteDoc(config, docId);
+    if (shouldOutputJson(opts.json ?? false)) {
+      console.log(JSON.stringify({ success: true, docId }, null, 2));
+    } else {
+      console.log(`Deleted doc ${docId}`);
+    }
+  })
+);
+program.command("doc-page-delete <docId> <pageId>").description("Delete a doc page").option("--json", "Force JSON output even in terminal").action(
+  wrapAction(async (docId, pageId, opts) => {
+    const config = loadConfig();
+    await deleteDocPage(config, docId, pageId);
+    if (shouldOutputJson(opts.json ?? false)) {
+      console.log(JSON.stringify({ success: true, docId, pageId }, null, 2));
+    } else {
+      console.log(`Deleted page ${pageId} from doc ${docId}`);
+    }
+  })
+);
+program.command("tag-update <spaceId> <tagName>").description("Update a tag in a space").requiredOption("--name <newName>", "New tag name").option("--fg <color>", "New foreground color (hex)").option("--bg <color>", "New background color (hex)").option("--json", "Force JSON output even in terminal").action(
+  wrapAction(
+    async (spaceId, tagName, opts) => {
+      const config = loadConfig();
+      await updateSpaceTag(config, spaceId, tagName, {
+        name: opts.name,
+        fg: opts.fg,
+        bg: opts.bg
+      });
+      if (shouldOutputJson(opts.json ?? false)) {
+        console.log(
+          JSON.stringify(
+            { success: true, spaceId, oldName: tagName, newName: opts.name },
+            null,
+            2
+          )
+        );
+      } else {
+        console.log(`Renamed tag "${tagName}" to "${opts.name}" in space ${spaceId}`);
+      }
+    }
+  )
+);
+program.command("task-types").description("List custom task types in your workspace").option("--json", "Force JSON output even in terminal").action(
+  wrapAction(async (opts) => {
+    const config = loadConfig();
+    const types = await listTaskTypes(config);
+    if (shouldOutputJson(opts.json ?? false)) {
+      console.log(JSON.stringify(types, null, 2));
+    } else if (isTTY()) {
+      console.log(formatTaskTypes(types));
+    } else {
+      console.log(formatTaskTypesMarkdown(types));
+    }
+  })
+);
+program.command("templates").description("List task templates in your workspace").option("--json", "Force JSON output even in terminal").action(
+  wrapAction(async (opts) => {
+    const config = loadConfig();
+    const templates = await listTemplates(config);
+    if (shouldOutputJson(opts.json ?? false)) {
+      console.log(JSON.stringify(templates, null, 2));
+    } else if (isTTY()) {
+      console.log(formatTemplates(templates));
+    } else {
+      console.log(formatTemplatesMarkdown(templates));
+    }
+  })
+);
 var configCmd = program.command("config").description("Manage CLI configuration");
 configCmd.command("get <key>").description("Print a config value").action(
   wrapAction(async (key) => {

package/package.json

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

package/skills/clickup-cli/SKILL.md

@@ -61,6 +61,8 @@ All commands support `--help` for full flag details.
 | `cup docs [query] [--json]`                                                                         | List workspace docs (optionally filter by name)    |
 | `cup doc <docId> [pageId] [--json]`                                                                 | View doc metadata + page tree, or a specific page  |
 | `cup doc-pages <docId> [--json]`                                                                    | All pages in a doc with content                    |
+| `cup task-types [--json]`                                                                           | List custom task types in your workspace           |
+| `cup templates [--json]`                                                                            | List task templates in your workspace              |
 
 ### Write
 
@@ -105,6 +107,12 @@ All commands support `--help` for full flag details.
 | `cup goal-update <goalId> [-n name] [-d desc] [--color hex] [--json]`                                                                                                               | Update a goal                                              |
 | `cup key-result-create <goalId> <name> [--type t] [--target n] [--json]`                                                                                                            | Create a key result on a goal                              |
 | `cup key-result-update <keyResultId> [--progress n] [--note text] [--json]`                                                                                                         | Update a key result                                        |
+| `cup goal-delete <goalId> [--json]`                                                                                                                                                 | Delete a goal                                              |
+| `cup key-result-delete <keyResultId> [--json]`                                                                                                                                      | Delete a key result                                        |
+| `cup doc-delete <docId> [--json]`                                                                                                                                                   | Delete a doc                                               |
+| `cup doc-page-delete <docId> <pageId> [--json]`                                                                                                                                     | Delete a doc page                                          |
+| `cup tag-update <spaceId> <tagName> --name <newName> [--fg c] [--bg c] [--json]`                                                                                                    | Update a tag in a space                                    |
+| `cup create -n name -l listId --template <templateId> [--json]`                                                                                                                     | Create task from a template                                |
 | `cup config get <key>` / `cup config set <key> <value>` / `cup config path`                                                                                                         | Manage CLI config (keys: apiToken, teamId, sprintFolderId) |
 | `cup completion <shell>`                                                                                                                                                            | Shell completions (bash/zsh/fish)                          |
 
@@ -168,6 +176,14 @@ All commands support `--help` for full flag details.
 | `cup doc-create`            | Create a new doc with optional initial content                                                                                                                                                                                                            |
 | `cup doc-page-create`       | Create a page in a doc, optionally nested under a parent page                                                                                                                                                                                             |
 | `cup doc-page-edit`         | Edit a doc page name or content                                                                                                                                                                                                                           |
+| `cup doc-delete`            | Delete a doc                                                                                                                                                                                                                                              |
+| `cup doc-page-delete`       | Delete a doc page                                                                                                                                                                                                                                         |
+| `cup goal-delete`           | Delete a goal                                                                                                                                                                                                                                             |
+| `cup key-result-delete`     | Delete a key result                                                                                                                                                                                                                                       |
+| `cup tag-update`            | Rename a tag in a space, optionally update colors                                                                                                                                                                                                         |
+| `cup task-types`            | List custom task types (useful for discovering `--custom-item-id` values)                                                                                                                                                                                 |
+| `cup templates`             | List task templates (useful for `cup create --template`)                                                                                                                                                                                                  |
+| `--template`                | On `cup create`, create task from a template instead of from scratch                                                                                                                                                                                      |
 | `cup task`                  | Shows custom fields, checklists, attachments, dependencies, and linked tasks in detail view                                                                                                                                                               |
 | `cup lists`                 | Discovers list IDs needed for `--list` and `cup create -l`                                                                                                                                                                                                |
 | Errors                      | stderr with exit code 1                                                                                                                                                                                                                                   |
@@ -276,9 +292,27 @@ cup config set sprintFolderId <id>   # pin sprint detection to a folder
 cup duplicate abc123                 # duplicate a task
 cup bulk status "done" t1 t2 t3     # mark multiple tasks done
 cup tag-create <spaceId> "urgent"    # create a space tag
+cup tag-update <spaceId> "urgent" --name "critical"  # rename a tag
 cup tag-delete <spaceId> "old-tag"   # delete a space tag
 ```
 
+### Templates and task types
+
+```bash
+cup task-types                       # list custom task types
+cup templates                        # list task templates
+cup create -n "Bug" -l <listId> --template <templateId>  # create from template
+```
+
+### Delete operations
+
+```bash
+cup goal-delete <goalId>             # delete a goal
+cup key-result-delete <krId>         # delete a key result
+cup doc-delete <docId>               # delete a doc
+cup doc-page-delete <docId> <pageId> # delete a doc page
+```
+
 ### Goals and key results
 
 ```bash