npm - @krodak/clickup-cli - Versions diffs - 0.12.2 → 0.13.0 - Mend

@krodak/clickup-cli 0.12.2 → 0.13.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (4) hide show

package/README.md +61 -1
package/dist/index.js +382 -46
package/package.json +1 -1
package/skills/clickup-cli/SKILL.md +45 -28

package/README.md CHANGED Viewed

@@ -98,7 +98,7 @@ When output is piped (no TTY), all commands output **Markdown** by default - opt
 ## Commands
-27 commands total. All support `--help` for full flag details.
+30 commands total. All support `--help` for full flag details.
 ### `cu init`
@@ -261,6 +261,48 @@ cu create -n "Fix bug" -l <listId> --json
 | `--custom-item-id <id>`      | no               | Custom task type ID (for creating initiatives)       |
 | `--json`                     | no               | Force JSON output even in terminal                   |
+### `cu delete <id>`
+Delete a task. **DESTRUCTIVE - cannot be undone.**
+```bash
+cu delete abc123
+cu delete abc123 --confirm
+cu delete abc123 --confirm --json
+```
+In TTY mode without `--confirm`: shows the task name and prompts for confirmation (default: No). In non-interactive/piped mode, `--confirm` is required.
+| Flag        | Description                                                 |
+| ----------- | ----------------------------------------------------------- |
+| `--confirm` | Skip confirmation prompt (required in non-interactive mode) |
+| `--json`    | Force JSON output                                           |
+### `cu field <id>`
+Set or remove a custom field value. Field names are resolved case-insensitively; errors list available fields/options.
+```bash
+cu field abc123 --set "Priority Level" high
+cu field abc123 --set "Story Points" 5
+cu field abc123 --set "Approved" true
+cu field abc123 --set "Category" "Bug Fix"
+cu field abc123 --set "Due" 2025-06-01
+cu field abc123 --set "Website" "https://example.com"
+cu field abc123 --set "Contact" "user@example.com"
+cu field abc123 --remove "Priority Level"
+cu field abc123 --set "Points" 3 --remove "Old Field"
+cu field abc123 --set "Points" 3 --json
+```
+| Flag                       | Description                                                                                                                      |
+| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
+| `--set "Field Name" <val>` | Set a custom field by name. Supports: text, number, checkbox (true/false), dropdown (option name), date (YYYY-MM-DD), url, email |
+| `--remove "Field Name"`    | Remove a custom field value                                                                                                      |
+| `--json`                   | Force JSON output                                                                                                                |
+Both `--set` and `--remove` can be used together in one invocation.
 ### `cu comment <id>`
 Post a comment on a task.
@@ -423,6 +465,24 @@ cu move abc123 --to <listId> --json
 | `--remove <listId>` | Remove task from this list |
 | `--json`            | Force JSON output          |
+### `cu tag <id>`
+Add or remove tags on a task. Both `--add` and `--remove` can be used together.
+```bash
+cu tag abc123 --add "bug"
+cu tag abc123 --add "bug,frontend,urgent"
+cu tag abc123 --remove "wontfix"
+cu tag abc123 --add "bug" --remove "triage"
+cu tag abc123 --add "bug" --json
+```
+| Flag              | Description                         |
+| ----------------- | ----------------------------------- |
+| `--add <tags>`    | Comma-separated tag names to add    |
+| `--remove <tags>` | Comma-separated tag names to remove |
+| `--json`          | Force JSON output                   |
 ### `cu auth`
 Check authentication status. Validates your API token and shows your user info.

package/dist/index.js CHANGED Viewed

@@ -170,26 +170,15 @@ var ClickUpClient = class {
       return `/list/${listId}/task?${qs}`;
     });
   }
-  async getMyTasksFromList(listId) {
-    const me = await this.getMe();
-    return this.getTasksFromList(listId, { "assignees[]": String(me.id) });
-  }
   async getTask(taskId) {
     return this.request(`/task/${taskId}?include_markdown_description=true`);
   }
-  async updateTaskMarkdown(taskId, markdown) {
-    return this.updateTask(taskId, { markdown_content: markdown });
-  }
   async createTask(listId, options) {
     return this.request(`/list/${listId}/task`, {
       method: "POST",
       body: JSON.stringify(options)
     });
   }
