# prb search command reference

Search resources with a query string. This page documents **1 command** under `prb search`.

Flags and examples below come from the command definitions. A **Required** flag is explicitly marked required by Cobra; an unmarked flag can still be needed by runtime validation or a non-interactive workflow. Empty strings and empty lists are registered defaults, not sample values.

Every command also inherits the [global flags](/docs/developers/cli/commands#global-flags). Run `prb <command> --help` to check your installed version. Replace placeholder IDs and names in source examples before running them. Return to the [complete CLI command reference](/docs/developers/cli/commands) to browse another command.

## Commands

| Command                     | Description                           | Usage                | Source                                                                                          |
| --------------------------- | ------------------------------------- | -------------------- | ----------------------------------------------------------------------------------------------- |
| [`prb search`](#prb-search) | Search resources with a query string. | `prb search <query>` | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/search/search.go#L74) |

## prb search

Search resources with a query string.

### Usage

```text
prb search <query>
```

Requires 1 positional argument.

### Additional help

```text
Search resources with a query string.

Qualifiers:
  tag:name        Resource must carry this tag. Repeat to require every tag (AND).
  type:name       Restrict results to this resource type, for example document or risk.
                  Repeat to accept several types (OR).

Quote a name that contains spaces, and escape a quote or backslash inside
a quoted value with a backslash.
```

### Flags

| Flag             | Type    | Default | Required | Description                          |
| ---------------- | ------- | ------- | -------- | ------------------------------------ |
| `--after`        | string  | `""`    | —        | Cursor to continue listing from      |
| `--json`         | boolean | `false` | —        | Output JSON (same as --output json)  |
| `--limit`, `-L`  | integer | `30`    | —        | Maximum number of resources to list  |
| `--org`          | string  | `""`    | —        | Organization ID                      |
| `--output`, `-o` | string  | `""`    | —        | Output format: json, table (default) |

### Examples

```bash
# Find resources tagged Production
prb search 'tag:Production'

# Find documents that have every listed tag
prb search 'tag:Production tag:Compliance type:document'
```

[View command implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/search/search.go#L74).
