@krodak/clickup-cli 1.2.0 → 1.4.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.2.0",
+  "version": "1.4.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>`    | :construction:     |
-| Create from template | `cup create --template` | :construction:     |
-| Bulk operations      | `cup bulk`              | :construction:     |
+| 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: |
 
 ### Dependencies & Relations
 
@@ -203,15 +203,16 @@ Status: :white_check_mark: implemented | :construction: planned | :no_entry_sign
 | --------------------- | ------------------------- | ------------------ |
 | Set field value       | `cup field <id> --set`    | :white_check_mark: |
 | Remove field value    | `cup field <id> --remove` | :white_check_mark: |
-| List available fields | `cup fields <listId>`     | :construction:     |
+| List available fields | `cup fields <listId>`     | :white_check_mark: |
 
 ### Tags
 
-| Feature                 | Command              | Status             |
-| ----------------------- | -------------------- | ------------------ |
-| Add/remove tag on task  | `cup tag <id>`       | :white_check_mark: |
-| List space tags         | `cup tags <spaceId>` | :construction:     |
-| Create/delete space tag |                      | :construction:     |
+| Feature                | Command                           | Status             |
+| ---------------------- | --------------------------------- | ------------------ |
+| 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: |
+| Delete space tag       | `cup tag-delete <spaceId> <name>` | :white_check_mark: |
 
 ### Time Tracking
 
@@ -222,8 +223,8 @@ Status: :white_check_mark: implemented | :construction: planned | :no_entry_sign
 | Timer status   | `cup time status`              | :white_check_mark: |
 | Log time entry | `cup time log <id> <duration>` | :white_check_mark: |
 | List entries   | `cup time list`                | :white_check_mark: |
-| Update entry   | `cup time update <id>`         | :construction:     |
-| Delete entry   | `cup time delete <id>`         | :construction:     |
+| Update entry   | `cup time update <id>`         | :white_check_mark: |
+| Delete entry   | `cup time delete <id>`         | :white_check_mark: |
 
 ### Workspace
 
