@krodak/clickup-cli 0.11.1 → 0.12.1

package/README.md

@@ -98,7 +98,7 @@ When output is piped (no TTY), all commands output **Markdown** by default - opt
 
 ## Commands
 
-25 commands total. All support `--help` for full flag details.
+27 commands total. All support `--help` for full flag details.
 
 ### `cu init`
 
@@ -153,6 +153,7 @@ List all sprints across sprint folders. Marks the currently active sprint.
 
 ```bash
 cu sprints
+cu sprints --space "Engineering"
 cu sprints --json
 ```
 
@@ -174,6 +175,7 @@ Tasks assigned to me that were recently updated, grouped by time period (today,
 ```bash
 cu inbox
 cu inbox --days 7
+cu inbox --include-closed
 cu inbox --json
 ```
 
@@ -213,6 +215,7 @@ 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 --parent parentTaskId   # make it a subtask
 cu update abc123 -s "in progress" --json
 ```
 
@@ -225,6 +228,7 @@ cu update abc123 -s "in progress" --json
 | `--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                                             |
+| `--parent <taskId>`          | Set parent task (makes this a subtask)                                      |
 | `--json`                     | Force JSON output even in terminal                                          |
 
 ### `cu create`
@@ -263,6 +267,7 @@ Post a comment on a task.
 
 ```bash
 cu comment abc123 -m "Addressed in PR #42"
+cu comment abc123 -m "Done" --json
 ```
 
 ### `cu comments <id>`
@@ -309,11 +314,11 @@ cu spaces --my
 cu spaces --json
 ```
 
-| Flag               | Description                         |
-| ------------------ | ----------------------------------- |
-| `--name <partial>` | Filter spaces by partial name match |
-| `--my`             | Show only spaces you belong to      |
-| `--json`           | Force JSON output                   |
+| Flag               | Description                                  |
+| ------------------ | -------------------------------------------- |
+| `--name <partial>` | Filter spaces by partial name match          |
+| `--my`             | Show only spaces where I have assigned tasks |
+| `--json`           | Force JSON output                            |
 
 ### `cu open <query>`
 
@@ -356,10 +361,11 @@ cu summary --json
 
 ### `cu overdue`
 
-List tasks that are past their due date (excludes done/closed tasks). Sorted most overdue first.
+List tasks that are past their due date (excludes done/closed tasks by default). Sorted most overdue first.
 
 ```bash
 cu overdue
+cu overdue --include-closed
 cu overdue --json
 ```
 
@@ -400,6 +406,23 @@ cu depend abc123 --on def456 --json
 | `--remove`          | Remove the dependency instead of adding it  |
 | `--json`            | Force JSON output                           |
 
+### `cu move <id>`
+
+Add or remove a task from a list. Tasks can belong to multiple lists in ClickUp.
+
+```bash
+cu move abc123 --to <listId>                    # add task to a list
+cu move abc123 --remove <listId>                # remove task from a list
+cu move abc123 --to <newListId> --remove <oldListId>  # move between lists
+cu move abc123 --to <listId> --json
+```
+
+| Flag                | Description                |
+| ------------------- | -------------------------- |
+| `--to <listId>`     | Add task to this list      |
+| `--remove <listId>` | Remove task from this list |
+| `--json`            | Force JSON output          |
+
 ### `cu auth`
 
 Check authentication status. Validates your API token and shows your user info.

package/dist/index.js

@@ -175,7 +175,7 @@ var ClickUpClient = class {
     return this.getTasksFromList(listId, { "assignees[]": String(me.id) });
   }
   async getTask(taskId) {
-    return this.request(`/task/${taskId}`);
+    return this.request(`/task/${taskId}?include_markdown_description=true`);
   }
   async updateTaskMarkdown(taskId, markdown) {
     return this.updateTask(taskId, { markdown_content: markdown });
@@ -223,6 +223,12 @@ var ClickUpClient = class {
   async getViewTasks(viewId) {
     return this.paginate((page) => `/view/${viewId}/task?page=${page}`);
   }
+  async addTaskToList(taskId, listId) {
+    await this.request(`/list/${listId}/task/${taskId}`, { method: "POST" });
+  }
+  async removeTaskFromList(taskId, listId) {
+    await this.request(`/list/${listId}/task/${taskId}`, { method: "DELETE" });
+  }
   async addDependency(taskId, opts) {
     const body = {};
     if (opts.dependsOn) body.depends_on = opts.dependsOn;
@@ -281,6 +287,8 @@ var TASK_COLUMNS = [
   { key: "id", label: "ID" },
   { key: "name", label: "NAME", maxWidth: 60 },
   { key: "status", label: "STATUS" },
+  { key: "priority", label: "PRIORITY" },
+  { key: "due_date", label: "DUE" },
   { key: "list", label: "LIST" }
 ];
 
@@ -302,6 +310,8 @@ var TASK_MD_COLUMNS = [
   { key: "id", label: "ID" },
   { key: "name", label: "Name" },
   { key: "status", label: "Status" },
+  { key: "priority", label: "Priority" },
+  { key: "due_date", label: "Due" },
   { key: "list", label: "List" }
 ];
 function formatTasksMarkdown(tasks) {
@@ -385,8 +395,9 @@ function formatTaskDetailMarkdown(task) {
       lines.push(`**${label}:** ${value}`);
     }
   }
-  if (task.description) {
-    lines.push("", "## Description", "", task.description);
+  const descriptionContent = task.markdown_content ?? task.description;
+  if (descriptionContent) {
+    lines.push("", "## Description", "", descriptionContent);
   }
   return lines.join("\n");
 }
@@ -614,12 +625,22 @@ function isDoneStatus(status) {
 function isInitiative(task) {
   return (task.custom_item_id ?? 0) !== 0;
 }
+function formatDueDate(ms) {
+  if (!ms) return "";
+  const d = new Date(Number(ms));
+  const year = d.getUTCFullYear();
+  const month = String(d.getUTCMonth() + 1).padStart(2, "0");
+  const day = String(d.getUTCDate()).padStart(2, "0");
+  return `${year}-${month}-${day}`;
+}
 function summarize(task) {
   return {
     id: task.id,
     name: task.name,
     status: task.status.status,
     task_type: isInitiative(task) ? "initiative" : "task",
+    priority: task.priority?.priority ?? "none",
+    due_date: formatDueDate(task.due_date),
     list: task.list.name,
     url: task.url,
     ...task.parent ? { parent: task.parent } : {}
@@ -725,10 +746,11 @@ function buildUpdatePayload(opts) {
   if (opts.timeEstimate !== void 0) {
     payload.time_estimate = parseTimeEstimate(opts.timeEstimate);
   }
+  if (opts.parent !== void 0) payload.parent = opts.parent;
   return payload;
 }
 function hasUpdateFields(options) {
-  return options.name !== void 0 || options.description !== void 0 || options.markdown_content !== void 0 || options.status !== void 0 || options.priority !== void 0 || options.due_date !== void 0 || options.time_estimate !== void 0 || options.assignees !== void 0;
+  return options.name !== void 0 || options.description !== void 0 || options.markdown_content !== void 0 || options.status !== void 0 || options.priority !== void 0 || options.due_date !== void 0 || options.time_estimate !== void 0 || options.assignees !== void 0 || options.parent !== void 0;
 }
 async function resolveStatus(client, taskId, statusInput) {
   const task = await client.getTask(taskId);
@@ -748,7 +770,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, --time-estimate, --assignee"
+      "Provide at least one of: --name, --description, --status, --priority, --due-date, --time-estimate, --assignee, --parent"
     );
   const client = new ClickUpClient(config);
   if (options.status !== void 0) {
@@ -1181,9 +1203,12 @@ function groupTasks(tasks, now) {
   }
   return groups;
 }
-async function fetchInbox(config, days = 30) {
+async function fetchInbox(config, days = 30, opts = {}) {
   const client = new ClickUpClient(config);
-  const tasks = await client.getMyTasks(config.teamId, { subtasks: true });
+  const tasks = await client.getMyTasks(config.teamId, {
+    subtasks: true,
+    includeClosed: opts.includeClosed
+  });
   const cutoff = Date.now() - days * 24 * 60 * 60 * 1e3;
   return tasks.filter((t) => Number(t.date_updated ?? 0) > cutoff).sort((a, b) => Number(b.date_updated ?? 0) - Number(a.date_updated ?? 0)).map(summarizeWithDate);
 }
@@ -1258,7 +1283,6 @@ async function listSpaces(config, opts) {
 }
 
 // src/commands/assigned.ts
-var CLOSED_STATUSES = /* @__PURE__ */ new Set(["done", "closed", "complete", "completed"]);
 var STATUS_ORDER = [
   "code review",
   "in review",
@@ -1270,18 +1294,6 @@ var STATUS_ORDER = [
   "backlog",
   "blocked"
 ];
-function toJsonTask(task, summary) {
-  return {
-    id: summary.id,
-    name: summary.name,
-    status: summary.status,
-    task_type: summary.task_type,
-    list: summary.list,
-    url: summary.url,
-    priority: task.priority?.priority ?? null,
-    due_date: task.due_date ?? null
-  };
-}
 function statusSortKey(status) {
   const idx = STATUS_ORDER.indexOf(status.toLowerCase());
   return idx === -1 ? STATUS_ORDER.length : idx;
@@ -1290,16 +1302,15 @@ function groupByStatus(tasks, includeClosed) {
   const groups = /* @__PURE__ */ new Map();
   for (const task of tasks) {
     const status = task.status.status;
-    const key = status.toLowerCase();
-    if (!includeClosed && CLOSED_STATUSES.has(key)) continue;
+    if (!includeClosed && isDoneStatus(status)) continue;
     if (!groups.has(status)) {
       groups.set(status, []);
     }
     groups.get(status).push(task);
   }
   return Array.from(groups.entries()).sort((a, b) => {
-    const aIsClosed = CLOSED_STATUSES.has(a[0].toLowerCase());
-    const bIsClosed = CLOSED_STATUSES.has(b[0].toLowerCase());
+    const aIsClosed = isDoneStatus(a[0]);
+    const bIsClosed = isDoneStatus(b[0]);
     if (aIsClosed !== bIsClosed) return aIsClosed ? 1 : -1;
     return statusSortKey(a[0]) - statusSortKey(b[0]);
   }).map(([status, tasks2]) => ({ status, tasks: tasks2 }));
@@ -1317,7 +1328,7 @@ async function runAssignedCommand(config, opts) {
   if (shouldOutputJson(opts.json ?? false)) {
     const result = {};
     for (const group of groups) {
-      result[group.status.toLowerCase()] = group.tasks.map((t) => toJsonTask(t, summarize(t)));
+      result[group.status.toLowerCase()] = group.tasks.map(summarize);
     }
     console.log(JSON.stringify(result, null, 2));
     return;
@@ -1450,7 +1461,7 @@ ${label} (${tasks.length})`);
 }
 async function runSummaryCommand(config, opts) {
   const client = new ClickUpClient(config);
-  const allTasks = await client.getMyTasks(config.teamId);
+  const allTasks = await client.getMyTasks(config.teamId, { includeClosed: true });
   const result = categorizeTasks(allTasks, opts.hours);
   if (shouldOutputJson(opts.json)) {
     console.log(JSON.stringify(result, null, 2));
@@ -1475,11 +1486,11 @@ function isOverdue2(task, now) {
   if (!task.due_date) return false;
   return Number(task.due_date) < now;
 }
-async function fetchOverdueTasks(config) {
+async function fetchOverdueTasks(config, opts = {}) {
   const client = new ClickUpClient(config);
-  const allTasks = await client.getMyTasks(config.teamId);
+  const allTasks = await client.getMyTasks(config.teamId, { includeClosed: opts.includeClosed });
   const now = Date.now();
-  return allTasks.filter((t) => isOverdue2(t, now) && !isDoneStatus(t.status.status)).sort((a, b) => Number(a.due_date) - Number(b.due_date)).map(summarize);
+  return allTasks.filter((t) => isOverdue2(t, now) && (opts.includeClosed || !isDoneStatus(t.status.status))).sort((a, b) => Number(a.due_date) - Number(b.due_date)).map(summarize);
 }
 
 // src/commands/config.ts
@@ -2075,6 +2086,24 @@ async function manageDependency(config, taskId, opts) {
   return `Added dependency: ${taskId} blocks ${opts.blocks}`;
 }
 
+// src/commands/move.ts
+async function moveTask(config, taskId, opts) {
+  if (!opts.to && !opts.remove) {
+    throw new Error("Provide --to <listId> or --remove <listId>");
+  }
+  const client = new ClickUpClient(config);
+  const messages = [];
+  if (opts.to) {
+    await client.addTaskToList(taskId, opts.to);
+    messages.push(`Added ${taskId} to list ${opts.to}`);
+  }
+  if (opts.remove) {
+    await client.removeTaskFromList(taskId, opts.remove);
+    messages.push(`Removed ${taskId} from list ${opts.remove}`);
+  }
+  return messages.join("; ");
+}
+
 // src/index.ts
 var require2 = createRequire(import.meta.url);
 var { version } = require2("../package.json");
@@ -2147,7 +2176,7 @@ 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("--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("--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();
     const payload = buildUpdatePayload(opts);
@@ -2239,14 +2268,14 @@ program.command("spaces").description("List spaces in your workspace").option("-
     await listSpaces(config, opts);
   })
 );
-program.command("inbox").description("Recently updated tasks grouped by time period").option("--json", "Force JSON output even in terminal").option("--days <n>", "Lookback period in days", "30").action(
+program.command("inbox").description("Recently updated tasks grouped by time period").option("--include-closed", "Include done/closed tasks").option("--json", "Force JSON output even in terminal").option("--days <n>", "Lookback period in days", "30").action(
   wrapAction(async (opts) => {
     const config = loadConfig();
     const days = Number(opts.days ?? 30);
     if (!Number.isFinite(days) || days <= 0) {
       throw new Error("--days must be a positive number");
     }
-    const tasks = await fetchInbox(config, days);
+    const tasks = await fetchInbox(config, days, { includeClosed: opts.includeClosed });
     await printInbox(tasks, opts.json ?? false, config);
   })
 );
@@ -2284,10 +2313,10 @@ program.command("summary").description("Daily standup summary: completed, in-pro
     await runSummaryCommand(config, { hours, json: opts.json ?? false });
   })
 );
-program.command("overdue").description("List tasks that are past their due date").option("--json", "Force JSON output even in terminal").action(
+program.command("overdue").description("List tasks that are past their due date").option("--include-closed", "Include done/closed overdue tasks").option("--json", "Force JSON output even in terminal").action(
   wrapAction(async (opts) => {
     const config = loadConfig();
-    const tasks = await fetchOverdueTasks(config);
+    const tasks = await fetchOverdueTasks(config, { includeClosed: opts.includeClosed });
     await printTasks(tasks, opts.json ?? false, config);
   })
 );
@@ -2313,6 +2342,17 @@ program.command("depend <taskId>").description("Add or remove task dependencies"
     }
   })
 );
