@krodak/clickup-cli 0.13.1 → 0.13.2

package/README.md

@@ -201,6 +201,7 @@ cu update abc123 -n "New task name"
 cu update abc123 -d "Updated description with **markdown**"
 cu update abc123 --priority high
 cu update abc123 --due-date 2025-03-15
+cu update abc123 --assignee me
 cu update abc123 --assignee 12345
 cu update abc123 -n "New name" -s "done" --priority urgent
 cu update abc123 --time-estimate 2h
@@ -216,7 +217,7 @@ cu update abc123 -s "in progress" --json
 | `--priority <level>`         | Priority: `urgent`, `high`, `normal`, `low` (or 1-4)                        |
 | `--due-date <date>`          | Due date (`YYYY-MM-DD`)                                                     |
 | `--time-estimate <duration>` | Time estimate (e.g. `"2h"`, `"30m"`, `"1h30m"`)                             |
-| `--assignee <userId>`        | Add assignee by numeric user ID                                             |
+| `--assignee <userId>`        | Add assignee by user ID or `"me"`                                           |
 | `--parent <taskId>`          | Set parent task (makes this a subtask)                                      |
 | `--json`                     | Force JSON output even in terminal                                          |
 
@@ -229,7 +230,7 @@ cu create -n "Fix login bug" -l <listId>
 cu create -n "Subtask name" -p <parentTaskId>    # --list auto-detected
 cu create -n "Task" -l <listId> -d "desc" -s "open"
 cu create -n "Task" -l <listId> --priority high --due-date 2025-06-01
-cu create -n "Task" -l <listId> --assignee 12345 --tags "bug,frontend"
+cu create -n "Task" -l <listId> --assignee me --tags "bug,frontend"
 cu create -n "Initiative" -l <listId> --custom-item-id 1
 cu create -n "Task" -l <listId> --time-estimate 2h
 cu create -n "Fix bug" -l <listId> --json
@@ -245,7 +246,7 @@ cu create -n "Fix bug" -l <listId> --json
 | `--priority <level>`         | no               | Priority: `urgent`, `high`, `normal`, `low` (or 1-4) |
 | `--due-date <date>`          | no               | Due date (`YYYY-MM-DD`)                              |
 | `--time-estimate <duration>` | no               | Time estimate (e.g. `"2h"`, `"30m"`, `"1h30m"`)      |
-| `--assignee <userId>`        | no               | Assignee by numeric user ID                          |
+| `--assignee <userId>`        | no               | Assignee by user ID or `"me"`                        |
 | `--tags <tags>`              | no               | Comma-separated tag names                            |
 | `--custom-item-id <id>`      | no               | Custom task type ID (e.g. for creating initiatives)  |
 | `--json`                     | no               | Force JSON output even in terminal                   |

package/dist/index.js

@@ -4,72 +4,6 @@
 import { Command } from "commander";
 import { createRequire } from "module";
 
-// src/config.ts
-import fs from "fs";
-import { homedir } from "os";
-import { join } from "path";
-function configDir() {
-  const xdg = process.env.XDG_CONFIG_HOME;
-  if (xdg) return join(xdg, "cu");
-  return join(homedir(), ".config", "cu");
-}
-function configPath() {
-  return join(configDir(), "config.json");
-}
-function loadConfig() {
-  const envToken = process.env.CU_API_TOKEN?.trim();
-  const envTeamId = process.env.CU_TEAM_ID?.trim();
-  let fileToken;
-  let fileTeamId;
-  const path = configPath();
-  if (fs.existsSync(path)) {
-    const raw = fs.readFileSync(path, "utf-8");
-    let parsed;
-    try {
-      parsed = JSON.parse(raw);
-    } catch {
-      throw new Error(`Config file at ${path} contains invalid JSON. Please check the file syntax.`);
-    }
-    fileToken = parsed.apiToken?.trim();
-    fileTeamId = parsed.teamId?.trim();
-  }
-  const apiToken = envToken || fileToken;
-  if (!apiToken) {
-    throw new Error("Config missing required field: apiToken.\nSet CU_API_TOKEN or run: cu init");
-  }
-  if (!apiToken.startsWith("pk_")) {
-    throw new Error("Config apiToken must start with pk_. The configured token does not.");
-  }
-  const teamId = envTeamId || fileTeamId;
-  if (!teamId) {
-    throw new Error("Config missing required field: teamId.\nSet CU_TEAM_ID or run: cu init");
-  }
-  return { apiToken, teamId };
-}
-function loadRawConfig() {
-  const path = configPath();
-  if (!fs.existsSync(path)) return {};
-  try {
-    return JSON.parse(fs.readFileSync(path, "utf-8"));
-  } catch {
-    return {};
-  }
-}
-function getConfigPath() {
-  return configPath();
-}
-function writeConfig(config) {
-  const dir = configDir();
-  if (!fs.existsSync(dir)) {
-    fs.mkdirSync(dir, { recursive: true, mode: 448 });
-  }
-  const filePath = join(dir, "config.json");
-  fs.writeFileSync(filePath, JSON.stringify(config, null, 2) + "\n", {
-    encoding: "utf-8",
-    mode: 384
-  });
-}
-
 // src/api.ts
 var BASE_URL = "https://api.clickup.com/api/v2";
 var MAX_PAGES = 100;
