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

# modus scopes memories search

> Semantic search over a scope's long-term memories.

Semantic search over a scope's long-term memories.

## Usage

```bash theme={null}
modus scopes memories search [flags]
```

## Arguments

| Name    |          | Description   |
| ------- | -------- | ------------- |
| `id`    | required | Scope id.     |
| `query` | required | Search query. |

## Flags

| Flag        | Type   | Description                                              |
| ----------- | ------ | -------------------------------------------------------- |
| `--user-id` | string | Narrow results to memories tagged with this end-user id. |
| `--limit`   | string | Max results (default 10).                                |

Global: `--pretty` — human-readable table output instead of compact JSON.

## Examples

```bash theme={null}
modus scopes memories search 42 "user preferences for response style"
```

See [CLI quickstart](/guides/cli) for install and auth.