Skip to content

Latest commit

 

History

History
56 lines (47 loc) · 2.58 KB

File metadata and controls

56 lines (47 loc) · 2.58 KB

Changelog

1.0.0 - 2026-02-16

First release of clickup-cli — a production-quality CLI covering 99.3% of the ClickUp API (134/135 endpoints), optimized for AI agents.

Command Groups (27 resource groups)

  • Authlogin, whoami
  • Workspaceslist, plan, seats
  • Spaces — full CRUD (list, get, create, update, delete)
  • Folders — full CRUD
  • Lists — full CRUD (folder and folderless)
  • Tasks — full CRUD + search, add-to-list, remove-from-list, merge, time-in-status
  • Task Dependenciesadd, remove
  • Task Linksadd, remove
  • Comments — full CRUD on tasks, lists, views
  • Comment Replies — threaded reply list and create
  • Docs (v3 API) — doc CRUD + page CRUD (list, get, create, update)
  • Custom Fieldslist (workspace/space/folder/list scope), set, remove
  • Tags — full CRUD + task add/remove
  • Checklistscreate, update, delete
  • Checklist Itemscreate, update, delete
  • Time Entries — full CRUD + start, stop, current, history
  • Time Entry Legacy — task-level list, create, update, delete
  • Time Entry Tagsadd, remove, update
  • Views — full CRUD + tasks
  • Goals — full CRUD
  • Goal Key Resultscreate, update, delete
  • Webhooks — full CRUD
  • Memberslist (task/list)
  • User Groupslist, create, update, delete
  • Usersinvite, get, update, remove
  • Guestsinvite, get, edit, remove + add-to-task/list/folder, remove-from-task/list/folder
  • Roleslist custom roles
  • Custom Task Typeslist
  • Shared Hierarchylist
  • Templateslist, create-task, create-list, create-folder
  • Attachmentscreate (file upload)

Agent-Optimized Design

  • JSON-first output — every command outputs valid JSON. Errors: {"error":"message","code":"ERROR_CODE"}
  • Every API parameter exposed — no capability loss vs. the raw API
  • No interactive prompts — fully flag-driven for agent/automation use
  • Config persistence — token and default workspace in ~/.clickup-cli.yaml
  • Consistent patternsclickup <resource> <verb> [flags] everywhere

Developer Experience

  • CI with GitHub Actions (Go 1.22 + 1.23, golangci-lint)
  • Cross-platform binaries (Linux, macOS, Windows — amd64 + arm64)
  • Table-driven tests with httptest mocking
  • Conventional commits, issue templates, PR template