> ## 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 create

> Create a scope. Nested fields (toolset, connectionSet, contextSelections, interfaces) require --file/--body — see --example.

Create a scope. Nested fields (toolset, connectionSet, contextSelections, interfaces) require --file/--body — see --example.

## Usage

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

## Flags

| Flag            | Type    | Description                                         |
| --------------- | ------- | --------------------------------------------------- |
| `--example`     | boolean | Print an example scope JSON to stdout and exit.     |
| `--file`        | string  | Path to a JSON file with the full create body.      |
| `--body`        | string  | Read the full create body as JSON from stdin ('-'). |
| `--name`        | string  | Scope display name.                                 |
| `--description` | string  | One-paragraph description.                          |
| `--model`       | string  | Model identifier (e.g. claude-sonnet-5).            |
| `--instruction` | string  | System-prompt instruction fragment (repeatable).    |
| `--guardrail`   | string  | Guardrail id (repeatable).                          |

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

## Examples

```bash theme={null}
modus scopes create --example > scope.json
modus scopes create --file scope.json
modus scopes create --name "Revenue Analyst" --model claude-sonnet-5
```

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