A powerful, standalone command-line interface for managing ClickUp tasks, lists, and workspaces with speed and efficiency. Built for developers who prefer the terminal over the browser.
- 🔐 Secure Auth: Local configuration and environment variable support.
- 📂 Hierarchy Management: List Workspaces, Spaces, Folders, and Lists.
- ✅ Task Operations: Create, read, update, and delete tasks seamlessly.
- 🔍 Filtering: Filter tasks by status, assignee, and more.
- 📦 JSON Output: Optional JSON output for all commands, perfect for scripting.
- 🎨 Beautiful UI: Styled output with clear status indicators and emojis.
Choose your preferred way to install CU-CLI:
brew tap AndroidPoet/tap brew install cu-cli
npm install -g @androidpoet/cu-cli
git clone https://github.com/AndroidPoet/cu-cli.git cd cu-cli npm install npm run build npm install -g .
Once installed, follow these steps to get started:
- Configure your token:
cu-cli auth set <your_clickup_token>
- Verify the setup:
cu-cli auth status
- List your workspaces:
cu-cli workspaces
First, get your personal API token from ClickUp Settings > Apps.
# Set your token cu-cli auth set pk_your_token_here # Verify connectivity cu-cli auth status
Or use an environment variable: export CLICKUP_API_TOKEN=pk_xxxxxxxxxxxxx
# List all workspaces cu-cli workspaces # List spaces (uses first workspace by default) cu-cli spaces --workspace-id <id> # List folders in a space cu-cli folders --space-id <id> # List lists in a folder or space cu-cli lists --folder-id <id> cu-cli lists --space-id <id>
| Feature | Command |
|---|---|
| List Tasks | cu-cli tasks list --list-id <id> --status "In Progress" |
| Get Details | cu-cli tasks get <task-id> |
| Create Task | cu-cli tasks create --list-id <id> --name "New Bug Fix" |
| Update Task | cu-cli tasks update <task-id> --status "Done" |
| Delete Task | cu-cli tasks delete <task-id> --confirm |
cu-cli tasks create \ --list-id 123456 \ --name "Urgent API Fix" \ --description "Fix the auth timeout issue" \ --priority 1 \ --tags "bug,high-priority"
Your configuration is stored locally in ~/.cu-cli/config.json:
{
"integrations": {
"clickup": {
"token": "pk_xxxxxxxxxxxxx"
}
}
}| Value | Priority | Color |
|---|---|---|
1 |
Urgent | 🔴 |
2 |
High | 🟠 |
3 |
Normal | 🟢 |
4 |
Low | ⚪ |
Contributions are welcome! Please check out the BUILD.md for local development instructions.
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request
Distributed under the MIT License. See LICENSE for more information.
Developed with ❤️ by AndroidPoet
Contributions are welcome! If you've found a bug, have an idea for an improvement, or want to contribute new features, please open an issue or submit a pull request.
Support it by joining stargazers for this repository. ⭐
Also, follow me on GitHub for my next creations! 🤩
MIT © 2026 Ranbir Singh