> ## 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 context saved-queries create

> Save a SQL query against a connection as a context item.

Save a SQL query against a connection as a context item.

## Usage

```bash theme={null}
modus context saved-queries create [flags]
```

## Arguments

| Name   |          | Description       |
| ------ | -------- | ----------------- |
| `name` | required | Saved query name. |

## Flags

| Flag              | Type   | Description                         |
| ----------------- | ------ | ----------------------------------- |
| `--connection-id` | string | Connection this query runs against. |
| `--query`         | string | SQL query text.                     |
| `--description`   | string | Description.                        |
| `--path`          | string | Folder path segment (repeatable).   |

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

## Examples

```bash theme={null}
modus context saved-queries create "Monthly ARR" --connection-id conn_123 --query "select * from arr_monthly"
```

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