@krodak/clickup-cli 0.13.0 → 0.13.2

package/README.md

@@ -98,7 +98,7 @@ When output is piped (no TTY), all commands output **Markdown** by default - opt
 
 ## Commands
 
-30 commands total. All support `--help` for full flag details.
+29 commands total. All support `--help` for full flag details.
 
 ### `cu init`
 
@@ -110,32 +110,21 @@ cu init
 
 ### `cu tasks`
 
-List tasks assigned to me.
+List tasks assigned to me. By default shows all task types. Use `--type` to filter by task type.
 
 ```bash
 cu tasks
 cu tasks --status "in progress"
 cu tasks --name "login"
+cu tasks --type task                  # regular tasks only
+cu tasks --type initiative            # initiatives only
+cu tasks --type "Bug"                 # custom task type by name
 cu tasks --list <listId>
 cu tasks --space <spaceId>
 cu tasks --include-closed
 cu tasks --json
 ```
 
-### `cu initiatives`
-
-List initiatives assigned to me.
-
-```bash
-cu initiatives
-cu initiatives --status "to do"
-cu initiatives --name "auth"
-cu initiatives --list <listId>
-cu initiatives --space <spaceId>
-cu initiatives --include-closed
-cu initiatives --json
-```
-
 ### `cu sprint`
 
 List my tasks in the currently active sprint (auto-detected from sprint folder date ranges).
@@ -192,7 +181,7 @@ cu task abc123 --json
 
 ### `cu subtasks <id>`
 
-List subtasks of a task or initiative.
+List subtasks of a task.
 
 ```bash
 cu subtasks abc123
@@ -212,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
@@ -227,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                                          |
 
@@ -240,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
@@ -256,9 +246,9 @@ 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 (for creating initiatives)       |
+| `--custom-item-id <id>`      | no               | Custom task type ID (e.g. for creating initiatives)  |
 | `--json`                     | no               | Force JSON output even in terminal                   |
 
 ### `cu delete <id>`

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;
@@ -190,6 +124,12 @@ var ClickUpClient = class {
     const data = await this.request(`/team/${teamId}/space?archived=false`);
     return data.spaces ?? [];
   }
+  async getCustomTaskTypes(teamId) {
+    const data = await this.request(
+      `/team/${teamId}/custom_item`
+    );
+    return data.custom_items ?? [];
+  }
   async getLists(spaceId) {
     const data = await this.request(`/space/${spaceId}/list?archived=false`);
     return data.lists ?? [];
@@ -255,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));
@@ -372,11 +378,11 @@ function formatDuration(ms) {
 }
 function formatTaskDetailMarkdown(task) {
   const lines = [`# ${task.name}`, ""];
