Alle Befehle · context
pm search
Search items with keyword, semantic, or hybrid retrieval. Inline field:value tokens (tag:/status:/type:/priority:) in the query are parsed as filters, e.g. 'auth tag:area:search status:open'.
Finds relevant items by keyword, semantic, or hybrid retrieval modes.
Aufruf
pm search [options] <keywords...>Argumente
| <keywords…> | Keyword query tokens | erforderlich |
|---|
Optionen
| --for <intent> | Apply a declared context intent projection. Allowed core values: discover. Configured package and workspace intents may extend this domain. | optional |
|---|---|---|
| --token-budget <n> | Override the selected intent's maximum estimated output tokens | optional |
| --mode <value> | Search mode: keyword|semantic|hybrid (default: auto) | optional |
| --semantic | Shorthand for --mode semantic | optional |
| --hybrid | Shorthand for --mode hybrid | optional |
| --match-mode <value> | Token match mode: and|or|exact (default: or with all-terms ranking bonus; and = hard-require every token; exact = exact phrase) | optional |
| --min-score <value> | Per-query minimum score threshold (finite number >= 0); overrides settings search.score_threshold for this query only | optional |
| --count | Return only the count of matching items (post-filter/threshold, pre-limit); skips hit rows | optional |
| --semantic-weight <value> | Override hybrid semantic weight for this query (0..1); invalid values fall back to settings | optional |
| --include-linked | Include linked files, docs, and tests in the searchable corpus | optional |
| --title-exact | Require exact normalized title match for the full query string | optional |
| --phrase-exact | Require exact normalized phrase match in searchable text | optional |
| --highlight | Emit per-field matched-text snippets (wrapped in «…») on each hit; off by default | optional |
| --status <value> | Filter by status before query (all, open/closed/canceled aliases, or configured status id; CSV) | optional |
| --type <value> | Filter by item type | optional |
| --tag <value> | Filter by tag | optional |
| --priority <value> | Filter by priority | optional |
| --deadline-before <value> | Filter by deadline upper bound (ISO/date string or relative) | optional |
| --deadline-after <value> | Filter by deadline lower bound (ISO/date string or relative) | optional |
| --updated-after <value> | Filter by updated_at lower bound: ISO timestamp or signed relative (e.g. "-2h"/"-7d" for the past) | optional |
| --updated-before <value> | Filter by updated_at upper bound: ISO timestamp or signed relative (-2h/+1d) | optional |
| --created-after <value> | Filter by created_at lower bound: ISO timestamp or signed relative (-2h/+1d) | optional |
| --created-before <value> | Filter by created_at upper bound: ISO timestamp or signed relative (-2h/+1d) | optional |
| --assignee <value> | Filter by assignee | optional |
| --sprint <value> | Filter by sprint | optional |
| --release <value> | Filter by release | optional |
| --parent <value> | Filter by parent item ID | optional |
| --compact | Render compact search hits (default; mutually exclusive with --full/--fields) | optional |
| --full | Render full search hits with nested item payloads (mutually exclusive with --compact/--fields) | optional |
| --fields <value> | Render custom comma-separated search hit fields (mutually exclusive with --compact/--full). Allowed core values: acceptance_criteria|actual_result|affected_version|assignee|author|blocked_by|blocked_reason|close_reason|comments|component|confidence|created_at|customer_impact|deadline|definition_of_ready|dependencies|description|docs|environment|estimated_minutes|events|expected_result|files|fixed_version|goal|highlights|id|impact|learnings|matched_fields|notes|objective|order|outcome|parent|plan|priority|rank|regression|release|reminders|reporter|repro_steps|resolution|reviewer|risk|score|severity|sprint|status|tags|tests|title|type|updated_at|value|why_now. item.<field> aliases and configured runtime metadata fields are also accepted. | optional |
| --format <value> | Search output format override: json|ndjson|toon | optional |
| --limit <n> | Limit returned item count | optional |
| --after <cursor> | Continue after an opaque next_cursor from a previous search response | optional |
| --has-notes | Show only items that have notes | optional |
| --has-learnings | Show only items that have learnings | optional |
| --has-files | Show only items that have linked files | optional |
| --has-docs | Show only items that have linked docs | optional |
| --has-tests | Show only items that have linked tests | optional |
| --has-comments | Show only items that have comments | optional |
| --has-deps | Show only items that have dependencies | optional |
| --has-body | Show only items that have a non-empty body | optional |
| --has-linked-command | Show only items whose linked tests carry a runnable command | optional |
| --no-notes | Show only items that have no notes | optional |
| --no-learnings | Show only items that have no learnings | optional |
| --no-files | Show only items that have no linked files | optional |
| --no-docs | Show only items that have no linked docs | optional |
| --no-tests | Show only items that have no linked tests | optional |
| --no-comments | Show only items that have no comments | optional |
| --no-deps | Show only items that have no dependencies | optional |
| --empty-body | Show only items with an empty body | optional |
| --no-linked-command | Show only items whose linked tests carry no runnable command | optional |
| --filter-reviewer-missing | Show only items missing reviewer | optional |
| --filter-risk-missing | Show only items missing risk | optional |
| --filter-confidence-missing | Show only items missing confidence | optional |
| --filter-sprint-missing | Show only items missing sprint | optional |
| --filter-release-missing | Show only items missing release | optional |
Beispiele
pm search "lock stale retry" --mode keyword --limit 10