-  async getAssignedListIds(teamId) {
-    const tasks = await this.getMyTasks(teamId);
-    return new Set(tasks.map((t) => t.list.id));
-  }
   async getTeams() {
     const data = await this.request("/team");
     return data.teams ?? [];
@@ -229,6 +218,24 @@ var ClickUpClient = class {
   async removeTaskFromList(taskId, listId) {
     await this.request(`/list/${listId}/task/${taskId}`, { method: "DELETE" });
   }
+  async setCustomFieldValue(taskId, fieldId, value) {
+    await this.request(`/task/${taskId}/field/${fieldId}`, {
+      method: "POST",
+      body: JSON.stringify({ value })
+    });
+  }
+  async removeCustomFieldValue(taskId, fieldId) {
+    await this.request(`/task/${taskId}/field/${fieldId}`, { method: "DELETE" });
+  }
+  async deleteTask(taskId) {
+    await this.request(`/task/${taskId}`, { method: "DELETE" });
+  }
+  async addTagToTask(taskId, tagName) {
+    await this.request(`/task/${taskId}/tag/${encodeURIComponent(tagName)}`, { method: "POST" });
+  }
+  async removeTagFromTask(taskId, tagName) {
+    await this.request(`/task/${taskId}/tag/${encodeURIComponent(tagName)}`, { method: "DELETE" });
+  }
   async addDependency(taskId, opts) {
     const body = {};
     if (opts.dependsOn) body.depends_on = opts.dependsOn;
@@ -1626,7 +1633,7 @@ function bashCompletion() {
     cword=$COMP_CWORD
   fi
-  local commands="init tasks initiatives task update create sprint subtasks comment comments lists spaces inbox assigned open summary overdue assign config completion"
+  local commands="init auth tasks initiatives task update create sprint sprints subtasks comment comments activity lists spaces inbox assigned open search summary overdue assign depend move field delete tag config completion"
   if [[ $cword -eq 1 ]]; then
     COMPREPLY=($(compgen -W "$commands --help --version" -- "$cur"))
@@ -1648,29 +1655,35 @@ function bashCompletion() {
   case "$cmd" in
     tasks|initiatives)
-      COMPREPLY=($(compgen -W "--status --list --space --name --json" -- "$cur"))
+      COMPREPLY=($(compgen -W "--status --list --space --name --include-closed --json" -- "$cur"))
       ;;
     task)
       COMPREPLY=($(compgen -W "--json" -- "$cur"))
       ;;
     update)
-      COMPREPLY=($(compgen -W "--name --description --status --priority --due-date --assignee" -- "$cur"))
+      COMPREPLY=($(compgen -W "-n --name -d --description -s --status --priority --due-date --time-estimate --assignee --parent --json" -- "$cur"))
       ;;
     create)
-      COMPREPLY=($(compgen -W "--list --name --description --parent --status --priority --due-date --assignee --tags" -- "$cur"))
+      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"))
       ;;
     sprint)
-      COMPREPLY=($(compgen -W "--status --space --json" -- "$cur"))
+      COMPREPLY=($(compgen -W "--status --space --include-closed --json" -- "$cur"))
+      ;;
+    sprints)
+      COMPREPLY=($(compgen -W "--space --json" -- "$cur"))
       ;;
     subtasks)
-      COMPREPLY=($(compgen -W "--json" -- "$cur"))
+      COMPREPLY=($(compgen -W "--status --name --include-closed --json" -- "$cur"))
       ;;
     comment)
-      COMPREPLY=($(compgen -W "--message" -- "$cur"))
+      COMPREPLY=($(compgen -W "-m --message --json" -- "$cur"))
       ;;
     comments)
       COMPREPLY=($(compgen -W "--json" -- "$cur"))
       ;;
+    activity)
+      COMPREPLY=($(compgen -W "--json" -- "$cur"))
+      ;;
     lists)
       COMPREPLY=($(compgen -W "--name --json" -- "$cur"))
       ;;
@@ -1678,23 +1691,44 @@ function bashCompletion() {
       COMPREPLY=($(compgen -W "--name --my --json" -- "$cur"))
       ;;
     inbox)
-      COMPREPLY=($(compgen -W "--json --days" -- "$cur"))
+      COMPREPLY=($(compgen -W "--include-closed --json --days" -- "$cur"))
       ;;
     assigned)
-      COMPREPLY=($(compgen -W "--include-closed --json" -- "$cur"))
+      COMPREPLY=($(compgen -W "--status --include-closed --json" -- "$cur"))
       ;;
     open)
       COMPREPLY=($(compgen -W "--json" -- "$cur"))
       ;;
+    search)
+      COMPREPLY=($(compgen -W "--status --include-closed --json" -- "$cur"))
+      ;;
     summary)
       COMPREPLY=($(compgen -W "--hours --json" -- "$cur"))
       ;;
     overdue)
-      COMPREPLY=($(compgen -W "--json" -- "$cur"))
+      COMPREPLY=($(compgen -W "--include-closed --json" -- "$cur"))
       ;;
     assign)
       COMPREPLY=($(compgen -W "--to --remove --json" -- "$cur"))
       ;;
+    auth)
+      COMPREPLY=($(compgen -W "--json" -- "$cur"))
+      ;;
+    depend)
+      COMPREPLY=($(compgen -W "--on --blocks --remove --json" -- "$cur"))
+      ;;
+    move)
+      COMPREPLY=($(compgen -W "--to --remove --json" -- "$cur"))
+      ;;
+    field)
+      COMPREPLY=($(compgen -W "--set --remove --json" -- "$cur"))
+      ;;
+    delete)
+      COMPREPLY=($(compgen -W "--confirm --json" -- "$cur"))
+      ;;
+    tag)
+      COMPREPLY=($(compgen -W "--add --remove --json" -- "$cur"))
+      ;;
     config)
       if [[ $cword -eq 2 ]]; then
         COMPREPLY=($(compgen -W "get set path" -- "$cur"))
