clickup-cli 1.2.0__tar.gz → 1.4.0__tar.gz

clickup_cli-1.4.0/.claude/agents/api-compatibility-checker.md

@@ -0,0 +1,39 @@
+---
+name: api-compatibility-checker
+description: Cross-reference CLI endpoint usage against ClickUp API docs to flag deprecated or changed endpoints
+---
+
+# API Compatibility Checker
+
+You verify that the ClickUp CLI's API endpoint usage is current and compatible.
+
+## Steps
+
+1. Read `src/clickup_cli/client.py` to extract all API endpoints used (URL patterns in requests calls).
+
+2. Read each command file in `src/clickup_cli/commands/` to find any direct endpoint references.
+
+3. Build a list of all endpoints used, grouped by API version (v2 vs v3).
+
+4. For each endpoint, check the current ClickUp API documentation to verify:
+   - The endpoint still exists
+   - The HTTP method matches
+   - Required parameters haven't changed
+   - Response format is consistent with what the CLI expects
+
+5. Report findings:
+   - **OK** — endpoint verified as current
+   - **WARNING** — endpoint exists but has changes (new required params, deprecated fields)
+   - **BREAKING** — endpoint removed or fundamentally changed
+
+## Output
+
+Return a JSON summary:
+```json
+{
+  "total_endpoints": 0,
+  "ok": 0,
+  "warnings": [],
+  "breaking": []
+}
+```

clickup_cli-1.4.0/.claude/settings.json

@@ -0,0 +1,44 @@
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "filepath=\"$TOOL_INPUT_FILE_PATH$TOOL_INPUT_file_path\"; if echo \"$filepath\" | grep -qE '\\.py$'; then ruff check --fix --quiet \"$filepath\" 2>/dev/null; ruff format --quiet \"$filepath\" 2>/dev/null; fi; true"
+          }
+        ]
+      },
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "filepath=\"$TOOL_INPUT_FILE_PATH$TOOL_INPUT_file_path\"; if echo \"$filepath\" | grep -qE 'src/clickup_cli/commands/[a-z]+\\.py$'; then python -m pytest tests/test_commands.py -x -q --tb=short 2>&1 | tail -5; elif echo \"$filepath\" | grep -qE 'src/clickup_cli/(cli|helpers|config|client)\\.py$'; then mod=$(basename \"$filepath\" .py); if [ -f \"tests/test_${mod}.py\" ]; then python -m pytest \"tests/test_${mod}.py\" -x -q --tb=short 2>&1 | tail -5; fi; fi; true"
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "filepath=\"$TOOL_INPUT_FILE_PATH$TOOL_INPUT_file_path\"; if echo \"$filepath\" | grep -qE '\\.(env|secret|pem|key)$|credentials'; then echo 'BLOCKED: refusing to edit sensitive file'; exit 1; fi"
+          }
+        ]
+      },
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "filepath=\"$TOOL_INPUT_FILE_PATH$TOOL_INPUT_file_path\"; if echo \"$filepath\" | grep -qE 'pyproject\\.toml$'; then echo 'BLOCKED: pyproject.toml edit requires explicit approval'; exit 1; fi"
+          }
+        ]
+      }
+    ]
+  }
+}

clickup_cli-1.4.0/.claude/skills/changelog/SKILL.md