@@ -233,15 +234,18 @@ Status: :white_check_mark: implemented | :construction: planned | :no_entry_sign
 | 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`           | :construction:     |
+| List members | `cup members`           | :white_check_mark: |
 
 ### Goals & Key Results
 
-| Feature            | Command     | Status         |
-| ------------------ | ----------- | -------------- |
-| List goals         | `cup goals` | :construction: |
-| Create/update goal |             | :construction: |
-| Key results CRUD   |             | :construction: |
+| Feature           | Command                              | Status             |
+| ----------------- | ------------------------------------ | ------------------ |
+| 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: |
+| 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: |
 
 ### Docs
 
@@ -265,6 +269,7 @@ Status: :white_check_mark: implemented | :construction: planned | :no_entry_sign
 
 | 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.                     |

package/dist/index.js

@@ -371,6 +371,36 @@ var ClickUpClient = class {
     }
     return entries;
   }
+  async updateTimeEntry(teamId, timeEntryId, updates) {
+    const data = await this.request(
+      `/team/${teamId}/time_entries/${timeEntryId}`,
+      { method: "PUT", body: JSON.stringify(updates) }
+    );
+    return data.data;
+  }
+  async getSpaceTags(spaceId) {
+    const data = await this.request(`/space/${spaceId}/tag`);
+    return data.tags ?? [];
+  }
+  async createSpaceTag(spaceId, name, fg, bg) {
+    await this.request(`/space/${spaceId}/tag`, {
+      method: "POST",
+      body: JSON.stringify({
+        tag: { name, tag_fg: fg ?? "#000000", tag_bg: bg ?? "#04A9F4" }
+      })
+    });
+  }
+  async deleteSpaceTag(spaceId, tagName) {
+    await this.request(
+      `/space/${spaceId}/tag/${encodeURIComponent(tagName)}`,
+      { method: "DELETE" }
+    );
+  }
+  async getWorkspaceMembers(teamId) {
+    const data = await this.request("/team");
+    const team = data.teams?.find((t) => t.id === teamId);
+    return team?.members?.map((m) => m.user) ?? [];
+  }
   async deleteTimeEntry(teamId, timeEntryId) {
     await this.request(`/team/${teamId}/time_entries/${timeEntryId}`, {
       method: "DELETE"
@@ -458,6 +488,52 @@ var ClickUpClient = class {
     );
     return data.pages ?? [];
   }
+  async getGoals(teamId) {
+    const data = await this.request(`/team/${teamId}/goal`);
+    return data.goals ?? [];
+  }
+  async createGoal(teamId, name, opts) {
+    const body = { name, multiple_owners: true };
+    if (opts?.description) body.description = opts.description;
+    if (opts?.dueDate) body.due_date = Number(opts.dueDate);
+    if (opts?.color) body.color = opts.color;
+    const data = await this.request(`/team/${teamId}/goal`, {
+      method: "POST",
+      body: JSON.stringify(body)
+    });
+    return data.goal;
+  }
+  async updateGoal(goalId, updates) {
+    const data = await this.request(`/goal/${goalId}`, {
+      method: "PUT",
+      body: JSON.stringify(updates)
+    });
+    return data.goal;
+  }
+  async getKeyResults(goalId) {
+    const data = await this.request(`/goal/${goalId}`);
+    return data.goal?.key_results ?? [];
+  }
+  async createKeyResult(goalId, name, type, stepsEnd) {
+    const data = await this.request(`/goal/${goalId}/key_result`, {
+      method: "POST",
+      body: JSON.stringify({
+        name,
+        type,
+        steps_start: 0,
+        steps_end: stepsEnd,
+        unit: type === "number" ? "items" : "%"
+      })
+    });
+    return data.key_result;
+  }
+  async updateKeyResult(keyResultId, updates) {
+    const data = await this.request(`/key_result/${keyResultId}`, {
+      method: "PUT",
+      body: JSON.stringify(updates)
+    });
+    return data.key_result;
+  }
 };
 
 // src/config.ts
@@ -2106,7 +2182,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 checklist time docs doc doc-create doc-pages doc-page-create doc-page-edit folders 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 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"
 
   if [[ $cword -eq 1 ]]; then
     COMPREPLY=($(compgen -W "$commands --help --version" -- "$cur"))
@@ -2239,6 +2315,47 @@ function bashCompletion(name) {
     doc-pages)
       COMPREPLY=($(compgen -W "--json" -- "$cur"))
       ;;
+    tags)
+      COMPREPLY=($(compgen -W "--json" -- "$cur"))
+      ;;
+    tag-create)
+      COMPREPLY=($(compgen -W "--fg --bg --json" -- "$cur"))
+      ;;
+    tag-delete)
+      COMPREPLY=($(compgen -W "--json" -- "$cur"))
+      ;;
+    members)
+      COMPREPLY=($(compgen -W "--json" -- "$cur"))
+      ;;
+    fields)
+      COMPREPLY=($(compgen -W "--json" -- "$cur"))
+      ;;
+    duplicate)
+      COMPREPLY=($(compgen -W "--json" -- "$cur"))
+      ;;
+    bulk)
+      if [[ $cword -eq 2 ]]; then
+        COMPREPLY=($(compgen -W "status" -- "$cur"))
+      fi
+      ;;
+    goals)
+      COMPREPLY=($(compgen -W "--json" -- "$cur"))
+      ;;
+    goal-create)
+      COMPREPLY=($(compgen -W "-d --description --color --json" -- "$cur"))
+      ;;
+    goal-update)
+      COMPREPLY=($(compgen -W "-n --name -d --description --color --json" -- "$cur"))
+      ;;
+    key-results)
+      COMPREPLY=($(compgen -W "--json" -- "$cur"))
+      ;;
+    key-result-create)
+      COMPREPLY=($(compgen -W "--type --target --json" -- "$cur"))
+      ;;
+    key-result-update)
+      COMPREPLY=($(compgen -W "--progress --note --json" -- "$cur"))
+      ;;
     folders)
       COMPREPLY=($(compgen -W "--name --json" -- "$cur"))
       ;;
@@ -2317,6 +2434,19 @@ _${name}() {
     'doc-pages:List all pages in a doc with content'
     'doc-page-create:Create a page in a doc'
     'doc-page-edit:Edit a doc page'
+    'tags:List tags in a space'
+    'tag-create:Create a tag in a space'
+    'tag-delete:Delete a tag from a space'
+    'members:List workspace members'
+    'fields:List custom fields for a list'
+    'duplicate:Duplicate a task'
+    'bulk:Bulk task operations'
+    'goals:List goals in your workspace'
+    'goal-create:Create a goal'
+    'goal-update:Update 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'
     'folders:List folders in a space'
     'config:Manage CLI configuration'
     'completion:Output shell completion script'
@@ -2656,6 +2786,99 @@ _${name}() {
             '1:doc_id:' \\
             '--json[Force JSON output]'
           ;;
+        tags)
+          _arguments \\
+            '1:space_id:' \\
+            '--json[Force JSON output]'
+          ;;
+        tag-create)
+          _arguments \\
+            '1:space_id:' \\
+            '2:name:' \\
+            '--fg[Foreground color]:color:' \\
+            '--bg[Background color]:color:' \\
+            '--json[Force JSON output]'
+          ;;
+        tag-delete)
+          _arguments \\
+            '1:space_id:' \\
+            '2:name:' \\
+            '--json[Force JSON output]'
+          ;;
+        members)
+          _arguments \\
+            '--json[Force JSON output]'
+          ;;
+        fields)
+          _arguments \\
+            '1:list_id:' \\
+            '--json[Force JSON output]'
+          ;;
+        duplicate)
+          _arguments \\
+            '1:task_id:' \\
+            '--json[Force JSON output]'
+          ;;
+        bulk)
+          local -a bulk_cmds
+          bulk_cmds=(
+            'status:Update status of multiple tasks'
+          )
+          _arguments -C \\
+            '1:bulk command:->bulk_cmd' \\
+            '*::bulk_arg:->bulk_args'
+          case $state in
+            bulk_cmd)
+              _describe 'bulk command' bulk_cmds
+              ;;
+            bulk_args)
+              case $words[1] in
+                status)
+                  _arguments '1:status:' '*:task_ids:' '--json[Force JSON output]'
+                  ;;
+              esac
+              ;;
+          esac
+          ;;
+        goals)
+          _arguments \\
+            '--json[Force JSON output]'
+          ;;
+        goal-create)
+          _arguments \\
+            '1:name:' \\
+            '(-d --description)'{-d,--description}'[Goal description]:text:' \\
+            '--color[Goal color]:color:' \\
+            '--json[Force JSON output]'
+          ;;
+        goal-update)
+          _arguments \\
+            '1:goal_id:' \\
+            '(-n --name)'{-n,--name}'[New goal name]:text:' \\
+            '(-d --description)'{-d,--description}'[New description]:text:' \\
+            '--color[New color]:color:' \\
+            '--json[Force JSON output]'
+          ;;
+        key-results)
+          _arguments \\
+            '1:goal_id:' \\
+            '--json[Force JSON output]'
+          ;;
+        key-result-create)
+          _arguments \\
+            '1:goal_id:' \\
+            '2:name:' \\
+            '--type[Key result type]:type:(number percentage)' \\
+            '--target[Target value]:number:' \\
+            '--json[Force JSON output]'
+          ;;
+        key-result-update)
+          _arguments \\
+            '1:key_result_id:' \\
+            '--progress[Current progress]:number:' \\
+            '--note[Progress note]:text:' \\
+            '--json[Force JSON output]'
+          ;;
         folders)
           _arguments \\
             '1:space_id:' \\
@@ -2764,6 +2987,19 @@ complete -c ${name} -n __fish_use_subcommand -a doc-create -d 'Create a new doc'
 complete -c ${name} -n __fish_use_subcommand -a doc-pages -d 'List all pages in a doc with content'
 complete -c ${name} -n __fish_use_subcommand -a doc-page-create -d 'Create a page in a doc'
 complete -c ${name} -n __fish_use_subcommand -a doc-page-edit -d 'Edit a doc page'
+complete -c ${name} -n __fish_use_subcommand -a tags -d 'List tags in a space'
+complete -c ${name} -n __fish_use_subcommand -a tag-create -d 'Create a tag in a space'
+complete -c ${name} -n __fish_use_subcommand -a tag-delete -d 'Delete a tag from a space'
+complete -c ${name} -n __fish_use_subcommand -a members -d 'List workspace members'
+complete -c ${name} -n __fish_use_subcommand -a fields -d 'List custom fields for a list'
+complete -c ${name} -n __fish_use_subcommand -a duplicate -d 'Duplicate a task'
+complete -c ${name} -n __fish_use_subcommand -a bulk -d 'Bulk task operations'
+complete -c ${name} -n __fish_use_subcommand -a goals -d 'List goals in your workspace'
+complete -c ${name} -n __fish_use_subcommand -a goal-create -d 'Create a goal'
+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 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'
@@ -2924,6 +3160,44 @@ complete -c ${name} -n '__fish_seen_subcommand_from doc' -l json -d 'Force JSON
 
 complete -c ${name} -n '__fish_seen_subcommand_from doc-pages' -l json -d 'Force JSON output'
 
+complete -c ${name} -n '__fish_seen_subcommand_from tags' -l json -d 'Force JSON output'
+
+complete -c ${name} -n '__fish_seen_subcommand_from tag-create' -l fg -d 'Foreground color'
+complete -c ${name} -n '__fish_seen_subcommand_from tag-create' -l bg -d 'Background color'
+complete -c ${name} -n '__fish_seen_subcommand_from tag-create' -l json -d 'Force JSON output'
+
+complete -c ${name} -n '__fish_seen_subcommand_from tag-delete' -l json -d 'Force JSON output'
+
+complete -c ${name} -n '__fish_seen_subcommand_from members' -l json -d 'Force JSON output'
+
+complete -c ${name} -n '__fish_seen_subcommand_from fields' -l json -d 'Force JSON output'
+
+complete -c ${name} -n '__fish_seen_subcommand_from duplicate' -l json -d 'Force JSON output'
+
+complete -c ${name} -n '__fish_seen_subcommand_from bulk; and not __fish_seen_subcommand_from status' -a status -d 'Update status of multiple tasks'
+complete -c ${name} -n '__fish_seen_subcommand_from status; and __fish_seen_subcommand_from bulk' -l json -d 'Force JSON output'
+
+complete -c ${name} -n '__fish_seen_subcommand_from goals' -l json -d 'Force JSON output'
+
+complete -c ${name} -n '__fish_seen_subcommand_from goal-create' -s d -l description -d 'Goal description'
+complete -c ${name} -n '__fish_seen_subcommand_from goal-create' -l color -d 'Goal color'
+complete -c ${name} -n '__fish_seen_subcommand_from goal-create' -l json -d 'Force JSON output'
+
+complete -c ${name} -n '__fish_seen_subcommand_from goal-update' -s n -l name -d 'New goal name'
+complete -c ${name} -n '__fish_seen_subcommand_from goal-update' -s d -l description -d 'New description'
+complete -c ${name} -n '__fish_seen_subcommand_from goal-update' -l color -d 'New color'
+complete -c ${name} -n '__fish_seen_subcommand_from goal-update' -l json -d 'Force JSON output'
+
+complete -c ${name} -n '__fish_seen_subcommand_from key-results' -l json -d 'Force JSON output'
+
+complete -c ${name} -n '__fish_seen_subcommand_from key-result-create' -l type -d 'Key result type' -a 'number percentage'
+complete -c ${name} -n '__fish_seen_subcommand_from key-result-create' -l target -d 'Target value'
+complete -c ${name} -n '__fish_seen_subcommand_from key-result-create' -l json -d 'Force JSON output'
+
+complete -c ${name} -n '__fish_seen_subcommand_from key-result-update' -l progress -d 'Current progress'
+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 folders' -l name -d 'Filter by folder name'
 complete -c ${name} -n '__fish_seen_subcommand_from folders' -l json -d 'Force JSON output'
 
@@ -3492,6 +3766,20 @@ async function listTimeEntries(config, opts) {
     taskId: opts?.taskId
   });
 }
+async function updateTimeEntry(config, timeEntryId, opts) {
+  if (!opts.description && !opts.duration) {
+    throw new Error("Provide --description or --duration to update");
+  }
+  const client = new ClickUpClient(config);
+  const updates = {};
+  if (opts.description) updates.description = opts.description;
+  if (opts.duration) updates.duration = parseTimeEstimate(opts.duration);
+  return client.updateTimeEntry(config.teamId, timeEntryId, updates);
+}
+async function deleteTimeEntry(config, timeEntryId) {
+  const client = new ClickUpClient(config);
+  await client.deleteTimeEntry(config.teamId, timeEntryId);
+}
 function formatTimeEntry(entry) {
   const lines = [];
   const taskName = entry.task?.name ?? "No task";
@@ -3524,6 +3812,156 @@ function formatTimeEntriesMarkdown(entries) {
   return entries.map(formatTimeEntryMarkdown).join("\n");
 }
 
+// src/commands/tags.ts
+import chalk11 from "chalk";
+async function listSpaceTags(config, spaceId) {
+  const client = new ClickUpClient(config);
+  return client.getSpaceTags(spaceId);
+}
+async function createSpaceTag(config, spaceId, name, fg, bg) {
+  const client = new ClickUpClient(config);
+  await client.createSpaceTag(spaceId, name, fg, bg);
+}
+async function deleteSpaceTag(config, spaceId, tagName) {
+  const client = new ClickUpClient(config);
+  await client.deleteSpaceTag(spaceId, tagName);
+}
+function formatTags(tags) {
+  if (tags.length === 0) return "No tags found";
+  return tags.map((t) => chalk11.bold(t.name)).join(", ");
+}
+function formatTagsMarkdown(tags) {
+  if (tags.length === 0) return "No tags found";
+  return tags.map((t) => `- ${t.name}`).join("\n");
+}
+
+// src/commands/members.ts
+import chalk12 from "chalk";
+async function listMembers(config) {
+  const client = new ClickUpClient(config);
+  return client.getWorkspaceMembers(config.teamId);
+}
+function formatMembers(members) {
+  if (members.length === 0) return "No members found";
+  return members.map((m) => `${chalk12.bold(m.username)} ${chalk12.dim(`(${m.id})`)} ${m.email}`).join("\n");
+}
+function formatMembersMarkdown(members) {
+  if (members.length === 0) return "No members found";
+  return members.map((m) => `- **${m.username}** (${m.id}) - ${m.email}`).join("\n");
+}
+
+// src/commands/fields.ts
+import chalk13 from "chalk";
+async function listFields(config, listId) {
+  const client = new ClickUpClient(config);
+  return client.getListCustomFields(listId);
+}
+function formatFields(fields) {
+  if (fields.length === 0) return "No custom fields";
+  return fields.map((f) => {
+    const options = f.type_config?.options?.map((o) => o.name).join(", ");
+    const optStr = options ? ` ${chalk13.dim(`[${options}]`)}` : "";
+    return `${chalk13.bold(f.name)} ${chalk13.dim(f.type)}${f.required ? chalk13.yellow(" (required)") : ""}${optStr}`;
+  }).join("\n");
+}
+function formatFieldsMarkdown(fields) {
+  if (fields.length === 0) return "No custom fields";
+  return fields.map((f) => {
+    const options = f.type_config?.options?.map((o) => o.name).join(", ");
+    const optStr = options ? ` [${options}]` : "";
+    return `- **${f.name}** (${f.type})${f.required ? " - required" : ""}${optStr}`;
+  }).join("\n");
+}
+
+// src/commands/duplicate.ts
+async function duplicateTask(config, taskId) {
+  const client = new ClickUpClient(config);
+  const task = await client.getTask(taskId);
+  const created = await client.createTask(task.list.id, {
+    name: `${task.name} (copy)`,
+    description: task.description,
+    markdown_content: task.markdown_content,
+    priority: task.priority ? Number(task.priority.priority) : void 0,
+    tags: task.tags?.map((t) => t.name),
+    time_estimate: task.time_estimate ?? void 0
+  });
+  return { id: created.id, name: created.name, url: created.url };
+}
+
+// src/commands/bulk.ts
+async function bulkUpdateStatus(config, taskIds, status) {
+  const client = new ClickUpClient(config);
+  const failed = [];
+  for (const id of taskIds) {
+    try {
+      await client.updateTask(id, { status });
+    } catch {
+      failed.push(id);
+    }
+  }
+  return { updated: taskIds.length - failed.length, failed };
+}
+
+// src/commands/goals.ts
+import chalk14 from "chalk";
+async function listGoals(config) {
+  const client = new ClickUpClient(config);
+  return client.getGoals(config.teamId);
+}
+async function createGoal(config, name, opts) {
+  const client = new ClickUpClient(config);
+  return client.createGoal(config.teamId, name, opts);
+}
+async function updateGoal(config, goalId, updates) {
+  const client = new ClickUpClient(config);
+  return client.updateGoal(goalId, updates);
+}
+async function listKeyResults(config, goalId) {
+  const client = new ClickUpClient(config);
+  return client.getKeyResults(goalId);
+}
+async function createKeyResult(config, goalId, name, type, target) {
+  const client = new ClickUpClient(config);
+  return client.createKeyResult(goalId, name, type, target);
+}
+async function updateKeyResult(config, keyResultId, updates) {
+  const client = new ClickUpClient(config);
+  return client.updateKeyResult(keyResultId, {
+    steps_current: updates.progress,
+    note: updates.note
+  });
+}
+function formatGoals(goals) {
+  if (goals.length === 0) return "No goals found";
+  return goals.map((g) => {
+    const pct = Math.round(g.percent_completed * 100);
+    const owner = g.owner ? ` ${chalk14.dim(`@${g.owner.username}`)}` : "";
+    return `${chalk14.bold(g.name)} ${chalk14.dim(`(${g.id})`)} ${chalk14.cyan(`${pct}%`)}${owner}`;
+  }).join("\n");
+}
+function formatGoalsMarkdown(goals) {
+  if (goals.length === 0) return "No goals found";
+  return goals.map((g) => {
+    const pct = Math.round(g.percent_completed * 100);
+    const owner = g.owner ? ` - @${g.owner.username}` : "";
+    return `- **${g.name}** (${g.id}) - ${pct}%${owner}`;
+  }).join("\n");
+}
+function formatKeyResults(keyResults) {
+  if (keyResults.length === 0) return "No key results found";
+  return keyResults.map((kr) => {
+    const pct = Math.round(kr.percent_completed * 100);
+    return `${chalk14.bold(kr.name)} ${chalk14.dim(`(${kr.id})`)} ${chalk14.cyan(`${kr.steps_current}/${kr.steps_end}`)} ${chalk14.dim(`${pct}%`)}`;
+  }).join("\n");
+}
+function formatKeyResultsMarkdown(keyResults) {
+  if (keyResults.length === 0) return "No key results found";
+  return keyResults.map((kr) => {
+    const pct = Math.round(kr.percent_completed * 100);
+    return `- **${kr.name}** (${kr.id}) - ${kr.steps_current}/${kr.steps_end} (${pct}%)`;
+  }).join("\n");
+}
+
 // src/index.ts
 var require2 = createRequire(import.meta.url);
 var { version } = require2("../package.json");
@@ -4066,6 +4504,220 @@ timeCmd.command("list").description("List recent time entries (default: last 7 d
     }
   })
 );
+timeCmd.command("update <timeEntryId>").description("Update a time entry").option("-d, --description <text>", "New description").option("--duration <duration>", 'New duration (e.g. "2h", "30m")').option("--json", "Force JSON output even in terminal").action(
+  wrapAction(
+    async (timeEntryId, opts) => {
+      const config = loadConfig();
+      const entry = await updateTimeEntry(config, timeEntryId, {
+        description: opts.description,
+        duration: opts.duration
+      });
+      if (shouldOutputJson(opts.json ?? false)) {
+        console.log(JSON.stringify(entry, null, 2));
+      } else if (isTTY()) {
+        console.log(formatTimeEntry(entry));
+      } else {
+        console.log(formatTimeEntryMarkdown(entry));
+      }
+    }
+  )
+);
+timeCmd.command("delete <timeEntryId>").description("Delete a time entry").option("--json", "Force JSON output even in terminal").action(
+  wrapAction(async (timeEntryId, opts) => {
+    const config = loadConfig();
+    await deleteTimeEntry(config, timeEntryId);
+    if (shouldOutputJson(opts.json ?? false)) {
+      console.log(JSON.stringify({ deleted: timeEntryId }));
+    } else {
+      console.log(`Deleted time entry ${timeEntryId}`);
+    }
+  })
+);
+program.command("tags <spaceId>").description("List tags in a space").option("--json", "Force JSON output even in terminal").action(
+  wrapAction(async (spaceId, opts) => {
+    const config = loadConfig();
+    const tags = await listSpaceTags(config, spaceId);
+    if (shouldOutputJson(opts.json ?? false)) {
+      console.log(JSON.stringify(tags, null, 2));
+    } else if (isTTY()) {
+      console.log(formatTags(tags));
+    } else {
+      console.log(formatTagsMarkdown(tags));
+    }
+  })
+);
+program.command("tag-create <spaceId> <name>").description("Create a tag in a space").option("--fg <color>", "Foreground color (hex)").option("--bg <color>", "Background color (hex)").option("--json", "Force JSON output even in terminal").action(
+  wrapAction(
+    async (spaceId, name, opts) => {
+      const config = loadConfig();
+      await createSpaceTag(config, spaceId, name, opts.fg, opts.bg);
+      if (shouldOutputJson(opts.json ?? false)) {
+        console.log(JSON.stringify({ success: true, spaceId, tag: name }, null, 2));
+      } else {
+        console.log(`Created tag "${name}" in space ${spaceId}`);
+      }
+    }
+  )
+);
+program.command("tag-delete <spaceId> <name>").description("Delete a tag from a space").option("--json", "Force JSON output even in terminal").action(
+  wrapAction(async (spaceId, name, opts) => {
+    const config = loadConfig();
+    await deleteSpaceTag(config, spaceId, name);
+    if (shouldOutputJson(opts.json ?? false)) {
+      console.log(JSON.stringify({ success: true, spaceId, tag: name }, null, 2));
+    } else {
+      console.log(`Deleted tag "${name}" from space ${spaceId}`);
+    }
+  })
+);
+program.command("members").description("List workspace members").option("--json", "Force JSON output even in terminal").action(
+  wrapAction(async (opts) => {
+    const config = loadConfig();
+    const members = await listMembers(config);
+    if (shouldOutputJson(opts.json ?? false)) {
+      console.log(JSON.stringify(members, null, 2));
+    } else if (isTTY()) {
+      console.log(formatMembers(members));
+    } else {
+      console.log(formatMembersMarkdown(members));
+    }
+  })
+);
+program.command("fields <listId>").description("List custom fields for a list").option("--json", "Force JSON output even in terminal").action(
+  wrapAction(async (listId, opts) => {
+    const config = loadConfig();
+    const fields = await listFields(config, listId);
+    if (shouldOutputJson(opts.json ?? false)) {
+      console.log(JSON.stringify(fields, null, 2));
+    } else if (isTTY()) {
+      console.log(formatFields(fields));
+    } else {
+      console.log(formatFieldsMarkdown(fields));
+    }
+  })
+);
+program.command("duplicate <taskId>").description("Duplicate a task").option("--json", "Force JSON output even in terminal").action(
+  wrapAction(async (taskId, opts) => {
+    const config = loadConfig();
+    const result = await duplicateTask(config, taskId);
+    if (shouldOutputJson(opts.json ?? false)) {
+      console.log(JSON.stringify(result, null, 2));
+    } else {
+      console.log(`Duplicated as "${result.name}" (${result.id})`);
+    }
+  })
+);
+var bulkCmd = program.command("bulk").description("Bulk task operations");
+bulkCmd.command("status <status> <taskIds...>").description("Update status of multiple tasks").option("--json", "Force JSON output even in terminal").action(
+  wrapAction(async (status, taskIds, opts) => {
+    const config = loadConfig();
+    const result = await bulkUpdateStatus(config, taskIds, status);
+    if (shouldOutputJson(opts.json ?? false)) {
+      console.log(JSON.stringify(result, null, 2));
+    } else {
+      console.log(`Updated ${result.updated} tasks to "${status}"`);
+      if (result.failed.length > 0) {
+        console.log(`Failed: ${result.failed.join(", ")}`);
+      }
+    }
+  })
+);
+program.command("goals").description("List goals in your workspace").option("--json", "Force JSON output even in terminal").action(
+  wrapAction(async (opts) => {
+    const config = loadConfig();
+    const goals = await listGoals(config);
+    if (shouldOutputJson(opts.json ?? false)) {
+      console.log(JSON.stringify(goals, null, 2));
+    } else if (isTTY()) {
+      console.log(formatGoals(goals));
+    } else {
+      console.log(formatGoalsMarkdown(goals));
+    }
+  })
+);
+program.command("goal-create <name>").description("Create a goal").option("-d, --description <text>", "Goal description").option("--color <hex>", "Goal color (hex)").option("--json", "Force JSON output even in terminal").action(
+  wrapAction(
+    async (name, opts) => {
+      const config = loadConfig();
+      const goal = await createGoal(config, name, {
+        description: opts.description,
+        color: opts.color
+      });
+      if (shouldOutputJson(opts.json ?? false)) {
+        console.log(JSON.stringify(goal, null, 2));
+      } else {
+        console.log(`Created goal "${goal.name}" (${goal.id})`);
+      }
+    }
+  )
+);
+program.command("goal-update <goalId>").description("Update a goal").option("-n, --name <text>", "New goal name").option("-d, --description <text>", "New description").option("--color <hex>", "New color (hex)").option("--json", "Force JSON output even in terminal").action(
+  wrapAction(
+    async (goalId, opts) => {
+      const config = loadConfig();
+      const goal = await updateGoal(config, goalId, {
+        name: opts.name,
+        description: opts.description,
+        color: opts.color
+      });
+      if (shouldOutputJson(opts.json ?? false)) {
+        console.log(JSON.stringify(goal, null, 2));
+      } else {
+        console.log(`Updated goal "${goal.name}" (${goal.id})`);
+      }
+    }
+  )
+);
+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();
+    const krs = await listKeyResults(config, goalId);
+    if (shouldOutputJson(opts.json ?? false)) {
+      console.log(JSON.stringify(krs, null, 2));
+    } else if (isTTY()) {
+      console.log(formatKeyResults(krs));
+    } else {
+      console.log(formatKeyResultsMarkdown(krs));
+    }
+  })
+);
+program.command("key-result-create <goalId> <name>").description("Create a key result on a goal").option("--type <type>", "Key result type (number or percentage)", "number").option("--target <n>", "Target value", "100").option("--json", "Force JSON output even in terminal").action(
+  wrapAction(
+    async (goalId, name, opts) => {
+      const config = loadConfig();
+      const target = Number(opts.target ?? 100);
+      if (!Number.isFinite(target) || target <= 0) {
+        throw new Error("--target must be a positive number");
+      }
+      const kr = await createKeyResult(config, goalId, name, opts.type ?? "number", target);
+      if (shouldOutputJson(opts.json ?? false)) {
+        console.log(JSON.stringify(kr, null, 2));
+      } else {
+        console.log(`Created key result "${kr.name}" (${kr.id})`);
+      }
+    }
+  )
+);
+program.command("key-result-update <keyResultId>").description("Update a key result").option("--progress <n>", "Current progress value").option("--note <text>", "Progress note").option("--json", "Force JSON output even in terminal").action(
+  wrapAction(
+    async (keyResultId, opts) => {
+      const config = loadConfig();
+      const updates = {};
+      if (opts.progress !== void 0) {
+        const p = Number(opts.progress);
+        if (!Number.isFinite(p)) throw new Error("--progress must be a number");
+        updates.progress = p;
+      }
+      if (opts.note !== void 0) updates.note = opts.note;
+      const kr = await updateKeyResult(config, keyResultId, updates);
+      if (shouldOutputJson(opts.json ?? false)) {
+        console.log(JSON.stringify(kr, null, 2));
+      } else {
+        console.log(`Updated key result "${kr.name}" (${kr.id})`);
+      }
+    }
+  )
+);
 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();

package/package.json

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

package/skills/clickup-cli/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: clickup
-description: 'Use when managing ClickUp tasks, sprints, or comments via the `cup` CLI tool. Triggers: task queries, status updates, sprint tracking, creating subtasks, posting comments, threaded replies, 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, managing checklists, editing comments, task links, time tracking, attachments, file uploads.'
+description: 'Use when managing ClickUp tasks, sprints, or comments via the `cup` CLI tool. Triggers: task queries, status updates, sprint tracking, creating subtasks, posting comments, threaded replies, 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, managing checklists, editing comments, task links, time tracking, attachments, file uploads, listing members, listing fields, duplicating tasks, bulk operations, goals, key results.'
 ---
 
 # ClickUp CLI (`cup`)
@@ -53,6 +53,11 @@ All commands support `--help` for full flag details.
 | `cup open <query> [--json]`                                                                         | Open task in browser by ID or name                 |
 | `cup auth [--json]`                                                                                 | Check authentication status                        |
 | `cup folders <spaceId> [--name partial] [--json]`                                                   | Folders in a space (with their lists)              |
+| `cup tags <spaceId> [--json]`                                                                       | List tags available in a space                     |
+| `cup members [--json]`                                                                              | List workspace members                             |
+| `cup fields <listId> [--json]`                                                                      | List custom fields for a list                      |
+| `cup goals [--json]`                                                                                | List goals in your workspace                       |
+| `cup key-results <goalId> [--json]`                                                                 | List key results for a goal                        |
 | `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                    |
