query_streams
List, view, and analyze Perforce streams: inspect stream specs, hierarchy, integration status, workspaces, file validation, and interchanges.
Instructions
Query streams: list, get spec, children/parent/graph, integration status, workspaces, validate files, check resolve, interchanges (READ permission)
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| user | No | Filter workspaces by user (list_workspaces) | |
| limit | No | Max changelists (interchanges) | |
| action | Yes | Stream query action: 'list' streams, 'get' stream spec, 'children'/'parent'/'graph' of a stream, 'integration_status' (p4 istat), 'get_workspace'/'list_workspaces', 'validate_file'/'validate_submit' against stream view, 'check_resolve' for pending spec conflicts, 'interchanges' between streams | |
| fields | No | Fields to return for 'list' (e.g. ['Stream', 'Owner', 'Name', 'Type']) | |
| filter | No | Filter expression string for 'list' (-F flag). Supports &, |, and parentheses. E.g. 'Parent=//Ace/MAIN&(Type=development|Type=release)' | |
| reverse | No | Reverse comparison direction (interchanges) | |
| template | No | Template workspace for get_workspace | |
| unloaded | No | Include unloaded streams/workspaces | |
| at_change | No | Changelist number for historical stream spec | |
| viewmatch | No | Single depot file path to filter streams whose views contain this path | |
| workspace | No | Workspace name for get_workspace, validate_file, validate_submit | |
| changelist | No | Changelist for validate_submit | |
| file_paths | No | File paths for validate_file or interchanges | |
| all_streams | No | Include virtual streams in 'list' results | |
| long_output | No | Full changelist descriptions (interchanges) | |
| max_results | No | Maximum number of results to return. Bounds 'list' and 'list_workspaces' and also caps 'children' via 'p4 streams -m N'. Omit for unbounded results. | |
| stream_name | No | Stream depot path (e.g. '//depot/main'). Required for most actions. | |
| stream_path | No | Stream path pattern(s) for 'list' (e.g. ['//depot/...']) | |
| force_refresh | No | Force istat to assume cache is stale and search for pending integrations (-c flag) | |
| both_directions | No | Show integration status in both directions (-a flag for integration_status) | |
| view_without_edit | No | View locked stream without opening for edit (-v flag) |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||