@@ -0,0 +1,48 @@
+---
+name: changelog
+description: Generate release notes from git log since last tag, categorized by commit type
+disable-model-invocation: true
+---
+
+# Generate Changelog Entry
+
+Generate a categorized changelog entry for the next release.
+
+## Steps
+
+1. Find the last release tag:
+
+```bash
+git describe --tags --abbrev=0 2>/dev/null || echo "none"
+```
+
+2. Get all commits since that tag (or all commits if no tag exists):
+
+```bash
+git log $(git describe --tags --abbrev=0 2>/dev/null)..HEAD --oneline 2>/dev/null || git log --oneline
+```
+
+3. Categorize commits by their prefix:
+   - **Added** — `feat:`, `add:`
+   - **Changed** — `refactor:`, `update:`, `improve:`
+   - **Fixed** — `fix:`, `bugfix:`
+   - **Testing** — `test:`
+   - **Docs** — `docs:`
+   - **Other** — everything else
+
+4. Draft a markdown changelog entry:
+
+```markdown
+## [vX.Y.Z] - YYYY-MM-DD
+
+### Added
+- Description of new features
+
+### Changed
+- Description of changes
+
+### Fixed
+- Description of bug fixes
+```
+
+5. Present the draft for review. Do not write to any file until the user approves.

clickup_cli-1.4.0/.claude/skills/validate-output/SKILL.md

@@ -0,0 +1,43 @@
+---
+name: validate-output
+description: Verify the CLI's JSON-only stdout contract across all commands. Run after adding new commands or modifying output logic.
+---
+
+# Validate CLI Output Contract
+
+Verify that every CLI command produces valid JSON on stdout and errors on stderr.
+
+## Steps
+
+1. Get all command groups and subcommands:
+
+```bash
+clickup --help 2>/dev/null
+```
+
+2. For each command group, get its subcommands:
+
+```bash
+clickup <group> --help 2>/dev/null
+```
+
+3. For each subcommand that supports `--dry-run`, run it with dummy arguments and `--dry-run`:
+
+```bash
+clickup --dry-run <group> <subcommand> <required-args> 2>/dev/null
+```
+
+4. Validate that stdout is valid JSON by piping through `python3 -c "import sys,json; json.load(sys.stdin)"`.
+
+5. For read-only commands (list, get, search), run with `--help` and verify the help text renders without errors.
+
+6. Report results as a summary:
+   - Total commands checked
+   - Commands producing valid JSON
+   - Commands with issues (list each with the error)
+
+## What Counts as a Failure
+
+- Any stdout output that is not valid JSON
+- Any command that crashes (non-zero exit without stderr message)
+- Help text that fails to render

{clickup_cli-1.2.0 → clickup_cli-1.4.0}/CHANGELOG.md

@@ -1,7 +1,27 @@
 # Changelog
 
+## 1.4.0 (2026-04-11)
+
+- **`tasks update` now handles tags, assignees, and custom fields.** Five new repeatable flags: `--add-assignee` / `--remove-assignee` (packed into the PUT body), `--add-tag` / `--remove-tag` (issues one POST/DELETE per tag), and `--custom-field FIELD_ID=VALUE` (issues one POST per field). When no PUT body is needed, the task is re-fetched at the end so the returned JSON always reflects final state. `--dry-run` returns a structured plan with no API calls.
+- **New `tasks depend` subcommand group** — `add`, `remove`, and `list` for task dependencies. Direction is required and mutually exclusive: `--depends-on OTHER` (this task waits on OTHER) or `--depended-on-by OTHER` (OTHER waits on this). `list` partitions the task's `dependencies` array into both directions from the target task's point of view.
+- **`tasks list` and `tasks search` accept `--include-archived`.** Since ClickUp's `archived` param is a filter (returns only archived), the flag issues a second paginated request with `archived=true` and merges the results. Default behavior unchanged.
+- **Raw numeric IDs accepted on all name-lookup flags.** `--space` / `--folder` on folders, lists, spaces, and tasks commands now transparently accept raw ClickUp IDs alongside config aliases. On tasks commands, raw space IDs resolve via a one-call API lookup to the first folderless list in that space. Help metavars updated to `SPACE_NAME_OR_ID` for discoverability. Case-sensitive alias matching is unchanged — `Personal` vs `personal` remains a deliberate error.
+- **Fix: `tasks create` no longer leaks `hint: inferred --space` to stderr.** Same fix applied to `tasks search`'s auto name-prefix hint. Both are deterministic from inputs and the JSON response — the hints were informational noise that broke `2>&1 | jq` pipes.
+- **Fix: `tasks create` is now truly neutral.** The v1.3.0 release advertised neutral defaults but still read `default_tags` from the config file and applied it silently. Removed `default_tags` from the config schema entirely; stale entries in existing configs are now ignored.
+- **Fix: `tasks list --full` returns a consistent status shape.** Compact mode already flattened status to a string, but `--full` passed raw API shapes through — sometimes dict, sometimes string. Now `--full` always returns status as a dict (`{status, color, type, orderindex}`), upgrading string statuses with null metadata.
+- **Client: `delete_v2` accepts an optional `params` kwarg** to forward query parameters (needed for the dependency remove endpoint).
+- Test suite: 305 → 332 tests. Added coverage for stderr contract, archived pagination, status-shape normalization, raw-ID lookups, expanded update paths, and dependency CRUD.
+
+## 1.3.0 (2026-04-10)
+
+- Add `--tag` filter on `tasks list` (API-level, repeatable, auto-lowercased) and `tasks search` (client-side filter).
+- Remove opinionated `tasks create` defaults: no auto-assignee, no auto-priority, no auto-tags unless explicitly passed. (Note: `default_tags` config field was not fully removed until 1.4.0.)
+- Explicit `--assign <user_id>` flag for `tasks create` when you do want to assign.
+
 ## 1.2.0 (2026-03-29)
 