@@ -1722,23 +1756,32 @@ _cu() {
   local -a commands
   commands=(
     'init:Set up cu for the first time'
+    'auth:Validate API token and show current user'
     'tasks:List tasks assigned to me'
     'initiatives:List initiatives assigned to me'
     'task:Get task details'
     'update:Update a task'
     'create:Create a new task'
     'sprint:List my tasks in the current active sprint'
+    'sprints:List all sprints in sprint folders'
     'subtasks:List subtasks of a task or initiative'
     'comment:Post a comment on a task'
     'comments:List comments on a task'
+    'activity:Show task details and comments combined'
     'lists:List all lists in a space'
     'spaces:List spaces in your workspace'
     'inbox:Recently updated tasks grouped by time period'
     'assigned:Show all tasks assigned to me'
     'open:Open a task in the browser by ID or name'
+    'search:Search my tasks by name'
     'summary:Daily standup summary'
     'overdue:List tasks that are past their due date'
     'assign:Assign or unassign users from a task'
+    'depend:Add or remove task dependencies'
+    'move:Add or remove a task from a list'
+    'field:Set or remove a custom field value on a task'
+    'delete:Delete a task'
+    'tag:Add or remove tags from a task'
     'config:Manage CLI configuration'
     'completion:Output shell completion script'
   )
@@ -1761,6 +1804,7 @@ _cu() {
             '--list[Filter by list ID]:list_id:' \\
             '--space[Filter by space ID]:space_id:' \\
             '--name[Filter by name]:query:' \\
+            '--include-closed[Include done/closed tasks]' \\
             '--json[Force JSON output]'
           ;;
         task)
@@ -1776,7 +1820,10 @@ _cu() {
             '(-s --status)'{-s,--status}'[New status]:status:(open "in progress" "in review" done closed)' \\
             '--priority[Priority level]:priority:(urgent high normal low)' \\
             '--due-date[Due date]:date:' \\
-            '--assignee[Add assignee]:user_id:'
+            '--time-estimate[Time estimate]:duration:' \\
+            '--assignee[Add assignee]:user_id:' \\
+            '--parent[Set parent task]:task_id:' \\
+            '--json[Force JSON output]'
           ;;
         create)
           _arguments \\
@@ -1788,29 +1835,47 @@ _cu() {
             '--priority[Priority level]:priority:(urgent high normal low)' \\
             '--due-date[Due date]:date:' \\
             '--assignee[Assignee user ID]:user_id:' \\
-            '--tags[Comma-separated tag names]:tags:'
+            '--tags[Comma-separated tag names]:tags:' \\
+            '--custom-item-id[Custom task type ID]:id:' \\
+            '--time-estimate[Time estimate]:duration:' \\
+            '--json[Force JSON output]'
           ;;
         sprint)
           _arguments \\
             '--status[Filter by status]:status:(open "in progress" "in review" done closed)' \\
             '--space[Narrow sprint search to a space]:space:' \\
+            '--include-closed[Include done/closed tasks]' \\
+            '--json[Force JSON output]'
+          ;;
+        sprints)
+          _arguments \\
+            '--space[Filter by space]:space:' \\
             '--json[Force JSON output]'
           ;;
         subtasks)
           _arguments \\
             '1:task_id:' \\
+            '--status[Filter by status]:status:(open "in progress" "in review" done closed)' \\
+            '--name[Filter by name]:query:' \\
+            '--include-closed[Include closed/done subtasks]' \\
             '--json[Force JSON output]'
           ;;
         comment)
           _arguments \\
             '1:task_id:' \\
-            '(-m --message)'{-m,--message}'[Comment text]:text:'
+            '(-m --message)'{-m,--message}'[Comment text]:text:' \\
+            '--json[Force JSON output]'
           ;;
         comments)
           _arguments \\
             '1:task_id:' \\
             '--json[Force JSON output]'
           ;;
+        activity)
+          _arguments \\
+            '1:task_id:' \\
+            '--json[Force JSON output]'
+          ;;
         lists)
           _arguments \\
             '1:space_id:' \\
@@ -1825,11 +1890,13 @@ _cu() {
           ;;
         inbox)
           _arguments \\
+            '--include-closed[Include done/closed tasks]' \\
             '--json[Force JSON output]' \\
             '--days[Lookback period in days]:days:'
           ;;
         assigned)
           _arguments \\
+            '--status[Show only tasks with this status]:status:(open "in progress" "in review" done closed)' \\
             '--include-closed[Include done/closed tasks]' \\
             '--json[Force JSON output]'
           ;;
@@ -1838,6 +1905,13 @@ _cu() {
             '1:query:' \\
             '--json[Output task JSON instead of opening]'
           ;;
+        search)
+          _arguments \\
+            '1:query:' \\
+            '--status[Filter by status]:status:(open "in progress" "in review" done closed)' \\
+            '--include-closed[Include done/closed tasks in search]' \\
+            '--json[Force JSON output]'
+          ;;
         summary)
           _arguments \\
             '--hours[Completed-tasks lookback in hours]:hours:' \\
@@ -1845,6 +1919,7 @@ _cu() {
           ;;
         overdue)
           _arguments \\
+            '--include-closed[Include done/closed overdue tasks]' \\
             '--json[Force JSON output]'
           ;;
         assign)
