Note:
cuis an unofficial, community-maintained project and is not affiliated with or endorsed by ClickUp.
A GitHub CLI-inspired command-line interface for ClickUp.
cu is a command-line tool that brings the power and convenience of GitHub's gh CLI to ClickUp. It allows developers to seamlessly manage tasks, lists, spaces, and other ClickUp resources directly from the terminal.
- GitHub CLI-like Interface: Familiar command structure for developers who use
gh - Task Management: Create, view, update, and manage tasks from the command line
- Comment Management: Add, list, and delete comments on tasks with user assignment
- Custom Fields: Read and write ClickUp custom fields, resolving names to option ids, and find tasks by field value
- Cache Management: Optimize performance with intelligent caching and cache control commands
- Project Configuration: Set project-specific defaults with
.cu.ymlconfiguration files - API Passthrough: Direct access to ClickUp API endpoints for advanced operations
- Export Functionality: Export tasks to CSV, JSON, or Markdown formats
- Multiple Output Formats: Support for table, JSON, YAML, and CSV output
- Shell Completions: Full support for bash, zsh, fish, and PowerShell
- Cross-Platform: Works on macOS, Linux, and Windows
brew install timimsms/cu/cuInstalls the latest tagged release from the timimsms/homebrew-cu tap.
go install github.com/timimsms/cu/cmd/cu@latestNote: binaries installed via go install currently report dev from cu version (#36); Homebrew and release downloads embed the real version.
The package name @timimsms/cu is reserved on npm as a placeholder only — a functional package is not yet published. Use Homebrew, go install, or a release download instead.
Download the latest release from the releases page.
macOS ships its own /usr/bin/cu, the Taylor UUCP serial-line dialer. If /usr/bin comes before Homebrew's bin directory (or ~/go/bin) on your PATH, typing cu runs that tool and prints UUCP usage text instead. Check which one you get:
which -a cu # the first entry should be /opt/homebrew/bin/cu (or ~/go/bin/cu)If /usr/bin/cu is listed first, move Homebrew's or Go's bin directory ahead of /usr/bin in your shell profile.
- Authenticate with ClickUp:
cu auth login- List your tasks:
cu task list- Create a new task:
cu task create# List tasks in current space
cu task list
# Create a new task
cu task create
# View task details
cu task view <task-id>
# Archive a task (reversible; keeps history and URL)
cu task archive <task-id>
cu task archive <task-id> --undo
# Export tasks to CSV
cu export tasks --format csv > tasks.csv# Add a comment to a task
cu comment <task-id> -m "This is my comment"
# List comments on a task
cu comment list <task-id>
# Add comment with assignee
cu comment <task-id> -m "Please review" --assignee user@example.com# List the custom fields available on a list
cu field list --list abc123
# Show the values set on a task
cu field get <task-id>
# Set values — names are resolved to option ids, dates to epoch millis
cu field set <task-id> Repo https://github.com/owner/repo
cu field set <task-id> "Last synced" today
cu field set <task-id> Machine "Chilastra,Sunrunner"
# Clear a value
cu field clear <task-id> "Last synced"
# Reverse lookup: find the task whose field holds a given value
cu field find Repo https://github.com/owner/repoEvery command that produces output honours -o json|yaml|csv, so cu is
scriptable and usable by AI agents without screen-scraping:
cu version -o json
cu auth status -o json # reports the unauthenticated state as data too
cu config list -o json # credentials are redacted in every format
cu task list -o json | jq '.[].id'
cu bulk close t1 t2 --yes -o json # per-task results, not just progress lines# View cache statistics
cu cache info
# Clear all cache
cu cache clear
# Clean expired cache entries
cu cache clean# Initialize project config
cu config init
# Set default list for project
cu config set default.list "My List ID"
# View all configuration
cu config list# Get workspace info
cu api /team
# Create a task via API
cu api /list/abc123/task -X POST -d '{"name": "New Task"}'
# Get tasks with query parameters
cu api "/list/abc123/task?archived=false"Any executable named cu-<name> on your PATH becomes cu <name>, the same
convention kubectl and gh use:
# an executable called cu-worklog on PATH
cu worklog plan --since 1d # runs: cu-worklog plan --since 1dBuiltins always win, so an extension can never shadow a cu command — a shadowed
extension stays runnable directly as cu-<name>. The child inherits
CU_CONFIG_DIR, CU_WORKSPACE and CU_PROJECT_CONFIG so it does not have to
rediscover cu's context, and its exit code is passed through unchanged.
Full documentation is available at https://timimsms.github.io/cu/
See CONTRIBUTING.md for development setup and contribution guidelines.
This project is licensed under the MIT License - see the LICENSE file for details.