clickuplisted

# ClickUp CLI (`cup`) - skill version 1.31.2 Reference for AI agents using the `cup` CLI tool. Covers task management, sprint tracking, comments, time tracking, custom fields, goals, docs, and project workflows. > **Version check:** Run `cup --version`. If your installed version is older than 1.31.2, 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 stored at `~/.config/cup/config.json` with named profiles. Each profile has `apiToken` and `teamId`. Optional: `sprintFo