@krodak/clickup-cli 0.9.1 → 0.11.0

package/README.md

@@ -98,7 +98,7 @@ When output is piped (no TTY), all commands output **Markdown** by default - opt
 
 ## Commands
 
-24 commands total. All support `--help` for full flag details.
+25 commands total. All support `--help` for full flag details.
 
 ### `cu init`
 
@@ -118,6 +118,7 @@ cu tasks --status "in progress"
 cu tasks --name "login"
 cu tasks --list <listId>
 cu tasks --space <spaceId>
+cu tasks --include-closed
 cu tasks --json
 ```
 
@@ -131,6 +132,7 @@ cu initiatives --status "to do"
 cu initiatives --name "auth"
 cu initiatives --list <listId>
 cu initiatives --space <spaceId>
+cu initiatives --include-closed
 cu initiatives --json
 ```
 
@@ -141,6 +143,7 @@ List my tasks in the currently active sprint (auto-detected from sprint folder d
 ```bash
 cu sprint
 cu sprint --status "in progress"
+cu sprint --include-closed
 cu sprint --json
 ```
 
@@ -159,6 +162,7 @@ All tasks assigned to me, grouped by pipeline stage (code review, in progress, t
 
 ```bash
 cu assigned
+cu assigned --status "in progress"
 cu assigned --include-closed
 cu assigned --json
 ```
@@ -190,6 +194,8 @@ List subtasks of a task or initiative.
 
 ```bash
 cu subtasks abc123
+cu subtasks abc123 --status "in progress"
+cu subtasks abc123 --name "auth"
 cu subtasks abc123 --include-closed
 cu subtasks abc123 --json
 ```
@@ -206,18 +212,20 @@ cu update abc123 --priority high
 cu update abc123 --due-date 2025-03-15
 cu update abc123 --assignee 12345
 cu update abc123 -n "New name" -s "done" --priority urgent
+cu update abc123 --time-estimate 2h
 cu update abc123 -s "in progress" --json
 ```
 
-| Flag                       | Description                                                                 |
-| -------------------------- | --------------------------------------------------------------------------- |
-| `-n, --name <text>`        | New task name                                                               |
-| `-d, --description <text>` | New description (markdown supported)                                        |
-| `-s, --status <status>`    | New status, supports fuzzy matching (e.g. `"prog"` matches `"in progress"`) |
-| `--priority <level>`       | Priority: `urgent`, `high`, `normal`, `low` (or 1-4)                        |
-| `--due-date <date>`        | Due date (`YYYY-MM-DD`)                                                     |
-| `--assignee <userId>`      | Add assignee by numeric user ID                                             |
-| `--json`                   | Force JSON output even in terminal                                          |
+| Flag                         | Description                                                                 |
+| ---------------------------- | --------------------------------------------------------------------------- |
+| `-n, --name <text>`          | New task name                                                               |
+| `-d, --description <text>`   | New description (markdown supported)                                        |
+| `-s, --status <status>`      | New status, supports fuzzy matching (e.g. `"prog"` matches `"in progress"`) |
+| `--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                                             |
+| `--json`                     | Force JSON output even in terminal                                          |
 
 ### `cu create`
 
@@ -229,21 +237,25 @@ 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 "Initiative" -l <listId> --custom-item-id 1
+cu create -n "Task" -l <listId> --time-estimate 2h
 cu create -n "Fix bug" -l <listId> --json
 ```
 
-| Flag                       | Required         | Description                                          |
-| -------------------------- | ---------------- | ---------------------------------------------------- |
-| `-n, --name <name>`        | yes              | Task name                                            |
-| `-l, --list <listId>`      | if no `--parent` | Target list ID                                       |
-| `-p, --parent <taskId>`    | no               | Parent task (list auto-detected)                     |
-| `-d, --description <text>` | no               | Description (markdown)                               |
-| `-s, --status <status>`    | no               | Initial status                                       |
-| `--priority <level>`       | no               | Priority: `urgent`, `high`, `normal`, `low` (or 1-4) |
-| `--due-date <date>`        | no               | Due date (`YYYY-MM-DD`)                              |
-| `--assignee <userId>`      | no               | Assignee by numeric user ID                          |
-| `--tags <tags>`            | no               | Comma-separated tag names                            |
-| `--json`                   | no               | Force JSON output even in terminal                   |
+| Flag                         | Required         | Description                                          |
+| ---------------------------- | ---------------- | ---------------------------------------------------- |
+| `-n, --name <name>`          | yes              | Task name                                            |
+| `-l, --list <listId>`        | if no `--parent` | Target list ID                                       |
+| `-p, --parent <taskId>`      | no               | Parent task (list auto-detected)                     |
+| `-d, --description <text>`   | no               | Description (markdown)                               |
+| `-s, --status <status>`      | no               | Initial status                                       |
+| `--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                          |
+| `--tags <tags>`              | no               | Comma-separated tag names                            |
+| `--custom-item-id <id>`      | no               | Custom task type ID (for creating initiatives)       |
+| `--json`                     | no               | Force JSON output even in terminal                   |
 
 ### `cu comment <id>`
 
@@ -324,6 +336,7 @@ cu search "login bug"
 cu search auth
 cu search "payment flow" --json
 cu search auth --status "prog"     # fuzzy matches "in progress"
+cu search "old task" --include-closed
 ```
 
 ### `cu summary`
@@ -368,6 +381,25 @@ cu assign abc123 --to me --json
 | `--remove <userId>` | Remove assignee (user ID or `me`) |
 | `--json`            | Force JSON output                 |
 
+### `cu depend <id>`
+
+Add or remove task dependencies. Set a task as waiting on or blocking another task.
+
+```bash
+cu depend abc123 --on def456          # abc123 depends on (waits for) def456
+cu depend abc123 --blocks def456      # abc123 blocks def456
+cu depend abc123 --on def456 --remove # remove the dependency
+cu depend abc123 --blocks def456 --remove
+cu depend abc123 --on def456 --json
+```
+
+| Flag                | Description                                 |
+| ------------------- | ------------------------------------------- |
+| `--on <taskId>`     | Task that this task depends on (waiting on) |
+| `--blocks <taskId>` | Task that this task blocks                  |
+| `--remove`          | Remove the dependency instead of adding it  |
+| `--json`            | Force JSON output                           |
+
 ### `cu auth`
 
 Check authentication status. Validates your API token and shows your user info.

package/dist/index.js

@@ -223,6 +223,23 @@ var ClickUpClient = class {
   async getViewTasks(viewId) {
     return this.paginate((page) => `/view/${viewId}/task?page=${page}`);
   }
+  async addDependency(taskId, opts) {
+    const body = {};
+    if (opts.dependsOn) body.depends_on = opts.dependsOn;
+    if (opts.dependencyOf) body.dependency_of = opts.dependencyOf;
+    await this.request(`/task/${taskId}/dependency`, {
+      method: "POST",
+      body: JSON.stringify(body)
+    });
+  }
+  async deleteDependency(taskId, opts) {
+    const params = new URLSearchParams();
+    if (opts.dependsOn) params.set("depends_on", opts.dependsOn);
+    if (opts.dependencyOf) params.set("dependency_of", opts.dependencyOf);
+    await this.request(`/task/${taskId}/dependency?${params.toString()}`, {
+      method: "DELETE"
+    });
+  }
 };
 
 // src/output.ts
@@ -680,6 +697,18 @@ function parseAssigneeId(value) {
   if (!Number.isInteger(id)) throw new Error("Assignee must be a numeric user ID");
   return id;
 }
+function parseTimeEstimate(value) {
+  const pattern = /^(?:(\d+)h)?(?:(\d+)m)?$/i;
+  const match = value.match(pattern);
+  if (match && (match[1] || match[2])) {
+    const hours = Number(match[1] ?? 0);
+    const minutes = Number(match[2] ?? 0);
+    return (hours * 60 + minutes) * 60 * 1e3;
+  }
+  const ms = Number(value);
+  if (Number.isFinite(ms) && ms > 0) return ms;
+  throw new Error('Time estimate must be a duration (e.g. "2h", "30m", "1h30m") or milliseconds');
+}
 function buildUpdatePayload(opts) {
   const payload = {};
   if (opts.name !== void 0) payload.name = opts.name;
@@ -693,10 +722,13 @@ function buildUpdatePayload(opts) {
   if (opts.assignee !== void 0) {
     payload.assignees = { add: [parseAssigneeId(opts.assignee)] };
   }
+  if (opts.timeEstimate !== void 0) {
+    payload.time_estimate = parseTimeEstimate(opts.timeEstimate);
+  }
   return payload;
 }
 function hasUpdateFields(options) {
-  return options.name !== void 0 || options.description !== void 0 || options.status !== void 0 || options.priority !== void 0 || options.due_date !== void 0 || options.assignees !== void 0;
+  return options.name !== void 0 || options.description !== void 0 || options.status !== void 0 || options.priority !== void 0 || options.due_date !== void 0 || options.time_estimate !== void 0 || options.assignees !== void 0;
 }
 async function resolveStatus(client, taskId, statusInput) {
   const task = await client.getTask(taskId);
@@ -716,7 +748,7 @@ async function resolveStatus(client, taskId, statusInput) {
 async function updateTask(config, taskId, options) {
   if (!hasUpdateFields(options))
     throw new Error(
-      "Provide at least one of: --name, --description, --status, --priority, --due-date, --assignee"
+      "Provide at least one of: --name, --description, --status, --priority, --due-date, --time-estimate, --assignee"
     );
   const client = new ClickUpClient(config);
   if (options.status !== void 0) {
@@ -756,6 +788,15 @@ async function createTask(config, options) {
   if (options.tags !== void 0) {
     payload.tags = options.tags.split(",").map((t) => t.trim());
   }
+  if (options.customItemId !== void 0) {
+    const id = Number(options.customItemId);
+    if (!Number.isInteger(id) || id < 0)
+      throw new Error("Custom item ID must be a non-negative integer");
+    payload.custom_item_id = id;
+  }
+  if (options.timeEstimate !== void 0) {
+    payload.time_estimate = parseTimeEstimate(options.timeEstimate);
+  }
   const task = await client.createTask(listId, payload);
   return { id: task.id, name: task.name, url: task.url };
 }
@@ -893,7 +934,10 @@ async function runSprintCommand(config, opts) {
   } else {
     allTasks = await client.getTasksFromList(activeList.id);
   }
-  const sprintTasks = allTasks.filter((t) => t.assignees.some((a) => Number(a.id) === me.id));
+  let sprintTasks = allTasks.filter((t) => t.assignees.some((a) => Number(a.id) === me.id));
+  if (!opts.includeClosed) {
+    sprintTasks = sprintTasks.filter((t) => !isDoneStatus(t.status.status));
+  }
   const filtered = opts.status ? sprintTasks.filter((t) => t.status.status.toLowerCase() === opts.status.toLowerCase()) : sprintTasks;
   const summaries = filtered.map(summarize);
   await printTasks(summaries, opts.json ?? false, config);
@@ -956,7 +1000,7 @@ async function listSprints(config, opts = {}) {
     const lists = listsByFolder[i];
     allSprints.push(...buildSprintInfos(lists, folder.name, today));
   }
-  if (opts.json || !isTTY()) {
+  if (shouldOutputJson(opts.json ?? false)) {
     console.log(JSON.stringify(allSprints, null, 2));
     return;
   }
@@ -973,6 +1017,15 @@ async function listSprints(config, opts = {}) {
       dates: dateStr
     };
   });
+  if (!isTTY()) {
+    const mdColumns = [
+      { key: "id", label: "ID" },
+      { key: "sprint", label: "Sprint" },
+      { key: "dates", label: "Dates" }
+    ];
+    console.log(formatMarkdownTable(rows, mdColumns));
+    return;
+  }
   console.log(formatTable(rows, SPRINT_COLUMNS));
 }
 
@@ -1190,6 +1243,8 @@ async function listSpaces(config, opts) {
     console.log(JSON.stringify(spaces, null, 2));
   } else if (!isTTY()) {
     console.log(formatSpacesMarkdown(spaces.map((s) => ({ id: s.id, name: s.name }))));
+  } else if (spaces.length === 0) {
+    console.log("No spaces found.");
   } else {
     const table = formatTable(
       spaces.map((s) => ({ id: s.id, name: s.name })),
@@ -1254,7 +1309,11 @@ async function runAssignedCommand(config, opts) {
   const allTasks = await client.getMyTasks(config.teamId, {
     includeClosed: opts.includeClosed
   });
-  const groups = groupByStatus(allTasks, opts.includeClosed ?? false);
+  let groups = groupByStatus(allTasks, opts.includeClosed ?? false);
+  if (opts.status) {
+    const lower = opts.status.toLowerCase();
+    groups = groups.filter((g) => g.status.toLowerCase() === lower);
+  }
   if (shouldOutputJson(opts.json ?? false)) {
     const result = {};
     for (const group of groups) {
@@ -1511,10 +1570,20 @@ async function fetchActivity(config, taskId) {
   return { task, comments };
 }
 function printActivity(result, forceJson) {
-  if (forceJson || !isTTY()) {
+  if (shouldOutputJson(forceJson)) {
     console.log(JSON.stringify(result, null, 2));
     return;
   }
+  if (!isTTY()) {
+    const taskMd = formatTaskDetailMarkdown(result.task);
+    const commentsMd = formatCommentsMarkdown(result.comments);
+    console.log(`${taskMd}
+
+## Comments
+
+${commentsMd}`);
+    return;
+  }
   console.log(formatTaskDetail(result.task));
   console.log("");
   console.log(chalk4.bold("Comments"));
@@ -1957,7 +2026,9 @@ async function searchTasks(config, query, opts = {}) {
     throw new Error("Search query cannot be empty");
   }
   const client = new ClickUpClient(config);
-  const allTasks = await client.getMyTasks(config.teamId);
+  const allTasks = await client.getMyTasks(config.teamId, {
+    includeClosed: opts.includeClosed
+  });
   const words = trimmed.toLowerCase().split(/\s+/);
   let matched = allTasks.filter((task) => {
     const name = task.name.toLowerCase();
@@ -1979,6 +2050,31 @@ async function searchTasks(config, query, opts = {}) {
   return matched.map(summarize);
 }
 
+// src/commands/depend.ts
+async function manageDependency(config, taskId, opts) {
+  if (!opts.on && !opts.blocks) {
+    throw new Error("Provide --on <taskId> or --blocks <taskId>");
+  }
+  if (opts.on && opts.blocks) {
+    throw new Error("Provide only one of --on or --blocks per invocation");
+  }
+  const client = new ClickUpClient(config);
+  if (opts.remove) {
+    await client.deleteDependency(taskId, {
+      dependsOn: opts.on,
+      dependencyOf: opts.blocks
+    });
+    if (opts.on) return `Removed dependency: ${taskId} no longer depends on ${opts.on}`;
+    return `Removed dependency: ${taskId} no longer blocks ${opts.blocks}`;
+  }
+  await client.addDependency(taskId, {
+    dependsOn: opts.on,
+    dependencyOf: opts.blocks
+  });
+  if (opts.on) return `Added dependency: ${taskId} depends on ${opts.on}`;
+  return `Added dependency: ${taskId} blocks ${opts.blocks}`;
+}
+
 // src/index.ts
 var require2 = createRequire(import.meta.url);
 var { version } = require2("../package.json");
@@ -2001,17 +2097,16 @@ program.command("auth").description("Validate API token and show current user").
   wrapAction(async (opts) => {
     const config = loadConfig();
     const result = await checkAuth(config);
-    if (opts.json || !isTTY()) {
+    if (shouldOutputJson(opts.json ?? false)) {
       console.log(JSON.stringify(result, null, 2));
     } else if (result.authenticated && result.user) {
       console.log(`Authenticated as @${result.user.username} (id: ${result.user.id})`);
     } else {
-      console.error(`Authentication failed: ${result.error ?? "unknown error"}`);
-      process.exit(1);
+      throw new Error(`Authentication failed: ${result.error ?? "unknown error"}`);
     }
   })
 );
-program.command("tasks").description("List tasks assigned to me").option("--status <status>", 'Filter by status (e.g. "in progress")').option("--list <listId>", "Filter by list ID").option("--space <spaceId>", "Filter by space ID").option("--name <partial>", "Filter by name (case-insensitive contains)").option("--json", "Force JSON output even in terminal").action(
+program.command("tasks").description("List tasks assigned to me").option("--status <status>", 'Filter by status (e.g. "in progress")').option("--list <listId>", "Filter by list ID").option("--space <spaceId>", "Filter by space ID").option("--name <partial>", "Filter by name (case-insensitive contains)").option("--include-closed", "Include done/closed tasks").option("--json", "Force JSON output even in terminal").action(
   wrapAction(async (opts) => {
     const config = loadConfig();
     const tasks = await fetchMyTasks(config, {
@@ -2019,12 +2114,13 @@ program.command("tasks").description("List tasks assigned to me").option("--stat
       statuses: opts.status ? [opts.status] : void 0,
       listIds: opts.list ? [opts.list] : void 0,
       spaceIds: opts.space ? [opts.space] : void 0,
-      name: opts.name
+      name: opts.name,
+      includeClosed: opts.includeClosed
     });
     await printTasks(tasks, opts.json ?? false, config);
   })
 );
-program.command("initiatives").description("List initiatives assigned to me").option("--status <status>", "Filter by status").option("--list <listId>", "Filter by list ID").option("--space <spaceId>", "Filter by space ID").option("--name <partial>", "Filter by name (case-insensitive contains)").option("--json", "Force JSON output even in terminal").action(
+program.command("initiatives").description("List initiatives assigned to me").option("--status <status>", "Filter by status").option("--list <listId>", "Filter by list ID").option("--space <spaceId>", "Filter by space ID").option("--name <partial>", "Filter by name (case-insensitive contains)").option("--include-closed", "Include done/closed tasks").option("--json", "Force JSON output even in terminal").action(
   wrapAction(async (opts) => {
     const config = loadConfig();
     const tasks = await fetchMyTasks(config, {
@@ -2032,7 +2128,8 @@ program.command("initiatives").description("List initiatives assigned to me").op
       statuses: opts.status ? [opts.status] : void 0,
       listIds: opts.list ? [opts.list] : void 0,
       spaceIds: opts.space ? [opts.space] : void 0,
-      name: opts.name
+      name: opts.name,
+      includeClosed: opts.includeClosed
     });
     await printTasks(tasks, opts.json ?? false, config);
   })
@@ -2050,34 +2147,36 @@ 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("--assignee <userId>", "Add assignee by user ID").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").option("--json", "Force JSON output even in terminal").action(
   wrapAction(async (taskId, opts) => {
     const config = loadConfig();
     const payload = buildUpdatePayload(opts);
     const result = await updateTask(config, taskId, payload);
-    if (shouldOutputJson(false)) {
+    if (shouldOutputJson(opts.json ?? false)) {
       console.log(JSON.stringify(result, null, 2));
     } else {
       console.log(formatUpdateConfirmation(result.id, result.name));
     }
   })
 );
-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").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("--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").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(
   wrapAction(async (opts) => {
     const config = loadConfig();
     const result = await createTask(config, opts);
-    if (shouldOutputJson(false)) {
+    if (shouldOutputJson(opts.json ?? false)) {
       console.log(JSON.stringify(result, null, 2));
     } else {
       console.log(formatCreateConfirmation(result.id, result.name, result.url));
     }
   })
 );
-program.command("sprint").description("List my tasks in the current active sprint (auto-detected)").option("--status <status>", "Filter by status").option("--space <nameOrId>", "Narrow sprint search to a specific space (partial name or ID)").option("--json", "Force JSON output even in terminal").action(
-  wrapAction(async (opts) => {
-    const config = loadConfig();
-    await runSprintCommand(config, opts);
-  })
+program.command("sprint").description("List my tasks in the current active sprint (auto-detected)").option("--status <status>", "Filter by status").option("--space <nameOrId>", "Narrow sprint search to a specific space (partial name or ID)").option("--include-closed", "Include done/closed tasks").option("--json", "Force JSON output even in terminal").action(
+  wrapAction(
+    async (opts) => {
+      const config = loadConfig();
+      await runSprintCommand(config, opts);
+    }
+  )
 );
 program.command("sprints").description("List all sprints in sprint folders").option("--space <nameOrId>", "Filter by space (partial name or ID)").option("--json", "Force JSON output even in terminal").action(
   wrapAction(async (opts) => {
@@ -2085,18 +2184,28 @@ program.command("sprints").description("List all sprints in sprint folders").opt
     await listSprints(config, opts);
   })
 );
-program.command("subtasks <taskId>").description("List subtasks of a task or initiative").option("--include-closed", "Include closed/done subtasks").option("--json", "Force JSON output even in terminal").action(
-  wrapAction(async (taskId, opts) => {
-    const config = loadConfig();
-    const tasks = await fetchSubtasks(config, taskId, { includeClosed: opts.includeClosed });
-    await printTasks(tasks, opts.json ?? false, config);
-  })
+program.command("subtasks <taskId>").description("List subtasks of a task or initiative").option("--status <status>", "Filter by status").option("--name <partial>", "Filter by name (case-insensitive contains)").option("--include-closed", "Include closed/done subtasks").option("--json", "Force JSON output even in terminal").action(
+  wrapAction(
+    async (taskId, opts) => {
+      const config = loadConfig();
+      let tasks = await fetchSubtasks(config, taskId, { includeClosed: opts.includeClosed });
+      if (opts.status) {
+        const lower = opts.status.toLowerCase();
+        tasks = tasks.filter((t) => t.status.toLowerCase() === lower);
+      }
+      if (opts.name) {
+        const query = opts.name.toLowerCase();
+        tasks = tasks.filter((t) => t.name.toLowerCase().includes(query));
+      }
+      await printTasks(tasks, opts.json ?? false, config);
+    }
+  )
 );
-program.command("comment <taskId>").description("Post a comment on a task").requiredOption("-m, --message <text>", "Comment text").action(
+program.command("comment <taskId>").description("Post a comment on a task").requiredOption("-m, --message <text>", "Comment text").option("--json", "Force JSON output even in terminal").action(
   wrapAction(async (taskId, opts) => {
     const config = loadConfig();
     const result = await postComment(config, taskId, opts.message);
-    if (shouldOutputJson(false)) {
+    if (shouldOutputJson(opts.json ?? false)) {
       console.log(JSON.stringify(result, null, 2));
     } else {
       console.log(formatCommentConfirmation(result.id));
@@ -2135,14 +2244,13 @@ program.command("inbox").description("Recently updated tasks grouped by time per
     const config = loadConfig();
     const days = Number(opts.days ?? 30);
     if (!Number.isFinite(days) || days <= 0) {
-      console.error("Error: --days must be a positive number");
-      process.exit(1);
+      throw new Error("--days must be a positive number");
     }
     const tasks = await fetchInbox(config, days);
     await printInbox(tasks, opts.json ?? false, config);
   })
 );
-program.command("assigned").description("Show all tasks assigned to me, grouped by status").option("--include-closed", "Include done/closed tasks").option("--json", "Force JSON output even in terminal").action(
+program.command("assigned").description("Show all tasks assigned to me, grouped by status").option("--status <status>", "Show only tasks with this status").option("--include-closed", "Include done/closed tasks").option("--json", "Force JSON output even in terminal").action(
   wrapAction(async (opts) => {
     const config = loadConfig();
     await runAssignedCommand(config, opts);
@@ -2154,20 +2262,24 @@ program.command("open <query>").description("Open a task in the browser by ID or
     await openTask(config, query, opts);
   })
 );
-program.command("search <query>").description("Search my tasks by name").option("--status <status>", "Filter by status").option("--json", "Force JSON output even in terminal").action(
-  wrapAction(async (query, opts) => {
-    const config = loadConfig();
-    const tasks = await searchTasks(config, query, { status: opts.status });
-    await printTasks(tasks, opts.json ?? false, config);
-  })
+program.command("search <query>").description("Search my tasks by name").option("--status <status>", "Filter by status").option("--include-closed", "Include done/closed tasks in search").option("--json", "Force JSON output even in terminal").action(
+  wrapAction(
+    async (query, opts) => {
+      const config = loadConfig();
+      const tasks = await searchTasks(config, query, {
+        status: opts.status,
+        includeClosed: opts.includeClosed
+      });
+      await printTasks(tasks, opts.json ?? false, config);
+    }
+  )
 );
 program.command("summary").description("Daily standup summary: completed, in-progress, overdue").option("--hours <n>", "Completed-tasks lookback in hours", "24").option("--json", "Force JSON output even in terminal").action(
   wrapAction(async (opts) => {
     const config = loadConfig();
     const hours = Number(opts.hours ?? 24);
     if (!Number.isFinite(hours) || hours <= 0) {
-      console.error("Error: --hours must be a positive number");
-      process.exit(1);
+      throw new Error("--hours must be a positive number");
     }
     await runSummaryCommand(config, { hours, json: opts.json ?? false });
   })
@@ -2190,6 +2302,17 @@ program.command("assign <taskId>").description("Assign or unassign users from a
     }
   })
 );
+program.command("depend <taskId>").description("Add or remove task dependencies").option("--on <taskId>", "Task that this task depends on (waiting on)").option("--blocks <taskId>", "Task that this task blocks").option("--remove", "Remove the dependency instead of adding it").option("--json", "Force JSON output even in terminal").action(
+  wrapAction(async (taskId, opts) => {
+    const config = loadConfig();
+    const message = await manageDependency(config, taskId, opts);
+    if (shouldOutputJson(opts.json ?? false)) {
+      console.log(JSON.stringify({ taskId, ...opts, message }, null, 2));
+    } else {
+      console.log(message);
+    }
+  })
+);
 var configCmd = program.command("config").description("Manage CLI configuration");
 configCmd.command("get <key>").description("Print a config value").action(
   wrapAction(async (key) => {

package/package.json

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

package/skills/clickup-cli/SKILL.md

@@ -34,62 +34,66 @@ All commands support `--help` for full flag details.
 
 ### Read
 
-| Command                                                                    | What it returns                                    |
-| -------------------------------------------------------------------------- | -------------------------------------------------- |
-| `cu tasks [--status s] [--name q] [--list id] [--space id] [--json]`       | My tasks (workspace-wide)                          |
-| `cu initiatives [--status s] [--name q] [--list id] [--space id] [--json]` | My initiatives                                     |
-| `cu assigned [--include-closed] [--json]`                                  | All my tasks grouped by status                     |
-| `cu sprint [--status s] [--space nameOrId] [--json]`                       | Tasks in active sprint (auto-detected)             |
-| `cu sprints [--space nameOrId] [--json]`                                   | List all sprints (marks active with \*)            |
-| `cu search <query> [--status s] [--json]`                                  | Search my tasks by name (multi-word, fuzzy status) |
-| `cu task <id> [--json]`                                                    | Single task details                                |
-| `cu subtasks <id> [--include-closed] [--json]`                             | Subtasks of a task or initiative                   |
-| `cu comments <id> [--json]`                                                | Comments on a task                                 |
-| `cu activity <id> [--json]`                                                | Task details + comment history combined            |
-| `cu inbox [--days n] [--json]`                                             | Tasks updated in last n days (default 30)          |
-| `cu summary [--hours n] [--json]`                                          | Standup helper: completed, in-progress, overdue    |
-| `cu overdue [--json]`                                                      | Tasks past their due date                          |
-| `cu spaces [--name partial] [--my] [--json]`                               | List/filter workspace spaces                       |
-| `cu lists <spaceId> [--name partial] [--json]`                             | Lists in a space (including folder lists)          |
-| `cu open <query> [--json]`                                                 | Open task in browser by ID or name                 |
-| `cu auth [--json]`                                                         | Check authentication status                        |
+| Command                                                                                       | What it returns                                    |
+| --------------------------------------------------------------------------------------------- | -------------------------------------------------- |
+| `cu tasks [--status s] [--name q] [--list id] [--space id] [--include-closed] [--json]`       | My tasks (workspace-wide)                          |
+| `cu initiatives [--status s] [--name q] [--list id] [--space id] [--include-closed] [--json]` | My initiatives                                     |
+| `cu assigned [--status s] [--include-closed] [--json]`                                        | All my tasks grouped by status                     |
+| `cu sprint [--status s] [--space nameOrId] [--include-closed] [--json]`                       | Tasks in active sprint (auto-detected)             |
+| `cu sprints [--space nameOrId] [--json]`                                                      | List all sprints (marks active with \*)            |
+| `cu search <query> [--status s] [--include-closed] [--json]`                                  | Search my tasks by name (multi-word, fuzzy status) |
+| `cu task <id> [--json]`                                                                       | Single task details                                |
+| `cu subtasks <id> [--status s] [--name q] [--include-closed] [--json]`                        | Subtasks of a task or initiative                   |
+| `cu comments <id> [--json]`                                                                   | Comments on a task                                 |
+| `cu activity <id> [--json]`                                                                   | Task details + comment history combined            |
+| `cu inbox [--days n] [--json]`                                                                | Tasks updated in last n days (default 30)          |
+| `cu summary [--hours n] [--json]`                                                             | Standup helper: completed, in-progress, overdue    |
+| `cu overdue [--json]`                                                                         | Tasks past their due date                          |
+| `cu spaces [--name partial] [--my] [--json]`                                                  | List/filter workspace spaces                       |
+| `cu lists <spaceId> [--name partial] [--json]`                                                | Lists in a space (including folder lists)          |
+| `cu open <query> [--json]`                                                                    | Open task in browser by ID or name                 |
+| `cu auth [--json]`                                                                            | Check authentication status                        |
 
 ### Write
 
-| Command                                                                                                                               | What it does                                 |
-| ------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- |
-| `cu update <id> [-n name] [-d desc] [-s status] [--priority p] [--due-date d] [--assignee id] [--json]`                               | Update task fields                           |
-| `cu create -n name [-l listId] [-p parentId] [-d desc] [-s status] [--priority p] [--due-date d] [--assignee id] [--tags t] [--json]` | Create task (list auto-detected from parent) |
-| `cu comment <id> -m text`                                                                                                             | Post comment on task                         |
-| `cu assign <id> [--to userId\|me] [--remove userId\|me] [--json]`                                                                     | Assign/unassign users                        |
-| `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] [--json]`                                                    | Update task fields                           |
+| `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 (list auto-detected from parent) |
+| `cu comment <id> -m text`                                                                                                                                                      | 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 config get <key>` / `cu config set <key> <value>` / `cu config path`                                                                                                       | Manage CLI config                            |
+| `cu completion <shell>`                                                                                                                                                        | Shell completions (bash/zsh/fish)            |
 
 ## Quick Reference
 
-| Topic               | Detail                                                                            |
-| ------------------- | --------------------------------------------------------------------------------- |
-| Task IDs            | Stable alphanumeric strings (e.g. `abc123def`)                                    |
-| Initiatives         | Detected via `custom_item_id !== 0`                                               |
-| `--list` on create  | Optional when `--parent` is given (auto-detected)                                 |
-| `--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`)                                  |
-| `--tags`            | Comma-separated (e.g. `--tags "bug,frontend"`)                                    |
-| `--space`           | Partial name match or exact ID                                                    |
-| `--name`            | Partial match, case-insensitive                                                   |
-| `--include-closed`  | Include closed/done tasks (on `subtasks` and `assigned`)                          |
-| `cu assign --to me` | Shorthand for your own user ID                                                    |
-| `cu search`         | Matches all query words against task name, case-insensitive                       |
-| `cu sprint`         | Auto-detects active sprint via view API and date range parsing                    |
-| `cu summary`        | Categories: completed (done/complete/closed within N hours), in progress, overdue |
-| `cu overdue`        | Excludes closed tasks, sorted most overdue first                                  |
-| `cu open`           | Tries task ID first, falls back to name search                                    |
-| `cu task`           | Shows custom fields in detail view                                                |
-| `cu lists`          | Discovers list IDs needed for `--list` and `cu create -l`                         |
-| Errors              | stderr with exit code 1                                                           |
-| Parsing             | Strict - excess/unknown arguments rejected                                        |
+| Topic               | Detail                                                                                            |
+| ------------------- | ------------------------------------------------------------------------------------------------- |
+| Task IDs            | Stable alphanumeric strings (e.g. `abc123def`)                                                    |
+| Initiatives         | Detected via `custom_item_id !== 0`                                                               |
+| `--list` on create  | Optional when `--parent` is given (auto-detected)                                                 |
+| `--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`)                                                  |
+| `--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 (e.g. `1` for initiative)                                                     |
+| `--on` / `--blocks` | Task dependency direction (used with `cu depend`)                                                 |
+| `--space`           | Partial name match or exact ID                                                                    |
+| `--name`            | Partial match, case-insensitive                                                                   |
+| `--include-closed`  | Include closed/done tasks (on `tasks`, `initiatives`, `assigned`, `subtasks`, `sprint`, `search`) |
+| `cu assign --to me` | Shorthand for your own user ID                                                                    |
+| `cu search`         | Matches all query words against task name, case-insensitive                                       |
+| `cu sprint`         | Auto-detects active sprint via view API and date range parsing                                    |
+| `cu summary`        | Categories: completed (done/complete/closed within N hours), in progress, overdue                 |
+| `cu overdue`        | Excludes closed tasks, sorted most overdue first                                                  |
+| `cu open`           | Tries task ID first, falls back to name search                                                    |
+| `cu task`           | Shows custom fields in detail view                                                                |
+| `cu lists`          | Discovers list IDs needed for `--list` and `cu create -l`                                         |
+| Errors              | stderr with exit code 1                                                                           |
+| Parsing             | Strict - excess/unknown arguments rejected                                                        |
 
 ## Agent Workflow Examples
 
@@ -121,10 +125,14 @@ cu inbox --days 7                   # recently updated
 ```bash
 cu update abc123def -s "done"
 cu update abc123def --priority high --due-date 2025-03-15
+cu update abc123def --time-estimate 2h
 cu create -n "Fix the thing" -p abc123def
 cu create -n "Fix bug" -l <listId> --priority urgent --tags "bug,frontend"
+cu create -n "Q3 Roadmap" -l <listId> --custom-item-id 1  # create initiative
 cu comment abc123def -m "Completed in PR #42"
 cu assign abc123def --to me
+cu depend task3 --on task2            # task3 waits for task2
+cu depend task1 --blocks task2        # task1 blocks task2
 ```
 
 ### Discover workspace structure