{"id":49791008,"url":"https://github.com/androidpoet/cu-cli","last_synced_at":"2026-05-12T04:04:25.153Z","repository":{"id":355603625,"uuid":"1228790795","full_name":"AndroidPoet/cu-cli","owner":"AndroidPoet","description":"A powerful, standalone command-line interface for managing ClickUp tasks, lists, and workspaces.","archived":false,"fork":false,"pushed_at":"2026-05-04T12:09:34.000Z","size":34,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-05-04T13:33:40.546Z","etag":null,"topics":["cli","clickup","cu-cli","developer-tools","productivity","typescript"],"latest_commit_sha":null,"homepage":"https://github.com/AndroidPoet/cu-cli","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AndroidPoet.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-04T11:35:10.000Z","updated_at":"2026-05-04T12:07:36.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/AndroidPoet/cu-cli","commit_stats":null,"previous_names":["androidpoet/cu-cli"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/AndroidPoet/cu-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AndroidPoet%2Fcu-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AndroidPoet%2Fcu-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AndroidPoet%2Fcu-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AndroidPoet%2Fcu-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AndroidPoet","download_url":"https://codeload.github.com/AndroidPoet/cu-cli/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AndroidPoet%2Fcu-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32922894,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-11T17:09:15.040Z","status":"online","status_checked_at":"2026-05-12T02:00:06.338Z","response_time":102,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","clickup","cu-cli","developer-tools","productivity","typescript"],"created_at":"2026-05-12T04:04:07.245Z","updated_at":"2026-05-12T04:04:25.131Z","avatar_url":"https://github.com/AndroidPoet.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚀 CU-CLI (ClickUp CLI)\n\n[![GitHub License](https://img.shields.io/github/license/AndroidPoet/cu-cli?style=flat-square\u0026color=blue)](https://github.com/AndroidPoet/cu-cli/blob/master/LICENSE)\n[![GitHub Stars](https://img.shields.io/github/stars/AndroidPoet/cu-cli)](https://github.com/AndroidPoet/cu-cli/stargazers)\n\nA 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.\n\n---\n\n## ✨ Features\n\n- 🔐 **Secure Auth**: Local configuration and environment variable support.\n- 📂 **Hierarchy Management**: List Workspaces, Spaces, Folders, and Lists.\n- ✅ **Task Operations**: Create, read, update, and delete tasks seamlessly.\n- 🔍 **Filtering**: Filter tasks by status, assignee, and more.\n- 📦 **JSON Output**: Optional JSON output for all commands, perfect for scripting.\n- 🎨 **Beautiful UI**: Styled output with clear status indicators and emojis.\n\n---\n\n## 📥 Installation\n\nChoose your preferred way to install CU-CLI:\n\n### 1. Via Homebrew (Recommended for macOS)\n```bash\nbrew tap AndroidPoet/tap\nbrew install cu-cli\n```\n\n### 2. Via npm (Directly from GitHub)\n```bash\nnpm install -g @androidpoet/cu-cli\n```\n\n### 3. From Source (For Developers)\n```bash\ngit clone https://github.com/AndroidPoet/cu-cli.git\ncd cu-cli\nnpm install\nnpm run build\nnpm install -g .\n```\n\n---\n\n## 🚀 Quick Start\n\nOnce installed, follow these steps to get started:\n\n1.  **Configure your token:**\n    ```bash\n    cu-cli auth set \u003cyour_clickup_token\u003e\n    ```\n2.  **Verify the setup:**\n    ```bash\n    cu-cli auth status\n    ```\n3.  **List your workspaces:**\n    ```bash\n    cu-cli workspaces\n    ```\n\n---\n\n## 🔑 Authentication\n\nFirst, get your personal API token from [ClickUp Settings \u003e Apps](https://app.clickup.com/settings/apps).\n\n```bash\n# Set your token\ncu-cli auth set pk_your_token_here\n\n# Verify connectivity\ncu-cli auth status\n```\n\n*Or use an environment variable:* `export CLICKUP_API_TOKEN=pk_xxxxxxxxxxxxx`\n\n---\n\n## 🛠 Usage Guide\n\n### 🏢 Workspaces \u0026 hierarchy\n```bash\n# List all workspaces\ncu-cli workspaces\n\n# List spaces (uses first workspace by default)\ncu-cli spaces --workspace-id \u003cid\u003e\n\n# List folders in a space\ncu-cli folders --space-id \u003cid\u003e\n\n# List lists in a folder or space\ncu-cli lists --folder-id \u003cid\u003e\ncu-cli lists --space-id \u003cid\u003e\n```\n\n### 📝 Task Management\n| Feature | Command |\n| :--- | :--- |\n| **List Tasks** | `cu-cli tasks list --list-id \u003cid\u003e --status \"In Progress\"` |\n| **Get Details** | `cu-cli tasks get \u003ctask-id\u003e` |\n| **Create Task** | `cu-cli tasks create --list-id \u003cid\u003e --name \"New Bug Fix\"` |\n| **Update Task** | `cu-cli tasks update \u003ctask-id\u003e --status \"Done\"` |\n| **Delete Task** | `cu-cli tasks delete \u003ctask-id\u003e --confirm` |\n\n#### Creating tasks with extra options:\n```bash\ncu-cli tasks create \\\n  --list-id 123456 \\\n  --name \"Urgent API Fix\" \\\n  --description \"Fix the auth timeout issue\" \\\n  --priority 1 \\\n  --tags \"bug,high-priority\"\n```\n\n---\n\n## ⚙️ Configuration\n\nYour configuration is stored locally in `~/.cu-cli/config.json`:\n\n```json\n{\n  \"integrations\": {\n    \"clickup\": {\n      \"token\": \"pk_xxxxxxxxxxxxx\"\n    }\n  }\n}\n```\n\n---\n\n## 🔴 Priority Cheat Sheet\n\n| Value | Priority | Color |\n| :--- | :--- | :--- |\n| `1` | Urgent | 🔴 |\n| `2` | High | 🟠 |\n| `3` | Normal | 🟢 |\n| `4` | Low | ⚪ |\n\n---\n\n## 🤝 Contributing\n\nContributions are welcome! Please check out the [BUILD.md](./BUILD.md) for local development instructions.\n\n1. Fork the Project\n2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the Branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n---\n\n## 📄 License\n\nDistributed under the MIT License. See `LICENSE` for more information.\n\nDeveloped with ❤️ by [AndroidPoet](https://github.com/AndroidPoet)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandroidpoet%2Fcu-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fandroidpoet%2Fcu-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandroidpoet%2Fcu-cli/lists"}