@@ -261,6 +195,72 @@ var ClickUpClient = class {
   }
 };
 
+// src/config.ts
+import fs from "fs";
+import { homedir } from "os";
+import { join } from "path";
+function configDir() {
+  const xdg = process.env.XDG_CONFIG_HOME;
+  if (xdg) return join(xdg, "cu");
+  return join(homedir(), ".config", "cu");
+}
+function configPath() {
+  return join(configDir(), "config.json");
+}
+function loadConfig() {
+  const envToken = process.env.CU_API_TOKEN?.trim();
+  const envTeamId = process.env.CU_TEAM_ID?.trim();
+  let fileToken;
+  let fileTeamId;
+  const path = configPath();
+  if (fs.existsSync(path)) {
+    const raw = fs.readFileSync(path, "utf-8");
+    let parsed;
+    try {
+      parsed = JSON.parse(raw);
+    } catch {
+      throw new Error(`Config file at ${path} contains invalid JSON. Please check the file syntax.`);
+    }
+    fileToken = parsed.apiToken?.trim();
+    fileTeamId = parsed.teamId?.trim();
+  }
+  const apiToken = envToken || fileToken;
+  if (!apiToken) {
+    throw new Error("Config missing required field: apiToken.\nSet CU_API_TOKEN or run: cu init");
+  }
+  if (!apiToken.startsWith("pk_")) {
+    throw new Error("Config apiToken must start with pk_. The configured token does not.");
+  }
+  const teamId = envTeamId || fileTeamId;
+  if (!teamId) {
+    throw new Error("Config missing required field: teamId.\nSet CU_TEAM_ID or run: cu init");
+  }
+  return { apiToken, teamId };
+}
+function loadRawConfig() {
+  const path = configPath();
+  if (!fs.existsSync(path)) return {};
+  try {
+    return JSON.parse(fs.readFileSync(path, "utf-8"));
+  } catch {
+    return {};
+  }
+}
+function getConfigPath() {
+  return configPath();
+}
+function writeConfig(config) {
+  const dir = configDir();
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true, mode: 448 });
+  }
+  const filePath = join(dir, "config.json");
+  fs.writeFileSync(filePath, JSON.stringify(config, null, 2) + "\n", {
+    encoding: "utf-8",
+    mode: 384
+  });
+}
+
 // src/date.ts
 function formatDate(ms) {
   const d = new Date(Number(ms));
@@ -754,9 +754,16 @@ function parseDueDate(value) {
 }
 function parseAssigneeId(value) {
   const id = Number(value);
-  if (!Number.isInteger(id)) throw new Error("Assignee must be a numeric user ID");
+  if (!Number.isInteger(id)) throw new Error('Assignee must be a numeric user ID or "me"');
   return id;
 }
+async function resolveAssigneeId(client, value) {
+  if (value === "me") {
+    const user = await client.getMe();
+    return user.id;
+  }
+  return parseAssigneeId(value);
+}
 function parseTimeEstimate(value) {
   const pattern = /^(?:(\d+)h)?(?:(\d+)m)?$/i;
   const match = value.match(pattern);
@@ -1583,13 +1590,6 @@ function configPath2() {
 }
 
 // src/commands/assign.ts
-async function resolveUserId(client, value) {
-  if (value === "me") {
-    const user = await client.getMe();
-    return user.id;
-  }
-  return parseAssigneeId(value);
-}
 async function assignTask(config, taskId, opts) {
   if (!opts.to && !opts.remove) {
     throw new Error("Provide at least one of: --to, --remove");
@@ -1598,10 +1598,10 @@ async function assignTask(config, taskId, opts) {
   const add = [];
   const rem = [];
   if (opts.to) {
-    add.push(await resolveUserId(client, opts.to));
+    add.push(await resolveAssigneeId(client, opts.to));
   }
   if (opts.remove) {
-    rem.push(await resolveUserId(client, opts.remove));
+    rem.push(await resolveAssigneeId(client, opts.remove));
   }
   return client.updateTask(taskId, {
     assignees: {
@@ -2509,9 +2509,13 @@ program.command("task <taskId>").description("Get task details").option("--json"
     }
   })
 );
-program.command("update <taskId>").description("Update a task").option("-n, --name <text>", "New task name").option("-d, --description <text>", "New description (markdown supported)").option("-s, --status <status>", 'New status (e.g. "in progress", "done")').option("--priority <level>", "Priority: urgent, high, normal, low (or 1-4)").option("--due-date <date>", "Due date (YYYY-MM-DD)").option("--time-estimate <duration>", 'Time estimate (e.g. "2h", "30m", "1h30m")').option("--assignee <userId>", "Add assignee by user ID").option("--parent <taskId>", "Set parent task (makes this a subtask)").option("--json", "Force JSON output even in terminal").action(
+program.command("update <taskId>").description("Update a task").option("-n, --name <text>", "New task name").option("-d, --description <text>", "New description (markdown supported)").option("-s, --status <status>", 'New status (e.g. "in progress", "done")').option("--priority <level>", "Priority: urgent, high, normal, low (or 1-4)").option("--due-date <date>", "Due date (YYYY-MM-DD)").option("--time-estimate <duration>", 'Time estimate (e.g. "2h", "30m", "1h30m")').option("--assignee <userId>", 'Add assignee by user ID or "me"').option("--parent <taskId>", "Set parent task (makes this a subtask)").option("--json", "Force JSON output even in terminal").action(
   wrapAction(async (taskId, opts) => {
     const config = loadConfig();
+    if (opts.assignee === "me") {
+      const client = new ClickUpClient(config);
+      opts.assignee = String(await resolveAssigneeId(client, "me"));
+    }
     const payload = buildUpdatePayload(opts);
     const result = await updateTask(config, taskId, payload);
     if (shouldOutputJson(opts.json ?? false)) {
@@ -2521,9 +2525,13 @@ program.command("update <taskId>").description("Update a task").option("-n, --na
     }
   })
 );
-program.command("create").description("Create a new task").option("-l, --list <listId>", "Target list ID (auto-detected from --parent if omitted)").requiredOption("-n, --name <name>", "Task name").option("-d, --description <text>", "Task description (markdown supported)").option("-p, --parent <taskId>", "Parent task ID (list auto-detected from parent)").option("-s, --status <status>", "Initial status").option("--priority <level>", "Priority: urgent, high, normal, low (or 1-4)").option("--due-date <date>", "Due date (YYYY-MM-DD)").option("--assignee <userId>", "Assignee user ID").option("--tags <tags>", "Comma-separated tag names").option("--custom-item-id <id>", "Custom task type ID (use to create initiatives)").option("--time-estimate <duration>", 'Time estimate (e.g. "2h", "30m", "1h30m")').option("--json", "Force JSON output even in terminal").action(
+program.command("create").description("Create a new task").option("-l, --list <listId>", "Target list ID (auto-detected from --parent if omitted)").requiredOption("-n, --name <name>", "Task name").option("-d, --description <text>", "Task description (markdown supported)").option("-p, --parent <taskId>", "Parent task ID (list auto-detected from parent)").option("-s, --status <status>", "Initial status").option("--priority <level>", "Priority: urgent, high, normal, low (or 1-4)").option("--due-date <date>", "Due date (YYYY-MM-DD)").option("--assignee <userId>", 'Assignee user ID or "me"').option("--tags <tags>", "Comma-separated tag names").option("--custom-item-id <id>", "Custom task type ID (use to create initiatives)").option("--time-estimate <duration>", 'Time estimate (e.g. "2h", "30m", "1h30m")').option("--json", "Force JSON output even in terminal").action(
   wrapAction(async (opts) => {
     const config = loadConfig();
+    if (opts.assignee === "me") {
+      const client = new ClickUpClient(config);
+      opts.assignee = String(await resolveAssigneeId(client, "me"));
+    }
     const result = await createTask(config, opts);
     if (shouldOutputJson(opts.json ?? false)) {
       console.log(JSON.stringify(result, null, 2));

package/package.json

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

package/skills/clickup-cli/SKILL.md

@@ -55,19 +55,19 @@ All commands support `--help` for full flag details.
 
 ### Write
 
-| Command                                                                                                                                                                        | What it does                                |
-| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------- |
-| `cu update <id> [-n name] [-d desc] [-s status] [--priority p] [--due-date d] [--time-estimate t] [--assignee id] [--parent id] [--json]`                                      | Update task fields (desc supports markdown) |
-| `cu create -n name [-l listId] [-p parentId] [-d desc] [-s status] [--priority p] [--due-date d] [--time-estimate t] [--assignee id] [--tags t] [--custom-item-id n] [--json]` | Create task (desc supports markdown)        |
-| `cu comment <id> -m text [--json]`                                                                                                                                             | Post comment on task                        |
-| `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)           |
+| Command                                                                                                                                                                            | What it does                                |
+| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------- |
+| `cu update <id> [-n name] [-d desc] [-s status] [--priority p] [--due-date d] [--time-estimate t] [--assignee id\|me] [--parent id] [--json]`                                      | Update task fields (desc supports markdown) |
+| `cu create -n name [-l listId] [-p parentId] [-d desc] [-s status] [--priority p] [--due-date d] [--time-estimate t] [--assignee id\|me] [--tags t] [--custom-item-id n] [--json]` | Create task (desc supports markdown)        |
+| `cu comment <id> -m text [--json]`                                                                                                                                                 | Post comment on task                        |
+| `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
 
@@ -79,7 +79,7 @@ All commands support `--help` for full flag details.
 | `--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`)                                                       |
+| `--assignee`            | User ID or `me` (on `cu create`, `cu update`, `cu assign`)                                             |
 | `--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 for `cu create` (e.g. `1` for initiative)                                          |