add cup as second binary name to avoid cu(1) conflict

Author: krodak

.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 cu command",
-  "version": "0.17.0",
+  "description": "ClickUp CLI skills for managing tasks, sprints, comments, checklists, custom fields, tags, and time tracking via the cu/cup command",
+  "version": "0.18.0",
   "author": {
     "name": "Krzysztof Rodak"
   },

AGENTS.md

@@ -2,7 +2,7 @@
 
 ## Project Overview
 
-`@krodak/clickup-cli` (`cu`) - a ClickUp CLI for AI agents and humans. TypeScript, ESM-only, Node 22+. Three output modes: interactive tables with task picker in TTY, Markdown when piped (optimized for AI context windows), JSON with `--json`.
+`@krodak/clickup-cli` (`cu` / `cup`) - a ClickUp CLI for AI agents and humans. TypeScript, ESM-only, Node 22+. Three output modes: interactive tables with task picker in TTY, Markdown when piped (optimized for AI context windows), JSON with `--json`. Both `cu` and `cup` are registered as binary names - `cup` avoids conflicts with the Unix `cu(1)` utility.
 
 ## Skills
 

README.md

@@ -11,6 +11,8 @@
 npm install -g @krodak/clickup-cli && cu init
 ```
 
+Both `cu` and `cup` are installed as binaries. Use `cup` if `cu` conflicts with the Unix [cu(1)](<https://en.wikipedia.org/wiki/Cu_(Unix_utility)>) utility on your system. All examples below use `cu` but `cup` works identically.
+
 ## Talk to your agent
 
 Install the CLI, add the skill file to your agent, and it works with ClickUp. No API knowledge needed.

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "@krodak/clickup-cli",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "description": "ClickUp CLI for AI agents and humans",
   "type": "module",
   "license": "MIT",
@@ -20,7 +20,8 @@
     "initiative"
   ],
   "bin": {
-    "cu": "./dist/index.js"
+    "cu": "./dist/index.js",
+    "cup": "./dist/index.js"
   },
   "files": [
     "dist",

package.json

@@ -1,14 +1,18 @@
 ---
 name: clickup
-description: 'Use when managing ClickUp tasks, sprints, or comments via the `cu` CLI tool. Triggers: task queries, status updates, sprint tracking, creating subtasks, posting comments, threaded replies, standup summaries, searching tasks, checking overdue items, assigning tasks, listing spaces and lists, opening tasks in browser, checking auth or config, setting custom fields, deleting tasks, managing tags, managing checklists, editing comments, task links, time tracking, attachments, file uploads.'
+description: 'Use when managing ClickUp tasks, sprints, or comments via the `cu` / `cup` CLI tool. Triggers: task queries, status updates, sprint tracking, creating subtasks, posting comments, threaded replies, standup summaries, searching tasks, checking overdue items, assigning tasks, listing spaces and lists, opening tasks in browser, checking auth or config, setting custom fields, deleting tasks, managing tags, managing checklists, editing comments, task links, time tracking, attachments, file uploads.'
 ---
 
-# ClickUp CLI (`cu`)
+# ClickUp CLI (`cu` / `cup`)
 
 Reference for AI agents using the `cu` CLI tool. Covers task management, sprint tracking, comments, and project workflows.
 
 Keywords: ClickUp, task management, sprint, project management, agile, backlog, subtasks, standup, overdue, search
 
+## Binary Names
+
+Both `cu` and `cup` are available as binary names. They are identical. Use `cup` if `cu` conflicts with the Unix `cu(1)` utility on your system. All examples below use `cu`, but `cup` works the same way.
+
 ## Setup
 
 Config at `~/.config/cu/config.json` with `apiToken` and `teamId`. Run `cu init` to set up interactively.

skills/clickup-cli/SKILL.md

@@ -1,3 +1,4 @@
+import { basename } from 'path'
 import { Command } from 'commander'
 import { createRequire } from 'module'
 import { ClickUpClient } from './api.js'
@@ -74,6 +75,8 @@ import {
 const require = createRequire(import.meta.url)
 const { version } = require('../package.json') as { version: string }
 
+const programName = basename(process.argv[1] ?? 'cu')
+
 function wrapAction<T extends unknown[]>(fn: (...args: T) => Promise<void>): (...args: T) => void {
   return (...args: T) => {
     fn(...args).catch((err: unknown) => {
@@ -96,14 +99,14 @@ interface TaskFilterOpts {
 const program = new Command()
 
 program
-  .name('cu')
+  .name(programName)
   .description('ClickUp CLI for AI agents')
   .version(version)
   .allowExcessArguments(false)
 
 program
   .command('init')
-  .description('Set up cu for the first time')
+  .description(`Set up ${programName} for the first time`)
   .action(
     wrapAction(async () => {
       await runInitCommand()
@@ -958,7 +961,7 @@ program
   .description('Output shell completion script (bash, zsh, fish)')
   .action(
     wrapAction(async (shell: string) => {
-      const script = generateCompletion(shell)
+      const script = generateCompletion(shell, programName)
       process.stdout.write(script)
     }),
   )

src/commands/completion.ts

@@ -142,6 +142,35 @@ describe('generateCompletion', () => {
     })
   })
 
+  describe('custom binary name', () => {
+    it('bash uses the provided name for function and registration', () => {
+      const result = generateCompletion('bash', 'cup')
+      expect(result).toContain('_cup_completions()')
+      expect(result).toContain('complete -F _cup_completions cup')
+      expect(result).not.toContain('_cu_completions')
+    })
+
+    it('zsh uses the provided name for compdef and function', () => {
+      const result = generateCompletion('zsh', 'cup')
+      expect(result).toContain('#compdef cup')
+      expect(result).toContain('_cup()')
+      expect(result).not.toContain('#compdef cu\n')
+    })
+
+    it('fish uses the provided name for complete commands', () => {
+      const result = generateCompletion('fish', 'cup')
+      expect(result).toContain('complete -c cup -f')
+      expect(result).toContain('complete -c cup -n __fish_use_subcommand')
+      expect(result).not.toContain('complete -c cu ')
+    })
+
+    it('defaults to cu when name is not provided', () => {
+      const result = generateCompletion('bash')
+      expect(result).toContain('_cu_completions()')
+      expect(result).toContain('complete -F _cu_completions cu')
+    })
+  })
+
   describe('unknown shell', () => {
     it('throws an error for unsupported shell', () => {
       expect(() => generateCompletion('powershell')).toThrow()