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

# CLI reference

> Current Verglas command groups and common examples.

The `verglas` CLI manages cloud resources and talks to a selected local server. Run `verglas <command> --help` for the complete argument reference generated by the current binary.

## Global options

```text theme={null}
--server-endpoint <URL>  Local server admin API. Uses VERGLAS_ENDPOINT.
--json                   Emit machine-readable JSON.
-V, --version            Print the CLI version.
```

The default local endpoint is `http://127.0.0.1:8334`.

## Authentication

```bash theme={null}
verglas login
verglas login --device
printf '%s' "$VERGLAS_API_KEY" | verglas login --api-key
```

## Server operations

```bash theme={null}
verglas status
verglas drain --timeout 10m
```

## Workers

```bash theme={null}
verglas workers list
verglas workers get <id-or-name>
verglas workers create --file ./worker.toml
verglas workers create --file ./worker.toml --local
verglas workers update <id-or-name> --file ./worker.toml
verglas workers run <id-or-name>
verglas workers logs <id-or-name>
verglas workers push <local-name>
verglas workers pull <id-or-name> --file ./worker.toml
verglas workers delete <id-or-name>
```

## Containers

```bash theme={null}
verglas containers list
verglas containers get <id>
verglas containers create --file ./container.json
verglas containers update <id> --file ./container.json
verglas containers scale <id> --instances 3
verglas containers stop <id>
verglas containers resume <id>
verglas containers catalog
verglas containers deploy <catalog-id>
verglas containers config <id>
verglas containers push docker://ghcr.io/acme/app:1.2
verglas containers delete <id>
```

## Tables and queries

```bash theme={null}
verglas table create analytics.orders ./orders.parquet
verglas table append analytics.orders ./new-orders.jsonl
verglas table list analytics
verglas table show analytics.orders
verglas table history analytics.orders
verglas table compact
verglas table delete analytics.orders --yes
verglas table metrics

verglas query 'SELECT count(*) FROM analytics.orders'
```

The table import commands recognize CSV, Parquet, and JSON Lines from the file extension.

## Vector indexes

```bash theme={null}
verglas index add search.documents --field embedding --metric cosine
verglas index list search.documents
verglas index search search.documents embedding --vector '0.1,0.2,0.3' -k 10
```

## Property graphs

```bash theme={null}
verglas graph create fraud
verglas graph add-node fraud ./nodes.json
verglas graph add-edge fraud ./edges.json
verglas graph index fraud
verglas graph neighbors fraud customer-17 --direction out
verglas graph k-hop fraud customer-17 --hops 3
verglas graph paths fraud customer-17 merchant-42 --max-hops 4
verglas graph show fraud
```

## Cloud databases, volumes, and secrets

```bash theme={null}
verglas db list
verglas db create app-db --type postgres
verglas db delete app-db

verglas volumes list
verglas volumes create app-data --size 20GiB
verglas volumes resize app-data --size 50GiB
verglas volumes delete app-data

verglas secrets list
printf '%s' "$API_KEY" | verglas secrets set API_KEY
verglas secrets delete API_KEY
```

Database creation prints one-time connection credentials. The CLI does not store the database password.