> ## Documentation Index
> Fetch the complete documentation index at: https://docs.moorcheh.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# moorcheh-edge search

> Search with plain text or a JSON query vector.

## Synopsis

```bash theme={null}
moorcheh-edge search (--query-text TEXT | --query-vector-json JSON) [--top-k N] [--base-url URL]
```

## Options

| Flag                  | Required     | Description                         |
| --------------------- | ------------ | ----------------------------------- |
| `--query-text`        | One required | Plain text query (embeds locally)   |
| `--query-vector-json` | One required | JSON array matching store dimension |
| `--top-k`             | No           | Max results (default `10`)          |
| `--threshold`         | No           | Minimum score filter                |
| `--kiosk-mode`        | No           | Enable threshold filtering          |
| `--base-url`          | No           | API base URL                        |

## Examples

```bash theme={null}
moorcheh-edge search --query-text "Hello world" --top-k 5
moorcheh-edge search --query-vector-json "[0.1, 0.2, ...]" --top-k 5
```

<Note>
  On PowerShell, wrap JSON in **single quotes**: `'["item-1"]'` for delete, and a full float array for search.
</Note>

See [API: Search](/api-references/search).