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

> Chat with a scope. One-shot (streams tokens, then exits) if a message is given; otherwise opens an interactive REPL.

Chat with a scope. One-shot (streams tokens, then exits) if a message is given; otherwise opens an interactive REPL.

## Usage

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

## Arguments

| Name      |          | Description                                                    |
| --------- | -------- | -------------------------------------------------------------- |
| `id`      | required | Scope id.                                                      |
| `message` | optional | Message to send (quote it). Omit to start an interactive REPL. |

## Flags

| Flag       | Type    | Description                                                      |
| ---------- | ------- | ---------------------------------------------------------------- |
| `--model`  | string  | Chat model. (default: `claude-sonnet-5`)                         |
| `--thread` | string  | Continue an existing conversation thread id.                     |
| `--json`   | boolean | Emit structured SSE-derived events instead of raw streamed text. |

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

## Examples

```bash theme={null}
modus scopes chat 42 "What changed in revenue last week?"
modus scopes chat 42
```

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