clickup-agent-cli 0.3.0 → 0.4.1

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "clickup-agent-cli",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "description": "CLI covering the entire ClickUp API v2 surface",
   "type": "module",
   "bin": {
-    "clickup": "./dist/bin/clickup.js"
+    "clickup": "dist/clickup.js"
   },
   "files": [
     "dist",
@@ -46,5 +46,13 @@
     "tsx": "^4.0.0",
     "typescript": "^5.9.0",
     "vitest": "^3.0.0"
-  }
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/henryreith/clickup-cli"
+  },
+  "bugs": {
+    "url": "https://github.com/henryreith/clickup-cli/issues"
+  },
+  "homepage": "https://github.com/henryreith/clickup-cli#readme"
 }

package/skills/clickup/SKILL.md

@@ -27,6 +27,13 @@ clickup schema <resource>.<action>     # Show required/optional fields
 clickup <resource> <action> --help     # Full help text
 ```
 
+Agents without a skill-loading system (any platform other than Claude Code) can read every skill in this table directly from the CLI:
+
+```bash
+clickup skill list                     # All available skills
+clickup skill show <name>              # Print a skill's full contents (e.g. clickup-tasks)
+```
+
 ## Sub-Skills (load when needed)
 
 | Skill | What it covers |

package/skills/clickup-custom-report/SKILL.md

@@ -120,6 +120,6 @@ These all work with this recipe:
 ## Tips
 
 - Combine multiple searches if a single query can't capture everything
-- Use `clickup schema tasks.search` to discover available filter flags
+- Use `clickup schema task.search` to discover available filter flags
 - For complex comparisons, run separate searches and merge the results
 - If the user asks for something the CLI can't filter directly, fetch a broader set and filter in post-processing

package/skills/clickup-fields/SKILL.md

@@ -13,7 +13,7 @@ Custom fields are defined at the list level and set on individual tasks.
 ```bash
 clickup field list --list-id <id>                              # List field definitions
 clickup field set --task-id <id> --field-id <fid> --value <v>  # Set a field value
-clickup field remove --task-id <id> --field-id <fid>           # Clear a field value
+clickup field remove --task-id <id> --field-id <fid> --confirm # Clear a field value
 ```
 
 ### Value formats by field type
@@ -74,10 +74,10 @@ clickup field list --list-id 998877 --format md
 ```bash
 clickup attachment upload --task-id <id> --file <path> [--filename <name>]
 clickup attachment list --task-id <id>
-clickup attachment download --task-id <id> --attachment-id <id> [--output <path>]
+clickup attachment download --task-id <id> --attachment-id <id> [--output <path>] [--force]
 ```
 
-`attachment download` fetches the file with the auth header and writes to `--output` (default: `./attachment-<id>-<title>`). Shows a spinner during download.
+`attachment download` fetches the file with the auth header and writes to `--output` (default: `./attachment-<id>-<title>`). Refuses to overwrite an existing file unless `--force` is passed. Shows a spinner during download.
 
 ## Discovery
 

package/skills/clickup-rollout/SKILL.md

@@ -76,8 +76,8 @@ For a task template result, set assignees, dates, and custom fields:
 # Assign team members
 clickup task update "$TASK_ID" --assignee-add <user-id>
 
-# Set start and due dates (Unix milliseconds)
-clickup task update "$TASK_ID" --start-date <ms> --due-date <ms>
+# Set start and due dates (Unix ms, ISO 8601, or relative like "3d", "friday")
+clickup task update "$TASK_ID" --start-date <date> --due-date <date>
 
 # Fill in custom fields
 clickup field set --task-id "$TASK_ID" --field-id <field-id> --value "<value>"

package/skills/clickup-task-triage/SKILL.md

@@ -45,7 +45,7 @@ clickup task update <task-id> --priority 2 --assignee-add 112233 --status "to do
 clickup tag add --task-id <task-id> --name "bug"
 
 # Set a due date if time-sensitive
-clickup task update <task-id> --due-date <timestamp-ms>
+clickup task update <task-id> --due-date <date>   # Unix ms, ISO 8601, or relative like "3d", "friday"
 ```
 
 ### Step 4: Route to appropriate lists (optional)

package/skills/clickup-tasks/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: clickup-tasks
 description: Creates, updates, searches, and manages ClickUp tasks, subtasks, checklists, dependencies, and attachments. Use when the user asks about tasks, wants to create or find work items, manage subtasks, add checklists, set dependencies, or upload files to tasks.
-allowed-tools: Bash(clickup task *), Bash(clickup checklist *), Bash(clickup dependency *), Bash(clickup relation *), Bash(clickup attachment *), Bash(clickup schema tasks*), Bash(clickup schema checklist*)
+allowed-tools: Bash(clickup task *), Bash(clickup checklist *), Bash(clickup dependency *), Bash(clickup relation *), Bash(clickup attachment *), Bash(clickup schema task*), Bash(clickup schema checklist*)
 ---
 
 # ClickUp Tasks
@@ -47,6 +47,8 @@ clickup task update <task-id> [--name <name>] [--description <text>]
 
 Priority accepts both integers (`1`-`4`) and strings (`urgent`, `high`, `normal`, `low`). Mapping: urgent=1, high=2, normal=3, low=4.
 
+`--due-date` and `--start-date` accept Unix timestamps (ms or seconds), ISO 8601 dates (`2026-07-10`), or relative dates (`tomorrow`, `3d`, `friday`, `next monday`).
+
 ### Delete a task
 ```bash
 clickup task delete <task-id> --confirm
@@ -104,8 +106,12 @@ clickup relation remove --task-id <id> --links-to <id>
 
 ```bash
 clickup attachment upload --task-id <id> --file <path> [--filename <name>]
+clickup attachment list --task-id <id>
+clickup attachment download --task-id <id> --attachment-id <id> [--output <path>] [--force]
 ```
 
+`attachment download` refuses to overwrite an existing file unless `--force` is passed.
+
 ## Common Patterns
 
 ```bash
@@ -132,7 +138,7 @@ clickup chat send --channel-id <id> --message "$(clickup task list --list-id <id
 ## Discovery
 
 ```bash
-clickup schema tasks              # List all task actions
-clickup schema tasks.create       # Show create fields
-clickup schema tasks.list         # Show list filter flags
+clickup schema task              # List all task actions
+clickup schema task.create       # Show create fields
+clickup schema task.list         # Show list filter flags
 ```

package/skills/clickup-time/SKILL.md

@@ -25,7 +25,7 @@ clickup time update <timer-id> --workspace-id <id>
     [--description <text>] [--duration <ms>] [--start <ts>]
     [--tag-action <add|remove>] [--tag <name>...] [--billable <bool>]
 
-clickup time delete <timer-id> --workspace-id <id>
+clickup time delete <timer-id> --workspace-id <id> --confirm
 ```
 
 ### Get / History
@@ -77,7 +77,8 @@ clickup time list --workspace-id 9876543 --format md
 
 - Duration is always in **milliseconds** (1 hour = 3600000, 1 minute = 60000)
 - Start timestamps are Unix milliseconds
-- `time delete` does **not** require `--confirm` (unlike most delete commands)
+- `time delete` requires `--confirm` in non-interactive mode (like all delete commands)
+- `--billable` accepts only `true` or `false`; anything else errors (exit 2)
 
 ## Discovery