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

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

Configure CLI telemetry and usage metrics collection. Settings are stored in the per-user metrics config.

## Usage

```bash theme={"languages":{"custom":["languages/helixql.json"]}}
helix metrics <SUBCOMMAND>
```

## Available sub-commands

| Sub-command | Description                                                      |
| ----------- | ---------------------------------------------------------------- |
| `full`      | Enable full metrics collection (prompts for an email address).   |
| `basic`     | Enable minimal anonymous metrics.                                |
| `off`       | Disable all metrics collection.                                  |
| `status`    | Show current metrics configuration and when it was last updated. |

## `helix metrics status` output

`status` prints the metrics level, your user ID (if logged in), and a relative `Last updated` time:

| Age          | Format     |
| ------------ | ---------- |
| 0–4 seconds  | `just now` |
| 5–59 seconds | `<n>s ago` |
| 1–59 minutes | `<n>m ago` |
| 1–23 hours   | `<n>h ago` |
| 1+ days      | `<n>d ago` |

## Examples

```bash theme={"languages":{"custom":["languages/helixql.json"]}}
# Enable full metrics (prompts for email)
helix metrics full

# Enable anonymous basic metrics
helix metrics basic

# Disable all metrics
helix metrics off

# Show current state
helix metrics status
```