@@ -87,9 +92,19 @@ All commands support `--help` for full flag details.
 | `cup time status [--json]`                                                                                                                                                          | Show currently running timer                               |
 | `cup time log <taskId> <duration> [-d desc] [--json]`                                                                                                                               | Log manual time entry (e.g. "2h", "30m")                   |
 | `cup time list [--days n] [--task id] [--json]`                                                                                                                                     | List recent time entries                                   |
+| `cup time update <timeEntryId> [-d desc] [--duration dur] [--json]`                                                                                                                 | Update a time entry                                        |
+| `cup time delete <timeEntryId> [--json]`                                                                                                                                            | Delete a time entry                                        |
 | `cup doc-create <title> [-c content] [--json]`                                                                                                                                      | Create a new doc                                           |
 | `cup doc-page-create <docId> <name> [-c content] [--parent-page pageId] [--json]`                                                                                                   | Create a page in a doc                                     |
 | `cup doc-page-edit <docId> <pageId> [--name text] [-c content] [--json]`                                                                                                            | Edit a doc page                                            |
+| `cup tag-create <spaceId> <name> [--fg color] [--bg color] [--json]`                                                                                                                | Create a tag in a space                                    |
+| `cup tag-delete <spaceId> <name> [--json]`                                                                                                                                          | Delete a tag from a space                                  |
+| `cup duplicate <taskId> [--json]`                                                                                                                                                   | Duplicate a task (read + create copy)                      |
+| `cup bulk status <status> <taskIds...> [--json]`                                                                                                                                    | Bulk update status of multiple tasks                       |
+| `cup goal-create <name> [-d desc] [--color hex] [--json]`                                                                                                                           | Create a goal                                              |
+| `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 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)                          |
 
@@ -123,7 +138,22 @@ All commands support `--help` for full flag details.
 | `cup overdue`               | Excludes closed tasks, sorted most overdue first                                                                                                                                                                                                          |
 | `cup open`                  | Tries task ID first, falls back to name search                                                                                                                                                                                                            |
 | `cup checklist`             | Full CRUD for task checklists: view, create, delete, add-item, edit-item, delete-item                                                                                                                                                                     |
-| `cup time`                  | Track time: start/stop timer, log entries, list history. Duration format: "2h", "30m", "1h30m"                                                                                                                                                            |
+| `cup tags`                  | List available tags in a space. Useful for discovering valid tag names before using `cup tag`                                                                                                                                                             |
+| `cup tag-create`            | Create a new tag in a space. Optional `--fg` and `--bg` for colors                                                                                                                                                                                        |
+| `cup tag-delete`            | Delete a tag from a space                                                                                                                                                                                                                                 |
+| `cup members`               | List workspace members with username, ID, and email                                                                                                                                                                                                       |
+| `cup fields`                | List custom fields on a list. Shows field type, required status, and dropdown options                                                                                                                                                                     |
+| `cup duplicate`             | Duplicate a task. Creates a copy with name, description, priority, tags, and time estimate                                                                                                                                                                |
+| `cup bulk status`           | Update status of multiple tasks at once. Reports failures without stopping                                                                                                                                                                                |
+| `cup goals`                 | List goals with progress percentage and owner                                                                                                                                                                                                             |
+| `cup goal-create`           | Create a goal with optional description and color                                                                                                                                                                                                         |
+| `cup goal-update`           | Update goal name, description, or color                                                                                                                                                                                                                   |
+| `cup key-results`           | List key results for a goal with progress tracking                                                                                                                                                                                                        |
+| `cup key-result-create`     | Create a key result (number or percentage type) with a target value                                                                                                                                                                                       |
+| `cup key-result-update`     | Update key result progress or add a note                                                                                                                                                                                                                  |
+| `cup time`                  | Track time: start/stop timer, log entries, list history, update/delete entries. Duration format: "2h", "30m", "1h30m"                                                                                                                                     |
+| `cup time update`           | Update a time entry description or duration                                                                                                                                                                                                               |
+| `cup time delete`           | Delete a time entry                                                                                                                                                                                                                                       |
 | `cup comment-edit`          | Edit comment text and resolution status                                                                                                                                                                                                                   |
 | `cup comment-delete`        | Delete a comment                                                                                                                                                                                                                                          |
 | `cup replies` / `cup reply` | View and post threaded comment replies                                                                                                                                                                                                                    |
@@ -234,10 +264,32 @@ cup folders <spaceId>                # folders with their lists
 cup folders <spaceId> --name "sprint"  # filter folders by name
 cup lists <spaceId>                  # lists in a space (needs ID from cup spaces)
 cup sprints                          # all sprints across folders
+cup members                          # workspace members
+cup fields <listId>                  # custom fields on a list
 cup auth                             # verify token works
 cup config set sprintFolderId <id>   # pin sprint detection to a folder
 ```
 
+### Bulk operations
+
+```bash
+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-delete <spaceId> "old-tag"   # delete a space tag
+```
+
+### Goals and key results
+
+```bash
+cup goals                            # list all goals
+cup goal-create "Ship v2" -d "Release version 2"
+cup goal-update g123 -n "Updated name"
+cup key-results g123                 # key results for a goal
+cup key-result-create g123 "API coverage" --type percentage --target 80
+cup key-result-update kr456 --progress 60 --note "On track"
+```
+
 ### Standup
 
 ```bash