+**First PyPI release** — `pip install clickup-cli`
+
 - Accept flag aliases for all positional arguments — agents can now use `--task-id`, `--query`, `--doc-id`, `--page-id`, `--folder-id`, `--list-id`, `--comment-id`, `--space` instead of positional args. Both forms work; positional args are unchanged for backwards compatibility.
 - Auto-infer `--space` from `--list` on `tasks create` — when `--list` is provided without `--space`, the CLI fetches the list metadata via API to resolve its parent space automatically. Eliminates the most common agent error (12+ failures in 3 days).
 - Make `--space` optional on `tasks create` (was required) — now only required if `--list` is also absent.

{clickup_cli-1.2.0 → clickup_cli-1.4.0}/CLAUDE.md

@@ -54,8 +54,27 @@ When adding new commands with ID arguments, always use `add_id_argument()` inste
 pip install -e ".[dev]"
 pytest -v
 ruff check src/ tests/
+scripts/validate-cli-output.sh   # verify JSON stdout contract
 ```
 
+## Test Structure
+
+```
+tests/
+├── conftest.py       # test config setup (runs at import time, before clickup_cli loads)
+├── test_cli.py       # argument parsing, dispatch, global flags, resolve_id_args
+├── test_client.py    # ClickUpClient: rate limiting, dry-run, debug mode, HTTP methods
+├── test_commands.py  # all command handlers: tasks, comments, docs, folders, lists, spaces, tags, team
+├── test_config.py    # config loading: file, env vars, fallback chain, workspace auto-detect
+└── test_helpers.py   # output/error helpers, compact_task, add_id_argument, fetch_all_comments pagination
+```
+
+305 tests, all using `unittest.TestCase` + `FakeClient` pattern (no real HTTP calls).
+
+## CI
+
+GitHub Actions (`ci.yml`): lint + test on Python 3.9, 3.11, 3.13. Runs on push to main and PRs.
+
 ## Adding a New Command
 
 1. Create or extend a file in `src/clickup_cli/commands/`
@@ -74,3 +93,24 @@ ruff check src/ tests/
 - Stdout is always JSON. Errors and warnings go to stderr.
 - Every mutation supports `--dry-run`
 - Config is lazy-loaded — the `init` command works without any config file
+
+## Automations
+
+Hooks, skills, and subagents in `.claude/`:
+
+**Hooks** (`settings.json`):
+- PostToolUse: ruff auto-lint/format on `.py` edits
+- PostToolUse: auto-run affected test file on source edits
+- PreToolUse: block `.env`/`.pem`/`.key`/credentials edits
+- PreToolUse: block `pyproject.toml` edits (requires explicit approval)
+
+**Skills** (`skills/`):
+- `add-command` — step-by-step workflow for adding new CLI commands
+- `clickup-cli` — usage guide for the CLI itself
+- `release` — version bump, build, PyPI publish workflow
+- `validate-output` — verify JSON stdout contract across all commands
+- `changelog` — generate categorized release notes from git log
+
+**Subagents** (`agents/`):
+- `test-writer` — generate pytest tests following existing patterns
+- `api-compatibility-checker` — cross-ref CLI endpoints against ClickUp API docs

clickup_cli-1.4.0/CONTRIBUTING.md

@@ -0,0 +1,54 @@
+# Contributing
+
+Thanks for your interest in clickup-cli.
+
+## Getting Started
+
+```bash
+git clone https://github.com/efetoker/clickup-cli.git
+cd clickup-cli
+pip install -e ".[dev]"
+```
+
+## Running Tests
+
+```bash
+pytest -v
+```
+
+All tests must pass before submitting a PR.
+
+## Linting
+
+```bash
+ruff check src/ tests/
+ruff format src/ tests/
+```
+
+## Guidelines
+
+- **JSON stdout, errors to stderr** — all commands follow this convention
+- **Dry-run on mutations** — every mutating command must support `--dry-run`
+- **Help text is documentation** — `--help` should be self-sufficient for discovering usage
+- **No workspace-specific values** — help text and source must not contain hardcoded workspace IDs, space names, or user data
+- **Tests required** — new commands need test coverage in `tests/`
+
+## Adding a New Command
+
+1. Create or extend a file in `src/clickup_cli/commands/`
+2. Implement `register_parser()` and handler functions in the same module
+3. Register the handler in `commands/__init__.py`
+4. Use `add_id_argument()` from `helpers.py` for positional ID arguments (provides both positional and `--flag` forms)
+5. Add `--help` text with description and usage examples
+6. Add tests in `tests/`
+
+## Submitting Changes
+
+1. Fork the repo and create a feature branch
+2. Make your changes with tests
+3. Run `pytest -v` and `ruff check src/ tests/`
+4. Open a PR with a clear description of what changed and why
+
+## License
+
+By contributing, you agree that your contributions will be licensed under the MIT License.

{clickup_cli-1.2.0 → clickup_cli-1.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: clickup-cli
-Version: 1.2.0
+Version: 1.4.0
 Summary: The missing ClickUp CLI. Built for developers and AI agents.
 Project-URL: Homepage, https://github.com/efetoker/clickup-cli
 Project-URL: Repository, https://github.com/efetoker/clickup-cli
@@ -32,6 +32,10 @@ Description-Content-Type: text/markdown
 
 # clickup-cli
 
+[![PyPI version](https://img.shields.io/pypi/v/clickup-cli)](https://pypi.org/project/clickup-cli/)
+[![Python versions](https://img.shields.io/pypi/pyversions/clickup-cli)](https://pypi.org/project/clickup-cli/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
 The missing ClickUp CLI. Built for developers and AI agents.
 
 There's no official ClickUp CLI. If you're a developer who lives in the terminal, or an AI agent that needs structured data from ClickUp, this fills the gap. JSON stdout, errors to stderr, dry-run on every mutation.
@@ -127,7 +131,6 @@ clickup tasks list --space <name> --pretty
 - **`tasks create`** auto-infers `--space` from `--list` via API lookup. You can omit `--space` if `--list` is provided.
 - **`tasks get`** auto-fetches comments and appends them to the output. Use `--no-comments` to skip.
 - **`tasks search`** auto-detects task ID patterns like `PROJ-39` and applies prefix filtering.
-- **`tasks create`** checks for duplicates before creating. Use `--skip-dedup` to bypass.
 - **`docs edit-page --append`** reads the current page content, appends your new content, and sends one update.
 - **Tag names** are auto-lowercased (ClickUp API stores them lowercase regardless of UI display).
 - **Doc ID ≠ page ID.** Always use `docs pages <doc_id>` to discover page IDs before using `get-page` or `edit-page`.
@@ -145,11 +148,7 @@ clickup tasks list --space <name> --pretty
   "user_id": "67890",
   "spaces": {
     "myspace": {"space_id": "111", "list_id": "222"}
-  },
-  "default_tags": [],
-  "draft_tag": "draft",
-  "good_as_is_tag": "good as is",
-  "default_priority": 4
+  }
 }
 ```
 

