Skip to content

v1.22.1

Choose a tag to compare

@github-actions github-actions released this 09 Apr 09:07
· 20 commits to main since this release

Easier onboarding

cup init now explains where to get a ClickUp API token instead of just prompting for one:

Welcome to ClickUp CLI!

How to get a ClickUp API token:
  1. Open https://app.clickup.com/settings/apps
  2. Find the "API Token" section, click "Generate" (or copy the existing one)
  3. The token starts with "pk_"

Paste your ClickUp API token (starts with pk_):

After successful setup, next-step hints are printed:

Next steps:
  cup auth      # verify setup
  cup tasks     # list your assigned tasks
  cup sprint    # show current sprint
  cup --help    # see all commands

Better error messages for agents

cup init now detects non-interactive (piped) stdin and prints a helpful error pointing to the --token and --team flags instead of hanging or crashing:

cup init requires an interactive terminal.

For scripts, CI, or AI agents, use flags:
  cup init --token pk_YOUR_TOKEN --team YOUR_TEAM_ID

Or set environment variables:
  export CU_API_TOKEN=pk_YOUR_TOKEN
  export CU_TEAM_ID=YOUR_TEAM_ID

Invalid token errors now include the ClickUp settings URL. Missing config errors point to cup init with both interactive and non-interactive examples.

Clearer README for AI agents

The "For AI Agents" section now tells the agent exactly what to do: fetch the SKILL.md (which contains the full bootstrap guide), install the CLI, walk the user through getting a token, run cup init, and install the skill persistently with cup skill.

974 unit tests.