@@ -1854,6 +1929,45 @@ _cu() {
             '--remove[Remove assignee]:user_id:' \\
             '--json[Force JSON output]'
           ;;
+        auth)
+          _arguments \\
+            '--json[Force JSON output]'
+          ;;
+        depend)
+          _arguments \\
+            '1:task_id:' \\
+            '--on[Task that this task depends on]:task_id:' \\
+            '--blocks[Task that this task blocks]:task_id:' \\
+            '--remove[Remove the dependency instead of adding it]' \\
+            '--json[Force JSON output]'
+          ;;
+        move)
+          _arguments \\
+            '1:task_id:' \\
+            '--to[Add task to this list]:list_id:' \\
+            '--remove[Remove task from this list]:list_id:' \\
+            '--json[Force JSON output]'
+          ;;
+        field)
+          _arguments \\
+            '1:task_id:' \\
+            '--set[Set field name and value]:name_and_value:' \\
+            '--remove[Remove field value by name]:field_name:' \\
+            '--json[Force JSON output]'
+          ;;
+        delete)
+          _arguments \\
+            '1:task_id:' \\
+            '--confirm[Skip confirmation prompt]' \\
+            '--json[Force JSON output]'
+          ;;
+        tag)
+          _arguments \\
+            '1:task_id:' \\
+            '--add[Comma-separated tag names to add]:tags:' \\
+            '--remove[Comma-separated tag names to remove]:tags:' \\
+            '--json[Force JSON output]'
+          ;;
         config)
           local -a config_cmds
           config_cmds=(
@@ -1889,54 +2003,62 @@ _cu
 `;
 }
 function fishCompletion() {
-  return `# Disable file completions
-complete -c cu -f
+  return `complete -c cu -f
-# Global flags
 complete -c cu -n __fish_use_subcommand -s h -l help -d 'Show help'
 complete -c cu -n __fish_use_subcommand -s V -l version -d 'Show version'
-# Commands
 complete -c cu -n __fish_use_subcommand -a init -d 'Set up cu for the first time'
+complete -c cu -n __fish_use_subcommand -a auth -d 'Validate API token and show current user'
 complete -c cu -n __fish_use_subcommand -a tasks -d 'List tasks assigned to me'
 complete -c cu -n __fish_use_subcommand -a initiatives -d 'List initiatives assigned to me'
 complete -c cu -n __fish_use_subcommand -a task -d 'Get task details'
 complete -c cu -n __fish_use_subcommand -a update -d 'Update a task'
 complete -c cu -n __fish_use_subcommand -a create -d 'Create a new task'
 complete -c cu -n __fish_use_subcommand -a sprint -d 'List my tasks in the current active sprint'
+complete -c cu -n __fish_use_subcommand -a sprints -d 'List all sprints in sprint folders'
 complete -c cu -n __fish_use_subcommand -a subtasks -d 'List subtasks of a task or initiative'
 complete -c cu -n __fish_use_subcommand -a comment -d 'Post a comment on a task'
 complete -c cu -n __fish_use_subcommand -a comments -d 'List comments on a task'
+complete -c cu -n __fish_use_subcommand -a activity -d 'Show task details and comments combined'
 complete -c cu -n __fish_use_subcommand -a lists -d 'List all lists in a space'
 complete -c cu -n __fish_use_subcommand -a spaces -d 'List spaces in your workspace'
 complete -c cu -n __fish_use_subcommand -a inbox -d 'Recently updated tasks grouped by time period'
 complete -c cu -n __fish_use_subcommand -a assigned -d 'Show all tasks assigned to me'
 complete -c cu -n __fish_use_subcommand -a open -d 'Open a task in the browser by ID or name'
+complete -c cu -n __fish_use_subcommand -a search -d 'Search my tasks by name'
 complete -c cu -n __fish_use_subcommand -a summary -d 'Daily standup summary'
 complete -c cu -n __fish_use_subcommand -a overdue -d 'List tasks that are past their due date'
 complete -c cu -n __fish_use_subcommand -a assign -d 'Assign or unassign users from a task'
+complete -c cu -n __fish_use_subcommand -a depend -d 'Add or remove task dependencies'
+complete -c cu -n __fish_use_subcommand -a move -d 'Add or remove a task from a list'
+complete -c cu -n __fish_use_subcommand -a field -d 'Set or remove a custom field value on a task'
+complete -c cu -n __fish_use_subcommand -a delete -d 'Delete a task'
+complete -c cu -n __fish_use_subcommand -a tag -d 'Add or remove tags from a task'
 complete -c cu -n __fish_use_subcommand -a config -d 'Manage CLI configuration'
 complete -c cu -n __fish_use_subcommand -a completion -d 'Output shell completion script'
-# tasks / initiatives flags
+complete -c cu -n '__fish_seen_subcommand_from auth' -l json -d 'Force JSON output'
 complete -c cu -n '__fish_seen_subcommand_from tasks initiatives' -l status -d 'Filter by status'
 complete -c cu -n '__fish_seen_subcommand_from tasks initiatives' -l list -d 'Filter by list ID'
 complete -c cu -n '__fish_seen_subcommand_from tasks initiatives' -l space -d 'Filter by space ID'
 complete -c cu -n '__fish_seen_subcommand_from tasks initiatives' -l name -d 'Filter by name'
+complete -c cu -n '__fish_seen_subcommand_from tasks initiatives' -l include-closed -d 'Include done/closed tasks'
 complete -c cu -n '__fish_seen_subcommand_from tasks initiatives' -l json -d 'Force JSON output'
-# task flags
 complete -c cu -n '__fish_seen_subcommand_from task' -l json -d 'Force JSON output'
-# update flags
 complete -c cu -n '__fish_seen_subcommand_from update' -s n -l name -d 'New task name'
 complete -c cu -n '__fish_seen_subcommand_from update' -s d -l description -d 'New description'
 complete -c cu -n '__fish_seen_subcommand_from update' -s s -l status -d 'New status'
 complete -c cu -n '__fish_seen_subcommand_from update' -l priority -d 'Priority level' -a 'urgent high normal low'
 complete -c cu -n '__fish_seen_subcommand_from update' -l due-date -d 'Due date'
+complete -c cu -n '__fish_seen_subcommand_from update' -l time-estimate -d 'Time estimate'
 complete -c cu -n '__fish_seen_subcommand_from update' -l assignee -d 'Add assignee'
+complete -c cu -n '__fish_seen_subcommand_from update' -l parent -d 'Set parent task'
+complete -c cu -n '__fish_seen_subcommand_from update' -l json -d 'Force JSON output'
-# create flags
 complete -c cu -n '__fish_seen_subcommand_from create' -s l -l list -d 'Target list ID'
 complete -c cu -n '__fish_seen_subcommand_from create' -s n -l name -d 'Task name'
 complete -c cu -n '__fish_seen_subcommand_from create' -s d -l description -d 'Task description'
@@ -1946,60 +2068,86 @@ complete -c cu -n '__fish_seen_subcommand_from create' -l priority -d 'Priority
 complete -c cu -n '__fish_seen_subcommand_from create' -l due-date -d 'Due date'
 complete -c cu -n '__fish_seen_subcommand_from create' -l assignee -d 'Assignee user ID'
 complete -c cu -n '__fish_seen_subcommand_from create' -l tags -d 'Comma-separated tag names'
+complete -c cu -n '__fish_seen_subcommand_from create' -l custom-item-id -d 'Custom task type ID'
+complete -c cu -n '__fish_seen_subcommand_from create' -l time-estimate -d 'Time estimate'
+complete -c cu -n '__fish_seen_subcommand_from create' -l json -d 'Force JSON output'
-# sprint flags
 complete -c cu -n '__fish_seen_subcommand_from sprint' -l status -d 'Filter by status'
 complete -c cu -n '__fish_seen_subcommand_from sprint' -l space -d 'Narrow sprint search to a space'
+complete -c cu -n '__fish_seen_subcommand_from sprint' -l include-closed -d 'Include done/closed tasks'
 complete -c cu -n '__fish_seen_subcommand_from sprint' -l json -d 'Force JSON output'
-# subtasks flags
+complete -c cu -n '__fish_seen_subcommand_from sprints' -l space -d 'Filter by space'
+complete -c cu -n '__fish_seen_subcommand_from sprints' -l json -d 'Force JSON output'
+complete -c cu -n '__fish_seen_subcommand_from subtasks' -l status -d 'Filter by status'
+complete -c cu -n '__fish_seen_subcommand_from subtasks' -l name -d 'Filter by name'
+complete -c cu -n '__fish_seen_subcommand_from subtasks' -l include-closed -d 'Include closed/done subtasks'
 complete -c cu -n '__fish_seen_subcommand_from subtasks' -l json -d 'Force JSON output'
-# comment flags
 complete -c cu -n '__fish_seen_subcommand_from comment' -s m -l message -d 'Comment text'
+complete -c cu -n '__fish_seen_subcommand_from comment' -l json -d 'Force JSON output'
-# comments flags
 complete -c cu -n '__fish_seen_subcommand_from comments' -l json -d 'Force JSON output'
-# lists flags
+complete -c cu -n '__fish_seen_subcommand_from activity' -l json -d 'Force JSON output'
 complete -c cu -n '__fish_seen_subcommand_from lists' -l name -d 'Filter by name'
 complete -c cu -n '__fish_seen_subcommand_from lists' -l json -d 'Force JSON output'
-# spaces flags
 complete -c cu -n '__fish_seen_subcommand_from spaces' -l name -d 'Filter spaces by name'
 complete -c cu -n '__fish_seen_subcommand_from spaces' -l my -d 'Show only spaces where I have assigned tasks'
 complete -c cu -n '__fish_seen_subcommand_from spaces' -l json -d 'Force JSON output'
-# inbox flags
+complete -c cu -n '__fish_seen_subcommand_from inbox' -l include-closed -d 'Include done/closed tasks'
 complete -c cu -n '__fish_seen_subcommand_from inbox' -l json -d 'Force JSON output'
 complete -c cu -n '__fish_seen_subcommand_from inbox' -l days -d 'Lookback period in days'
-# assigned flags
+complete -c cu -n '__fish_seen_subcommand_from assigned' -l status -d 'Show only tasks with this status'
 complete -c cu -n '__fish_seen_subcommand_from assigned' -l include-closed -d 'Include done/closed tasks'
 complete -c cu -n '__fish_seen_subcommand_from assigned' -l json -d 'Force JSON output'
-# open flags
 complete -c cu -n '__fish_seen_subcommand_from open' -l json -d 'Output task JSON instead of opening'
-# summary flags
+complete -c cu -n '__fish_seen_subcommand_from search' -l status -d 'Filter by status'
+complete -c cu -n '__fish_seen_subcommand_from search' -l include-closed -d 'Include done/closed tasks in search'
+complete -c cu -n '__fish_seen_subcommand_from search' -l json -d 'Force JSON output'
 complete -c cu -n '__fish_seen_subcommand_from summary' -l hours -d 'Completed-tasks lookback in hours'
 complete -c cu -n '__fish_seen_subcommand_from summary' -l json -d 'Force JSON output'
-# overdue flags
+complete -c cu -n '__fish_seen_subcommand_from overdue' -l include-closed -d 'Include done/closed overdue tasks'
 complete -c cu -n '__fish_seen_subcommand_from overdue' -l json -d 'Force JSON output'
-# assign flags
 complete -c cu -n '__fish_seen_subcommand_from assign' -l to -d 'Add assignee'
 complete -c cu -n '__fish_seen_subcommand_from assign' -l remove -d 'Remove assignee'
 complete -c cu -n '__fish_seen_subcommand_from assign' -l json -d 'Force JSON output'
-# config subcommands
+complete -c cu -n '__fish_seen_subcommand_from depend' -l on -d 'Task that this task depends on'
+complete -c cu -n '__fish_seen_subcommand_from depend' -l blocks -d 'Task that this task blocks'
+complete -c cu -n '__fish_seen_subcommand_from depend' -l remove -d 'Remove the dependency'
+complete -c cu -n '__fish_seen_subcommand_from depend' -l json -d 'Force JSON output'
+complete -c cu -n '__fish_seen_subcommand_from move' -l to -d 'Add task to this list'
+complete -c cu -n '__fish_seen_subcommand_from move' -l remove -d 'Remove task from this list'
+complete -c cu -n '__fish_seen_subcommand_from move' -l json -d 'Force JSON output'
+complete -c cu -n '__fish_seen_subcommand_from field' -l set -d 'Set field name and value'
+complete -c cu -n '__fish_seen_subcommand_from field' -l remove -d 'Remove field value by name'
+complete -c cu -n '__fish_seen_subcommand_from field' -l json -d 'Force JSON output'
+complete -c cu -n '__fish_seen_subcommand_from delete' -l confirm -d 'Skip confirmation prompt'
+complete -c cu -n '__fish_seen_subcommand_from delete' -l json -d 'Force JSON output'
+complete -c cu -n '__fish_seen_subcommand_from tag' -l add -d 'Comma-separated tag names to add'
+complete -c cu -n '__fish_seen_subcommand_from tag' -l remove -d 'Comma-separated tag names to remove'
+complete -c cu -n '__fish_seen_subcommand_from tag' -l json -d 'Force JSON output'
 complete -c cu -n '__fish_seen_subcommand_from config; and not __fish_seen_subcommand_from get set path' -a get -d 'Print a config value'
 complete -c cu -n '__fish_seen_subcommand_from config; and not __fish_seen_subcommand_from get set path' -a set -d 'Set a config value'
 complete -c cu -n '__fish_seen_subcommand_from config; and not __fish_seen_subcommand_from get set path' -a path -d 'Print config file path'
 complete -c cu -n '__fish_seen_subcommand_from get set' -a 'apiToken teamId' -d 'Config key'
-# completion subcommand
 complete -c cu -n '__fish_seen_subcommand_from completion' -a 'bash zsh fish' -d 'Shell type'
 `;
 }
