@krodak/clickup-cli 0.7.0 → 0.8.0

package/.claude-plugin/plugin.json

@@ -0,0 +1,11 @@
+{
+  "name": "clickup-cli",
+  "description": "Claude Code skills for the cu (ClickUp CLI) tool - manage tasks, sprints, initiatives, and comments",
+  "version": "0.6.1",
+  "author": {
+    "name": "Krzysztof Rodak"
+  },
+  "homepage": "https://github.com/krodak/clickup-cli",
+  "repository": "https://github.com/krodak/clickup-cli",
+  "license": "MIT"
+}

package/README.md

@@ -1,18 +1,15 @@
 # cu - ClickUp CLI
 
-> A ClickUp CLI built for AI agents that also works well for humans. Outputs Markdown when piped (optimized for AI context windows), interactive tables when run in a terminal.
+A ClickUp CLI built for AI agents that also works well for humans. Outputs JSON when piped, interactive tables when run in a terminal.
 
-[![npm](https://img.shields.io/npm/v/@krodak/clickup-cli)](https://www.npmjs.com/package/@krodak/clickup-cli)
-[![node](https://img.shields.io/node/v/@krodak/clickup-cli)](https://nodejs.org)
-[![license](https://img.shields.io/npm/l/@krodak/clickup-cli)](./LICENSE)
-[![CI](https://github.com/krodak/clickup-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/krodak/clickup-cli/actions/workflows/ci.yml)
+## Quick start
 
 ```bash
 npm install -g @krodak/clickup-cli   # or: brew tap krodak/tap && brew install clickup-cli
 cu init                               # walks you through API token + workspace setup
 ```
 
-You need a ClickUp personal API token (`pk_...` from https://app.clickup.com/settings/apps).
+You need Node 22+ and a ClickUp personal API token (`pk_...` from https://app.clickup.com/settings/apps).
 
 ## Using with AI agents
 
@@ -20,13 +17,21 @@ This is the primary use case. Install the tool, install the skill file, and your
 
 ### 1. Install the skill
 
-The repo includes a skill file at `skill/SKILL.md` that teaches agents all available commands and when to use them.
+The repo includes a skill file at `skills/clickup-cli/SKILL.md` that teaches agents all available commands and when to use them. It's also packaged as a Claude Code plugin.
 
-**Claude Code:**
+**Claude Code (plugin - recommended):**
+
+The repo ships as a Claude Code plugin. Point Claude Code at the repo or installed npm package:
+
+```bash
+claude --plugin-dir ./node_modules/@krodak/clickup-cli
+```
+
+Or copy the skill manually:
 
 ```bash
 mkdir -p ~/.claude/skills/clickup
-cp skill/SKILL.md ~/.claude/skills/clickup/SKILL.md
+cp skills/clickup-cli/SKILL.md ~/.claude/skills/clickup/SKILL.md
 ```
 
 Then reference it in your `CLAUDE.md` or project instructions.
@@ -35,12 +40,12 @@ Then reference it in your `CLAUDE.md` or project instructions.
 
 ```bash
 mkdir -p ~/.config/opencode/skills/clickup
-cp skill/SKILL.md ~/.config/opencode/skills/clickup/SKILL.md
+cp skills/clickup-cli/SKILL.md ~/.config/opencode/skills/clickup/SKILL.md
 ```
 
 **Codex / other agents:**
 
-Copy the contents of `skill/SKILL.md` into your system prompt or project instructions. It's a standalone markdown document.
+Copy the contents of `skills/clickup-cli/SKILL.md` into your system prompt or project instructions. It's a standalone markdown document.
 
 ### 2. Talk to your agent
 
@@ -84,13 +89,13 @@ cu update abc123 -s "done"        # update status
 cu assign abc123 --to me          # assign yourself
 ```
 
-Pass `--json` to any read command to force JSON output instead of the default format.
+Pass `--json` to any command to get raw JSON output instead of the interactive UI.
 
-When output is piped (no TTY), all commands output **Markdown** by default - optimized for AI agent context windows. Pass `--json` to any command for JSON output. Set `CU_OUTPUT=json` environment variable to always get JSON when piped.
+When output is piped (no TTY), all commands automatically output JSON. All commands support `--json` to force JSON output even in a terminal.
 
 ## Commands
 
-20 commands total. All support `--help` for full flag details.
+24 commands total. All support `--help` for full flag details.
 
 ### `cu init`
 
@@ -136,6 +141,15 @@ cu sprint --status "in progress"
 cu sprint --json
 ```
 
+### `cu sprints`
+
+List all sprints across sprint folders. Marks the currently active sprint.
+
+```bash
+cu sprints
+cu sprints --json
+```
+
 ### `cu assigned`
 
 All tasks assigned to me, grouped by pipeline stage (code review, in progress, to do, etc.).
@@ -158,15 +172,13 @@ cu inbox --json
 
 ### `cu task <id>`
 
-Get task details. Pretty summary in terminal, JSON when piped.
+Get task details including custom fields. Pretty summary in terminal, JSON when piped.
 
 ```bash
 cu task abc123
 cu task abc123 --json
 ```
 
-**Note:** When piped, `cu task` outputs a structured Markdown summary of the task. For the full raw API response with all fields (custom fields, checklists, etc.), use `--json`.
-
 ### `cu subtasks <id>`
 
 List subtasks of a task or initiative.
@@ -188,16 +200,18 @@ 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 -s "in progress" --json
 ```
 
-| Flag                       | Description                                          |
-| -------------------------- | ---------------------------------------------------- |
-| `-n, --name <text>`        | New task name                                        |
-| `-d, --description <text>` | New description (markdown supported)                 |
-| `-s, --status <status>`    | New status (e.g. `"in progress"`, `"done"`)          |
-| `--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                      |
+| 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                                          |
 
 ### `cu create`
 
@@ -209,6 +223,7 @@ 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 "Fix bug" -l <listId> --json
 ```
 
 | Flag                       | Required         | Description                                          |
@@ -222,6 +237,7 @@ cu create -n "Task" -l <listId> --assignee 12345 --tags "bug,frontend"
 | `--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                   |
 
 ### `cu comment <id>`
 
@@ -240,6 +256,15 @@ cu comments abc123
 cu comments abc123 --json
 ```
 
+### `cu activity <id>`
+
+View task details and comment history together. Combines `cu task` and `cu comments` into a single view.
+
+```bash
+cu activity abc123
+cu activity abc123 --json
+```
+
 ### `cu lists <spaceId>`
 
 List all lists in a space, including lists inside folders. Useful for discovering list IDs needed by `--list` filter and `cu create -l`.
@@ -284,6 +309,17 @@ cu open abc123 --json
 
 If the query matches multiple tasks by name, all matches are listed and the first is opened.
 
+### `cu search <query>`
+
+Search my tasks by name. Supports multi-word queries with case-insensitive matching. Status filter supports fuzzy matching.
+
+```bash
+cu search "login bug"
+cu search auth
+cu search "payment flow" --json
+cu search auth --status "prog"     # fuzzy matches "in progress"
+```
+
 ### `cu summary`
 
 Daily standup helper. Shows tasks grouped into: recently completed, in progress, and overdue.
@@ -326,6 +362,15 @@ cu assign abc123 --to me --json
 | `--remove <userId>` | Remove assignee (user ID or `me`) |
 | `--json`            | Force JSON output                 |
 
+### `cu auth`
+
+Check authentication status. Validates your API token and shows your user info.
+
+```bash
+cu auth
+cu auth --json
+```
+
 ### `cu config`
 
 Manage CLI configuration.
@@ -365,11 +410,10 @@ cu completion fish > ~/.config/fish/completions/cu.fish          # Fish
 
 Environment variables override config file values:
 
-| Variable       | Description                                                       |
-| -------------- | ----------------------------------------------------------------- |
-| `CU_API_TOKEN` | ClickUp personal API token (`pk_`)                                |
-| `CU_TEAM_ID`   | Workspace (team) ID                                               |
-| `CU_OUTPUT`    | Set to `json` to force JSON output when piped (default: markdown) |
+| Variable       | Description                        |
+| -------------- | ---------------------------------- |
+| `CU_API_TOKEN` | ClickUp personal API token (`pk_`) |
+| `CU_TEAM_ID`   | Workspace (team) ID                |
 
 When both are set, the config file is not required. Useful for CI/CD and containerized agents.
 

package/dist/index.js

@@ -61,9 +61,13 @@ function getConfigPath() {
 function writeConfig(config) {
   const dir = configDir();
   if (!fs.existsSync(dir)) {
-    fs.mkdirSync(dir, { recursive: true });
+    fs.mkdirSync(dir, { recursive: true, mode: 448 });
   }
-  fs.writeFileSync(join(dir, "config.json"), JSON.stringify(config, null, 2) + "\n", "utf-8");
+  const filePath = join(dir, "config.json");
+  fs.writeFileSync(filePath, JSON.stringify(config, null, 2) + "\n", {
+    encoding: "utf-8",
+    mode: 384
+  });
 }
 
 // src/api.ts
@@ -187,6 +191,9 @@ var ClickUpClient = class {
     const data = await this.request("/team");
     return data.teams ?? [];
   }
+  async getSpaceWithStatuses(spaceId) {
+    return this.request(`/space/${spaceId}`);
+  }
   async getSpaces(teamId) {
     const data = await this.request(`/team/${teamId}/space?archived=false`);
     return data.spaces ?? [];
@@ -220,11 +227,6 @@ import chalk from "chalk";
 function isTTY() {
   return Boolean(process.stdout.isTTY);
 }
-function shouldOutputJson(forceJson) {
-  if (forceJson) return true;
-  if (process.env["CU_OUTPUT"] === "json") return true;
-  return false;
-}
 function cell(value, width) {
   if (value.length > width) return value.slice(0, width - 1) + "\u2026";
   return value.padEnd(width);
@@ -257,128 +259,6 @@ var TASK_COLUMNS = [
   { key: "list", label: "LIST" }
 ];
 
-// src/markdown.ts
-function escapeCell(value) {
-  return value.replace(/\|/g, "\\|");
-}
-function formatMarkdownTable(rows, columns) {
-  const header = "| " + columns.map((c) => c.label).join(" | ") + " |";
-  const divider = "| " + columns.map(() => "---").join(" | ") + " |";
-  const lines = [header, divider];
-  for (const row of rows) {
-    const cells = columns.map((c) => escapeCell(String(row[c.key] ?? "")));
-    lines.push("| " + cells.join(" | ") + " |");
-  }
-  return lines.join("\n");
-}
-var TASK_MD_COLUMNS = [
-  { key: "id", label: "ID" },
-  { key: "name", label: "Name" },
-  { key: "status", label: "Status" },
-  { key: "list", label: "List" }
-];
-function formatTasksMarkdown(tasks) {
-  if (tasks.length === 0) return "No tasks found.";
-  return formatMarkdownTable(tasks, TASK_MD_COLUMNS);
-}
-function formatCommentsMarkdown(comments) {
-  if (comments.length === 0) return "No comments found.";
-  return comments.map((c) => `**${c.user}** (${c.date})
-
-${c.text}`).join("\n\n---\n\n");
-}
-var LIST_MD_COLUMNS = [
-  { key: "id", label: "ID" },
-  { key: "name", label: "Name" },
-  { key: "folder", label: "Folder" }
-];
-function formatListsMarkdown(lists) {
-  if (lists.length === 0) return "No lists found.";
-  return formatMarkdownTable(lists, LIST_MD_COLUMNS);
-}
-var SPACE_MD_COLUMNS = [
-  { key: "id", label: "ID" },
-  { key: "name", label: "Name" }
-];
-function formatSpacesMarkdown(spaces) {
-  if (spaces.length === 0) return "No spaces found.";
-  return formatMarkdownTable(spaces, SPACE_MD_COLUMNS);
-}
-function formatGroupedTasksMarkdown(groups) {
-  const sections = groups.filter((g) => g.tasks.length > 0).map((g) => `## ${g.label}
-
-${formatMarkdownTable(g.tasks, TASK_MD_COLUMNS)}`);
-  if (sections.length === 0) return "No tasks found.";
-  return sections.join("\n\n");
-}
-function formatDate(ms) {
-  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 formatDuration(ms) {
-  const totalMinutes = Math.floor(ms / 6e4);
-  const hours = Math.floor(totalMinutes / 60);
-  const minutes = totalMinutes % 60;
-  return `${hours}h ${minutes}m`;
-}
-function formatTaskDetailMarkdown(task) {
-  const lines = [`# ${task.name}`, ""];
-  const isInitiative2 = (task.custom_item_id ?? 0) !== 0;
-  const fields = [
-    ["ID", task.id],
-    ["Status", task.status.status],
-    ["Type", isInitiative2 ? "initiative" : "task"],
-    ["List", task.list.name],
-    ["URL", task.url],
-    [
-      "Assignees",
-      task.assignees.length > 0 ? task.assignees.map((a) => a.username).join(", ") : void 0
-    ],
-    ["Priority", task.priority?.priority],
-    ["Parent", task.parent ?? void 0],
-    ["Start Date", task.start_date ? formatDate(task.start_date) : void 0],
-    ["Due Date", task.due_date ? formatDate(task.due_date) : void 0],
-    [
-      "Time Estimate",
-      task.time_estimate != null && task.time_estimate > 0 ? formatDuration(task.time_estimate) : void 0
-    ],
-    [
-      "Time Spent",
-      task.time_spent != null && task.time_spent > 0 ? formatDuration(task.time_spent) : void 0
-    ],
-    ["Tags", task.tags && task.tags.length > 0 ? task.tags.map((t) => t.name).join(", ") : void 0],
-    ["Created", task.date_created ? formatDate(task.date_created) : void 0],
-    ["Updated", task.date_updated ? formatDate(task.date_updated) : void 0]
-  ];
-  for (const [label, value] of fields) {
-    if (value != null && value !== "") {
-      lines.push(`**${label}:** ${value}`);
-    }
-  }
-  if (task.description) {
-    lines.push("", "## Description", "", task.description);
-  }
-  return lines.join("\n");
-}
-function formatUpdateConfirmation(id, name) {
-  return `Updated task ${id}: "${name}"`;
-}
-function formatCreateConfirmation(id, name, url) {
-  return `Created task ${id}: "${name}" - ${url}`;
-}
-function formatCommentConfirmation(id) {
-  return `Comment posted (id: ${id})`;
-}
-function formatAssignConfirmation(taskId, opts) {
-  const parts = [];
-  if (opts.to) parts.push(`Assigned ${opts.to} to ${taskId}`);
-  if (opts.remove) parts.push(`Removed ${opts.remove} from ${taskId}`);
-  return parts.join("; ");
-}
-
 // src/interactive.ts
 import { execFileSync } from "child_process";
 import { checkbox, confirm, Separator } from "@inquirer/prompts";
@@ -422,6 +302,40 @@ function descriptionPreview(text, maxLines = 3) {
   ${chalk2.dim(`... (${lines.length - maxLines} more lines)`)}`;
   return result;
 }
+function stringifyFieldValue(value) {
+  if (typeof value === "string") return value;
+  if (typeof value === "number" || typeof value === "boolean") return String(value);
+  return JSON.stringify(value);
+}
+function formatCustomFieldValue(field) {
+  if (field.value === null || field.value === void 0) return null;
+  const options = field.type_config?.options;
+  switch (field.type) {
+    case "drop_down": {
+      if (!options) return stringifyFieldValue(field.value);
+      const match = options.find((o) => o.id === Number(field.value));
+      return match?.name ?? stringifyFieldValue(field.value);
+    }
+    case "labels": {
+      if (!Array.isArray(field.value) || !options) return stringifyFieldValue(field.value);
+      const names = field.value.map((id) => options.find((o) => o.id === id)?.name).filter((n) => n !== void 0);
+      return names.length > 0 ? names.join(", ") : null;
+    }
+    case "date": {
+      const ts = Number(field.value);
+      if (!Number.isFinite(ts)) return stringifyFieldValue(field.value);
+      return new Date(ts).toLocaleDateString("en-US", {
+        month: "short",
+        day: "numeric",
+        year: "numeric"
+      });
+    }
+    case "checkbox":
+      return field.value === true || field.value === "true" ? "Yes" : "No";
+    default:
+      return stringifyFieldValue(field.value);
+  }
+}
 function formatTaskDetail(task) {
   const lines = [];
   const isInitiative2 = (task.custom_item_id ?? 0) !== 0;
@@ -451,6 +365,16 @@ function formatTaskDetail(task) {
     if (!value) continue;
     lines.push(`  ${chalk2.bold(label.padEnd(maxLabel + 1))} ${value}`);
   }
+  if (task.custom_fields?.length) {
+    const formatted = task.custom_fields.map((f) => [f.name, formatCustomFieldValue(f)]).filter((pair) => pair[1] !== null);
+    if (formatted.length > 0) {
+      lines.push("");
+      lines.push(chalk2.bold("Custom Fields"));
+      for (const [name, value] of formatted) {
+        lines.push(`  ${chalk2.bold(name)}  ${value}`);
+      }
+    }
+  }
   if (task.text_content?.trim()) {
     lines.push("");
     lines.push(descriptionPreview(task.text_content));
@@ -566,14 +490,10 @@ async function fetchMyTasks(config, opts = {}) {
   return filtered.map(summarize);
 }
 async function printTasks(tasks, forceJson, config) {
-  if (shouldOutputJson(forceJson)) {
+  if (forceJson || !isTTY()) {
     console.log(JSON.stringify(tasks, null, 2));
     return;
   }
-  if (!isTTY()) {
-    console.log(formatTasksMarkdown(tasks));
-    return;
-  }
   if (tasks.length === 0) {
     console.log("No tasks found.");
     return;
@@ -586,6 +506,19 @@ async function printTasks(tasks, forceJson, config) {
   await showDetailsAndOpen(selected, fetchTask);
 }
 
+// src/status.ts
+function matchStatus(input, statuses) {
+  if (!input) return null;
+  const lower = input.toLowerCase();
+  const exact = statuses.find((s) => s.toLowerCase() === lower);
+  if (exact) return exact;
+  const startsWith = statuses.find((s) => s.toLowerCase().startsWith(lower));
+  if (startsWith) return startsWith;
+  const contains = statuses.find((s) => s.toLowerCase().includes(lower));
+  if (contains) return contains;
+  return null;
+}
+
 // src/commands/update.ts
 var PRIORITY_MAP = {
   urgent: 1,
@@ -631,12 +564,30 @@ function buildUpdatePayload(opts) {
 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;
 }
+async function resolveStatus(client, taskId, statusInput) {
+  const task = await client.getTask(taskId);
+  if (!task.space) return statusInput;
+  const space = await client.getSpaceWithStatuses(task.space.id);
+  const available = space.statuses.map((s) => s.status);
+  const matched = matchStatus(statusInput, available);
+  if (!matched) {
+    throw new Error(`No matching status for "${statusInput}". Available: ${available.join(", ")}`);
+  }
+  if (matched.toLowerCase() !== statusInput.toLowerCase()) {
+    process.stderr.write(`Status matched: "${statusInput}" -> "${matched}"
+`);
+  }
+  return matched;
+}
 async function updateTask(config, taskId, options) {
   if (!hasUpdateFields(options))
     throw new Error(
       "Provide at least one of: --name, --description, --status, --priority, --due-date, --assignee"
     );
   const client = new ClickUpClient(config);
+  if (options.status !== void 0) {
+    options.status = await resolveStatus(client, taskId, options.status);
+  }
   const task = await client.updateTask(taskId, options);
   return { id: task.id, name: task.name };
 }
@@ -814,6 +765,83 @@ async function runSprintCommand(config, opts) {
   await printTasks(summaries, opts.json ?? false, config);
 }
 
+// src/commands/sprints.ts
+var SPRINT_COLUMNS = [
+  { key: "id", label: "ID" },
+  { key: "sprint", label: "SPRINT", maxWidth: 60 },
+  { key: "dates", label: "DATES" }
+];
+function formatDate(d) {
+  return `${d.getMonth() + 1}/${d.getDate()}`;
+}
+function buildSprintInfos(lists, folderName, today) {
+  return lists.map((list) => {
+    const dates = parseSprintDates(list.name);
+    const active = dates !== null && today >= dates.start && today <= dates.end;
+    return {
+      id: list.id,
+      name: list.name,
+      folder: folderName,
+      start: dates ? dates.start.toISOString() : null,
+      end: dates ? dates.end.toISOString() : null,
+      active
+    };
+  });
+}
+async function listSprints(config, opts = {}) {
+  const client = new ClickUpClient(config);
+  const [myTasks, allSpaces] = await Promise.all([
+    client.getMyTasks(config.teamId),
+    client.getSpaces(config.teamId)
+  ]);
+  let spaces;
+  if (opts.space) {
+    spaces = allSpaces.filter(
+      (s) => s.name.toLowerCase().includes(opts.space.toLowerCase()) || s.id === opts.space
+    );
+    if (spaces.length === 0) {
+      throw new Error(
+        `No space matching "${opts.space}" found. Use \`cu spaces\` to list available spaces.`
+      );
+    }
+  } else {
+    const mySpaceIds = new Set(
+      myTasks.map((t) => t.space?.id).filter((id) => Boolean(id))
+    );
+    spaces = findRelatedSpaces(mySpaceIds, allSpaces);
+  }
+  const foldersBySpace = await Promise.all(spaces.map((space) => client.getFolders(space.id)));
+  const sprintFolders = foldersBySpace.flat().filter((f) => f.name.toLowerCase().includes("sprint"));
+  const today = /* @__PURE__ */ new Date();
+  const allSprints = [];
+  const listsByFolder = await Promise.all(
+    sprintFolders.map((folder) => client.getFolderLists(folder.id))
+  );
+  for (let i = 0; i < sprintFolders.length; i++) {
+    const folder = sprintFolders[i];
+    const lists = listsByFolder[i];
+    allSprints.push(...buildSprintInfos(lists, folder.name, today));
+  }
+  if (opts.json || !isTTY()) {
+    console.log(JSON.stringify(allSprints, null, 2));
+    return;
+  }
+  if (allSprints.length === 0) {
+    console.log("No sprints found.");
+    return;
+  }
+  const rows = allSprints.map((s) => {
+    const dates = parseSprintDates(s.name);
+    const dateStr = dates ? `${formatDate(dates.start)} - ${formatDate(dates.end)}` : "";
+    return {
+      id: s.id,
+      sprint: s.active ? `* ${s.name}` : s.name,
+      dates: dateStr
+    };
+  });
+  console.log(formatTable(rows, SPRINT_COLUMNS));
+}
+
 // src/commands/subtasks.ts
 async function fetchSubtasks(config, taskId) {
   const client = new ClickUpClient(config);
@@ -851,14 +879,10 @@ async function fetchComments(config, taskId) {
   }));
 }
 function printComments(comments, forceJson) {
-  if (shouldOutputJson(forceJson)) {
+  if (forceJson || !isTTY()) {
     console.log(JSON.stringify(comments, null, 2));
     return;
   }
-  if (!isTTY()) {
-    console.log(formatCommentsMarkdown(comments));
-    return;
-  }
   if (comments.length === 0) {
     console.log("No comments found.");
     return;
@@ -896,14 +920,10 @@ async function fetchLists(config, spaceId, opts = {}) {
   return results;
 }
 function printLists(lists, forceJson) {
-  if (shouldOutputJson(forceJson)) {
+  if (forceJson || !isTTY()) {
     console.log(JSON.stringify(lists, null, 2));
     return;
   }
-  if (!isTTY()) {
-    console.log(formatListsMarkdown(lists));
-    return;
-  }
   if (lists.length === 0) {
     console.log("No lists found.");
     return;
@@ -971,7 +991,7 @@ async function fetchInbox(config, days = 30) {
 async function printInbox(tasks, forceJson, config) {
   const now = Date.now();
   const groups = groupTasks(tasks, now);
-  if (shouldOutputJson(forceJson)) {
+  if (forceJson || !isTTY()) {
     const jsonGroups = {};
     for (const { key } of TIME_PERIODS) {
       if (groups[key].length > 0) {
@@ -981,14 +1001,6 @@ async function printInbox(tasks, forceJson, config) {
     console.log(JSON.stringify(jsonGroups, null, 2));
     return;
   }
-  if (!isTTY()) {
-    const mdGroups = TIME_PERIODS.filter((p) => groups[p.key].length > 0).map((p) => ({
-      label: p.label,
-      tasks: groups[p.key]
-    }));
-    console.log(formatGroupedTasksMarkdown(mdGroups));
-    return;
-  }
   if (tasks.length === 0) {
     console.log("No recently updated tasks.");
     return;
@@ -1020,11 +1032,7 @@ async function listSpaces(config, opts) {
     );
     spaces = spaces.filter((s) => mySpaceIds.has(s.id));
   }
-  if (shouldOutputJson(opts.json ?? false)) {
-    console.log(JSON.stringify(spaces, null, 2));
-  } else if (!isTTY()) {
-    console.log(formatSpacesMarkdown(spaces.map((s) => ({ id: s.id, name: s.name }))));
-  } else {
+  if (!opts.json && isTTY()) {
     const table = formatTable(
       spaces.map((s) => ({ id: s.id, name: s.name })),
       [
@@ -1033,6 +1041,8 @@ async function listSpaces(config, opts) {
       ]
     );
     console.log(table);
+  } else {
+    console.log(JSON.stringify(spaces, null, 2));
   }
 }
 
@@ -1087,7 +1097,7 @@ async function runAssignedCommand(config, opts) {
   const client = new ClickUpClient(config);
   const allTasks = await client.getMyTasks(config.teamId);
   const groups = groupByStatus(allTasks, opts.includeClosed ?? false);
-  if (shouldOutputJson(opts.json ?? false)) {
+  if (opts.json || !isTTY()) {
     const result = {};
     for (const group of groups) {
       result[group.status.toLowerCase()] = group.tasks.map((t) => toJsonTask(t, summarize(t)));
@@ -1095,14 +1105,6 @@ async function runAssignedCommand(config, opts) {
     console.log(JSON.stringify(result, null, 2));
     return;
   }
-  if (!isTTY()) {
-    const mdGroups = groups.map((g) => ({
-      label: g.status,
-      tasks: g.tasks.map((t) => summarize(t))
-    }));
-    console.log(formatGroupedTasksMarkdown(mdGroups));
-    return;
-  }
   if (groups.length === 0) {
     console.log("No tasks found.");
     return;
@@ -1128,13 +1130,13 @@ async function openTask(config, query, opts = {}) {
     } catch {
     }
     if (task) {
-      if (shouldOutputJson(opts.json ?? false)) {
+      if (opts.json) {
         console.log(JSON.stringify(task, null, 2));
-      } else if (!isTTY()) {
-        console.log(formatTaskDetailMarkdown(task));
       } else {
-        console.log(task.name);
-        console.log(task.url);
+        if (isTTY()) {
+          console.log(task.name);
+          console.log(task.url);
+        }
         openUrl(task.url);
       }
       return task;
@@ -1152,18 +1154,15 @@ async function openTask(config, query, opts = {}) {
     }
     console.log("Opening first match...");
   }
-  if (shouldOutputJson(opts.json ?? false)) {
+  if (opts.json) {
     const fullTask = await client.getTask(first.id);
     console.log(JSON.stringify(fullTask, null, 2));
     return fullTask;
   }
-  if (!isTTY()) {
-    const fullTask = await client.getTask(first.id);
-    console.log(formatTaskDetailMarkdown(fullTask));
-    return fullTask;
+  if (isTTY()) {
+    console.log(first.name);
+    console.log(first.url);
   }
-  console.log(first.name);
-  console.log(first.url);
   openUrl(first.url);
   return {
     id: first.id,
@@ -1225,19 +1224,10 @@ async function runSummaryCommand(config, opts) {
   const client = new ClickUpClient(config);
   const allTasks = await client.getMyTasks(config.teamId);
   const result = categorizeTasks(allTasks, opts.hours);
-  if (shouldOutputJson(opts.json)) {
+  if (opts.json || !isTTY()) {
     console.log(JSON.stringify(result, null, 2));
     return;
   }
-  if (!isTTY()) {
-    const mdGroups = [
-      { label: "Completed Recently", tasks: result.completed },
-      { label: "In Progress", tasks: result.inProgress },
-      { label: "Overdue", tasks: result.overdue }
-    ];
-    console.log(formatGroupedTasksMarkdown(mdGroups));
-    return;
-  }
   printSection("Completed Recently", result.completed);
   printSection("In Progress", result.inProgress);
   printSection("Overdue", result.overdue);
@@ -1317,6 +1307,55 @@ async function assignTask(config, taskId, opts) {
   });
 }
 
+// src/commands/activity.ts
+import chalk4 from "chalk";
+function formatDate3(timestamp) {
+  return new Date(Number(timestamp)).toLocaleString("en-US", {
+    month: "short",
+    day: "numeric",
+    year: "numeric",
+    hour: "numeric",
+    minute: "2-digit"
+  });
+}
+async function fetchActivity(config, taskId) {
+  const client = new ClickUpClient(config);
+  const [task, rawComments] = await Promise.all([
+    client.getTask(taskId),
+    client.getTaskComments(taskId)
+  ]);
+  const comments = rawComments.map((c) => ({
+    id: c.id,
+    user: c.user.username,
+    date: c.date,
+    text: c.comment_text
+  }));
+  return { task, comments };
+}
+function printActivity(result, forceJson) {
+  if (forceJson || !isTTY()) {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+  console.log(formatTaskDetail(result.task));
+  console.log("");
+  console.log(chalk4.bold("Comments"));
+  console.log(chalk4.dim("-".repeat(60)));
+  if (result.comments.length === 0) {
+    console.log("No comments.");
+    return;
+  }
+  for (let i = 0; i < result.comments.length; i++) {
+    const c = result.comments[i];
+    if (i > 0) {
+      console.log("");
+      console.log(chalk4.dim("-".repeat(60)));
+    }
+    console.log(`${chalk4.bold(c.user)}  ${chalk4.dim(formatDate3(c.date))}`);
+    console.log(c.text);
+  }
+}
+
 // src/commands/completion.ts
 function bashCompletion() {
   return `_cu_completions() {
@@ -1721,6 +1760,47 @@ function generateCompletion(shell) {
   }
 }
 
+// src/commands/auth.ts
+async function checkAuth(config) {
+  const client = new ClickUpClient(config);
+  try {
+    const user = await client.getMe();
+    return { authenticated: true, user };
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    return { authenticated: false, error: message };
+  }
+}
+
+// src/commands/search.ts
+async function searchTasks(config, query, opts = {}) {
+  const trimmed = query.trim();
+  if (!trimmed) {
+    throw new Error("Search query cannot be empty");
+  }
+  const client = new ClickUpClient(config);
+  const allTasks = await client.getMyTasks(config.teamId);
+  const words = trimmed.toLowerCase().split(/\s+/);
+  let matched = allTasks.filter((task) => {
+    const name = task.name.toLowerCase();
+    return words.every((word) => name.includes(word));
+  });
+  if (opts.status) {
+    const availableStatuses = [...new Set(allTasks.map((t) => t.status.status))];
+    const resolved = matchStatus(opts.status, availableStatuses);
+    if (resolved) {
+      if (resolved.toLowerCase() !== opts.status.toLowerCase()) {
+        process.stderr.write(`Status matched: "${opts.status}" -> "${resolved}"
+`);
+      }
+      matched = matched.filter((t) => t.status.status.toLowerCase() === resolved.toLowerCase());
+    } else {
+      matched = matched.filter((t) => t.status.status.toLowerCase() === opts.status.toLowerCase());
+    }
+  }
+  return matched.map(summarize);
+}
+
 // src/index.ts
 var require2 = createRequire(import.meta.url);
 var { version } = require2("../package.json");
@@ -1739,6 +1819,20 @@ program.command("init").description("Set up cu for the first time").action(
     await runInitCommand();
   })
 );
+program.command("auth").description("Validate API token and show current user").option("--json", "Force JSON output even in terminal").action(
+  wrapAction(async (opts) => {
+    const config = loadConfig();
+    const result = await checkAuth(config);
+    if (opts.json || !isTTY()) {
+      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);
+    }
+  })
+);
 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(
   wrapAction(async (opts) => {
     const config = loadConfig();
@@ -1769,45 +1863,33 @@ program.command("task <taskId>").description("Get task details").option("--json"
   wrapAction(async (taskId, opts) => {
     const config = loadConfig();
     const result = await getTask(config, taskId);
-    if (shouldOutputJson(opts.json ?? false)) {
+    if (opts.json || !isTTY()) {
       console.log(JSON.stringify(result, null, 2));
-    } else if (!isTTY()) {
-      console.log(formatTaskDetailMarkdown(result));
     } else {
-      const lines = [
-        `ID:          ${result.id}`,
-        `Name:        ${result.name}`,
-        `Status:      ${result.status?.status ?? "unknown"}`,
-        `Type:        ${(result.custom_item_id ?? 0) !== 0 ? "initiative" : "task"}`,
-        `List:        ${result.list?.name ?? "unknown"}`,
-        `URL:         ${result.url}`,
-        ...result.parent ? [`Parent:      ${result.parent}`] : [],
-        ...result.description ? ["", result.description] : []
-      ];
-      console.log(lines.join("\n"));
+      console.log(formatTaskDetail(result));
     }
   })
 );
-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").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("--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 (opts.json || !isTTY()) {
       console.log(JSON.stringify(result, null, 2));
     } else {
-      console.log(formatUpdateConfirmation(result.id, result.name));
+      console.log(`Updated task ${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").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("--json", "Force JSON output even in terminal").action(
   wrapAction(async (opts) => {
     const config = loadConfig();
     const result = await createTask(config, opts);
-    if (shouldOutputJson(false)) {
+    if (opts.json || !isTTY()) {
       console.log(JSON.stringify(result, null, 2));
     } else {
-      console.log(formatCreateConfirmation(result.id, result.name, result.url));
+      console.log(`Created task ${result.id}: "${result.name}" - ${result.url}`);
     }
   })
 );
@@ -1817,6 +1899,12 @@ program.command("sprint").description("List my tasks in the current active sprin
     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) => {
+    const config = loadConfig();
+    await listSprints(config, opts);
+  })
+);
 program.command("subtasks <taskId>").description("List subtasks of a task or initiative").option("--json", "Force JSON output even in terminal").action(
   wrapAction(async (taskId, opts) => {
     const config = loadConfig();
@@ -1828,10 +1916,10 @@ program.command("comment <taskId>").description("Post a comment on a task").requ
   wrapAction(async (taskId, opts) => {
     const config = loadConfig();
     const result = await postComment(config, taskId, opts.message);
-    if (shouldOutputJson(false)) {
-      console.log(JSON.stringify(result, null, 2));
+    if (isTTY()) {
+      console.log(`Comment posted (id: ${result.id})`);
     } else {
-      console.log(formatCommentConfirmation(result.id));
+      console.log(JSON.stringify(result, null, 2));
     }
   })
 );
@@ -1842,6 +1930,13 @@ program.command("comments <taskId>").description("List comments on a task").opti
     printComments(comments, opts.json ?? false);
   })
 );
+program.command("activity <taskId>").description("Show task details and comments combined").option("--json", "Force JSON output even in terminal").action(
+  wrapAction(async (taskId, opts) => {
+    const config = loadConfig();
+    const result = await fetchActivity(config, taskId);
+    printActivity(result, opts.json ?? false);
+  })
+);
 program.command("lists <spaceId>").description("List all lists in a space (including lists inside folders)").option("--name <partial>", "Filter by name (case-insensitive contains)").option("--json", "Force JSON output even in terminal").action(
   wrapAction(async (spaceId, opts) => {
     const config = loadConfig();
@@ -1879,6 +1974,13 @@ 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("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();
@@ -1901,10 +2003,13 @@ program.command("assign <taskId>").description("Assign or unassign users from a
   wrapAction(async (taskId, opts) => {
     const config = loadConfig();
     const result = await assignTask(config, taskId, opts);
-    if (shouldOutputJson(opts.json ?? false)) {
+    if (opts.json || !isTTY()) {
       console.log(JSON.stringify(result, null, 2));
     } else {
-      console.log(formatAssignConfirmation(taskId, { to: opts.to, remove: opts.remove }));
+      const parts = [];
+      if (opts.to) parts.push(`Assigned ${opts.to} to task ${taskId}`);
+      if (opts.remove) parts.push(`Removed ${opts.remove} from task ${taskId}`);
+      console.log(parts.join("; "));
     }
   })
 );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@krodak/clickup-cli",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "ClickUp CLI for AI agents and humans",
   "type": "module",
   "license": "MIT",
@@ -24,6 +24,8 @@
   },
   "files": [
     "dist",
+    ".claude-plugin",
+    "skills",
     "README.md",
     "LICENSE"
   ],

package/skills/clickup-cli/SKILL.md

@@ -0,0 +1,149 @@
+---
+name: clickup
+description: 'Use when managing ClickUp tasks, initiatives, sprints, or comments via the `cu` CLI tool. Covers task queries, status updates, sprint tracking, and project management workflows.'
+---
+
+# ClickUp CLI (`cu`)
+
+Reference for AI agents using the `cu` command-line tool to interact with ClickUp. Covers task management, sprint tracking, initiatives, and comments.
+
+Keywords: ClickUp, task management, sprint, initiative, project management, agile, backlog, subtasks
+
+## Setup
+
+Config at `~/.config/cu/config.json` (or `$XDG_CONFIG_HOME/cu/config.json`) with `apiToken` and `teamId`. Run `cu init` to set up.
+
+Alternatively, set `CU_API_TOKEN` and `CU_TEAM_ID` environment variables (overrides config file, no file needed when both are set).
+
+## Commands
+
+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 inbox [--days n] [--json]`                                             | Tasks updated in last n days (default 30)          |
+| `cu task <id> [--json]`                                                    | Single task details                                |
+| `cu subtasks <id> [--json]`                                                | Subtasks of a task or initiative                   |
+| `cu comments <id> [--json]`                                                | List comments on a task                            |
+| `cu spaces [--name partial] [--my] [--json]`                               | List/filter workspace spaces                       |
+| `cu lists <spaceId> [--name partial] [--json]`                             | List all lists in a space (including folder lists) |
+| `cu open <query> [--json]`                                                 | Open task in browser by ID or name                 |
+| `cu summary [--hours n] [--json]`                                          | Standup helper: completed, in-progress, overdue    |
+| `cu overdue [--json]`                                                      | Tasks past their due date                          |
+| `cu search <query> [--status s] [--json]`                                  | Search my tasks by name (multi-word, fuzzy status) |
+| `cu activity <id> [--json]`                                                | Task details + comment history combined            |
+| `cu auth [--json]`                                                         | Check authentication status                        |
+| `cu sprints [--space nameOrId] [--json]`                                   | List all sprints (marks active with \*)            |
+
+### 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 from a task            |
+| `cu config get <key>` / `cu config set <key> <value>` / `cu config path`                                                              | Manage CLI config                            |
+| `cu completion <shell>`                                                                                                               | Output shell completions (bash/zsh/fish)     |
+
+## Output modes
+
+- **TTY (terminal)**: Interactive picker UI. Use `--json` to bypass.
+- **Piped / non-TTY**: Always JSON. This is what agents get by default.
+- **Agents should always pass `--json`** to guarantee machine-readable output.
+- Set `NO_COLOR` to disable color output (tables still render, just without color).
+
+## Key facts
+
+- All task IDs are stable alphanumeric strings (e.g. `abc123def`)
+- Initiatives are detected via `custom_item_id !== 0` (not `task_type`)
+- `--list` is optional in `cu create` when `--parent` is given (list auto-detected from parent)
+- `cu sprint` auto-detects active sprint from spaces where user has tasks, using view API and date range parsing from sprint names like "Acme Sprint 4 (3/1 - 3/14)"
+- `--name` on tasks/initiatives filters by partial name match (case-insensitive)
+- `--space` on sprint/tasks accepts partial name match (e.g. `--space Acm`)
+- `--priority` accepts names (`urgent`, `high`, `normal`, `low`) or numbers (1-4)
+- `--due-date` accepts `YYYY-MM-DD` format
+- `--assignee` takes a numeric user ID (use `cu task <id> --json` to find assignee IDs)
+- `cu assign` supports `me` as a shorthand for your own user ID
+- `cu open` tries task ID lookup first, then falls back to name search
+- `cu summary` categories: completed (done/complete/closed within N hours), in progress, overdue
+- `cu overdue` excludes done/complete/closed tasks, sorted most overdue first
+- `--tags` accepts comma-separated tag names (e.g. `--tags "bug,frontend"`)
+- `cu lists <spaceId>` discovers list IDs needed for `--list` and `cu create -l`
+- Strict argument parsing - excess/unknown arguments are rejected
+- `cu update -s` supports fuzzy status matching (exact > starts-with > contains). Prints matched status to stderr when fuzzy-resolved.
+- `cu task` shows custom fields in detail view (read-only)
+- `cu search` matches all query words against task name (case-insensitive). `--status` supports fuzzy matching.
+- Errors go to stderr with exit code 1
+
+## Agent workflow example
+
+```bash
+# List my in-progress tasks
+cu tasks --status "in progress" --json
+
+# Find tasks by partial name
+cu tasks --name "login" --json
+
+# Check current sprint
+cu sprint --json | jq '.[].name'
+
+# Get full details on a task
+cu task abc123def --json
+
+# List subtasks of an initiative
+cu subtasks abc123def --json
+
+# Read comments on a task
+cu comments abc123def --json
+
+# Update task status
+cu update abc123def -s "done"
+
+# Update priority and due date
+cu update abc123def --priority high --due-date 2025-03-15
+
+# Create subtask under initiative (no --list needed)
+cu create -n "Fix the thing" -p abc123def
+
+# Create task with priority and tags
+cu create -n "Fix bug" -l <listId> --priority urgent --tags "bug,frontend"
+
+# Post a comment
+cu comment abc123def -m "Completed in PR #42"
+
+# Discover lists in a space
+cu lists <spaceId> --json
+
+# Open a task in the browser
+cu open abc123def
+
+# Standup summary
+cu summary --json
+
+# Check overdue tasks
+cu overdue --json
+
+# Assign yourself to a task
+cu assign abc123def --to me
+
+# Check/set config
+cu config get teamId
+cu config set apiToken pk_example_token
+
+cu search "login bug" --json
+
+cu activity abc123def --json
+
+cu auth --json
+
+cu sprints --json
+
+cu update abc123def -s "prog"
+```