clickup-agent-cli 0.4.0 → 0.4.2

package/.claude-plugin/marketplace.json

@@ -11,7 +11,7 @@
       "name": "clickup",
       "source": "./",
       "description": "ClickUp CLI with 25 agent skills covering the full API -- token-efficient alternative to MCP with chat, time tracking, docs, and project management workflows",
-      "version": "0.4.0",
+      "version": "0.4.2",
       "homepage": "https://github.com/henryreith/clickup-cli",
       "keywords": ["clickup", "project-management", "tasks", "time-tracking"],
       "category": "productivity"

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "clickup",
   "description": "ClickUp CLI with 25 agent skills covering the full API -- token-efficient alternative to MCP with chat, time tracking, docs, and project management workflows",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "author": {
     "name": "Henry Reith"
   },

package/README.md

@@ -112,7 +112,7 @@ import { query } from "@anthropic-ai/claude-agent-sdk";
 for await (const message of query({
   prompt: "Create a task for the login bug fix and assign to the backend team",
   options: {
-    plugins: [{ type: "local", path: "./node_modules/clickup-cli" }],
+    plugins: [{ type: "local", path: "./node_modules/clickup-agent-cli" }],
     allowedTools: ["Skill", "Bash"],
     settingSources: ["project"]
   }
@@ -133,7 +133,7 @@ clickup skill show clickup
 clickup skill show clickup-tasks
 
 # Or asks the CLI what fields are needed (~50 tokens in response)
-clickup schema tasks.create
+clickup schema task.create
 
 # For complex workflows, load a recipe skill
 clickup skill show clickup-weekly-review
@@ -180,11 +180,34 @@ This creates `/marketing-weekly` alongside the built-in `/clickup:*` skills.
 | Platform | How to use |
 |----------|-----------|
 | Claude Code | Plugin via marketplace (see above) |
-| Claude Agent SDK | `plugins: [{ type: "local", path: "./node_modules/clickup-cli" }]` |
+| Claude Agent SDK | `plugins: [{ type: "local", path: "./node_modules/clickup-agent-cli" }]` |
 | Gemini CLI | `npm install -g clickup-agent-cli`, read skills via `clickup skill show` |
 | OpenAI Codex | `npm install -g clickup-agent-cli`, execute commands via bash |
 | Custom agents | `clickup skill list` for discovery, `clickup schema` for field info |
 
+### Bootstrap From Any Agent
+
+Any agent that can run shell commands can set up and use the CLI in five steps, no plugin system required:
+
+```bash
+# 1. Install
+npm install -g clickup-agent-cli
+
+# 2. Authenticate non-interactively (env var, or --token-file / --token per call)
+export CLICKUP_API_TOKEN=pk_your_token
+
+# 3. Verify auth and workspace
+clickup config validate
+
+# 4. Discover capabilities: the root skill indexes everything
+clickup skill show clickup          # start here (~150 tokens)
+clickup skill list                  # all 25 skills
+clickup skill show clickup-tasks    # per-resource command reference
+
+# 5. Discover exact fields before calling a command
+clickup schema task.create
+```
+
 ### Agent-Friendly Design
 
 - JSON is the default output when stdout is not a TTY
@@ -199,10 +222,10 @@ This creates `/marketing-weekly` alongside the built-in `/clickup:*` skills.
 
 ```bash
 # Discover what's available
-clickup schema tasks
+clickup schema task
 
 # Check what fields task create needs
-clickup schema tasks.create --format json
+clickup schema task.create --format json
 
 # Create a task (JSON output automatic in non-TTY)
 clickup task create --list-id 998877 --name "Review PR" --priority 2

package/dist/clickup.js

@@ -1545,8 +1545,9 @@ function registerFolderCommands(program, getClient) {
 }
 
 // src/dates.ts
-var RELATIVE_OFFSET_RE = /^([+-]\d+)([dwmh])$/;
+var RELATIVE_OFFSET_RE = /^([+-]?\d+)([dwmh])$/;
 var UNIX_MS_RE = /^\d{13,}$/;
+var UNIX_SECONDS_RE = /^\d{10}$/;
 var ISO_DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
 var ISO_DATETIME_RE = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}/;
 var DAY_NAMES = ["sunday", "monday", "tuesday", "wednesday", "thursday", "friday", "saturday"];
@@ -1556,6 +1557,9 @@ function parseDate(input) {
   if (UNIX_MS_RE.test(raw)) {
     return parseInt(raw, 10);
   }
+  if (UNIX_SECONDS_RE.test(raw)) {
+    return parseInt(raw, 10) * 1e3;
+  }
   const now = /* @__PURE__ */ new Date();
   switch (lower) {
     case "today": {
@@ -1579,17 +1583,15 @@ function parseDate(input) {
     const ms = unitToMs(unit, amount);
     return now.getTime() + ms;
   }
-  if (lower.startsWith("next ")) {
-    const dayName = lower.slice(5);
-    const dayIndex = DAY_NAMES.indexOf(dayName);
-    if (dayIndex !== -1) {
-      const today = now.getDay();
-      let daysAhead = dayIndex - today;
-      if (daysAhead <= 0) daysAhead += 7;
-      const target = startOfDay(now);
-      target.setDate(target.getDate() + daysAhead);
-      return target.getTime();
-    }
+  const dayName = lower.startsWith("next ") ? lower.slice(5) : lower;
+  const dayIndex = DAY_NAMES.indexOf(dayName);
+  if (dayIndex !== -1) {
+    const today = now.getDay();
+    let daysAhead = dayIndex - today;
+    if (daysAhead <= 0) daysAhead += 7;
+    const target = startOfDay(now);
+    target.setDate(target.getDate() + daysAhead);
+    return target.getTime();
   }
   if (ISO_DATE_RE.test(raw)) {
     const d = /* @__PURE__ */ new Date(raw + "T00:00:00");
@@ -1641,7 +1643,7 @@ function parseDateStrict(value, flag) {
   try {
     return parseDate(value);
   } catch {
-    fail(`${flag} must be a date (ISO 8601, relative like +3d, or Unix ms), got "${value}"`);
+    fail(`${flag} must be a date (ISO 8601, relative like 3d or friday, or a Unix timestamp), got "${value}"`);
   }
 }
 function parseBoolStrict(value, flag) {
@@ -3091,7 +3093,7 @@ function registerGoalCommands(program, getClient) {
     if (!workspaceId) return;
     const client = getClient();
     const body = { name: opts.name };
-    if (opts.dueDate !== void 0) body["due_date"] = opts.dueDate;
+    if (opts.dueDate !== void 0) body["due_date"] = parseDateStrict(opts.dueDate, "--due-date");
     if (opts.description !== void 0) body["description"] = opts.description;
     if (opts.multipleOwners) body["multiple_owners"] = true;
     if (opts.owner.length) body["owners"] = opts.owner.map((id) => parseIntStrict(id, "--owner"));
@@ -3104,7 +3106,7 @@ function registerGoalCommands(program, getClient) {
     const client = getClient();
     const body = {};
     if (opts.name !== void 0) body["name"] = opts.name;
-    if (opts.dueDate !== void 0) body["due_date"] = opts.dueDate;
+    if (opts.dueDate !== void 0) body["due_date"] = parseDateStrict(opts.dueDate, "--due-date");
     if (opts.description !== void 0) body["description"] = opts.description;
     if (opts.color !== void 0) body["color"] = opts.color;
     await client.put(`/goal/${goalId}`, body);
@@ -4533,13 +4535,14 @@ function registerSkillCommands(program) {
     const outputOpts = getOutputOptions(program);
     const format = outputOpts.format ?? (process.stdout.isTTY ? "table" : "json");
     if (format === "json") {
-      const { frontmatter } = parseFrontmatter(result.content);
+      const { frontmatter, body } = parseFrontmatter(result.content);
       const output = {
         name: frontmatter["name"] || name,
         description: frontmatter["description"] || "",
         type: classifySkill(frontmatter),
         path: result.skillDir,
-        frontmatter
+        frontmatter,
+        content: body
       };
       process.stdout.write(JSON.stringify(output, null, 2) + "\n");
       return;
@@ -4626,7 +4629,7 @@ function registerChatCommands(program, getClient) {
 }
 
 // src/cli.ts
-var VERSION = "0.4.0";
+var VERSION = "0.4.2";
 function createProgram() {
   const program = new Command();
   program.name("clickup").description("ClickUp CLI - Manage ClickUp workspaces from the terminal").version(VERSION).option("--token <token>", "API token").option("--token-file <path>", "Read API token from this file path").option("--profile <name>", "Profile to use (key, workspace name, or nickname)").option("--workspace-id <id>", "Workspace ID").addOption(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clickup-agent-cli",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "CLI covering the entire ClickUp API v2 surface",
   "type": "module",
   "bin": {

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-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
 ```