@krodak/clickup-cli 1.19.5 → 1.20.0

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "clickup-cli",
   "description": "ClickUp CLI skills for managing tasks, sprints, comments, checklists, custom fields, tags, and time tracking via the cup command",
-  "version": "1.19.5",
+  "version": "1.20.0",
   "author": {
     "name": "Krzysztof Rodak"
   },

package/README.md

@@ -66,6 +66,7 @@ You need Node 22+ and a ClickUp personal API token (`pk_...` from [ClickUp Setti
 ```bash
 npm install -g @krodak/clickup-cli
 cup init
+cup auth  # verify setup
 ```
 
 </details>
@@ -77,6 +78,7 @@ cup init
 brew tap krodak/tap
 brew install clickup-cli
 cup init
+cup auth  # verify setup
 ```
 
 </details>
@@ -226,6 +228,23 @@ Environment variables override config file values:
 
 When both `CU_API_TOKEN` and `CU_TEAM_ID` are set, the config file is not required. Useful for CI/CD and containerized agents.
 
+```bash
+cup auth  # verify setup
+```
+
+### Non-interactive setup
+
+For CI, scripts, and AI agents, you can skip the interactive prompts:
+
+```bash
+# Write config directly
+cup init --token pk_YOUR_TOKEN --team YOUR_TEAM_ID
+
+# Or use environment variables (no config file needed)
+export CU_API_TOKEN=pk_YOUR_TOKEN
+export CU_TEAM_ID=YOUR_TEAM_ID
+```
+
 ## Troubleshooting
 
 **"No config file found"** - Run `cup init` to set up your API token and workspace.

package/dist/index.js

@@ -2014,7 +2014,30 @@ async function getTask(config, taskId) {
 // src/commands/init.ts
 import { password, select, confirm as confirm2 } from "@inquirer/prompts";
 import fs2 from "fs";
-async function runInitCommand() {
+async function runInitCommand(opts) {
+  if (opts?.token && opts?.team) {
+    const apiToken2 = opts.token.trim();
+    if (!apiToken2.startsWith("pk_")) throw new Error("Token must start with pk_");
+    const client2 = new ClickUpClient({ apiToken: apiToken2 });
+    let username2;
+    try {
+      const me = await client2.getMe();
+      username2 = me.username;
+    } catch (err) {
+      throw new Error(`Invalid token: ${err instanceof Error ? err.message : String(err)}`, {
+        cause: err
+      });
+    }
+    process.stdout.write(`Authenticated as @${username2}
+`);
+    writeConfig({ apiToken: apiToken2, teamId: opts.team });
+    process.stdout.write(`Config written to ${getConfigPath()}
+`);
+    return;
+  }
+  if (opts?.token || opts?.team) {
+    throw new Error("Both --token and --team are required for non-interactive setup");
+  }
   const configPath3 = getConfigPath();
   if (fs2.existsSync(configPath3)) {
     const overwrite = await confirm2({
@@ -3054,6 +3077,7 @@ var commandMetadata = [
   {
     name: "init",
     description: "Set up cup for the first time",
+    flags: ["--token", "--team"],
     quickReference: [{ section: "setup", usage: "init", description: "First-time setup wizard" }]
   },
   {
@@ -6421,9 +6445,9 @@ function buildProgram(programName = basename(process.argv[1] ?? "cup")) {
   function getProfileName() {
     return program.opts().profile;
   }
-  program.command("init").description(`Set up ${programName} for the first time`).action(
-    wrapAction(async () => {
-      await runInitCommand();
+  program.command("init").description(`Set up ${programName} for the first time`).option("--token <token>", "API token (pk_...) for non-interactive setup").option("--team <teamId>", "Workspace/team ID for non-interactive setup").action(
+    wrapAction(async (opts) => {
+      await runInitCommand(opts);
     })
   );
   program.command("auth").description("Validate API token and show current user").option("--json", "Force JSON output even in terminal").action(

package/package.json

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

package/skills/clickup-cli/SKILL.md

@@ -9,13 +9,70 @@ Reference for AI agents using the `cup` CLI tool. Covers task management, sprint
 
 > **Version check:** Run `cup --version`. If your installed version is older than 1.18.0, update with `npm install -g @krodak/clickup-cli` and refresh this skill with `cup skill`.
 
+## Install & Configure
+
+### Prerequisites
+
+Node.js 22+ required.
+
+### Install
+
+```bash
+npm install -g @krodak/clickup-cli
+```
+
+Or via Homebrew:
+
+```bash
+brew tap krodak/tap && brew install clickup-cli
+```
+
+### Get an API token
+
+The user needs a personal API token from ClickUp:
+
+1. Open https://app.clickup.com/settings/apps
+2. Under "API Token", click "Generate" (or copy existing)
+3. The token starts with `pk_`
+
+### Configure
+
+**Non-interactive (recommended for agents):**
+
+```bash
+cup init --token pk_USER_TOKEN --team TEAM_ID
+```
+
+To find the team/workspace ID, the user can check their ClickUp URL: `https://app.clickup.com/TEAM_ID/...`
+
+**Interactive (for humans in a terminal):**
+
+```bash
+cup init
+```
+
+**Environment variables (no config file needed):**
+
+```bash
+export CU_API_TOKEN="pk_..."
+export CU_TEAM_ID="12345678"
+```
+
+### Verify
+
+```bash
+cup auth
+```
+
+This prints the authenticated username and workspace. If it fails, the token or config is invalid.
+
 ## Setup
 
-Config at `~/.config/cup/config.json` with named profiles. Each profile has `apiToken` and `teamId`. Optional: `sprintFolderId` to pin sprint detection to a specific folder. Run `cup init` to set up interactively.
+Config stored at `~/.config/cup/config.json` with named profiles. Each profile has `apiToken` and `teamId`. Optional: `sprintFolderId` to pin sprint detection to a specific folder.
 
 Multiple profiles supported - use `cup profile add <name>` to create, `cup profile use <name>` to switch, or `-p <name>` flag for one-off overrides.
 
-Environment variables `CU_API_TOKEN` and `CU_TEAM_ID` override config file when both are set. `CU_PROFILE` selects a profile (overridden by `-p` flag).
+`CU_PROFILE` environment variable selects a profile (overridden by `-p` flag).
 
 ## Saved Filters (Quick Shortcuts)