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

# cassian status

> Show running instances and volumes.

## Usage

```bash theme={null}
cassian status [options]
```

## Options

| Flag     | Description                                 |
| -------- | ------------------------------------------- |
| `--json` | Output raw JSON (for scripts and AI agents) |

## Human-readable output

```
Instances

  my-project  ● running  5m  ~$0.04
  GPUs     1x L4
  Storage  my-project → /workspace

Storage

  my-project  50G  attached  5m ago
```

Cost estimate is shown for running instances based on GPU type and elapsed time.

## JSON output

```bash theme={null}
cassian status --json
```

```json theme={null}
{
  "instances": [
    {
      "id": "abc123",
      "name": "my-project",
      "status": "running",
      "gpu_count": 1,
      "gpu_type": "l4",
      "created_at": "2026-05-30T09:00:00Z"
    }
  ],
  "volumes": [
    {
      "name": "my-project",
      "size_gb": 50,
      "status": "attached"
    }
  ]
}
```

Useful for scripting and for AI agents that need to check instance state:

```bash theme={null}
# Check if an instance is running
cassian status --json | python3 -c "
import json, sys
data = json.load(sys.stdin)
running = [i for i in data['instances'] if i['status'] == 'running']
print('running:', [i['name'] for i in running])
"
```