clickup-cli

@triptechtravel/clickup-cli

A command-line tool for working with ClickUp tasks, comments, and sprints -- designed for developers who live in the terminal and use GitHub.

Install

# Homebrew
brew install triptechtravel/tap/clickup

# Go
go install github.com/triptechtravel/clickup-cli/cmd/clickup@latest

# Or download a binary from the releases page

Quick start

clickup auth login        # authenticate with your API token
clickup space select       # choose a default space
clickup task view          # view the task from your current git branch
clickup status set "done"  # fuzzy-matched status update
clickup link pr            # link the current GitHub PR to the task

See the getting started guide for a full walkthrough.

What it does

• Task management -- view, create, edit, search, and bulk-edit tasks with custom fields, tags, points, and time estimates
• Docs -- list, view, create ClickUp Docs and manage their pages (list, view, create, edit) via the v3 API
• Git integration -- auto-detects task IDs from branch names and links PRs, branches, and commits to ClickUp
• Sprint dashboard -- sprint current shows tasks grouped by status; task create --current creates tasks in the active sprint
• Time tracking -- log time, view per-task entries, or query workspace-wide timesheets by date range
• Comments & inbox -- add comments with @mentions, view your recent mentions across the workspace
• Fuzzy status matching -- set statuses with partial input ("review" matches "code review")
• AI-friendly -- --json output and explicit flags make it easy for AI agents to read and update tasks
• CI/CD ready -- --with-token, exit codes, and JSON output for automation; includes GitHub Actions examples

Commands

Full command list with flags and examples: Command reference

Documentation

triptechtravel.github.io/clickup-cli

• Installation -- Homebrew, Go, binaries, shell completions
• Getting started -- first-time setup walkthrough
• Configuration -- config file, per-directory defaults, aliases
• Git integration -- branch naming, GitHub linking strategy
• CI usage -- non-interactive auth, JSON output, scripting
• GitHub Actions -- ready-to-use workflow templates
• AI agents -- integration with Claude Code, Copilot, Cursor
• Command reference -- auto-generated flag and usage docs

Contributing

See CONTRIBUTING.md for development setup, project structure, and guidelines.

Author

Created by Isaac Rowntree.

License

MIT