-  const isInitiative2 = (task.custom_item_id ?? 0) !== 0;
+  const isInitiative = (task.custom_item_id ?? 0) !== 0;
   const fields = [
     ["ID", task.id],
     ["Status", task.status.status],
-    ["Type", isInitiative2 ? "initiative" : "task"],
+    ["Type", isInitiative ? "initiative" : "task"],
     ["List", task.list.name],
     ["URL", task.url],
     [
@@ -505,8 +511,8 @@ function formatCustomFieldValue(field) {
 }
 function formatTaskDetail(task) {
   const lines = [];
-  const isInitiative2 = (task.custom_item_id ?? 0) !== 0;
-  const typeLabel = isInitiative2 ? "initiative" : "task";
+  const isInitiative = (task.custom_item_id ?? 0) !== 0;
+  const typeLabel = isInitiative ? "initiative" : "task";
   lines.push(chalk2.bold.underline(task.name));
   lines.push("");
   const fields = [
@@ -631,19 +637,21 @@ function isDoneStatus(status) {
   const lower = status.toLowerCase();
   return DONE_PATTERNS.some((p) => lower.includes(p));
 }
-function isInitiative(task) {
-  return (task.custom_item_id ?? 0) !== 0;
-}
 function formatDueDate(ms) {
   if (!ms) return "";
   return formatDate(ms);
 }
-function summarize(task) {
+function resolveTaskType(task, typeMap) {
+  const id = task.custom_item_id ?? 0;
+  if (id === 0) return "task";
+  return typeMap.get(id) ?? `type_${id}`;
+}
+function summarize(task, typeMap) {
   return {
     id: task.id,
     name: task.name,
     status: task.status.status,
-    task_type: isInitiative(task) ? "initiative" : "task",
+    task_type: resolveTaskType(task, typeMap ?? /* @__PURE__ */ new Map()),
     priority: task.priority?.priority ?? "none",
     due_date: formatDueDate(task.due_date),
     list: task.list.name,
@@ -651,16 +659,42 @@ function summarize(task) {
     ...task.parent ? { parent: task.parent } : {}
   };
 }
+function buildTypeMap(types) {
+  const map = /* @__PURE__ */ new Map();
+  for (const t of types) {
+    map.set(t.id, t.name);
+  }
+  return map;
+}
+function resolveTypeFilter(typeFilter, typeMap) {
+  if (typeFilter === "task") return 0;
+  const asNum = Number(typeFilter);
+  if (Number.isFinite(asNum)) return asNum;
+  const lower = typeFilter.toLowerCase();
+  for (const [id, name] of typeMap) {
+    if (name.toLowerCase() === lower) return id;
+  }
+  const available = ["task", ...Array.from(typeMap.values())].join(", ");
+  throw new Error(`Unknown task type "${typeFilter}". Available types: ${available}`);
+}
 async function fetchMyTasks(config, opts = {}) {
   const client = new ClickUpClient(config);
   const { typeFilter, name, ...apiFilters } = opts;
-  const allTasks = await client.getMyTasks(config.teamId, apiFilters);
-  let filtered = typeFilter === "initiative" ? allTasks.filter(isInitiative) : typeFilter === "task" ? allTasks.filter((t) => !isInitiative(t)) : allTasks;
+  const [allTasks, customTypes] = await Promise.all([
+    client.getMyTasks(config.teamId, apiFilters),
+    client.getCustomTaskTypes(config.teamId)
+  ]);
+  const typeMap = buildTypeMap(customTypes);
+  let filtered = allTasks;
+  if (typeFilter) {
+    const targetId = resolveTypeFilter(typeFilter, typeMap);
+    filtered = allTasks.filter((t) => (t.custom_item_id ?? 0) === targetId);
+  }
   if (name) {
     const query = name.toLowerCase();
     filtered = filtered.filter((t) => t.name.toLowerCase().includes(query));
   }
-  return filtered.map(summarize);
+  return filtered.map((t) => summarize(t, typeMap));
 }
 async function printTasks(tasks, forceJson, config) {
   if (shouldOutputJson(forceJson)) {
@@ -720,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);
@@ -920,10 +961,12 @@ function findRelatedSpaces(mySpaceIds, allSpaces) {
 async function runSprintCommand(config, opts) {
   const client = new ClickUpClient(config);
   process.stderr.write("Detecting active sprint...\n");
-  const [myTasks, allSpaces] = await Promise.all([
+  const [myTasks, allSpaces, customTypes] = await Promise.all([
     client.getMyTasks(config.teamId),
-    client.getSpaces(config.teamId)
+    client.getSpaces(config.teamId),
+    client.getCustomTaskTypes(config.teamId)
   ]);
+  const typeMap = buildTypeMap(customTypes);
   let spaces;
   if (opts.space) {
     spaces = allSpaces.filter(
@@ -966,7 +1009,7 @@ async function runSprintCommand(config, opts) {
     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);
+  const summaries = filtered.map((t) => summarize(t, typeMap));
   await printTasks(summaries, opts.json ?? false, config);
 }
 
@@ -1059,13 +1102,17 @@ async function listSprints(config, opts = {}) {
 // src/commands/subtasks.ts
 async function fetchSubtasks(config, taskId, options = {}) {
   const client = new ClickUpClient(config);
-  const parent = await client.getTask(taskId);
+  const [parent, customTypes] = await Promise.all([
+    client.getTask(taskId),
+    client.getCustomTaskTypes(config.teamId)
+  ]);
+  const typeMap = buildTypeMap(customTypes);
   const tasks = await client.getTasksFromList(
     parent.list.id,
     { parent: taskId, subtasks: "false" },
     { includeClosed: options.includeClosed }
   );
-  return tasks.map(summarize);
+  return tasks.map((t) => summarize(t, typeMap));
 }
 
 // src/commands/comment.ts
@@ -1171,9 +1218,9 @@ var TIME_PERIODS = [
   { key: "last_month", label: "Last month" },
   { key: "older", label: "Older" }
 ];
-function summarizeWithDate(task) {
+function summarizeWithDate(task, typeMap) {
   return {
-    ...summarize(task),
+    ...summarize(task, typeMap),
     date_updated: task.date_updated ?? "0"
   };
 }
@@ -1210,12 +1257,13 @@ function groupTasks(tasks, now) {
 }
 async function fetchInbox(config, days = 30, opts = {}) {
   const client = new ClickUpClient(config);
-  const tasks = await client.getMyTasks(config.teamId, {
-    subtasks: true,
-    includeClosed: opts.includeClosed
-  });
+  const [tasks, customTypes] = await Promise.all([
+    client.getMyTasks(config.teamId, { subtasks: true, includeClosed: opts.includeClosed }),
+    client.getCustomTaskTypes(config.teamId)
+  ]);
+  const typeMap = buildTypeMap(customTypes);
   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);
+  return tasks.filter((t) => Number(t.date_updated ?? 0) > cutoff).sort((a, b) => Number(b.date_updated ?? 0) - Number(a.date_updated ?? 0)).map((t) => summarizeWithDate(t, typeMap));
 }
 async function printInbox(tasks, forceJson, config) {
   const now = Date.now();
@@ -1322,9 +1370,11 @@ function groupByStatus(tasks, includeClosed) {
 }
 async function runAssignedCommand(config, opts) {
   const client = new ClickUpClient(config);
-  const allTasks = await client.getMyTasks(config.teamId, {
-    includeClosed: opts.includeClosed
-  });
+  const [allTasks, customTypes] = await Promise.all([
+    client.getMyTasks(config.teamId, { includeClosed: opts.includeClosed }),
+    client.getCustomTaskTypes(config.teamId)
+  ]);
+  const typeMap = buildTypeMap(customTypes);
   let groups = groupByStatus(allTasks, opts.includeClosed ?? false);
   if (opts.status) {
     const lower = opts.status.toLowerCase();
@@ -1333,7 +1383,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(summarize);
+      result[group.status.toLowerCase()] = group.tasks.map((t) => summarize(t, typeMap));
     }
     console.log(JSON.stringify(result, null, 2));
     return;
@@ -1341,7 +1391,7 @@ async function runAssignedCommand(config, opts) {
   if (!isTTY()) {
     const mdGroups = groups.map((g) => ({
       label: g.status,
-      tasks: g.tasks.map((t) => summarize(t))
+      tasks: g.tasks.map((t) => summarize(t, typeMap))
     }));
     console.log(formatGroupedTasksMarkdown(mdGroups));
     return;
@@ -1352,7 +1402,7 @@ async function runAssignedCommand(config, opts) {
   }
   const pickerGroups = groups.map((g) => ({
     label: g.status.toUpperCase(),
-    tasks: g.tasks.map(summarize)
+    tasks: g.tasks.map((t) => summarize(t, typeMap))
   }));
   const selected = await groupedTaskPicker(pickerGroups);
   await showDetailsAndOpen(selected, (id) => client.getTask(id));
@@ -1435,7 +1485,7 @@ function isOverdue(task, now) {
   const due = Number(task.due_date);
   return !isNaN(due) && due < now;
 }
-function categorizeTasks(tasks, hoursBack) {
+function categorizeTasks(tasks, hoursBack, typeMap) {
   const now = Date.now();
   const cutoff = now - hoursBack * 60 * 60 * 1e3;
   const completed = [];
@@ -1444,13 +1494,13 @@ function categorizeTasks(tasks, hoursBack) {
   for (const task of tasks) {
     const done = isDoneStatus(task.status.status);
     if (done && isCompletedRecently(task, cutoff)) {
-      completed.push(summarize(task));
+      completed.push(summarize(task, typeMap));
     }
     if (!done && isInProgress(task)) {
-      inProgress.push(summarize(task));
+      inProgress.push(summarize(task, typeMap));
     }
     if (!done && isOverdue(task, now)) {
-      overdue.push(summarize(task));
+      overdue.push(summarize(task, typeMap));
     }
   }
   return { completed, inProgress, overdue };
@@ -1466,8 +1516,12 @@ ${label} (${tasks.length})`);
 }
 async function runSummaryCommand(config, opts) {
   const client = new ClickUpClient(config);
-  const allTasks = await client.getMyTasks(config.teamId, { includeClosed: true });
-  const result = categorizeTasks(allTasks, opts.hours);
+  const [allTasks, customTypes] = await Promise.all([
+    client.getMyTasks(config.teamId, { includeClosed: true }),
+    client.getCustomTaskTypes(config.teamId)
+  ]);
+  const typeMap = buildTypeMap(customTypes);
+  const result = categorizeTasks(allTasks, opts.hours, typeMap);
   if (shouldOutputJson(opts.json)) {
     console.log(JSON.stringify(result, null, 2));
     return;
@@ -1493,9 +1547,13 @@ function isOverdue2(task, now) {
 }
 async function fetchOverdueTasks(config, opts = {}) {
   const client = new ClickUpClient(config);
-  const allTasks = await client.getMyTasks(config.teamId, { includeClosed: opts.includeClosed });
+  const [allTasks, customTypes] = await Promise.all([
+    client.getMyTasks(config.teamId, { includeClosed: opts.includeClosed }),
+    client.getCustomTaskTypes(config.teamId)
+  ]);
+  const typeMap = buildTypeMap(customTypes);
   const now = Date.now();
-  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);
+  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((t) => summarize(t, typeMap));
 }
 
 // src/commands/config.ts
@@ -1532,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");
@@ -1547,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: {
@@ -1633,7 +1684,7 @@ function bashCompletion() {
     cword=$COMP_CWORD
   fi
 
-  local commands="init auth tasks initiatives task update create sprint sprints subtasks comment comments activity lists spaces inbox assigned open search summary overdue assign depend move field delete tag config completion"
+  local commands="init auth tasks task update create sprint sprints subtasks comment comments activity lists spaces inbox assigned open search summary overdue assign depend move field delete tag config completion"
 
   if [[ $cword -eq 1 ]]; then
     COMPREPLY=($(compgen -W "$commands --help --version" -- "$cur"))
@@ -1654,8 +1705,8 @@ function bashCompletion() {
   esac
 
   case "$cmd" in
-    tasks|initiatives)
-      COMPREPLY=($(compgen -W "--status --list --space --name --include-closed --json" -- "$cur"))
+    tasks)
+      COMPREPLY=($(compgen -W "--status --list --space --name --type --include-closed --json" -- "$cur"))
       ;;
     task)
       COMPREPLY=($(compgen -W "--json" -- "$cur"))
@@ -1758,7 +1809,6 @@ _cu() {
     'init:Set up cu for the first time'
     'auth:Validate API token and show current user'
     'tasks:List tasks assigned to me'
-    'initiatives:List initiatives assigned to me'
     'task:Get task details'
     'update:Update a task'
     'create:Create a new task'
@@ -1798,12 +1848,13 @@ _cu() {
       ;;
     args)
       case $words[1] in
-        tasks|initiatives)
+        tasks)
           _arguments \\
             '--status[Filter by status]:status:(open "in progress" "in review" done closed)' \\
             '--list[Filter by list ID]:list_id:' \\
             '--space[Filter by space ID]:space_id:' \\
             '--name[Filter by name]:query:' \\
+            '--type[Filter by task type]:type:' \\
             '--include-closed[Include done/closed tasks]' \\
             '--json[Force JSON output]'
           ;;
@@ -2011,7 +2062,6 @@ complete -c cu -n __fish_use_subcommand -s V -l version -d 'Show version'
 complete -c cu -n __fish_use_subcommand -a init -d 'Set up cu for the first time'
 complete -c cu -n __fish_use_subcommand -a auth -d 'Validate API token and show current user'
 complete -c cu -n __fish_use_subcommand -a tasks -d 'List tasks assigned to me'
-complete -c cu -n __fish_use_subcommand -a initiatives -d 'List initiatives assigned to me'
 complete -c cu -n __fish_use_subcommand -a task -d 'Get task details'
 complete -c cu -n __fish_use_subcommand -a update -d 'Update a task'
 complete -c cu -n __fish_use_subcommand -a create -d 'Create a new task'
@@ -2040,12 +2090,13 @@ complete -c cu -n __fish_use_subcommand -a completion -d 'Output shell completio
 
 complete -c cu -n '__fish_seen_subcommand_from auth' -l json -d 'Force JSON output'
 
-complete -c cu -n '__fish_seen_subcommand_from tasks initiatives' -l status -d 'Filter by status'
-complete -c cu -n '__fish_seen_subcommand_from tasks initiatives' -l list -d 'Filter by list ID'
-complete -c cu -n '__fish_seen_subcommand_from tasks initiatives' -l space -d 'Filter by space ID'
-complete -c cu -n '__fish_seen_subcommand_from tasks initiatives' -l name -d 'Filter by name'
-complete -c cu -n '__fish_seen_subcommand_from tasks initiatives' -l include-closed -d 'Include done/closed tasks'
-complete -c cu -n '__fish_seen_subcommand_from tasks initiatives' -l json -d 'Force JSON output'
+complete -c cu -n '__fish_seen_subcommand_from tasks' -l status -d 'Filter by status'
+complete -c cu -n '__fish_seen_subcommand_from tasks' -l list -d 'Filter by list ID'
+complete -c cu -n '__fish_seen_subcommand_from tasks' -l space -d 'Filter by space ID'
+complete -c cu -n '__fish_seen_subcommand_from tasks' -l name -d 'Filter by name'
+complete -c cu -n '__fish_seen_subcommand_from tasks' -l type -d 'Filter by task type'
+complete -c cu -n '__fish_seen_subcommand_from tasks' -l include-closed -d 'Include done/closed tasks'
+complete -c cu -n '__fish_seen_subcommand_from tasks' -l json -d 'Force JSON output'
 
 complete -c cu -n '__fish_seen_subcommand_from task' -l json -d 'Force JSON output'
 
@@ -2183,9 +2234,11 @@ 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, {
-    includeClosed: opts.includeClosed
-  });
+  const [allTasks, customTypes] = await Promise.all([
+    client.getMyTasks(config.teamId, { includeClosed: opts.includeClosed }),
+    client.getCustomTaskTypes(config.teamId)
+  ]);
+  const typeMap = buildTypeMap(customTypes);
   const words = trimmed.toLowerCase().split(/\s+/);
   let matched = allTasks.filter((task) => {
     const name = task.name.toLowerCase();
@@ -2204,7 +2257,7 @@ async function searchTasks(config, query, opts = {}) {
       matched = matched.filter((t) => t.status.status.toLowerCase() === opts.status.toLowerCase());
     }
   }
-  return matched.map(summarize);
+  return matched.map((t) => summarize(t, typeMap));
 }
 
 // src/commands/depend.ts
@@ -2426,25 +2479,14 @@ program.command("auth").description("Validate API token and show current user").
     }
   })
 );
-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, {
-      typeFilter: "task",
-      statuses: opts.status ? [opts.status] : void 0,
-      listIds: opts.list ? [opts.list] : void 0,
-      spaceIds: opts.space ? [opts.space] : void 0,
-      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("--include-closed", "Include done/closed tasks").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(
+  "--type <type>",
+  'Filter by task type (e.g. "task", "initiative", or custom type name/ID)'
+).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, {
-      typeFilter: "initiative",
+      typeFilter: opts.type,
       statuses: opts.status ? [opts.status] : void 0,
       listIds: opts.list ? [opts.list] : void 0,
       spaceIds: opts.space ? [opts.space] : void 0,
@@ -2467,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)) {
@@ -2479,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.0",
+  "version": "0.13.2",
   "description": "ClickUp CLI for AI agents and humans",
   "type": "module",
   "license": "MIT",

package/skills/clickup-cli/SKILL.md

@@ -1,13 +1,13 @@
 ---
 name: clickup
-description: 'Use when managing ClickUp tasks, initiatives, sprints, or comments via the `cu` CLI tool. Triggers: task queries, status updates, sprint tracking, creating subtasks, posting comments, standup summaries, searching tasks, checking overdue items, assigning tasks, listing spaces and lists, opening tasks in browser, checking auth or config, setting custom fields, deleting tasks, managing tags.'
+description: 'Use when managing ClickUp tasks, sprints, or comments via the `cu` CLI tool. Triggers: task queries, status updates, sprint tracking, creating subtasks, posting comments, standup summaries, searching tasks, checking overdue items, assigning tasks, listing spaces and lists, opening tasks in browser, checking auth or config, setting custom fields, deleting tasks, managing tags.'
 ---
 
 # ClickUp CLI (`cu`)
 
-Reference for AI agents using the `cu` CLI tool. Covers task management, sprint tracking, initiatives, comments, and project workflows.
+Reference for AI agents using the `cu` CLI tool. Covers task management, sprint tracking, comments, and project workflows.
 
-Keywords: ClickUp, task management, sprint, initiative, project management, agile, backlog, subtasks, standup, overdue, search
+Keywords: ClickUp, task management, sprint, project management, agile, backlog, subtasks, standup, overdue, search
 
 ## Setup
 
@@ -34,75 +34,74 @@ All commands support `--help` for full flag details.
 
 ### Read
 
-| 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] [--include-closed] [--json]`                                             | Tasks updated in last n days (default 30)          |
-| `cu summary [--hours n] [--json]`                                                             | Standup helper: completed, in-progress, overdue    |
-| `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                 |
-| `cu auth [--json]`                                                                            | Check authentication status                        |
+| Command                                                                                            | What it returns                                    |
+| -------------------------------------------------------------------------------------------------- | -------------------------------------------------- |
+| `cu tasks [--status s] [--name q] [--type t] [--list id] [--space id] [--include-closed] [--json]` | My tasks (all types, or filter with --type)        |
+| `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                                 |
+| `cu comments <id> [--json]`                                                                        | Comments on a task                                 |
+| `cu activity <id> [--json]`                                                                        | Task details + comment history combined            |
+| `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 [--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                 |
+| `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] [--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
 
-| 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`)                                                                      |
-| `cu field --set`        | Supports: text, number, checkbox (true/false), dropdown (option name), date (YYYY-MM-DD), url, email                  |
-| `cu field`              | Field names resolved case-insensitively; errors list available fields/options                                         |
-| `cu delete`             | DESTRUCTIVE. Requires `--confirm` in non-interactive mode. Cannot be undone                                           |
-| `cu tag --add/--remove` | Comma-separated tag names (e.g. `--add "bug,frontend"`)                                                               |
-| `--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                                                                            |
+| Topic                   | Detail                                                                                                 |
+| ----------------------- | ------------------------------------------------------------------------------------------------------ |
+| Task IDs                | Stable alphanumeric strings (e.g. `abc123def`)                                                         |
+| `--type`                | Filter by task type: `task` (regular), or custom type name/ID (e.g. `initiative`, `Bug`)               |
+| `--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`            | 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)                                          |
+| `--on` / `--blocks`     | Task dependency direction (used with `cu depend`)                                                      |
+| `--to` / `--remove`     | List ID to add/remove task (used with `cu move`)                                                       |
+| `cu field --set`        | Supports: text, number, checkbox (true/false), dropdown (option name), date (YYYY-MM-DD), url, email   |
+| `cu field`              | Field names resolved case-insensitively; errors list available fields/options                          |
+| `cu delete`             | DESTRUCTIVE. Requires `--confirm` in non-interactive mode. Cannot be undone                            |
+| `cu tag --add/--remove` | Comma-separated tag names (e.g. `--add "bug,frontend"`)                                                |
+| `--space`               | Partial name match or exact ID                                                                         |
+| `--name`                | Partial match, case-insensitive                                                                        |
+| `--include-closed`      | Include closed/done tasks (on `tasks`, `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
 
@@ -121,6 +120,8 @@ cu activity abc123def               # task + comments combined
 ```bash
 cu tasks --status "in progress"     # by status
 cu tasks --name "login"             # by partial name
+cu tasks --type initiative          # initiatives only
+cu tasks --type task                # regular tasks only
 cu search "payment flow"            # multi-word search
 cu search auth --status "prog"      # fuzzy status match
 cu sprint                           # current sprint