clickup-agent-cli 0.2.1 → 0.3.0

package/.claude-plugin/marketplace.json

@@ -10,8 +10,8 @@
     {
       "name": "clickup",
       "source": "./",
-      "description": "ClickUp CLI with 23 agent skills covering the full API -- token-efficient alternative to MCP with chat, time tracking, docs, and project management workflows",
-      "version": "0.2.1",
+      "description": "ClickUp CLI with 25 agent skills covering the full API -- token-efficient alternative to MCP with chat, time tracking, docs, and project management workflows",
+      "version": "0.3.0",
       "homepage": "https://github.com/henryreith/clickup-cli",
       "keywords": ["clickup", "project-management", "tasks", "time-tracking"],
       "category": "productivity"

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "clickup",
-  "description": "ClickUp CLI with 23 agent skills covering the full API -- token-efficient alternative to MCP with chat, time tracking, docs, and project management workflows",
-  "version": "0.2.1",
+  "description": "ClickUp CLI with 25 agent skills covering the full API -- token-efficient alternative to MCP with chat, time tracking, docs, and project management workflows",
+  "version": "0.3.0",
   "author": {
     "name": "Henry Reith"
   },

package/dist/clickup.js

@@ -47,7 +47,7 @@ function mapToExitCode(error) {
       return 1;
   }
 }
