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

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

Delete an instance from `helix.toml` and clean up any local runtime state for it.

For local instances, Helix-owned containers, networks, disk-mode volumes, and the per-instance directory under `.helix/` are deleted. For Helix Cloud instances, only the `[enterprise.<name>]` block in `helix.toml` and any local workspace state are removed — the cluster itself is untouched.

## Usage

```bash theme={"languages":{"custom":["languages/helixql.json"]}}
helix delete <INSTANCE> [OPTIONS]
```

## Arguments

| Argument   | Description                   |
| ---------- | ----------------------------- |
| `INSTANCE` | Instance to delete. Required. |

## Available flags

| Flag          | Type    | Description                                                  |
| ------------- | ------- | ------------------------------------------------------------ |
| `-y`, `--yes` | Boolean | Skip confirmation prompts. Required in non-TTY environments. |

## Confirmation behavior

In a TTY, `helix delete` prints a warning and asks for confirmation. In non-TTY environments it refuses to run without `--yes`:

```
Refusing to delete '<instance>' non-interactively. Re-run with --yes to confirm.
```

## Examples

```bash theme={"languages":{"custom":["languages/helixql.json"]}}
# Delete a local instance (TTY)
helix delete staging

# Delete non-interactively
helix delete staging --yes
```