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

> ## Agent Instructions
> Reactor hosts multiple models, each with its own connect slug (modelName) and command/event schema. The catalog of every model — slug, typed SDK package, and links to its schema — is at /model-api-reference/overview. Some models expose one slug per experience (e.g. HappyOyster); always take the slug from the model's own pages, never guess it.
> Fastest path to a working app: `npx create-reactor-app my-app --model=<slug>` scaffolds a complete app with secure auth wired up. Typed TypeScript SDKs are published as @reactor-models/<model>; Python uses the base reactor-sdk package.
> Auth: exchange an API key (rk_...) for a JWT via POST https://api.reactor.inc/tokens from your server. Never put the API key in client-side code.
> Append .md to any docs URL for clean Markdown. Search these docs via the MCP server at https://docs.reactor.inc/mcp.

# reactor model instances

> List the running instances of a model

```sh theme={"theme":{"light":"github-light","dark":"github-dark-high-contrast"}}
reactor model instances [<model>] [flags]
```

## Description

List the model instances currently serving a model.

The listing opens with a per-region table of DESIRED, RUNNING, HEALTHY and IDLE
counts, printing "?" for unknown values. A region where the model is scaled to
zero is hidden from it unless `--all` is passed. Each instance below it reports its own
STATUS: healthy (holding a fresh heartbeat), unhealthy (running, but not
heartbeating yet), or terminated (served past sessions and now gone from its
cluster, shown with `--all`). A "?" means the server reported no status - an old
server, or a cluster it could not reach - which is not the same as unhealthy.

\<model> is the model name (name or canonical org/name). With no argument, the name is
inferred by walking up from the current directory to the nearest
enclosing `reactor.yaml`'s `model.name` (stopping at the repository
root).

The default view is live-only. Pass `--all` to also include recent
historical instances (those that served sessions but are no longer running);
`--since` bounds that history window as a Go duration (plus a `d` day
suffix), e.g. 30m, 24h, 7d - server default 24h, maximum 7d.

Pass `--json` to emit the listing as JSON (useful for scripting).

**Examples:**

```sh theme={"theme":{"light":"github-light","dark":"github-dark-high-contrast"}}
reactor model instances                    # model.name from reactor.yaml
reactor model instances my-model
reactor model instances partner/my-model
reactor model instances my-model --all
reactor model instances my-model --all --since 7d
reactor model instances my-model --json | jq .count
```

Runtime errors (model not found, discovery unavailable) do NOT print
the full usage screen - only argument / syntax errors do.

## Options

| Flag             | Description                                                                                 |
| ---------------- | ------------------------------------------------------------------------------------------- |
| `--all`          | Include recent historical instances and all-zero regions                                    |
| `--json`         | Emit the raw JSON response instead of the formatted listing                                 |
| `--since string` | History window for `--all` as a Go duration (e.g. 30m, 24h, 7d; server default 24h, max 7d) |

## Global options

| Flag              | Description                                                                           |
| ----------------- | ------------------------------------------------------------------------------------- |
| `--server string` | Reactor API server URL (default "[https://api.reactor.inc](https://api.reactor.inc)") |
| `-v, --verbose`   | Enable verbose output                                                                 |

## See also

* [reactor model](/deploy/cli-reference/reactor_model) - Model management commands