@@ -2113,6 +2261,140 @@ async function moveTask(config, taskId, opts) {
   return messages.join("; ");
 }
+// src/commands/field.ts
+var SUPPORTED_TYPES = /* @__PURE__ */ new Set(["text", "number", "drop_down", "checkbox", "date", "url", "email"]);
+function findFieldByName(fields, name) {
+  const lower = name.toLowerCase();
+  const match = fields.find((f) => f.name.toLowerCase() === lower);
+  if (!match) {
+    const available = fields.map((f) => f.name).join(", ");
+    throw new Error(`Field "${name}" not found. Available fields: ${available}`);
+  }
+  return match;
+}
+function parseFieldValue(field, rawValue) {
+  if (!SUPPORTED_TYPES.has(field.type)) {
+    throw new Error(
+      `Field type "${field.type}" is not supported. Supported types: ${[...SUPPORTED_TYPES].join(", ")}`
+    );
+  }
+  switch (field.type) {
+    case "number": {
+      const n = Number(rawValue);
+      if (!Number.isFinite(n)) throw new Error(`Value "${rawValue}" is not a valid numeric value`);
+      return n;
+    }
+    case "checkbox":
+      if (rawValue !== "true" && rawValue !== "false") {
+        throw new Error('Checkbox value must be "true" or "false"');
+      }
+      return rawValue === "true";
+    case "drop_down": {
+      const options = field.type_config?.options;
+      if (!options?.length) throw new Error("Dropdown field has no configured options");
+      const lower = rawValue.toLowerCase();
+      const option = options.find((o) => o.name.toLowerCase() === lower);
+      if (!option) {
+        const available = options.map((o) => o.name).join(", ");
+        throw new Error(`Option "${rawValue}" not found. Available options: ${available}`);
+      }
+      if (option.orderindex === void 0) {
+        throw new Error(`Dropdown option "${option.name}" has no orderindex`);
+      }
+      return option.orderindex;
+    }
+    case "date": {
+      const ms = new Date(rawValue).getTime();
+      if (!Number.isFinite(ms))
+        throw new Error(`Value "${rawValue}" is not a valid date (use YYYY-MM-DD)`);
+      return ms;
+    }
+    default:
+      return rawValue;
+  }
+}
+async function setCustomField(config, taskId, opts) {
+  if (!opts.set && !opts.remove) {
+    throw new Error("Provide at least one of: --set, --remove");
+  }
+  const client = new ClickUpClient(config);
+  const task = await client.getTask(taskId);
+  const fields = task.custom_fields ?? [];
+  const results = [];
+  if (opts.set) {
+    const [fieldName, rawValue] = opts.set;
+    const field = findFieldByName(fields, fieldName);
+    const parsed = parseFieldValue(field, rawValue);
+    await client.setCustomFieldValue(taskId, field.id, parsed);
+    results.push({ taskId, field: field.name, action: "set", value: parsed });
+  }
+  if (opts.remove) {
+    const field = findFieldByName(fields, opts.remove);
+    await client.removeCustomFieldValue(taskId, field.id);
+    results.push({ taskId, field: field.name, action: "removed" });
+  }
+  return { results };
+}
+// src/commands/delete.ts
+async function deleteTaskCommand(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: `Delete task "${task.name}" (${task.id})? This cannot be undone.`,
+      default: false
+    });
+    if (!confirmed) {
+      throw new Error("Cancelled");
+    }
+  }
+  await client.deleteTask(taskId);
+  return { taskId, deleted: true };
+}
+// src/commands/tag.ts
+function parseTags(input) {
+  return input.split(",").map((t) => t.trim()).filter((t) => t.length > 0);
+}
+async function manageTags(config, taskId, opts) {
+  if (!opts.add && !opts.remove) {
+    throw new Error("Provide at least one of: --add, --remove");
+  }
+  const client = new ClickUpClient(config);
+  const added = [];
+  const removed = [];
+  if (opts.add) {
+    const tags = parseTags(opts.add);
+    for (const tag of tags) {
+      await client.addTagToTask(taskId, tag);
+      added.push(tag);
+    }
+  }
+  if (opts.remove) {
+    const tags = parseTags(opts.remove);
+    try {
+      for (const tag of tags) {
+        await client.removeTagFromTask(taskId, tag);
+        removed.push(tag);
+      }
+    } catch (err) {
+      if (added.length > 0) {
+        const reason = err instanceof Error ? err.message : String(err);
+        throw new Error(`Added tags: ${added.join(", ")}; but failed to remove: ${reason}`, {
+          cause: err
+        });
+      }
+      throw err;
+    }
+  }
+  return { taskId, added, removed };
+}
 // src/index.ts
 var require2 = createRequire(import.meta.url);
 var { version } = require2("../package.json");
