Skip to content

Commit 2da996f

Browse files
krodakkrodak
committed
document field, delete, and tag commands
1 parent 93a329d commit 2da996f

File tree

2 files changed

+106
-29
lines changed

2 files changed

+106
-29
lines changed

‎README.md‎

Lines changed: 61 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -98,7 +98,7 @@ When output is piped (no TTY), all commands output **Markdown** by default - opt
9898

9999
## Commands
100100

101-
27 commands total. All support `--help` for full flag details.
101+
30 commands total. All support `--help` for full flag details.
102102

103103
### `cu init`
104104

@@ -261,6 +261,48 @@ cu create -n "Fix bug" -l <listId> --json
261261
| `--custom-item-id <id>` | no | Custom task type ID (for creating initiatives) |
262262
| `--json` | no | Force JSON output even in terminal |
263263

264+
### `cu delete <id>`
265+
266+
Delete a task. **DESTRUCTIVE - cannot be undone.**
267+
268+
```bash
269+
cu delete abc123
270+
cu delete abc123 --confirm
271+
cu delete abc123 --confirm --json
272+
```
273+
274+
In TTY mode without `--confirm`: shows the task name and prompts for confirmation (default: No). In non-interactive/piped mode, `--confirm` is required.
275+
276+
| Flag | Description |
277+
| ----------- | ----------------------------------------------------------- |
278+
| `--confirm` | Skip confirmation prompt (required in non-interactive mode) |
279+
| `--json` | Force JSON output |
280+
281+
### `cu field <id>`
282+
283+
Set or remove a custom field value. Field names are resolved case-insensitively; errors list available fields/options.
284+
285+
```bash
286+
cu field abc123 --set "Priority Level" high
287+
cu field abc123 --set "Story Points" 5
288+
cu field abc123 --set "Approved" true
289+
cu field abc123 --set "Category" "Bug Fix"
290+
cu field abc123 --set "Due" 2025-06-01
291+
cu field abc123 --set "Website" "https://example.com"
292+
cu field abc123 --set "Contact" "user@example.com"
293+
cu field abc123 --remove "Priority Level"
294+
cu field abc123 --set "Points" 3 --remove "Old Field"
295+
cu field abc123 --set "Points" 3 --json
296+
```
297+
298+
| Flag | Description |
299+
| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
300+
| `--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 |
301+
| `--remove "Field Name"` | Remove a custom field value |
302+
| `--json` | Force JSON output |
303+
304+
Both `--set` and `--remove` can be used together in one invocation.
305+
264306
### `cu comment <id>`
265307

266308
Post a comment on a task.
@@ -423,6 +465,24 @@ cu move abc123 --to <listId> --json
423465
| `--remove <listId>` | Remove task from this list |
424466
| `--json` | Force JSON output |
425467

468+
### `cu tag <id>`
469+
470+
Add or remove tags on a task. Both `--add` and `--remove` can be used together.
471+
472+
```bash
473+
cu tag abc123 --add "bug"
474+
cu tag abc123 --add "bug,frontend,urgent"
475+
cu tag abc123 --remove "wontfix"
476+
cu tag abc123 --add "bug" --remove "triage"
477+
cu tag abc123 --add "bug" --json
478+
```
479+
480+
| Flag | Description |
481+
| ----------------- | ----------------------------------- |
482+
| `--add <tags>` | Comma-separated tag names to add |
483+
| `--remove <tags>` | Comma-separated tag names to remove |
484+
| `--json` | Force JSON output |
485+
426486
### `cu auth`
427487

428488
Check authentication status. Validates your API token and shows your user info.

‎skills/clickup-cli/SKILL.md‎

Lines changed: 45 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
name: clickup
3-
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.'
3+
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.'
44
---
55

66
# ClickUp CLI (`cu`)
@@ -64,38 +64,45 @@ All commands support `--help` for full flag details.
6464
| `cu assign <id> [--to userId\|me] [--remove userId\|me] [--json]` | Assign/unassign users |
6565
| `cu depend <id> [--on taskId] [--blocks taskId] [--remove] [--json]` | Add/remove task dependencies |
6666
| `cu move <id> [--to listId] [--remove listId] [--json]` | Add/remove task from lists |
67+
| `cu field <id> [--set "Name" value] [--remove "Name"] [--json]` | Set/remove custom field values |
68+
| `cu delete <id> [--confirm] [--json]` | Delete a task (DESTRUCTIVE, irreversible) |
69+
| `cu tag <id> [--add tags] [--remove tags] [--json]` | Add/remove tags on a task |
6770
| `cu config get <key>` / `cu config set <key> <value>` / `cu config path` | Manage CLI config |
6871
| `cu completion <shell>` | Shell completions (bash/zsh/fish) |
6972

7073
## Quick Reference
7174

72-
| Topic | Detail |
73-
| ------------------- | --------------------------------------------------------------------------------------------------------------------- |
74-
| Task IDs | Stable alphanumeric strings (e.g. `abc123def`) |
75-
| Initiatives | Detected via `custom_item_id !== 0` |
76-
| `--list` on create | Optional when `--parent` is given (auto-detected) |
77-
| `--status` | Fuzzy matching: exact > starts-with > contains. Prints match to stderr. |
78-
| `--priority` | Names (`urgent`, `high`, `normal`, `low`) or numbers (1-4) |
79-
| `--due-date` | `YYYY-MM-DD` format |
80-
| `--assignee` | Numeric user ID (find via `cu task <id> --json`) |
81-
| `--tags` | Comma-separated (e.g. `--tags "bug,frontend"`) |
82-
| `--time-estimate` | Duration format: `"2h"`, `"30m"`, `"1h30m"`, or raw milliseconds |
83-
| `--custom-item-id` | Custom task type ID (e.g. `1` for initiative) |
84-
| `--on` / `--blocks` | Task dependency direction (used with `cu depend`) |
85-
| `--to` / `--remove` | List ID to add/remove task (used with `cu move`) |
86-
| `--space` | Partial name match or exact ID |
87-
| `--name` | Partial match, case-insensitive |
88-
| `--include-closed` | Include closed/done tasks (on `tasks`, `initiatives`, `assigned`, `subtasks`, `sprint`, `search`, `inbox`, `overdue`) |
89-
| `cu assign --to me` | Shorthand for your own user ID |
90-
| `cu search` | Matches all query words against task name, case-insensitive |
91-
| `cu sprint` | Auto-detects active sprint via view API and date range parsing |
92-
| `cu summary` | Categories: completed (done/complete/closed within N hours), in progress, overdue |
93-
| `cu overdue` | Excludes closed tasks, sorted most overdue first |
94-
| `cu open` | Tries task ID first, falls back to name search |
95-
| `cu task` | Shows custom fields in detail view |
96-
| `cu lists` | Discovers list IDs needed for `--list` and `cu create -l` |
97-
| Errors | stderr with exit code 1 |
98-
| Parsing | Strict - excess/unknown arguments rejected |
75+
| Topic | Detail |
76+
| ----------------------- | --------------------------------------------------------------------------------------------------------------------- |
77+
| Task IDs | Stable alphanumeric strings (e.g. `abc123def`) |
78+
| Initiatives | Detected via `custom_item_id !== 0` |
79+
| `--list` on create | Optional when `--parent` is given (auto-detected) |
80+
| `--status` | Fuzzy matching: exact > starts-with > contains. Prints match to stderr. |
81+
| `--priority` | Names (`urgent`, `high`, `normal`, `low`) or numbers (1-4) |
82+
| `--due-date` | `YYYY-MM-DD` format |
83+
| `--assignee` | Numeric user ID (find via `cu task <id> --json`) |
84+
| `--tags` | Comma-separated (e.g. `--tags "bug,frontend"`) |
85+
| `--time-estimate` | Duration format: `"2h"`, `"30m"`, `"1h30m"`, or raw milliseconds |
86+
| `--custom-item-id` | Custom task type ID (e.g. `1` for initiative) |
87+
| `--on` / `--blocks` | Task dependency direction (used with `cu depend`) |
88+
| `--to` / `--remove` | List ID to add/remove task (used with `cu move`) |
89+
| `cu field --set` | Supports: text, number, checkbox (true/false), dropdown (option name), date (YYYY-MM-DD), url, email |
90+
| `cu field` | Field names resolved case-insensitively; errors list available fields/options |
91+
| `cu delete` | DESTRUCTIVE. Requires `--confirm` in non-interactive mode. Cannot be undone |
92+
| `cu tag --add/--remove` | Comma-separated tag names (e.g. `--add "bug,frontend"`) |
93+
| `--space` | Partial name match or exact ID |
94+
| `--name` | Partial match, case-insensitive |
95+
| `--include-closed` | Include closed/done tasks (on `tasks`, `initiatives`, `assigned`, `subtasks`, `sprint`, `search`, `inbox`, `overdue`) |
96+
| `cu assign --to me` | Shorthand for your own user ID |
97+
| `cu search` | Matches all query words against task name, case-insensitive |
98+
| `cu sprint` | Auto-detects active sprint via view API and date range parsing |
99+
| `cu summary` | Categories: completed (done/complete/closed within N hours), in progress, overdue |
100+
| `cu overdue` | Excludes closed tasks, sorted most overdue first |
101+
| `cu open` | Tries task ID first, falls back to name search |
102+
| `cu task` | Shows custom fields in detail view |
103+
| `cu lists` | Discovers list IDs needed for `--list` and `cu create -l` |
104+
| Errors | stderr with exit code 1 |
105+
| Parsing | Strict - excess/unknown arguments rejected |
99106

100107
## Agent Workflow Examples
101108

@@ -137,6 +144,12 @@ cu assign abc123def --to me
137144
cu depend task3 --on task2 # task3 waits for task2
138145
cu depend task1 --blocks task2 # task1 blocks task2
139146
cu move task1 --to list2 --remove list1 # move between lists
147+
cu field abc123def --set "Story Points" 5
148+
cu field abc123def --set "Category" "Bug Fix"
149+
cu field abc123def --remove "Old Field"
150+
cu tag abc123def --add "bug,frontend"
151+
cu tag abc123def --remove "triage"
152+
cu delete abc123def --confirm # irreversible!
140153
```
141154

142155
### Discover workspace structure
@@ -155,3 +168,7 @@ cu auth # verify token works
155168
cu summary # completed / in progress / overdue
156169
cu summary --hours 48 # wider window
157170
```
171+
172+
## DELETE SAFETY
173+
174+
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.

0 commit comments

Comments
 (0)