pp-clickup

What this skill does

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/project-management/clickup/SKILL.md,
     regenerated post-merge by tools/generate-skills/. Hand-edits here are
     silently overwritten on the next regen. Edit the library/ source instead.
     See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

# ClickUp — Printing Press CLI

## Prerequisites: Install the CLI

This skill drives the `clickup-pp-cli` binary. **You must verify the CLI is installed before invoking any command from this skill.** If it is missing, install it first:

1. Install via the Printing Press installer. It defaults binaries to `$HOME/.local/bin` on macOS/Linux and `%LOCALAPPDATA%\Programs\PrintingPress\bin` on Windows:
   ```bash
   npx -y @mvanhorn/printing-press-library install clickup --cli-only
   ```
2. Verify: `clickup-pp-cli --version`
3. Ensure the reported install directory is on `$PATH` for the agent/runtime that will invoke this skill.

If the `npx` install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.3 or newer):

```bash
go install github.com/mvanhorn/printing-press-library/library/project-management/clickup/cmd/clickup-pp-cli@latest
```

If `--version` reports "command not found" after install, the runtime cannot see the binary directory on `$PATH`. Do not proceed with skill commands until verification succeeds.

## When to Use This CLI

Use clickup-pp-cli when you need to script against the full ClickUp v2 + v3 surface, populate a local SQLite store for offline analytics across a workspace's full hierarchy, or expose ClickUp as an MCP server to an agent. Particularly useful for time-tracking aggregation, sprint reporting, and bulk task operations that the web UI doesn't surface.

## Unique Capabilities

These capabilities aren't available in any other tool for this API.

### Local state that compounds
- **`sync`** — Walks the full ClickUp hierarchy in dependency order (teams → spaces → folders → lists → tasks; teams → docs; teams → channels) and lands every record in the local SQLite store. Every parent-child relationship in the API is traversed automatically.

  _Reach for this when you want offline search, analytics, or any compound query across a ClickUp workspace's full structure. One command populates the entire tree._

  ```bash
  clickup-pp-cli sync --json --profile default
  ```
- **`sync`** — Distinguishes "recognized envelope with empty array" from "unrecognized response shape" so tenants with zero records of a resource type sync cleanly instead of crashing. ClickUp returns {"spaces":[]} for workspaces with no spaces; the original framework treated this as a singular response and tried to upsert the wrapper as a single record, failing with "missing id for space".

  _Without this, sync silently fails for any workspace with empty resource collections, leaving the local store partially populated._

  ```bash
  clickup-pp-cli sync --resources space --profile default --json
  ```

### Agent-native plumbing
- **`docs`** — Top-level `docs` and `chat` commands with idiomatic verbs (search, get, pages, page, listing, create, edit, send, react, reply, members, followers, messages) replacing the spec-derived workspaces/docs/<verb>-public and workspaces/chat/get-channels paths. ~22 aliases total. Original verbs kept as Cobra aliases for back-compat.

  _Reach for `docs search`, `chat list`, `chat send` directly instead of remembering the deeply-nested workspaces tree. Especially useful when scripting against v3 endpoints._

  ```bash
  clickup-pp-cli docs search 9017321407 --json --profile default
  ```

## Command Reference

**checklist** — Manage checklist

- `clickup-pp-cli checklist delete` — Delete a checklist from a task.
- `clickup-pp-cli checklist edit` — Rename a task checklist, or reorder a checklist so it appears above or below other checklists on a task.

**comment** — Manage comment

- `clickup-pp-cli comment delete` — Delete a task comment.
- `clickup-pp-cli comment update` — Replace the content of a task commment, assign a comment, and mark a comment as resolved.

**folder** — Manage folder

- `clickup-pp-cli folder delete` — Delete a Folder from your Workspace.
- `clickup-pp-cli folder get` — View the Lists within a Folder.
- `clickup-pp-cli folder update` — Rename a Folder.

**goal** — Manage goal

- `clickup-pp-cli goal delete` — Remove a Goal from your Workspace.
- `clickup-pp-cli goal get` — View the details of a Goal including its Targets.
- `clickup-pp-cli goal update` — Rename a Goal, set the due date, replace the description, add or remove owners, and set the Goal color.

**group** — Manage group

- `clickup-pp-cli group delete-team` — This endpoint is used to remove a [User Group](https://docs.clickup.com/en/articles/4010016-teams-how-to-create-user-...
- `clickup-pp-cli group get-teams1` — This endpoint is used to view [User Groups](https://docs.clickup.com/en/articles/4010016-teams-how-to-create-user-gro...
- `clickup-pp-cli group update-team` — This endpoint is used to manage [User Groups](https://docs.clickup.com/en/articles/4010016-teams-how-to-create-user-g...

**key-result** — Manage key result

- `clickup-pp-cli key-result delete` — Delete a target from a Goal.
- `clickup-pp-cli key-result edit` — Update a Target.

**list** — Manage list

- `clickup-pp-cli list delete` — Delete a List from your Workspace.
- `clickup-pp-cli list get` — View information about a List.
- `clickup-pp-cli list update` — Rename a List, update the List Info description, set a due date/time, set the List's priority, set an assignee, set...

**oauth** — Manage oauth

- `clickup-pp-cli oauth` — These are the routes for authing the API and going through the [OAuth flow](doc:authentication). Applications...

**space** — Manage space

- `clickup-pp-cli space delete` — Delete a Space from your Workspace.
- `clickup-pp-cli space get` — View the Spaces available in a Workspace.
- `clickup-pp-cli space update` — Rename, set the Space color, and enable ClickApps for a Space.

**task** — Manage task

- `clickup-pp-cli task delete` — Delete a task from your Workspace.
- `clickup-pp-cli task get` — View information about a task. You can only view task information of tasks you can access. Tasks with attachments...
- `clickup-pp-cli task get-bulk-timein-status` — View how long two or more tasks have been in each status. The Total time in Status ClickApp must first be enabled by...
- `clickup-pp-cli task update` — Update a task by including one or more fields in the request body.

**team** — Manage team

- `clickup-pp-cli team` — View the Workspaces available to the authenticated user.

**user** — Manage user

- `clickup-pp-cli user` — View the details of the authenticated user's ClickUp account.

**view** — Manage view

- `clickup-pp-cli view delete` — Delete View
- `clickup-pp-cli view get` — View information about a specific task or page view. The information returned about a view varies by the type of view.
- `clickup-pp-cli view update` — Rename a view, update the grouping, sorting, filters, columns, and settings of a view.

**webhook** — Manage webhook

- `clickup-pp-cli webhook delete` — Delete a webhook to stop monitoring the events and locations of the webhook.
- `clickup-pp-cli webhook update` — Update a webhook to change the events to be monitored.

**workspaces** — Manage workspaces



### Finding the right command

When you know what you want to do but not which command does it, ask the CLI directly:

```bash
clickup-pp-cli which "<capability in your own words>"
```

`which` resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code `0` means at least one match; exit code `2` means no confident match — fall back to `--help` or use a narrower query.

## Recipes


### Drill from workspace to tasks

```bash
clickup-pp-cli team space get <team_id> --json --profile default
```

Get every spa