@@ -2368,6 +2650,60 @@ program.command("move <taskId>").description("Add or remove a task from a list")
     }
   })
 );
+program.command("field <taskId>").description("Set or remove a custom field value on a task").option("--set <nameAndValue...>", 'Set field: --set "Field Name" value').option("--remove <fieldName>", "Remove field value by name").option("--json", "Force JSON output even in terminal").action(
+  wrapAction(
+    async (taskId, opts) => {
+      const config = loadConfig();
+      const fieldOpts = {};
+      if (opts.set) {
+        if (opts.set.length !== 2) {
+          throw new Error("--set requires exactly two arguments: field name and value");
+        }
+        fieldOpts.set = [opts.set[0], opts.set[1]];
+      }
+      if (opts.remove) {
+        fieldOpts.remove = opts.remove;
+      }
+      const { results } = await setCustomField(config, taskId, fieldOpts);
+      if (shouldOutputJson(opts.json ?? false)) {
+        console.log(JSON.stringify(results, null, 2));
+      } else {
+        for (const r of results) {
+          if (r.action === "set") {
+            console.log(`Set "${r.field}" to ${JSON.stringify(r.value)} on ${r.taskId}`);
+          } else {
+            console.log(`Removed "${r.field}" from ${r.taskId}`);
+          }
+        }
+      }
+    }
+  )
+);
+program.command("delete <taskId>").description("Delete a task (requires confirmation)").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();
+    const result = await deleteTaskCommand(config, taskId, opts);
+    if (shouldOutputJson(opts.json ?? false)) {
+      console.log(JSON.stringify(result, null, 2));
+    } else {
+      console.log(`Deleted 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) => {
+    const config = loadConfig();
+    const result = await manageTags(config, taskId, opts);
+    if (shouldOutputJson(opts.json ?? false)) {
+      console.log(JSON.stringify(result, null, 2));
+    } else {
+      const parts = [];
+      if (result.added.length > 0) parts.push(`Added tags: ${result.added.join(", ")}`);
+      if (result.removed.length > 0) parts.push(`Removed tags: ${result.removed.join(", ")}`);
+      console.log(parts.join("; "));
+    }
+  })
+);
 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 CHANGED Viewed

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

package/skills/clickup-cli/SKILL.md CHANGED Viewed

@@ -1,6 +1,6 @@
 ---
 name: clickup
-description: 'Use when managing ClickUp tasks, initiatives, sprints, or comments via the `cu` CLI tool. Triggers: task queries, status updates, sprint tracking, creating subtasks, posting comments, standup summaries, searching tasks, checking overdue items, assigning tasks, listing spaces and lists, opening tasks in browser, checking auth or config.'
+description: 'Use when managing ClickUp tasks, initiatives, sprints, or comments via the `cu` CLI tool. Triggers: task queries, status updates, sprint tracking, creating subtasks, posting comments, standup summaries, searching tasks, checking overdue items, assigning tasks, listing spaces and lists, opening tasks in browser, checking auth or config, setting custom fields, deleting tasks, managing tags.'
 ---
 # ClickUp CLI (`cu`)
@@ -64,38 +64,45 @@ All commands support `--help` for full flag details.
 | `cu assign <id> [--to userId\|me] [--remove userId\|me] [--json]`                                                                                                              | Assign/unassign users                       |
 | `cu depend <id> [--on taskId] [--blocks taskId] [--remove] [--json]`                                                                                                           | Add/remove task dependencies                |
 | `cu move <id> [--to listId] [--remove listId] [--json]`                                                                                                                        | Add/remove task from lists                  |
+| `cu field <id> [--set "Name" value] [--remove "Name"] [--json]`                                                                                                                | Set/remove custom field values              |
+| `cu delete <id> [--confirm] [--json]`                                                                                                                                          | Delete a task (DESTRUCTIVE, irreversible)   |
+| `cu tag <id> [--add tags] [--remove tags] [--json]`                                                                                                                            | Add/remove tags on a task                   |
 | `cu config get <key>` / `cu config set <key> <value>` / `cu config path`                                                                                                       | Manage CLI config                           |
 | `cu completion <shell>`                                                                                                                                                        | Shell completions (bash/zsh/fish)           |
 ## Quick Reference
-| Topic               | Detail                                                                                                                |
-| ------------------- | --------------------------------------------------------------------------------------------------------------------- |
-| Task IDs            | Stable alphanumeric strings (e.g. `abc123def`)                                                                        |
-| Initiatives         | Detected via `custom_item_id !== 0`                                                                                   |
-| `--list` on create  | Optional when `--parent` is given (auto-detected)                                                                     |
-| `--status`          | Fuzzy matching: exact > starts-with > contains. Prints match to stderr.                                               |
-| `--priority`        | Names (`urgent`, `high`, `normal`, `low`) or numbers (1-4)                                                            |
-| `--due-date`        | `YYYY-MM-DD` format                                                                                                   |
-| `--assignee`        | Numeric user ID (find via `cu task <id> --json`)                                                                      |
-| `--tags`            | Comma-separated (e.g. `--tags "bug,frontend"`)                                                                        |
-| `--time-estimate`   | Duration format: `"2h"`, `"30m"`, `"1h30m"`, or raw milliseconds                                                      |
-| `--custom-item-id`  | Custom task type ID (e.g. `1` for initiative)                                                                         |
-| `--on` / `--blocks` | Task dependency direction (used with `cu depend`)                                                                     |
-| `--to` / `--remove` | List ID to add/remove task (used with `cu move`)                                                                      |
-| `--space`           | Partial name match or exact ID                                                                                        |
-| `--name`            | Partial match, case-insensitive                                                                                       |
-| `--include-closed`  | Include closed/done tasks (on `tasks`, `initiatives`, `assigned`, `subtasks`, `sprint`, `search`, `inbox`, `overdue`) |
-| `cu assign --to me` | Shorthand for your own user ID                                                                                        |
-| `cu search`         | Matches all query words against task name, case-insensitive                                                           |
-| `cu sprint`         | Auto-detects active sprint via view API and date range parsing                                                        |
-| `cu summary`        | Categories: completed (done/complete/closed within N hours), in progress, overdue                                     |
-| `cu overdue`        | Excludes closed tasks, sorted most overdue first                                                                      |
-| `cu open`           | Tries task ID first, falls back to name search                                                                        |
-| `cu task`           | Shows custom fields in detail view                                                                                    |
-| `cu lists`          | Discovers list IDs needed for `--list` and `cu create -l`                                                             |
-| Errors              | stderr with exit code 1                                                                                               |
-| Parsing             | Strict - excess/unknown arguments rejected                                                                            |
+| Topic                   | Detail                                                                                                                |
+| ----------------------- | --------------------------------------------------------------------------------------------------------------------- |
+| Task IDs                | Stable alphanumeric strings (e.g. `abc123def`)                                                                        |
+| Initiatives             | Detected via `custom_item_id !== 0`                                                                                   |
+| `--list` on create      | Optional when `--parent` is given (auto-detected)                                                                     |
+| `--status`              | Fuzzy matching: exact > starts-with > contains. Prints match to stderr.                                               |
+| `--priority`            | Names (`urgent`, `high`, `normal`, `low`) or numbers (1-4)                                                            |
+| `--due-date`            | `YYYY-MM-DD` format                                                                                                   |
+| `--assignee`            | Numeric user ID (find via `cu task <id> --json`)                                                                      |
+| `--tags`                | Comma-separated (e.g. `--tags "bug,frontend"`)                                                                        |
+| `--time-estimate`       | Duration format: `"2h"`, `"30m"`, `"1h30m"`, or raw milliseconds                                                      |
+| `--custom-item-id`      | Custom task type ID (e.g. `1` for initiative)                                                                         |
+| `--on` / `--blocks`     | Task dependency direction (used with `cu depend`)                                                                     |
+| `--to` / `--remove`     | List ID to add/remove task (used with `cu move`)                                                                      |
+| `cu field --set`        | Supports: text, number, checkbox (true/false), dropdown (option name), date (YYYY-MM-DD), url, email                  |
+| `cu field`              | Field names resolved case-insensitively; errors list available fields/options                                         |
+| `cu delete`             | DESTRUCTIVE. Requires `--confirm` in non-interactive mode. Cannot be undone                                           |
+| `cu tag --add/--remove` | Comma-separated tag names (e.g. `--add "bug,frontend"`)                                                               |
+| `--space`               | Partial name match or exact ID                                                                                        |
+| `--name`                | Partial match, case-insensitive                                                                                       |
+| `--include-closed`      | Include closed/done tasks (on `tasks`, `initiatives`, `assigned`, `subtasks`, `sprint`, `search`, `inbox`, `overdue`) |
+| `cu assign --to me`     | Shorthand for your own user ID                                                                                        |
+| `cu search`             | Matches all query words against task name, case-insensitive                                                           |
+| `cu sprint`             | Auto-detects active sprint via view API and date range parsing                                                        |
+| `cu summary`            | Categories: completed (done/complete/closed within N hours), in progress, overdue                                     |
+| `cu overdue`            | Excludes closed tasks, sorted most overdue first                                                                      |
+| `cu open`               | Tries task ID first, falls back to name search                                                                        |
+| `cu task`               | Shows custom fields in detail view                                                                                    |
+| `cu lists`              | Discovers list IDs needed for `--list` and `cu create -l`                                                             |
+| Errors                  | stderr with exit code 1                                                                                               |
+| Parsing                 | Strict - excess/unknown arguments rejected                                                                            |
 ## Agent Workflow Examples
@@ -137,6 +144,12 @@ cu assign abc123def --to me
 cu depend task3 --on task2            # task3 waits for task2
 cu depend task1 --blocks task2        # task1 blocks task2
 cu move task1 --to list2 --remove list1  # move between lists
+cu field abc123def --set "Story Points" 5
+cu field abc123def --set "Category" "Bug Fix"
+cu field abc123def --remove "Old Field"
+cu tag abc123def --add "bug,frontend"
+cu tag abc123def --remove "triage"
+cu delete abc123def --confirm          # irreversible!
 ```
 ### Discover workspace structure
@@ -155,3 +168,7 @@ cu auth                             # verify token works
 cu summary                          # completed / in progress / overdue
 cu summary --hours 48               # wider window
 ```
+## DELETE SAFETY
+IMPORTANT: Always confirm with the user before running `cu delete`. This is a destructive, irreversible operation. Even when using `--confirm` flag, verify the task ID is correct with the user first.