fix: review findings and update docs for v0.28-v0.31 features

Fixes from code review:
- Add float64 case to getIntValue (custom field dates/emojis from JSON)
- Fix semaphore drain deadlock in searchTaskComments on context cancel
  (replaced cap-fill pattern with sync.WaitGroup)
- Normalize task API paths: remove trailing slash between ID and query
- Use strconv.FormatInt for 32-bit safety in date serialization
- Remove dead dedup function and its tests

Update SKILL.md and README with all new features: folder/list commands,
chat send, --list-name, --assignee search, --include-closed, bulk delete,
recursive view, checklist item edit.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: isaacrowntree

README.md

@@ -34,14 +34,17 @@ See the [getting started guide](https://triptechtravel.github.io/clickup-cli/get
 
 ## What it does
 
-- **Task management** -- view, create, edit, search, and bulk-edit tasks with custom fields, tags, points, and time estimates
+- **Task management** -- view, create, edit, search, bulk-edit, and bulk-delete tasks with custom fields, tags, points, and time estimates
+- **Folder & list management** -- browse folders and lists, select defaults per directory, create tasks by list name
 - **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
+- **Chat** -- send messages to ClickUp chat channels
+- **Search** -- server-side search with parallel space traversal, `--assignee` filtering (name, username, ID, or `me`)
 - **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
+- **AI-friendly** -- `--json` output, recursive task view, 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
@@ -50,13 +53,16 @@ Full command list with flags and examples: **[Command reference](https://triptec
 
 | Area | Key commands |
 |------|-------------|
-| **Tasks** | `task view`, `task create`, `task edit`, `task search`, `task recent` |
+| **Tasks** | `task view`, `task create`, `task edit`, `task search`, `task delete`, `task recent` |
+| **Folders** | `folder list`, `folder select` |
+| **Lists** | `list list`, `list select` |
 | **Docs** | `doc list`, `doc view`, `doc create`, `doc page list`, `doc page view`, `doc page create`, `doc page edit` |
 | **Time** | `task time log`, `task time list` |
 | **Status** | `status set`, `status list`, `status add` |
 | **Git** | `link pr`, `link sync`, `link branch`, `link commit` |
 | **Sprints** | `sprint current`, `sprint list` |
 | **Comments** | `comment add`, `comment list` |
+| **Chat** | `chat send` |
 | **Attachments** | `attachment list`, `attachment add` |
 | **Workspace** | `inbox`, `member list`, `space select`, `tag list`, `field list` |
 

internal/apiv2/local.go

@@ -71,7 +71,7 @@ func DependencyQuery(dependsOn, dependencyOf string, customTaskIDs bool, teamID
 // GetTaskLocal fetches a single task. qs is a query string (e.g. from TaskQuery).
 func GetTaskLocal(ctx context.Context, client *api.Client, taskID, qs string) (*clickup.Task, error) {
 	var task clickup.Task
-	path := fmt.Sprintf("task/%s/%s", taskID, qs)
+	path := fmt.Sprintf("task/%s%s", taskID, qs)
 	if err := do(ctx, client, "GET", path, nil, &task); err != nil {
 		return nil, err
 	}
@@ -104,7 +104,7 @@ func CreateTaskLocal(ctx context.Context, client *api.Client, listID string, req
 // TaskAssigneeUpdateRequest are used.
 func UpdateTaskLocal(ctx context.Context, client *api.Client, taskID string, req any, qs string) (*clickup.Task, error) {
 	var task clickup.Task
-	path := fmt.Sprintf("task/%s/%s", taskID, qs)
+	path := fmt.Sprintf("task/%s%s", taskID, qs)
 	if err := do(ctx, client, "PUT", path, req, &task); err != nil {
 		return nil, err
 	}
@@ -113,7 +113,7 @@ func UpdateTaskLocal(ctx context.Context, client *api.Client, taskID string, req
 
 // DeleteTaskLocal deletes a task.
 func DeleteTaskLocal(ctx context.Context, client *api.Client, taskID, qs string) error {
-	path := fmt.Sprintf("task/%s/%s", taskID, qs)
+	path := fmt.Sprintf("task/%s%s", taskID, qs)
 	return do(ctx, client, "DELETE", path, nil, nil)
 }
 

internal/apiv2/local_test.go

@@ -182,7 +182,7 @@ func TestGetTaskLocal(t *testing.T) {
 
 	require.NoError(t, err)
 	assert.Equal(t, "GET", capturedMethod)
-	assert.Contains(t, capturedPath, "/task/task123/")
+	assert.Contains(t, capturedPath, "/task/task123")
 
 	// Verify decoded fields
 	assert.Equal(t, "task123", task.ID)
@@ -263,7 +263,7 @@ func TestUpdateTaskLocal(t *testing.T) {
 
 	require.NoError(t, err)
 	assert.Equal(t, "PUT", capturedMethod)
-	assert.Contains(t, capturedPath, "/task/task123/")
+	assert.Contains(t, capturedPath, "/task/task123")
 	assert.Equal(t, "Updated Name", capturedBody["name"])
 	assert.EqualValues(t, 2, capturedBody["priority"])
 	assert.Equal(t, "task123", task.ID)
@@ -285,7 +285,7 @@ func TestDeleteTaskLocal(t *testing.T) {
 
 	require.NoError(t, err)
 	assert.Equal(t, "DELETE", capturedMethod)
-	assert.Contains(t, capturedPath, "/task/task123/")
+	assert.Contains(t, capturedPath, "/task/task123")
 }
 
 func TestGetFilteredTeamTasksLocal(t *testing.T) {

internal/clickup/custom_fields.go

@@ -316,6 +316,8 @@ func getIntValue(v interface{}) (int64, bool) {
 	switch v := v.(type) {
 	case int:
 		return int64(v), true
+	case float64:
+		return int64(v), true
 	case string:
 		num, err := strconv.ParseInt(v, 10, 64)
 		if err != nil {

internal/clickup/date.go

@@ -91,7 +91,7 @@ func (d Date) MarshalJSON() ([]byte, error) {
 }
 
 func int64ToJsonNumber(n int64) json.Number {
-	b := []byte(strconv.Itoa(int(n)))
+	b := []byte(strconv.FormatInt(n, 10))
 
 	var v json.Number
 	if err := json.Unmarshal(b, &v); err != nil {

pkg/cmd/task/search.go

@@ -693,23 +693,24 @@ func searchTaskComments(ctx context.Context, client *api.Client, query string, t
 	// Fan out with bounded concurrency.
 	sem := make(chan struct{}, maxWorkers)
 	resultCh := make(chan result, len(tasks))
+	var wg sync.WaitGroup
 
 	for _, t := range tasks {
 		if ctx.Err() != nil {
 			break
 		}
 		sem <- struct{}{} // acquire
+		wg.Add(1)
 		go func(task searchTask) {
+			defer wg.Done()
 			defer func() { <-sem }() // release
 			match := taskMatchesComment(ctx, client, query, task.ID)
 			resultCh <- result{task: task, match: match}
 		}(t)
 	}
 
 	// Wait for all goroutines to finish.
-	for i := 0; i < cap(sem); i++ {
-		sem <- struct{}{}
-	}
+	wg.Wait()
 	close(resultCh)
 
 	var scored []scoredTask
@@ -779,18 +780,6 @@ func dedupScored(tasks []scoredTask) []scoredTask {
 	return result
 }
 
-func dedup(tasks []searchTask) []searchTask {
-	seen := make(map[string]bool)
-	var unique []searchTask
-	for _, t := range tasks {
-		if !seen[t.ID] {
-			seen[t.ID] = true
-			unique = append(unique, t)
-		}
-	}
-	return unique
-}
-
 func noResultsPrompt(ios *iostreams.IOStreams, opts *searchOptions) error {
 	p := prompter.New(ios)
 	idx, err := p.Select("What would you like to do?", []string{

pkg/cmd/task/search_test.go

@@ -11,28 +11,6 @@ import (
 	"github.com/triptechtravel/clickup-cli/internal/testutil"
 )
 
-func TestDedup(t *testing.T) {
-	tasks := []searchTask{
-		{ID: "1", Name: "Task A"},
-		{ID: "2", Name: "Task B"},
-		{ID: "1", Name: "Task A duplicate"},
-		{ID: "3", Name: "Task C"},
-		{ID: "2", Name: "Task B duplicate"},
-	}
-
-	result := dedup(tasks)
-	assert.Len(t, result, 3)
-	assert.Equal(t, "1", result[0].ID)
-	assert.Equal(t, "Task A", result[0].Name) // keeps first occurrence
-	assert.Equal(t, "2", result[1].ID)
-	assert.Equal(t, "3", result[2].ID)
-}
-
-func TestDedup_Empty(t *testing.T) {
-	result := dedup(nil)
-	assert.Nil(t, result)
-}
-
 func TestNewCmdSearch_Flags(t *testing.T) {
 	cmd := NewCmdSearch(nil)
 

skills/clickup-cli/SKILL.md

@@ -22,7 +22,7 @@ clickup auth login    # Authenticate with API token
 clickup auth status   # Check auth status
 ```
 
-Configuration is stored in `~/.config/clickup/config.yml`. Supports per-directory defaults for space, team, and folder.
+Configuration is stored in `~/.config/clickup/config.yml`. Supports per-directory defaults for space, team, folder, and list.
 
 ## Task Management
 
@@ -45,9 +45,11 @@ clickup task view 86abc1 86abc2 86abc3 --json
 clickup task view 86abc1 86abc2 86abc3 --jq '[.[] | {id: .id, tags: [.tags[].name]}]'
 
 # Search tasks by name and description (supports fuzzy matching)
-# Uses progressive drill-down: sprint → your tasks → space → workspace
+# Uses server-side search (Level 0) with parallel space traversal
 clickup task search "login bug"
 clickup task search "login bug" --exact    # Exact matches only
+clickup task search "login bug" --assignee me       # Only your tasks
+clickup task search "login bug" --assignee "alice"   # By name/username/ID
 
 # Recent tasks (excludes archived folders)
 clickup task recent
@@ -56,6 +58,19 @@ clickup task recent --sprint               # Only current sprint tasks
 # List tasks in a specific list
 clickup task list --list-id 12345
 
+# List tasks using configured default list (via `list select`)
+clickup task list
+
+# Include closed tasks in the list
+clickup task list --include-closed
+clickup task list -c --list-id 12345
+
+# Recursive view — fetch subtasks and their children in a single tree
+clickup task view 86abc123 --recursive --json
+
+# Bulk delete tasks (requires confirmation or -y to skip)
+clickup task delete 86abc1 86abc2 86abc3 -y
+
 # Task activity/comment history
 clickup task activity CU-abc123
 ```
@@ -92,6 +107,7 @@ clickup task activity CU-abc123
 
 - `--current` — **preferred**: auto-resolves the active sprint list (no need to know the list ID)
 - `--list-id` — explicit list ID (use when creating outside the current sprint)
+- `--list-name` — resolve a list name to its ID (e.g., `--list-name "Sprint 89"`)
 - `--name` — task name (required — follow naming conventions above)
 - `--description` or `--markdown-description` — clear description of the work
 - `--status` — initial status (e.g., "open", "in progress")
@@ -115,6 +131,13 @@ After creating a task, consider adding checklists for acceptance criteria or sub
 clickup task checklist add <task-id> "Acceptance Criteria"
 clickup task checklist item add <checklist-id> "Unit tests pass"
 clickup task checklist item add <checklist-id> "Code reviewed"
+clickup task checklist item add <checklist-id> "Assigned item" --assignee 12345678
+```
+
+Example — create a task by list name (resolves name to ID):
+
+```bash
+clickup task create --list-name "Sprint 89" --name "Fix bug" --status "open"
 ```
 
 Example of a well-populated task creation:
@@ -262,6 +285,32 @@ clickup sprint current
 clickup sprint list
 ```
 
+## Folders
+
+```bash
+# List folders in a space
+clickup folder list
+clickup folder list --space 12345
+clickup folder list --archived --json
+
+# Select a default folder (interactive)
+clickup folder select
+clickup folder select --local  # per-directory
+```
+
+## Lists
+
+```bash
+# List lists in a folder
+clickup list list --folder 12345
+clickup list list --space 12345  # folderless lists
+clickup list list --json
+
+# Select a default list (interactive)
+clickup list select
+clickup list select --local  # per-directory
+```
+
 ## Comments
 
 ```bash
@@ -477,6 +526,29 @@ clickup doc page edit <doc-id> <page-id> \
 clickup doc create --name "Sprint Retro" --json | jq -r '.id'
 ```
 
+## Chat
+
+```bash
+# Send a message to a chat channel
+clickup chat send <channel-id> "Hello team!"
+clickup chat send <channel-id> "Deploy complete" --json
+```
+
+## Checklists
+
+```bash
+# Add a checklist to a task
+clickup task checklist add <task-id> "Acceptance Criteria"
+
+# Add items to a checklist
+clickup task checklist item add <checklist-id> "Unit tests pass"
+clickup task checklist item add <checklist-id> "Assigned item" --assignee 12345678
+
+# Edit checklist items (supports bulk — multiple item IDs)
+clickup task checklist item edit <checklist-id> <item-id> --assignee 12345678
+clickup task checklist item edit <checklist-id> <item-id1> <item-id2> --assignee 12345678
+```
+
 ## Common Flags
 
 | Flag | Description |
@@ -499,3 +571,8 @@ clickup doc create --name "Sprint Retro" --json | jq -r '.id'
 - **Multi-list**: `task list-add`/`task list-remove` manage secondary list memberships — useful for cross-team sprint planning
 - **Naming conventions**: Task names follow `[Work Type] Context — Action (Platform)` format for sprint-board scannability. Check existing tasks in the list for the prevailing convention before creating
 - **Tag reuse**: Always check available tags with `clickup tag list` before creating tasks. Use existing tags for consistency; don't invent new ones without user confirmation
+- **Per-directory config**: `folder select --local` and `list select --local` store defaults in the current directory, useful for monorepos with different ClickUp contexts
+- **Server-side search**: `task search` uses ClickUp's server-side search with parallel space traversal for faster results
+- **Assignee shortcut**: `task search --assignee me` filters results to the authenticated user; also accepts names, usernames, or IDs
+- **Contextual task list**: `task list` falls back to the configured default list (via `list select`) when no `--list-id` is given
+- **Bulk delete**: `task delete ID1 ID2 ID3 -y` deletes multiple tasks in one command