-var ClickUpError, ECODE_MESSAGES, STATUS_MESSAGES, EXIT_CODES;
+var ClickUpError, ECODE_MESSAGES, STATUS_MESSAGES, EXIT_CODES, DryRunComplete;
 var init_errors = __esm({
   "src/errors.ts"() {
     "use strict";
@@ -85,6 +85,12 @@ var init_errors = __esm({
       RATE_LIMITED: 6,
       NETWORK_ERROR: 7
     };
+    DryRunComplete = class extends Error {
+      constructor() {
+        super("Dry run complete");
+        this.name = "DryRunComplete";
+      }
+    };
   }
 });
 
@@ -140,6 +146,31 @@ var init_client = __esm({
       async delete(path, body) {
         return this.request("DELETE", path, body);
       }
+      async downloadUrl(url) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+          const response = await fetch(url, {
+            headers: { Authorization: this.token },
+            signal: controller.signal
+          });
+          clearTimeout(timeoutId);
+          if (!response.ok) {
+            const body = await this.safeJson(response);
+            throw parseApiError(body, response.status);
+          }
+          return response.arrayBuffer();
+        } catch (error) {
+          clearTimeout(timeoutId);
+          if (error instanceof ClickUpError) throw error;
+          throw new ClickUpError(
+            `Network error: ${error instanceof Error ? error.message : "Unknown error"}`,
+            0,
+            void 0,
+            void 0
+          );
+        }
+      }
       async upload(path, filePath, filename) {
         const fileBuffer = readFileSync(filePath);
         const resolvedFilename = filename ?? basename(filePath);
@@ -148,7 +179,7 @@ var init_client = __esm({
         const url = `${this.baseUrl}${path}`;
         if (this.dryRun) {
           this.logDryRun("POST", url, "[multipart form data]");
-          return {};
+          throw new DryRunComplete();
         }
         const controller = new AbortController();
         const timeoutId = setTimeout(() => controller.abort(), this.timeout);
@@ -193,7 +224,7 @@ var init_client = __esm({
         }
         if (this.dryRun) {
           this.logDryRun(method, url, body);
-          return {};
+          throw new DryRunComplete();
         }
         let lastError;
         for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
@@ -328,35 +359,111 @@ Headers: ${JSON.stringify(redactedHeaders)}
 });
 
 // src/config.ts
+import { readFileSync as readFileSync2 } from "fs";
 import Conf from "conf";
 function isValidConfigKey(key) {
-  return CONFIG_KEYS.includes(key);
-}
-function resolveString(key, flagValue) {
-  if (flagValue !== void 0) return flagValue;
-  const envVal = process.env[ENV_MAP[key]];
-  if (envVal !== void 0) return envVal;
-  const stored = config.get(key);
-  if (typeof stored === "string") return stored;
-  return void 0;
+  return ALL_CONFIG_KEYS.includes(key);
+}
+function setProfileOverride(nameOrKey) {
+  _profileOverride = nameOrKey ? findProfileKey(nameOrKey) : void 0;
+}
+function getActiveProfileKey() {
+  if (_profileOverride) return _profileOverride;
+  const active = config.get("active_profile");
+  return active ?? "default";
+}
+function getProfiles() {
+  const stored = config.get("profiles");
+  return stored ?? {};
+}
+function setProfile(key, profile) {
+  const profiles = getProfiles();
+  profiles[key] = profile;
+  config.set("profiles", profiles);
 }
-function resolveToken(flagValue) {
-  return resolveString("token", flagValue);
+function deleteProfile(key) {
+  const profiles = getProfiles();
+  delete profiles[key];
+  config.set("profiles", profiles);
+}
+function slugifyWorkspaceName(name) {
+  return name.toLowerCase().replace(/'/g, "").replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
+}
+function findProfileKey(nameOrKey) {
+  const profiles = getProfiles();
+  if (profiles[nameOrKey] !== void 0) return nameOrKey;
+  const lower = nameOrKey.toLowerCase();
+  for (const [key, profile] of Object.entries(profiles)) {
+    if (profile.workspace_name?.toLowerCase() === lower) return key;
+    if (profile.nickname?.toLowerCase() === lower) return key;
+  }
+  for (const [key, profile] of Object.entries(profiles)) {
+    if (profile.workspace_name?.toLowerCase().includes(lower)) return key;
+    if (profile.nickname?.toLowerCase().includes(lower)) return key;
+  }
+  return nameOrKey;
+}
+function migrateConfig() {
+  const legacyToken = config.get("token");
+  const legacyWorkspaceId = config.get("workspace_id");
+  if (!legacyToken && !legacyWorkspaceId) return;
+  const profiles = getProfiles();
+  if (!profiles["default"]) {
+    const defaultProfile = {};
+    if (legacyToken) defaultProfile.token = legacyToken;
+    if (legacyWorkspaceId) defaultProfile.workspace_id = legacyWorkspaceId;
+    setProfile("default", defaultProfile);
+    config.delete("token");
+    config.delete("workspace_id");
+  }
+}
+function resolveToken(flagValue, tokenFilePath) {
+  if (flagValue) return flagValue;
+  if (tokenFilePath) {
+    try {
+      const content = readFileSync2(tokenFilePath, "utf8").trim();
+      if (content) return content;
+    } catch {
+    }
+  }
+  const envVal = process.env["CLICKUP_API_TOKEN"];
+  if (envVal) return envVal;
+  const profileKey = getActiveProfileKey();
+  const profiles = getProfiles();
+  const activeProfile = profiles[profileKey];
+  if (activeProfile?.token) return activeProfile.token;
+  const legacyToken = config.get("token");
+  if (legacyToken) return legacyToken;
+  return void 0;
 }
 function resolveWorkspaceId(flagValue) {
-  return resolveString("workspace_id", flagValue);
+  if (flagValue) return flagValue;
+  const envVal = process.env["CLICKUP_WORKSPACE_ID"];
+  if (envVal) return envVal;
+  const profileKey = getActiveProfileKey();
+  const profiles = getProfiles();
+  const activeProfile = profiles[profileKey];
+  if (activeProfile?.workspace_id) return activeProfile.workspace_id;
+  const withWorkspace = Object.values(profiles).filter((p) => p.workspace_id);
+  if (withWorkspace.length === 1) return withWorkspace[0].workspace_id;
+  const legacyId = config.get("workspace_id");
+  if (legacyId) return legacyId;
+  return void 0;
 }
 function resolveOutputFormat(flagValue) {
-  const val = resolveString("output_format", flagValue);
-  if (val) return val;
+  if (flagValue) return flagValue;
+  const envVal = process.env["CLICKUP_OUTPUT_FORMAT"];
+  if (envVal) return envVal;
+  const stored = config.get("output_format");
+  if (stored) return stored;
   return process.stdout.isTTY ? "table" : "json";
 }
-var CONFIG_KEYS, VALID_CONFIG_KEYS, config, ENV_MAP;
+var ALL_CONFIG_KEYS, VALID_CONFIG_KEYS, config, _profileOverride;
 var init_config = __esm({
   "src/config.ts"() {
     "use strict";
-    CONFIG_KEYS = ["token", "workspace_id", "output_format", "color", "page_size", "timezone"];
-    VALID_CONFIG_KEYS = CONFIG_KEYS;
+    ALL_CONFIG_KEYS = ["token", "workspace_id", "output_format", "color", "page_size", "timezone", "active_profile"];
+    VALID_CONFIG_KEYS = ALL_CONFIG_KEYS;
     config = new Conf({
       projectName: "clickup-cli",
       schema: {
@@ -365,17 +472,15 @@ var init_config = __esm({
         output_format: { type: "string", enum: ["table", "json", "csv", "tsv", "quiet", "id"] },
         color: { type: "boolean", default: true },
         page_size: { type: "number", default: 100 },
-        timezone: { type: "string" }
+        timezone: { type: "string" },
+        active_profile: { type: "string" },
+        profiles: { type: "object" }
       }
     });
-    ENV_MAP = {
-      token: "CLICKUP_API_TOKEN",
-      workspace_id: "CLICKUP_WORKSPACE_ID",
-      output_format: "CLICKUP_OUTPUT_FORMAT",
-      color: "CLICKUP_COLOR",
-      page_size: "CLICKUP_PAGE_SIZE",
-      timezone: "CLICKUP_TIMEZONE"
-    };
+    try {
+      migrateConfig();
+    } catch {
+    }
   }
 });
 
@@ -532,9 +637,10 @@ import { Command } from "commander";
 
 // src/commands/auth-cmd.ts
 init_config();
+import { readFileSync as readFileSync3 } from "fs";
 function registerAuthCommands(program, getClient) {
   const auth = program.command("auth").description("Manage authentication");
-  auth.command("login").description("Authenticate with ClickUp").option("--token <token>", "Personal API token").option("--oauth", "Use OAuth2 PKCE browser flow (requires CLICKUP_CLIENT_ID and CLICKUP_CLIENT_SECRET)").action(async (opts) => {
+  auth.command("login").description("Authenticate with ClickUp").option("--token <token>", "Personal API token").option("--token-file <path>", "Read token from this file path").option("--oauth", "Use OAuth2 PKCE browser flow (requires CLICKUP_CLIENT_ID and CLICKUP_CLIENT_SECRET)").action(async (opts) => {
     if (opts.oauth) {
       const { oauthLogin: oauthLogin2 } = await Promise.resolve().then(() => (init_auth(), auth_exports));
       const token2 = await oauthLogin2();
@@ -550,9 +656,19 @@ function registerAuthCommands(program, getClient) {
       return;
     }
     let token = opts.token;
+    if (!token && opts.tokenFile) {
+      try {
+        token = readFileSync3(opts.tokenFile, "utf8").trim();
+      } catch {
+        process.stderr.write(`Error: Could not read token file: ${opts.tokenFile}
+`);
+        process.exit(2);
+        return;
+      }
+    }
     if (!token) {
       if (!process.stdin.isTTY) {
-        process.stderr.write("Error: No token provided. Use --token <token> or --oauth in non-interactive mode.\n");
+        process.stderr.write("Error: No token provided. Use --token <token>, --token-file <path>, or --oauth in non-interactive mode.\n");
         process.exit(2);
         return;
       }
@@ -571,15 +687,29 @@ function registerAuthCommands(program, getClient) {
     const client = new ClientClass({ token });
     try {
       const userData = await client.get("/user");
-      config.set("token", token);
+      const profileKey = getActiveProfileKey();
+      const profiles = getProfiles();
+      const existing = profiles[profileKey] ?? {};
+      setProfile(profileKey, { ...existing, token });
       process.stdout.write(`Authenticated as ${userData.user.username} (${userData.user.email})
 `);
+      const profile = getProfiles()[profileKey];
+      if (!profile?.workspace_id) {
+        process.stdout.write("Run: clickup workspace setup -- to configure your workspace.\n");
+      }
     } catch {
       process.stderr.write("Error: Invalid token. Authentication failed.\n");
       process.exit(3);
     }
   });
   auth.command("logout").description("Remove stored credentials").action(() => {
+    const profileKey = getActiveProfileKey();
+    const profiles = getProfiles();
+    const existing = profiles[profileKey];
+    if (existing) {
+      const { token: _removed, ...profileWithoutToken } = existing;
+      setProfile(profileKey, profileWithoutToken);
+    }
     config.delete("token");
     process.stdout.write("Logged out. Token removed.\n");
   });
@@ -592,9 +722,17 @@ function registerAuthCommands(program, getClient) {
     const prefix = token.slice(0, 8);
     process.stdout.write(`Token: ${prefix}...
 `);
-    const workspaceId = config.get("workspace_id");
-    if (workspaceId) {
-      process.stdout.write(`Workspace: ${workspaceId}
+    const profileKey = getActiveProfileKey();
+    process.stdout.write(`Profile: ${profileKey}
+`);
+    const profiles = getProfiles();
+    const activeProfile = profiles[profileKey];
+    if (activeProfile?.workspace_id) {
+      process.stdout.write(`Workspace: ${activeProfile.workspace_name ?? activeProfile.workspace_id}
+`);
+    } else {
+      const legacyId = config.get("workspace_id");
+      if (legacyId) process.stdout.write(`Workspace: ${legacyId}
 `);
     }
     try {
@@ -620,7 +758,7 @@ function registerAuthCommands(program, getClient) {
 
 // src/commands/config-cmd.ts
 init_config();
-function registerConfigCommands(program) {
+function registerConfigCommands(program, getClient) {
   const configCmd = program.command("config").description("Manage CLI configuration");
   configCmd.command("set").description("Set a configuration value").argument("<key>", "Config key").argument("<value>", "Config value").action((key, value) => {
     if (!isValidConfigKey(key)) {
@@ -694,6 +832,141 @@ function registerConfigCommands(program) {
   configCmd.command("path").description("Print the config file path").action(() => {
     process.stdout.write(config.path + "\n");
   });
+  configCmd.command("validate").description("Verify the stored token works and show current identity").action(async () => {
+    const client = getClient();
+    let user;
+    try {
+      const userData = await client.get("/user");
+      user = userData.user;
+    } catch (err) {
+      process.stderr.write(`Error: Token validation failed. Run: clickup auth login
+`);
+      process.exit(3);
+      return;
+    }
+    let workspaceName = "(none)";
+    let workspaceId = "(none)";
+    try {
+      const teamsData = await client.get("/team");
+      const activeKey = getActiveProfileKey();
+      const profiles = getProfiles();
+      const activeProfile = profiles[activeKey];
+      if (activeProfile?.workspace_id) {
+        const match = teamsData.teams.find((t) => t.id === activeProfile.workspace_id);
+        workspaceName = match?.name ?? activeProfile.workspace_name ?? activeProfile.workspace_id;
+        workspaceId = activeProfile.workspace_id;
+      } else if (teamsData.teams.length > 0) {
+        workspaceName = teamsData.teams.map((t) => t.name).join(", ");
+        workspaceId = teamsData.teams.map((t) => t.id).join(", ");
+      }
+    } catch {
+    }
+    process.stdout.write(`User:             ${user.username} (${user.email})
+`);
+    process.stdout.write(`Active profile:   ${getActiveProfileKey()}
+`);
+    process.stdout.write(`Workspace:        ${workspaceName}
+`);
+    process.stdout.write(`Workspace ID:     ${workspaceId}
+`);
+    process.stdout.write(`Token status:     Valid
+`);
+  });
+  const profileCmd = configCmd.command("profile").description("Manage named profiles");
+  profileCmd.command("list").description("List all profiles").action(() => {
+    const profiles = getProfiles();
+    const activeKey = getActiveProfileKey();
+    const keys = Object.keys(profiles);
+    if (keys.length === 0) {
+      process.stdout.write("No profiles configured. Run: clickup auth login\n");
+      return;
+    }
+    const col = (s, w) => s.padEnd(w).slice(0, w);
+    process.stdout.write(
+      `${col("Key", 20)} ${col("Workspace Name", 30)} ${col("Nickname", 15)} ${col("Workspace ID", 16)} Active
+`
+    );
+    process.stdout.write(`${"-".repeat(20)} ${"-".repeat(30)} ${"-".repeat(15)} ${"-".repeat(16)} ------
+`);
+    for (const key of keys) {
+      const p = profiles[key];
+      const active = key === activeKey ? "*" : "";
+      process.stdout.write(
+        `${col(key, 20)} ${col(p.workspace_name ?? "", 30)} ${col(p.nickname ?? "", 15)} ${col(p.workspace_id ?? "", 16)} ${active}
+`
+      );
+    }
+  });
+  profileCmd.command("create").description("Create an empty profile").argument("<key>", "Profile key").action((key) => {
+    const profiles = getProfiles();
+    if (profiles[key]) {
+      process.stderr.write(`Error: Profile "${key}" already exists.
+`);
+      process.exit(2);
+      return;
+    }
+    setProfile(key, {});
+    process.stdout.write(`Profile "${key}" created.
+`);
+  });
+  profileCmd.command("delete").description("Delete a profile").argument("<key>", "Profile key").option("--confirm", "Skip confirmation prompt").action(async (key, opts) => {
+    const profiles = getProfiles();
+    if (!profiles[key]) {
+      process.stderr.write(`Error: Profile "${key}" not found.
+`);
+      process.exit(2);
+      return;
+    }
+    const isActive = key === getActiveProfileKey();
+    if (!opts.confirm) {
+      if (!process.stdin.isTTY) {
+        process.stderr.write("Error: Add --confirm to delete a profile in non-interactive mode.\n");
+        process.exit(2);
+        return;
+      }
+      const { confirm } = await import("@inquirer/prompts");
+      const answer = await confirm({
+        message: isActive ? `"${key}" is the active profile. Delete it?` : `Delete profile "${key}"?`,
+        default: false
+      });
+      if (!answer) {
+        process.stdout.write("Cancelled.\n");
+        return;
+      }
+    }
+    deleteProfile(key);
+    if (isActive) {
+      config.delete("active_profile");
+    }
+    process.stdout.write(`Profile "${key}" deleted.
+`);
+  });
+  profileCmd.command("use").description("Switch the active profile").argument("<key>", "Profile key, workspace name, or nickname").action((nameOrKey) => {
+    const profiles = getProfiles();
+    const resolvedKey = findProfileKey(nameOrKey);
+    if (!profiles[resolvedKey]) {
+      process.stderr.write(`Error: Profile "${nameOrKey}" not found.
+`);
+      process.exit(2);
+      return;
+    }
+    config.set("active_profile", resolvedKey);
+    process.stdout.write(`Active profile: ${resolvedKey}
+`);
+  });
+  profileCmd.command("nickname").description("Set a short nickname for a profile").argument("<key>", "Profile key").argument("<nickname>", "Short nickname").action((key, nickname) => {
+    const profiles = getProfiles();
+    const profile = profiles[key];
+    if (!profile) {
+      process.stderr.write(`Error: Profile "${key}" not found.
+`);
+      process.exit(2);
+      return;
+    }
+    setProfile(key, { ...profile, nickname });
+    process.stdout.write(`Nickname "${nickname}" set for profile "${key}".
+`);
+  });
 }
 
 // src/commands/workspace.ts
@@ -869,6 +1142,7 @@ function getFields(resource, action) {
 }
 
 // src/commands/workspace.ts
+registerSchema("workspace", "setup", "Configure workspace -- fetches workspaces and saves profile", []);
 registerSchema("workspace", "list", "List all workspaces accessible to the authenticated user", []);
 registerSchema("workspace", "get", "Get workspace details", [
   { flag: "--workspace-id", type: "string", required: true, description: "Workspace ID" }
@@ -912,6 +1186,49 @@ function requireWorkspaceId(program) {
 }
 function registerWorkspaceCommands(program, getClient) {
   const workspace = program.command("workspace").description("Manage workspaces");
+  workspace.command("setup").description("Configure workspace for the active profile").action(async () => {
+    const client = getClient();
+    const data = await client.get("/team");
+    const teams = data.teams;
+    if (teams.length === 0) {
+      process.stderr.write("Error: No workspaces found for this token.\n");
+      process.exit(1);
+      return;
+    }
+    let selected;
+    if (teams.length === 1) {
+      selected = teams[0];
+    } else {
+      if (!process.stdin.isTTY) {
+        process.stderr.write("Error: Multiple workspaces found. Use --workspace-id or run in interactive mode.\n");
+        process.exit(2);
+        return;
+      }
+      const { select } = await import("@inquirer/prompts");
+      const selectedId = await select({
+        message: "Select workspace:",
+        choices: teams.map((t) => ({ name: t.name, value: t.id }))
+      });
+      selected = teams.find((t) => t.id === selectedId);
+    }
+    const profileKey = getActiveProfileKey();
+    const profiles = getProfiles();
+    const existing = profiles[profileKey] ?? {};
+    const slugKey = slugifyWorkspaceName(selected.name);
+    setProfile(profileKey, {
+      ...existing,
+      workspace_id: selected.id,
+      workspace_name: selected.name
+    });
+    process.stdout.write(
+      `Workspace "${selected.name}" saved as profile "${profileKey}".
+`
+    );
+    if (slugKey !== profileKey) {
+      process.stdout.write(`Use --profile "${selected.name}" or --profile ${profileKey}
+`);
+    }
+  });
   workspace.command("list").description("List all workspaces").action(async () => {
     const client = getClient();
     const data = await client.get("/team");
@@ -1351,6 +1668,17 @@ registerSchema("task", "delete", "Delete a task", [
 registerSchema("task", "time-in-status", "Get time spent in each status for a task", [
   { flag: "<task-id>", type: "string", required: true, description: "Task ID" }
 ]);
+registerSchema("task", "bulk-update", "Apply the same update to multiple tasks", [
+  { flag: "--task-id", type: "string[]", required: true, description: "Task ID (repeatable)" },
+  { flag: "--name", type: "string", required: false, description: "New task name" },
+  { flag: "--description", type: "string", required: false, description: "New description" },
+  { flag: "--status", type: "string", required: false, description: "New status" },
+  { flag: "--priority", type: "string", required: false, description: "New priority (1-4 or urgent/high/normal/low)" }
+]);
+registerSchema("task", "bulk-delete", "Delete multiple tasks", [
+  { flag: "--task-id", type: "string[]", required: true, description: "Task ID (repeatable)" },
+  { flag: "--confirm", type: "boolean", required: false, description: "Skip confirmation prompt" }
+]);
 var TASK_COLUMNS = [
   { key: "id", header: "ID", width: 12 },
   { key: "name", header: "Name", width: 30 },
@@ -1377,6 +1705,35 @@ function requireWorkspaceId3(program) {
 function collect(value, previous) {
   return previous.concat([value]);
 }
+var PRIORITY_MAP = {
+  urgent: 1,
+  high: 2,
+  normal: 3,
+  low: 4
+};
+function parsePriority(value) {
+  const lower = value.toLowerCase();
+  if (PRIORITY_MAP[lower] !== void 0) return PRIORITY_MAP[lower];
+  const num = parseInt(value, 10);
+  if (!isNaN(num) && num >= 1 && num <= 4) return num;
+  throw new Error("--priority must be 1-4 or urgent/high/normal/low");
+}
+async function runConcurrent(tasks, limit) {
+  const results = new Array(tasks.length);
+  let idx = 0;
+  async function worker() {
+    while (idx < tasks.length) {
+      const current = idx++;
+      try {
+        results[current] = await tasks[current]();
+      } catch (e) {
+        results[current] = e instanceof Error ? e : new Error(String(e));
+      }
+    }
+  }
+  await Promise.all(Array.from({ length: Math.min(limit, tasks.length) }, worker));
+  return results;
+}
 function buildTaskListParams(opts) {
   const params = {};
   if (opts.archived) params["archived"] = "true";
@@ -1455,13 +1812,13 @@ function registerTaskCommands(program, getClient) {
     const data = await client.get(`/task/${taskId}`, params);
     formatOutput(data, TASK_COLUMNS, getOutputOptions(program));
   });
-  task.command("create").description("Create a new task").requiredOption("--list-id <id>", "List ID").requiredOption("--name <name>", "Task name").option("--description <desc>", "Plain text description").option("--markdown-description <md>", "Markdown description (overrides --description)").option("--status <s>", "Initial status").option("--priority <n>", "Priority (1=urgent, 2=high, 3=normal, 4=low)", parseInt).option("--due-date <date>", "Due date (Unix ms)").option("--start-date <date>", "Start date (Unix ms)").option("--assignee <id>", "Assignee user ID (repeatable)", collect, []).option("--tag <name>", "Tag name (repeatable)", collect, []).option("--time-estimate <ms>", "Time estimate in milliseconds", parseInt).option("--notify-all", "Notify all assignees and watchers").option("--parent <task-id>", "Parent task ID (creates subtask)").option("--links-to <task-id>", "Link to another task").option("--custom-field <id=value>", "Set custom field (repeatable)", collect, []).option("--check-required-custom-fields", "Reject if required custom fields are missing").action(async (opts) => {
+  task.command("create").description("Create a new task").requiredOption("--list-id <id>", "List ID").requiredOption("--name <name>", "Task name").option("--description <desc>", "Plain text description").option("--markdown-description <md>", "Markdown description (overrides --description)").option("--status <s>", "Initial status").option("--priority <n>", "Priority (1-4 or urgent/high/normal/low)").option("--due-date <date>", "Due date (Unix ms)").option("--start-date <date>", "Start date (Unix ms)").option("--assignee <id>", "Assignee user ID (repeatable)", collect, []).option("--tag <name>", "Tag name (repeatable)", collect, []).option("--time-estimate <ms>", "Time estimate in milliseconds", parseInt).option("--notify-all", "Notify all assignees and watchers").option("--parent <task-id>", "Parent task ID (creates subtask)").option("--links-to <task-id>", "Link to another task").option("--custom-field <id=value>", "Set custom field (repeatable)", collect, []).option("--check-required-custom-fields", "Reject if required custom fields are missing").action(async (opts) => {
     const client = getClient();
     const body = { name: opts.name };
     if (opts.markdownDescription !== void 0) body["markdown_description"] = opts.markdownDescription;
     else if (opts.description !== void 0) body["description"] = opts.description;
     if (opts.status !== void 0) body["status"] = opts.status;
-    if (opts.priority !== void 0) body["priority"] = opts.priority;
+    if (opts.priority !== void 0) body["priority"] = parsePriority(opts.priority);
     if (opts.dueDate !== void 0) body["due_date"] = parseInt(opts.dueDate, 10);
     if (opts.startDate !== void 0) body["start_date"] = parseInt(opts.startDate, 10);
     const assignees = opts.assignee;
@@ -1490,13 +1847,13 @@ function registerTaskCommands(program, getClient) {
     const data = await client.post(`/list/${opts.listId}/task`, body);
     formatOutput(data, TASK_COLUMNS, getOutputOptions(program));
   });
-  task.command("update").description("Update a task").argument("<task-id>", "Task ID").option("--name <name>", "New task name").option("--description <desc>", "New description").option("--status <s>", "New status").option("--priority <n>", "New priority (1-4)", parseInt).option("--due-date <date>", "New due date (Unix ms)").option("--start-date <date>", "New start date (Unix ms)").option("--time-estimate <ms>", "New time estimate in milliseconds", parseInt).option("--assignee-add <id>", "Add assignee (repeatable)", collect, []).option("--assignee-remove <id>", "Remove assignee (repeatable)", collect, []).option("--archived <bool>", "Archive or unarchive").action(async (taskId, opts) => {
+  task.command("update").description("Update a task").argument("<task-id>", "Task ID").option("--name <name>", "New task name").option("--description <desc>", "New description").option("--status <s>", "New status").option("--priority <n>", "New priority (1-4 or urgent/high/normal/low)").option("--due-date <date>", "New due date (Unix ms)").option("--start-date <date>", "New start date (Unix ms)").option("--time-estimate <ms>", "New time estimate in milliseconds", parseInt).option("--assignee-add <id>", "Add assignee (repeatable)", collect, []).option("--assignee-remove <id>", "Remove assignee (repeatable)", collect, []).option("--archived <bool>", "Archive or unarchive").action(async (taskId, opts) => {
     const client = getClient();
     const body = {};
     if (opts.name !== void 0) body["name"] = opts.name;
     if (opts.description !== void 0) body["description"] = opts.description;
     if (opts.status !== void 0) body["status"] = opts.status;
-    if (opts.priority !== void 0) body["priority"] = opts.priority;
+    if (opts.priority !== void 0) body["priority"] = parsePriority(opts.priority);
     if (opts.dueDate !== void 0) body["due_date"] = parseInt(opts.dueDate, 10);
     if (opts.startDate !== void 0) body["start_date"] = parseInt(opts.startDate, 10);
     if (opts.timeEstimate !== void 0) body["time_estimate"] = opts.timeEstimate;
@@ -1553,6 +1910,68 @@ function registerTaskCommands(program, getClient) {
       { key: "statuses", header: "Statuses", width: 50 }
     ], getOutputOptions(program));
   });
+  task.command("bulk-update").description("Apply the same update to multiple tasks").requiredOption("--task-id <id>", "Task ID (repeatable)", collect, []).option("--name <name>", "New task name").option("--description <desc>", "New description").option("--status <s>", "New status").option("--priority <n>", "New priority (1-4 or urgent/high/normal/low)").option("--due-date <date>", "New due date (Unix ms)").option("--start-date <date>", "New start date (Unix ms)").option("--time-estimate <ms>", "New time estimate in milliseconds", parseInt).option("--assignee-add <id>", "Add assignee (repeatable)", collect, []).option("--assignee-remove <id>", "Remove assignee (repeatable)", collect, []).action(async (opts) => {
+    const client = getClient();
+    const taskIds = opts.taskId;
+    const body = {};
+    if (opts.name !== void 0) body["name"] = opts.name;
+    if (opts.description !== void 0) body["description"] = opts.description;
+    if (opts.status !== void 0) body["status"] = opts.status;
+    if (opts.priority !== void 0) body["priority"] = parsePriority(opts.priority);
+    if (opts.dueDate !== void 0) body["due_date"] = parseInt(opts.dueDate, 10);
+    if (opts.startDate !== void 0) body["start_date"] = parseInt(opts.startDate, 10);
+    if (opts.timeEstimate !== void 0) body["time_estimate"] = opts.timeEstimate;
+    const addIds = opts.assigneeAdd;
+    const remIds = opts.assigneeRemove;
+    if (addIds.length || remIds.length) {
+      body["assignees"] = {
+        add: addIds.map((a) => parseInt(a, 10)),
+        rem: remIds.map((a) => parseInt(a, 10))
+      };
+    }
+    const tasks = taskIds.map((id) => async () => {
+      const data = await client.put(`/task/${id}`, body);
+      return { task_id: id, name: data["name"], result: "ok" };
+    });
+    const results = await runConcurrent(tasks, 3);
+    const rows = results.map(
+      (r, i) => r instanceof Error ? { task_id: taskIds[i], name: "", result: r.message } : r
+    );
+    formatOutput(rows, [
+      { key: "task_id", header: "Task ID", width: 14 },
+      { key: "name", header: "Name", width: 30 },
+      { key: "result", header: "Result", width: 20 }
+    ], getOutputOptions(program));
+  });
+  task.command("bulk-delete").description("Delete multiple tasks").requiredOption("--task-id <id>", "Task ID (repeatable)", collect, []).option("--confirm", "Skip confirmation prompt").action(async (opts) => {
+    const client = getClient();
+    const taskIds = opts.taskId;
+    if (!opts.confirm) {
+      if (!process.stdin.isTTY) {
+        process.stderr.write("Error: Use --confirm to bulk delete in non-interactive mode.\n");
+        process.exit(2);
+        return;
+      }
+      const { confirm } = await import("@inquirer/prompts");
+      const yes = await confirm({ message: `Delete ${taskIds.length} task(s)?` });
+      if (!yes) {
+        process.stdout.write("Cancelled.\n");
+        return;
+      }
+    }
+    const tasks = taskIds.map((id) => async () => {
+      await client.delete(`/task/${id}`);
+      return { task_id: id, result: "deleted" };
+    });
+    const results = await runConcurrent(tasks, 3);
+    const rows = results.map(
+      (r, i) => r instanceof Error ? { task_id: taskIds[i], result: r.message } : r
+    );
+    formatOutput(rows, [
+      { key: "task_id", header: "Task ID", width: 14 },
+      { key: "result", header: "Result", width: 20 }
+    ], getOutputOptions(program));
+  });
 }
 
 // src/commands/checklist.ts
@@ -1900,11 +2319,21 @@ function registerRelationCommands(program, getClient) {
 }
 
 // src/commands/attachment.ts
+import { writeFileSync } from "fs";
+import { join } from "path";
 registerSchema("attachment", "upload", "Upload a file to a task", [
   { flag: "--task-id", type: "string", required: true, description: "Task ID" },
   { flag: "--file", type: "string", required: true, description: "Local file path" },
   { flag: "--filename", type: "string", required: false, description: "Override display filename" }
 ]);
+registerSchema("attachment", "list", "List attachments on a task", [
+  { flag: "--task-id", type: "string", required: true, description: "Task ID" }
+]);
+registerSchema("attachment", "download", "Download an attachment from a task", [
+  { flag: "--task-id", type: "string", required: true, description: "Task ID" },
+  { flag: "--attachment-id", type: "string", required: true, description: "Attachment ID" },
+  { flag: "--output", type: "string", required: false, description: "Output file path (default: ./attachment-<id>-<title>)" }
+]);
 var ATTACHMENT_COLUMNS = [
   { key: "id", header: "ID", width: 20 },
   { key: "title", header: "Title", width: 30 },
@@ -1919,6 +2348,35 @@ function registerAttachmentCommands(program, getClient) {
     const data = await client.upload(`/task/${opts.taskId}/attachment`, opts.file, opts.filename);
     formatOutput(data, ATTACHMENT_COLUMNS, getOutputOptions(program));
   });
+  attachment.command("list").description("List attachments on a task").requiredOption("--task-id <id>", "Task ID").action(async (opts) => {
+    const client = getClient();
+    const data = await client.get(`/task/${opts.taskId}`);
+    const attachments = data["attachments"] ?? [];
+    formatOutput(attachments, ATTACHMENT_COLUMNS, getOutputOptions(program));
+  });
+  attachment.command("download").description("Download an attachment from a task").requiredOption("--task-id <id>", "Task ID").requiredOption("--attachment-id <id>", "Attachment ID").option("--output <path>", "Output file path").action(async (opts) => {
+    const { default: ora } = await import("ora");
+    const client = getClient();
+    const data = await client.get(`/task/${opts.taskId}`);
+    const attachments = data["attachments"] ?? [];
+    const attachment2 = attachments.find((a) => a.id === opts.attachmentId);
+    if (!attachment2) {
+      process.stderr.write(`Error: Attachment "${opts.attachmentId}" not found on task "${opts.taskId}".
+`);
+      process.exit(4);
+      return;
+    }
+    const outputPath = opts.output ?? join(process.cwd(), `attachment-${attachment2.id}-${attachment2.title}`);
+    const spinner = ora(`Downloading ${attachment2.title}...`).start();
+    try {
+      const buffer = await client.downloadUrl(attachment2.url);
+      writeFileSync(outputPath, Buffer.from(buffer));
+      spinner.succeed(`Downloaded to ${outputPath}`);
+    } catch (err) {
+      spinner.fail("Download failed");
+      throw err;
+    }
+  });
 }
 
 // src/commands/comment.ts
@@ -3373,6 +3831,22 @@ registerSchema("template", "list", "List task templates in a workspace", [
   { flag: "--workspace-id", type: "string", required: true, description: "Workspace ID" },
   { flag: "--page", type: "integer", required: false, description: "Page number (starts at 0)" }
 ]);
+registerSchema("template", "apply-task", "Create a task from a task template", [
+  { flag: "--list-id", type: "string", required: true, description: "List to create the task in" },
+  { flag: "--template-id", type: "string", required: true, description: "Template ID to apply" },
+  { flag: "--name", type: "string", required: false, description: "Override the template name" }
+]);
+registerSchema("template", "apply-list", "Create a list from a list template", [
+  { flag: "--template-id", type: "string", required: true, description: "Template ID to apply" },
+  { flag: "--folder-id", type: "string", required: false, description: "Folder to create the list in (use this or --space-id)" },
+  { flag: "--space-id", type: "string", required: false, description: "Space to create the list in (use this or --folder-id)" },
+  { flag: "--name", type: "string", required: false, description: "Override the template name" }
+]);
+registerSchema("template", "apply-folder", "Create a folder from a folder template", [
+  { flag: "--space-id", type: "string", required: true, description: "Space to create the folder in" },
+  { flag: "--template-id", type: "string", required: true, description: "Template ID to apply" },
+  { flag: "--name", type: "string", required: false, description: "Override the template name" }
+]);
 function registerTemplateCommands(program, getClient) {
   const template = program.command("template").description("Manage task templates");
   template.command("list").description("List task templates").option("--page <n>", "Page number (starts at 0)", parseInt).action(async (opts) => {
@@ -3384,6 +3858,39 @@ function registerTemplateCommands(program, getClient) {
     const data = await client.get(`/team/${workspaceId}/taskTemplate`, params);
     formatOutput(data.templates, TEMPLATE_COLUMNS, getOutputOptions(program));
   });
+  template.command("apply-task").description("Create a task from a task template").requiredOption("--list-id <id>", "List to create the task in").requiredOption("--template-id <id>", "Template ID to apply").option("--name <name>", "Override the template name").action(async (opts) => {
+    const client = getClient();
+    const body = {};
+    if (opts.name !== void 0) body["name"] = opts.name;
+    const data = await client.post(
+      `/list/${opts.listId}/taskTemplate/${opts.templateId}`,
+      body
+    );
+    formatOutput([data], TEMPLATE_COLUMNS, getOutputOptions(program));
+  });
+  template.command("apply-list").description("Create a list from a list template").requiredOption("--template-id <id>", "Template ID to apply").option("--folder-id <id>", "Folder to create the list in").option("--space-id <id>", "Space to create the list in (folderless)").option("--name <name>", "Override the template name").action(async (opts) => {
+    if (!opts.folderId && !opts.spaceId) {
+      process.stderr.write("Error: Provide either --folder-id or --space-id\n");
+      process.exit(2);
+      return;
+    }
+    const client = getClient();
+    const body = {};
+    if (opts.name !== void 0) body["name"] = opts.name;
+    const path = opts.folderId ? `/folder/${opts.folderId}/listTemplate/${opts.templateId}` : `/space/${opts.spaceId}/listTemplate/${opts.templateId}`;
+    const data = await client.post(path, body);
+    formatOutput([data], TEMPLATE_COLUMNS, getOutputOptions(program));
+  });
+  template.command("apply-folder").description("Create a folder from a folder template").requiredOption("--space-id <id>", "Space to create the folder in").requiredOption("--template-id <id>", "Template ID to apply").option("--name <name>", "Override the template name").action(async (opts) => {
+    const client = getClient();
+    const body = {};
+    if (opts.name !== void 0) body["name"] = opts.name;
+    const data = await client.post(
+      `/space/${opts.spaceId}/folderTemplate/${opts.templateId}`,
+      body
+    );
+    formatOutput([data], TEMPLATE_COLUMNS, getOutputOptions(program));
+  });
 }
 
 // src/commands/task-type.ts
@@ -3729,8 +4236,8 @@ function registerDocCommands(program, getClient) {
 }
 
 // src/commands/skill-cmd.ts
-import { readdirSync, readFileSync as readFileSync2, existsSync } from "fs";
-import { join, dirname } from "path";
+import { readdirSync, readFileSync as readFileSync4, existsSync } from "fs";
+import { join as join2, dirname } from "path";
 import { fileURLToPath } from "url";
 var SKILL_COLUMNS = [
   { key: "name", header: "Name", width: 28 },
@@ -3746,9 +4253,9 @@ registerSchema("skill", "path", "Print the file system path to a skill directory
 ]);
 function findSkillsDir() {
   const thisDir = dirname(fileURLToPath(import.meta.url));
-  const bundledDir = join(thisDir, "..", "skills");
+  const bundledDir = join2(thisDir, "..", "skills");
   if (existsSync(bundledDir)) return bundledDir;
-  const projectDir = join(thisDir, "..", "..", "skills");
+  const projectDir = join2(thisDir, "..", "..", "skills");
   if (existsSync(projectDir)) return projectDir;
   return void 0;
 }
@@ -3789,16 +4296,16 @@ function loadSkills(skillsDir) {
     return skills;
   }
   for (const entry of entries) {
-    const skillFile = join(skillsDir, entry, "SKILL.md");
+    const skillFile = join2(skillsDir, entry, "SKILL.md");
     if (!existsSync(skillFile)) continue;
     try {
-      const content = readFileSync2(skillFile, "utf-8");
+      const content = readFileSync4(skillFile, "utf-8");
       const { frontmatter } = parseFrontmatter(content);
       skills.push({
         name: frontmatter["name"] || entry,
         description: (frontmatter["description"] || "").slice(0, 100),
         type: classifySkill(frontmatter),
-        path: join(skillsDir, entry),
+        path: join2(skillsDir, entry),
         frontmatter
       });
     } catch {
@@ -3813,11 +4320,11 @@ function loadSkills(skillsDir) {
   });
 }
 function findSkill(skillsDir, name) {
-  const skillDir = join(skillsDir, name);
-  const skillFile = join(skillDir, "SKILL.md");
+  const skillDir = join2(skillsDir, name);
+  const skillFile = join2(skillDir, "SKILL.md");
   if (!existsSync(skillFile)) return void 0;
   try {
-    const content = readFileSync2(skillFile, "utf-8");
+    const content = readFileSync4(skillFile, "utf-8");
     return { skillDir, content };
   } catch {
     return void 0;
@@ -3945,15 +4452,18 @@ function registerChatCommands(program, getClient) {
 }
 
 // src/cli.ts
-var VERSION = "0.2.0";
+var VERSION = "0.3.0";
 function createProgram() {
   const program = new Command();
-  program.name("clickup").description("ClickUp CLI - Manage ClickUp workspaces from the terminal").version(VERSION).option("--token <token>", "API token").option("--workspace-id <id>", "Workspace ID").option("--format <format>", "Output format (table|json|csv|tsv|quiet|id|md)").option("--no-color", "Disable colors").option("--no-header", "Omit column headers").option("--fields <fields>", "Show only specified fields (comma-separated)").option("--filter <filter>", "Client-side filter (key=value)").option("--sort <sort>", "Sort by field (field[:asc|:desc])").option("--limit <n>", "Limit results", parseInt).option("--verbose", "Show request details").option("--debug", "Full debug output").option("--dry-run", "Print what would be sent without executing");
+  program.name("clickup").description("ClickUp CLI - Manage ClickUp workspaces from the terminal").version(VERSION).option("--token <token>", "API token").option("--token-file <path>", "Read API token from this file path").option("--profile <name>", "Profile to use (key, workspace name, or nickname)").option("--workspace-id <id>", "Workspace ID").option("--format <format>", "Output format (table|json|csv|tsv|quiet|id|md)").option("--no-color", "Disable colors").option("--no-header", "Omit column headers").option("--fields <fields>", "Show only specified fields (comma-separated)").option("--filter <filter>", "Client-side filter (key=value)").option("--sort <sort>", "Sort by field (field[:asc|:desc])").option("--limit <n>", "Limit results", parseInt).option("--verbose", "Show request details").option("--debug", "Full debug output").option("--dry-run", "Print what would be sent without executing");
   return program;
 }
 function createClient(program) {
   const globalOpts = program.opts();
-  const token = resolveToken(globalOpts["token"]);
+  const token = resolveToken(
+    globalOpts["token"],
+    globalOpts["tokenFile"]
+  );
   if (!token) {
     process.stderr.write("Error: No API token found. Run: clickup auth login\n");
     process.exit(EXIT_CODES.AUTH_FAILURE);
@@ -3983,8 +4493,11 @@ function getOutputOptions(program) {
 }
 function run() {
   const program = createProgram();
+  program.hook("preAction", () => {
+    setProfileOverride(program.opts()["profile"]);
+  });
   registerAuthCommands(program, () => createClient(program));
-  registerConfigCommands(program);
+  registerConfigCommands(program, () => createClient(program));
   registerWorkspaceCommands(program, () => createClient(program));
   registerSpaceCommands(program, () => createClient(program));
   registerFolderCommands(program, () => createClient(program));
@@ -4014,6 +4527,9 @@ function run() {
   registerSchemaCommands(program);
   registerSkillCommands(program);
   program.parseAsync(process.argv).catch((error) => {
+    if (error instanceof DryRunComplete) {
+      process.exit(EXIT_CODES.SUCCESS);
+    }
     if (error instanceof ClickUpError) {
       process.stderr.write(`Error: ${error.message}
 `);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clickup-agent-cli",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "CLI covering the entire ClickUp API v2 surface",
   "type": "module",
   "bin": {
@@ -18,7 +18,8 @@
     "build": "tsup",
     "dev": "tsx bin/clickup.ts",
     "test": "vitest run",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "version": "node scripts/sync-version.js"
   },
   "keywords": [
     "clickup",

package/skills/clickup/SKILL.md

@@ -41,6 +41,7 @@ clickup <resource> <action> --help     # Full help text
 | `clickup-chat` | Chat channels, sending messages and notifications |
 | `clickup-webhooks` | Webhook registration and management |
 | `clickup-fields` | Custom fields, tags, custom task types |
+| `clickup-templates` | Templates: list available templates, apply task/list/folder templates |
 
 ## Recipe Skills (multi-step workflows)
 
@@ -57,6 +58,7 @@ Recipes accept natural language arguments. Scope them to any team, department, p
 | `clickup-sprint-closeout` | Close a sprint, carry over incomplete work |
 | `clickup-time-audit` | Audit time tracking and utilization |
 | `clickup-project-setup` | Scaffold a new project structure |
+| `clickup-rollout` | Roll out a saved process template (apply + configure) |
 | `clickup-capacity-check` | Check team workload and availability |
 | `clickup-blocker-report` | Find blocked tasks and dependency chains |
 | `clickup-goal-progress` | Report on goal/OKR completion |
@@ -81,6 +83,10 @@ clickup task list --list-id <id> --format quiet | xargs -I{} clickup task get {}
 
 All commands support: `--format json|table|csv|tsv|quiet|id|md`, `--dry-run`, `--debug`, `--no-color`
 
+Additional global flags:
+- `--profile <name>` -- select a named profile (accepts profile key, workspace name, or nickname)
+- `--token-file <path>` -- read API token from a file (useful in CI/CD and secret managers)
+
 Use `--format md` to render output as a markdown table -- ideal for displaying results in chat messages or documents.
 
 ## Auth
@@ -91,16 +97,45 @@ Requires a ClickUp API token.
 # Set up authentication
 clickup auth login --token pk_XXXXXXXX_YYYYYYYY
 
+# Read token from file (CI/CD-friendly)
+clickup auth login --token-file /run/secrets/clickup_token
+
 # Or use an environment variable
-export CLICKUP_TOKEN=pk_XXXXXXXX_YYYYYYYY
+export CLICKUP_API_TOKEN=pk_XXXXXXXX_YYYYYYYY
 
-# Store default workspace
-clickup config set workspace_id <id>
+# Auto-configure workspace after login (single workspace: auto-selects)
+clickup workspace setup
 
 # Check current auth status
 clickup auth status
+
+# Validate token and show identity
+clickup config validate
+```
+
+## Named Profiles (Multi-Account)
+
+Profiles store credentials per workspace. A single-workspace setup is transparent -- no `--profile` flag needed.
+
+```bash
+# List profiles
+clickup config profile list
+
+# Switch active profile
+clickup config profile use "Acme Corp"
+
+# Set a short nickname
+clickup config profile nickname acme-corp acme
+
+# Use a specific profile for one command
+clickup task list --list-id 123 --profile acme
 ```
 
+Profile resolution for `--profile` accepts:
+1. The profile key (e.g. `default`)
+2. Workspace name, case-insensitive (e.g. `"Henry's Workspace"`)
+3. Nickname if set (e.g. `acme`)
+
 ## Creating Custom Skills
 
 Users can create their own skills alongside the built-in ones. Add a SKILL.md to `.claude/skills/<name>/` in any project:

package/skills/clickup-fields/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: clickup-fields
 description: Manages ClickUp custom fields, tags, and custom task types. Use when the user asks about custom fields, wants to set field values on tasks, manage tags, or work with custom task types.
-allowed-tools: Bash(clickup custom-field *), Bash(clickup tag *), Bash(clickup custom-task-type *), Bash(clickup schema field*), Bash(clickup schema tag*)
+allowed-tools: Bash(clickup custom-field *), Bash(clickup tag *), Bash(clickup custom-task-type *), Bash(clickup attachment *), Bash(clickup schema field*), Bash(clickup schema tag*)
 ---
 
 # ClickUp Custom Fields, Tags, and Task Types
@@ -69,9 +69,20 @@ clickup field list --list-id 998877 --format json
 clickup field list --list-id 998877 --format md
 ```
 
+## Attachment Commands
+
+```bash
+clickup attachment upload --task-id <id> --file <path> [--filename <name>]
+clickup attachment list --task-id <id>
+clickup attachment download --task-id <id> --attachment-id <id> [--output <path>]
+```
+
+`attachment download` fetches the file with the auth header and writes to `--output` (default: `./attachment-<id>-<title>`). Shows a spinner during download.
+
 ## Discovery
 
 ```bash
 clickup schema fields.set      # Show field set options
 clickup schema tags.create     # Show tag create fields
+clickup schema attachment.list # Show attachment list options
 ```

package/skills/clickup-rollout/SKILL.md

@@ -0,0 +1,111 @@
+---
+name: clickup-rollout
+description: Rolls out a saved process template in ClickUp by applying it to a target location, then configuring assignees, due dates, and custom fields. Use when the user says "start a new [project/process/sprint/onboarding]" or wants to kick off a repeatable workflow from a template.
+disable-model-invocation: true
+context: fork
+agent: general-purpose
+argument-hint: "[template name or ID] [target location] [optional: assignee, due date, custom fields]"
+allowed-tools: Bash(clickup *)
+---
+
+# Template Rollout
+
+Apply a saved ClickUp template and configure the resulting task, list, or folder for a new instance of the process.
+
+## Workflow
+
+### Step 1: Find the template
+
+```bash
+# List all templates to find the right one
+clickup template list --format json
+```
+
+If the user gave a template name, find its ID by matching the `name` field. If they gave an ID directly, skip this step.
+
+### Step 2: Determine the template type and target
+
+Based on what the user wants to create:
+- **Task template**: needs a `--list-id` target
+- **List template**: needs a `--folder-id` or `--space-id` target
+- **Folder template**: needs a `--space-id` target
+
+If the user hasn't specified a target, find it:
+```bash
+clickup space list --format json
+clickup folder list --space-id <id> --format json
+clickup list list --folder-id <id> --format json
+```
+
+### Step 3: Apply the template
+
+```bash
+# Task template
+TASK_ID=$(clickup template apply-task \
+  --list-id <list-id> \
+  --template-id <tmpl-id> \
+  --name "<instance-name>" \
+  --format id)
+
+# List template (into folder)
+LIST_ID=$(clickup template apply-list \
+  --folder-id <folder-id> \
+  --template-id <tmpl-id> \
+  --name "<instance-name>" \
+  --format id)
+
+# List template (into space, folderless)
+LIST_ID=$(clickup template apply-list \
+  --space-id <space-id> \
+  --template-id <tmpl-id> \
+  --name "<instance-name>" \
+  --format id)
+
+# Folder template
+FOLDER_ID=$(clickup template apply-folder \
+  --space-id <space-id> \
+  --template-id <tmpl-id> \
+  --name "<instance-name>" \
+  --format id)
+```
+
+### Step 4: Configure the created resource
+
+For a task template result, set assignees, dates, and custom fields:
+```bash
+# Assign team members
+clickup task update "$TASK_ID" --assignee-add <user-id>
+
+# Set start and due dates (Unix milliseconds)
+clickup task update "$TASK_ID" --start-date <ms> --due-date <ms>
+
+# Fill in custom fields
+clickup field set --task-id "$TASK_ID" --field-id <field-id> --value "<value>"
+```
+
+For a list template result, populate it with initial tasks if needed:
+```bash
+clickup task list --list-id "$LIST_ID" --format json  # review what the template created
+```
+
+For a folder template result, review the created structure:
+```bash
+clickup list list --folder-id "$FOLDER_ID" --format table
+```
+
+### Step 5: Confirm and summarize
+
+Report what was created:
+- Resource type and ID
+- Name used
+- Assignees set
+- Dates configured
+- Custom fields populated
+- Link or path in the ClickUp hierarchy
+
+## Tips
+
+- Use `--name` to give each rollout a unique name (e.g. "Client Onboarding - Acme Corp" or "Sprint 14 - Apr 7")
+- Templates carry over all custom field definitions -- just fill in the values after applying
+- Task IDs from `--format id` can be piped directly into update and field commands
+- If rolling out multiple instances at once, loop over a list of names or targets

package/skills/clickup-spaces/SKILL.md

@@ -11,12 +11,15 @@ Manage the organizational hierarchy: Workspace > Space > Folder > List. Lists co
 ## Workspace Commands
 
 ```bash
+clickup workspace setup                         # Auto-configure workspace (run after auth login)
 clickup workspace list                          # List all workspaces
 clickup workspace get [--workspace-id <id>]     # Get workspace details
 clickup workspace seats [--workspace-id <id>]   # Show seat usage
 clickup workspace plan [--workspace-id <id>]    # Show billing plan
 ```
 
+`workspace setup` calls `GET /team`, auto-selects if only one workspace exists, prompts in TTY if multiple, and saves the workspace to the active profile. After running it, `--workspace-id` is not needed for subsequent commands.
+
 ## Space Commands
 
 ```bash

package/skills/clickup-tasks/SKILL.md

@@ -33,7 +33,7 @@ clickup task get <task-id> [--include-subtasks] [--include-markdown-description]
 ```bash
 clickup task create --list-id <id> --name <name>
     [--description <text>] [--markdown-description <md>]
-    [--status <s>] [--priority <1-4>] [--due-date <ts>] [--start-date <ts>]
+    [--status <s>] [--priority <1-4|urgent|high|normal|low>] [--due-date <ts>] [--start-date <ts>]
     [--assignee <id>...] [--tag <name>...] [--time-estimate <ms>]
     [--parent <task-id>] [--custom-field <id=value>...]
 ```
@@ -41,15 +41,28 @@ clickup task create --list-id <id> --name <name>
 ### Update a task
 ```bash
 clickup task update <task-id> [--name <name>] [--description <text>]
-    [--status <s>] [--priority <1-4>] [--due-date <ts>] [--start-date <ts>]
+    [--status <s>] [--priority <1-4|urgent|high|normal|low>] [--due-date <ts>] [--start-date <ts>]
     [--assignee-add <id>...] [--assignee-remove <id>...] [--archived <bool>]
 ```
 
+Priority accepts both integers (`1`-`4`) and strings (`urgent`, `high`, `normal`, `low`). Mapping: urgent=1, high=2, normal=3, low=4.
+
 ### Delete a task
 ```bash
 clickup task delete <task-id> --confirm
 ```
 
+### Bulk operations (concurrency limit 3)
+```bash
+# Apply the same update to multiple tasks
+clickup task bulk-update --task-id <id> --task-id <id> ... [same update flags as task update]
+
+# Delete multiple tasks
+clickup task bulk-delete --task-id <id> --task-id <id> ... --confirm
+```
+
+Both bulk commands output a results table with `task_id | name | result`.
+
 ### Time in status
 ```bash
 clickup task time-in-status <task-id>

package/skills/clickup-templates/SKILL.md

@@ -0,0 +1,76 @@
+---
+name: clickup-templates
+description: Lists and applies ClickUp templates to create tasks, lists, and folders from saved process templates. Use when the user wants to roll out a repeatable process, create items from a template, or find what templates are available in the workspace.
+allowed-tools: Bash(clickup template *), Bash(clickup schema template*)
+---
+
+# ClickUp Templates
+
+List available templates and apply them to create tasks, lists, and folders. Templates are defined in the ClickUp UI and can be rolled out repeatedly via the CLI.
+
+## List Templates
+
+```bash
+clickup template list [--workspace-id <id>] [--page <n>]
+```
+
+Returns all task templates in the workspace. Use this to find template IDs before applying them.
+
+## Apply a Task Template
+
+```bash
+clickup template apply-task --list-id <id> --template-id <id> [--name <override-name>]
+```
+
+Creates a new task in the specified list using the template structure, including all custom fields defined on the template.
+
+## Apply a List Template
+
+```bash
+# Into a folder
+clickup template apply-list --folder-id <id> --template-id <id> [--name <override-name>]
+
+# Into a space (folderless)
+clickup template apply-list --space-id <id> --template-id <id> [--name <override-name>]
+```
+
+Provide exactly one of `--folder-id` or `--space-id`.
+
+## Apply a Folder Template
+
+```bash
+clickup template apply-folder --space-id <id> --template-id <id> [--name <override-name>]
+```
+
+Creates an entire folder structure (with nested lists and tasks) from the template.
+
+## Common Patterns
+
+```bash
+# Step 1: Find available templates
+clickup template list --format json
+
+# Step 2: Apply a task template and capture the new task ID
+TASK_ID=$(clickup template apply-task --list-id <id> --template-id <tmpl_id> --format id)
+
+# Step 3: Set assignee and due date on the created task
+clickup task update "$TASK_ID" --assignee-add 112233 --due-date 1735689600000
+
+# Step 4: Fill in custom fields
+clickup field set --task-id "$TASK_ID" --field-id cf_001 --value "In Review"
+
+# Roll out a named instance of a process template
+clickup template apply-list --folder-id <id> --template-id <tmpl_id> --name "Q1 Launch - March 2026"
+
+# Apply a folder template to scaffold a whole project
+clickup template apply-folder --space-id <id> --template-id <tmpl_id> --name "Client Onboarding - Acme Corp"
+```
+
+## Discovery
+
+```bash
+clickup schema template               # List all template actions
+clickup schema template.apply-task    # Show apply-task fields
+clickup schema template.apply-list    # Show apply-list fields
+clickup schema template.apply-folder  # Show apply-folder fields
+```