{clickup_cli-1.2.0 → clickup_cli-1.4.0}/README.md

@@ -1,5 +1,9 @@
 # clickup-cli
 
+[![PyPI version](https://img.shields.io/pypi/v/clickup-cli)](https://pypi.org/project/clickup-cli/)
+[![Python versions](https://img.shields.io/pypi/pyversions/clickup-cli)](https://pypi.org/project/clickup-cli/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
 The missing ClickUp CLI. Built for developers and AI agents.
 
 There's no official ClickUp CLI. If you're a developer who lives in the terminal, or an AI agent that needs structured data from ClickUp, this fills the gap. JSON stdout, errors to stderr, dry-run on every mutation.
@@ -95,7 +99,6 @@ clickup tasks list --space <name> --pretty
 - **`tasks create`** auto-infers `--space` from `--list` via API lookup. You can omit `--space` if `--list` is provided.
 - **`tasks get`** auto-fetches comments and appends them to the output. Use `--no-comments` to skip.
 - **`tasks search`** auto-detects task ID patterns like `PROJ-39` and applies prefix filtering.
-- **`tasks create`** checks for duplicates before creating. Use `--skip-dedup` to bypass.
 - **`docs edit-page --append`** reads the current page content, appends your new content, and sends one update.
 - **Tag names** are auto-lowercased (ClickUp API stores them lowercase regardless of UI display).
 - **Doc ID ≠ page ID.** Always use `docs pages <doc_id>` to discover page IDs before using `get-page` or `edit-page`.
@@ -113,11 +116,7 @@ clickup tasks list --space <name> --pretty
   "user_id": "67890",
   "spaces": {
     "myspace": {"space_id": "111", "list_id": "222"}
-  },
-  "default_tags": [],
-  "draft_tag": "draft",
-  "good_as_is_tag": "good as is",
-  "default_priority": 4
+  }
 }
 ```
 

{clickup_cli-1.2.0 → clickup_cli-1.4.0}/clickup-config.example.json

@@ -4,9 +4,5 @@
   "user_id": "YOUR_USER_ID",
   "spaces": {
     "myspace": {"space_id": "SPACE_ID", "list_id": "DEFAULT_LIST_ID"}
-  },
-  "default_tags": [],
-  "draft_tag": "draft",
-  "good_as_is_tag": "good as is",
-  "default_priority": 4
+  }
 }

{clickup_cli-1.2.0 → clickup_cli-1.4.0}/src/clickup_cli/__init__.py

@@ -1,3 +1,3 @@
 """ClickUp CLI — the missing ClickUp CLI for developers and AI agents."""
 
-__version__ = "1.2.0"
+__version__ = "1.4.0"

{clickup_cli-1.2.0 → clickup_cli-1.4.0}/src/clickup_cli/client.py

@@ -100,8 +100,8 @@ class ClickUpClient:
     def put_v2(self, path, data=None):
         return self._request("PUT", f"{self.BASE_V2}{path}", json=data)
 
-    def delete_v2(self, path):
-        return self._request("DELETE", f"{self.BASE_V2}{path}")
+    def delete_v2(self, path, params=None):
+        return self._request("DELETE", f"{self.BASE_V2}{path}", params=params)
 
     def get_v3(self, path, params=None, allow_dry_run=False):
         return self._request(

{clickup_cli-1.2.0 → clickup_cli-1.4.0}/src/clickup_cli/commands/__init__.py

@@ -4,6 +4,7 @@ from .tasks import (
     cmd_tasks_list, cmd_tasks_get, cmd_tasks_create,
     cmd_tasks_update, cmd_tasks_search,
     cmd_tasks_delete, cmd_tasks_move, cmd_tasks_merge,
+    cmd_tasks_depend,
 )
 from .comments import (
     cmd_comments_list, cmd_comments_add,
@@ -37,6 +38,7 @@ HANDLERS = {
     "tasks_delete": cmd_tasks_delete,
     "tasks_move": cmd_tasks_move,
     "tasks_merge": cmd_tasks_merge,
+    "tasks_depend": cmd_tasks_depend,
     "comments_list": cmd_comments_list,
     "comments_add": cmd_comments_add,
     "comments_update": cmd_comments_update,

{clickup_cli-1.2.0 → clickup_cli-1.4.0}/src/clickup_cli/commands/folders.py

@@ -55,9 +55,10 @@ examples:
     )
     fl.add_argument(
         "--space",
+        metavar="SPACE_NAME_OR_ID",
         required=True,
         type=str,
-        help="Space name (from config) or raw space ID",
+        help="Space name (from config) or raw ClickUp space ID",
     )
 
     # folders get
@@ -101,9 +102,10 @@ examples:
     )
     fc.add_argument(
         "--space",
+        metavar="SPACE_NAME_OR_ID",
         required=True,
         type=str,
-        help="Space name (from config) or raw space ID",
+        help="Space name (from config) or raw ClickUp space ID",
     )
     fc.add_argument("--name", required=True, help="Folder name (required)")
 

{clickup_cli-1.2.0 → clickup_cli-1.4.0}/src/clickup_cli/commands/init.py

@@ -131,10 +131,6 @@ def cmd_init(args):
         "workspace_id": workspace_id,
         "user_id": user_id,
         "spaces": spaces,
-        "default_tags": [],
-        "draft_tag": "draft",
-        "good_as_is_tag": "good as is",
-        "default_priority": 4,
     }
 
     # Write config

{clickup_cli-1.2.0 → clickup_cli-1.4.0}/src/clickup_cli/commands/lists.py

@@ -61,12 +61,16 @@ notes:
     )
     ll_target = ll.add_mutually_exclusive_group(required=True)
     ll_target.add_argument(
-        "--folder", type=str, help="Folder ID — list all lists inside this folder"
+        "--folder",
+        metavar="FOLDER_ID",
+        type=str,
+        help="Raw ClickUp folder ID — list all lists inside this folder",
     )
     ll_target.add_argument(
         "--space",
+        metavar="SPACE_NAME_OR_ID",
         type=str,
-        help="Space name or ID — list folderless lists in this space",
+        help="Space name (from config) or raw ClickUp space ID — list folderless lists",
     )
 
     # lists get
@@ -119,12 +123,16 @@ notes:
     )
     lc_target = lc.add_mutually_exclusive_group(required=True)
     lc_target.add_argument(
-        "--folder", type=str, help="Folder ID — create list inside this folder"
+        "--folder",
+        metavar="FOLDER_ID",
+        type=str,
+        help="Raw ClickUp folder ID — create list inside this folder",
     )
     lc_target.add_argument(
         "--space",
+        metavar="SPACE_NAME_OR_ID",
         type=str,
-        help="Space name or ID — create a folderless list in this space",
+        help="Space name (from config) or raw ClickUp space ID — folderless list",
     )
     lc.add_argument("--name", required=True, help="List name (required)")
     lc.add_argument("--content", type=str, help="List description/content")