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

# motus serve chat

> Send a single message to a running agent or enter an interactive REPL.

Send a single message to a running agent or enter an interactive REPL.

## Usage

```bash theme={null}
motus serve chat <url> [message] [options]
```

## Options

| Flag        | Default | Description                                                                                                                   |
| ----------- | ------- | ----------------------------------------------------------------------------------------------------------------------------- |
| `--session` | —       | Resume an existing session by ID instead of creating a new one                                                                |
| `--param`   | —       | `KEY=VALUE` parameter passed to the agent as `user_params` (repeatable). Numeric values are auto-coerced to `int` or `float`. |

Sessions are kept on exit so traces remain viewable in the cloud console. The session
ID is printed when a new session is created — copy it to resume later with `--session`.

## Examples

### Single message

```bash theme={null}
motus serve chat http://localhost:8000 "What is 2+2?"
Session: 550e8400-e29b-41d4-a716-446655440000 (use --session to resume)
4
```

### Interactive REPL

```bash theme={null}
motus serve chat http://localhost:8000
Session: 550e8400-e29b-41d4-a716-446655440000 (use --session to resume)
Chat session started (Ctrl+C to quit)

> hello
hi there
> how are you?
I'm doing well!
^C
Bye!
```

### Resume an existing session

```bash theme={null}
motus serve chat http://localhost:8000 --session 550e8400-e29b-41d4-a716-446655440000
> where were we?
```

### Delete a session manually

```bash theme={null}
motus serve delete http://localhost:8000 550e8400-e29b-41d4-a716-446655440000
```