+program.command("move <taskId>").description("Add or remove a task from a list").option("--to <listId>", "Add task to this list").option("--remove <listId>", "Remove task from this list").option("--json", "Force JSON output even in terminal").action(
+  wrapAction(async (taskId, opts) => {
+    const config = loadConfig();
+    const message = await moveTask(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.11.1",
+  "version": "0.12.1",
   "description": "ClickUp CLI for AI agents and humans",
   "type": "module",
   "license": "MIT",

package/skills/clickup-cli/SKILL.md

@@ -46,9 +46,9 @@ All commands support `--help` for full flag 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 inbox [--days n] [--include-closed] [--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 overdue [--include-closed] [--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                 |
@@ -56,44 +56,46 @@ 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] [--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)            |
+| 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 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"`)                                                    |
-| `--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                                                        |
+| 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`)                                                                     |
+| `--to` / `--remove` | List ID to add/remove task (used with `cu move`)                                                                      |
+| `--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`, `inbox`, `overdue`) |
+| `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
 
@@ -126,6 +128,7 @@ cu inbox --days 7                   # recently updated
 cu update abc123def -s "done"
 cu update abc123def --priority high --due-date 2025-03-15
 cu update abc123def --time-estimate 2h
+cu update abc123def --parent parentId    # make it a subtask
 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
@@ -133,6 +136,7 @@ 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
+cu move task1 --to list2 --remove list1  # move between lists
 ```
 
 ### Discover workspace structure