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

# helix status

> For the complete documentation index optimized for AI agents, see [llms.txt](/llms.txt).

Show the status of local and Helix Cloud instances configured in `helix.toml`.

For local instances, status comes from `docker ps -a` / `podman ps -a` filtered on `helix-<project>-<instance>` and includes the configured storage mode. For Helix Cloud instances, status reflects the cluster configuration recorded in `helix.toml`.

## Usage

```bash theme={"languages":{"custom":["languages/helixql.json"]}}
helix status [INSTANCE]
```

## Arguments

| Argument   | Description                                                                                                                                                         |
| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `INSTANCE` | Show status for a specific instance. If omitted, shows every instance in the project. In a TTY with multiple instances, the CLI may offer a single-instance picker. |

## Examples

```bash theme={"languages":{"custom":["languages/helixql.json"]}}
# Show every instance
helix status

# Show one instance
helix status dev
```