所有命令 · 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.
用法
pm search [options] <keywords...>参数
| <keywords…> | Keyword query tokens | 必填 |
|---|
选项
| --for <intent> | Apply a declared context intent projection. Allowed core values: discover. Configured package and workspace intents may extend this domain. | 可选 |
|---|---|---|
| --token-budget <n> | Override the selected intent's maximum estimated output tokens | 可选 |
| --mode <value> | Search mode: keyword|semantic|hybrid (default: auto) | 可选 |
| --semantic | Shorthand for --mode semantic | 可选 |
| --hybrid | Shorthand for --mode hybrid | 可选 |
| --match-mode <value> | Token match mode: and|or|exact (default: or with all-terms ranking bonus; and = hard-require every token; exact = exact phrase) | 可选 |
| --min-score <value> | Per-query minimum score threshold (finite number >= 0); overrides settings search.score_threshold for this query only | 可选 |
| --count | Return only the count of matching items (post-filter/threshold, pre-limit); skips hit rows | 可选 |
| --semantic-weight <value> | Override hybrid semantic weight for this query (0..1); invalid values fall back to settings | 可选 |
| --include-linked | Include linked files, docs, and tests in the searchable corpus | 可选 |
| --title-exact | Require exact normalized title match for the full query string | 可选 |
| --phrase-exact | Require exact normalized phrase match in searchable text | 可选 |
| --highlight | Emit per-field matched-text snippets (wrapped in «…») on each hit; off by default | 可选 |
| --status <value> | Filter by status before query (all, open/closed/canceled aliases, or configured status id; CSV) | 可选 |
| --type <value> | Filter by item type | 可选 |
| --tag <value> | Filter by tag | 可选 |
| --priority <value> | Filter by priority | 可选 |
| --deadline-before <value> | Filter by deadline upper bound (ISO/date string or relative) | 可选 |
| --deadline-after <value> | Filter by deadline lower bound (ISO/date string or relative) | 可选 |
| --updated-after <value> | Filter by updated_at lower bound: ISO timestamp or signed relative (e.g. "-2h"/"-7d" for the past) | 可选 |
| --updated-before <value> | Filter by updated_at upper bound: ISO timestamp or signed relative (-2h/+1d) | 可选 |
| --created-after <value> | Filter by created_at lower bound: ISO timestamp or signed relative (-2h/+1d) | 可选 |
| --created-before <value> | Filter by created_at upper bound: ISO timestamp or signed relative (-2h/+1d) | 可选 |
| --assignee <value> | Filter by assignee | 可选 |
| --sprint <value> | Filter by sprint | 可选 |
| --release <value> | Filter by release | 可选 |
| --parent <value> | Filter by parent item ID | 可选 |
| --compact | Render compact search hits (default; mutually exclusive with --full/--fields) | 可选 |
| --full | Render full search hits with nested item payloads (mutually exclusive with --compact/--fields) | 可选 |
| --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. | 可选 |
| --format <value> | Search output format override: json|ndjson|toon | 可选 |
| --limit <n> | Limit returned item count | 可选 |
| --after <cursor> | Continue after an opaque next_cursor from a previous search response | 可选 |
| --has-notes | Show only items that have notes | 可选 |
| --has-learnings | Show only items that have learnings | 可选 |
| --has-files | Show only items that have linked files | 可选 |
| --has-docs | Show only items that have linked docs | 可选 |
| --has-tests | Show only items that have linked tests | 可选 |
| --has-comments | Show only items that have comments | 可选 |
| --has-deps | Show only items that have dependencies | 可选 |
| --has-body | Show only items that have a non-empty body | 可选 |
| --has-linked-command | Show only items whose linked tests carry a runnable command | 可选 |
| --no-notes | Show only items that have no notes | 可选 |
| --no-learnings | Show only items that have no learnings | 可选 |
| --no-files | Show only items that have no linked files | 可选 |
| --no-docs | Show only items that have no linked docs | 可选 |
| --no-tests | Show only items that have no linked tests | 可选 |
| --no-comments | Show only items that have no comments | 可选 |
| --no-deps | Show only items that have no dependencies | 可选 |
| --empty-body | Show only items with an empty body | 可选 |
| --no-linked-command | Show only items whose linked tests carry no runnable command | 可选 |
| --filter-reviewer-missing | Show only items missing reviewer | 可选 |
| --filter-risk-missing | Show only items missing risk | 可选 |
| --filter-confidence-missing | Show only items missing confidence | 可选 |
| --filter-sprint-missing | Show only items missing sprint | 可选 |
| --filter-release-missing | Show only items missing release | 可选 |
示例
pm search "lock stale retry" --mode keyword --limit 10