Skip to content

Commit ebc001c

Browse files
isaacrowntreeclaude
andcommitted
feat: server-side search, parallel space traversal, and --assignee filter
Search improvements (supersedes #9 and #10): - Level 0: server-side search via ClickUp's search= query param — finds tasks in a single API call regardless of update recency - Level 5: parallel space traversal with bounded parallelism (5 workers) when progressive drill-down finds nothing — discovers folders, folderless lists, and fetches tasks concurrently across all spaces - --assignee flag: filter by team member (name, username, numeric ID, or "me"). Resolves via exact match, substring match, or current user. Ambiguous matches error with candidates. Works alongside --space/--folder. - Query is now optional when --assignee is provided Includes 8 new tests for assignee resolution and server-side search. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent bde7da0 commit ebc001c

3 files changed

Lines changed: 450 additions & 91 deletions

File tree

docs/src/content/docs/reference/clickup_task_search.md

Lines changed: 10 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -12,11 +12,12 @@ Search ClickUp tasks across the workspace by name and description.
1212
Returns tasks whose names or descriptions match the search query. Matching
1313
priority: name substring > name fuzzy > description substring. When no
1414
--space or --folder is specified, search uses progressive drill-down:
15-
sprint tasks first, then your assigned tasks, then configured space, then
16-
full workspace.
15+
server-side search first, then sprint tasks, then your assigned tasks,
16+
then configured space, then full workspace.
1717

1818
Use --space and --folder to narrow the search scope for faster results.
1919
Use --comments to also search through task comments (slower).
20+
Use --assignee to filter by team member (name, username, ID, or "me").
2021

2122
In interactive mode (TTY), if many results are found you will be asked
2223
whether to refine the search. Use --pick to interactively select a single
@@ -29,7 +30,7 @@ If search returns no results, use 'clickup task recent' to see your
2930
recently updated tasks and discover which folders/lists to search in.
3031

3132
```
32-
clickup task search <query> [flags]
33+
clickup task search [query] [flags]
3334
```
3435

3536
### Examples
@@ -47,6 +48,11 @@ clickup task search <query> [flags]
4748
# Also search through task comments
4849
clickup task search "migration issue" --comments
4950
51+
# Filter by assignee
52+
clickup task search --assignee me
53+
clickup task search "bug" --assignee "Isaac"
54+
clickup task search --assignee 54695018
55+
5056
# Interactively pick a task (prints selected task ID)
5157
clickup task search geozone --pick
5258
@@ -61,6 +67,7 @@ clickup task search <query> [flags]
6167
### Options
6268

6369
```
70+
--assignee string Filter by assignee (name, username, numeric ID, or "me")
6471
--comments Also search through task comments (slower)
6572
--exact Only show exact substring matches (no fuzzy results)
6673
--folder string Limit search to a specific folder (name, substring match)

0 commit comments

Comments
 (0)