ReferenceTools
piyaz_search
Universal task finder.
Cross-project across every team by default; pass project='ZBR' to scope. At least one criterion required: query (matches taskRef, title, tags), status[], priority[], assignee ('me' or a user UUID), category, or tags[] (AND-within). Results are newest-updated first with a cursor when more pages exist; project-scoped results carry the derived state (ready/blocked/plannable). Every result line leads with the taskRef, chain it straight into piyaz_get, piyaz_edit, or piyaz_link. Narrow with filters instead of paging when a page overflows.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
assignee | string | No | Filter to tasks assigned to 'me' (the caller) or a user UUID. |
category | string | No | Exact project-category match. See the project's vocabulary via piyaz_get project view='meta'. |
cursor | string | No | Opaque cursor from a previous page's nextCursor. Prefer narrowing filters over deep paging. |
limit | integer | No | Page size, 1-50 (default 20). |
priority | ("urgent" | "core" | "normal" | "backlog")[] | No | Priorities to include (OR-within). |
project | string | No | Project identifier ('ZBR') or UUID to scope the search. DEFAULT: cross-project across every team you belong to. Project-scoped results include the derived state (ready/blocked/plannable/...). |
query | string | No | Free-text match on taskRef, title, or tag substring (case-insensitive). Optional when any filter is set. |
status | ("draft" | "planned" | "in_progress" | "in_review" | "done" | "cancelled")[] | No | Lifecycle statuses to include (OR-within). |
tags | string[] | No | Exact tags; every listed tag must be present (AND-within). Pick from the vocabulary in piyaz_get project view='meta'. |
Last updated