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

# Inspecting

> bay apps, status, logs, errors, diagnose, exec.

```bash theme={null}
bay apps                # list your apps
bay status <app>        # revision, url, env, database
bay open <app>          # open it in a browser
```

## Logs

```bash theme={null}
bay logs <app>
bay logs <app> --severity error --limit 50 --since 1h
bay logs <app> --follow
```

## Errors

```bash theme={null}
bay errors <app>        # production errors, last 7 days
```

## Diagnose

```bash theme={null}
bay diagnose <app>
bay diagnose <app> --error "TypeError: cannot read property 'id' of undefined"
```

Produces a fix-prompt aimed at **your own** coding agent, holding the error, the
surrounding logs and what Bay knows about how the app is built. Bay does not
silently commit to your source.

## Exec

```bash theme={null}
bay exec <app> -- <command>
```

Runs a command in the app's environment — the same variables and the same
database credentials — isolated from the running app.

```bash theme={null}
bay exec my-app -- npx prisma migrate status
```

<Tip>
  Every command on this page takes `--json`, which is how an agent reads them.
</Tip>