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

# status

> Muestra plan, cuota mensual usada y FHIR Score del tenant logueado.

## Uso

```bash theme={null}
fhiron status
```

Output:

```
Tenant:    mi-tenant
Plan:      Developer
Cuota:     1240/5000 (24.8%)
Score:     91/100 (últimos 7 días)
Última:    hace 12 min · ✓ Patient

Dashboard: https://fhiron.cl/dashboard
```

## Flags

| Flag     | Efecto                                                                |
| -------- | --------------------------------------------------------------------- |
| `--json` | Output programático en JSON, útil para scripts y dashboards externos. |

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

```json theme={null}
{
  "tenant": { "id": "...", "slug": "mi-tenant", "email": "tu@empresa.cl" },
  "plan":   { "name": "developer", "validationsPerMonth": 5000 },
  "usage":  { "month": 1240, "monthLimit": 5000 },
  "score":  { "avg7d": 91 },
  "lastValidation": { "resourceType": "Patient", "ok": true, "at": "2026-05-22T15:20:00Z" }
}
```

## Exit codes

| Code | Significado                                               |
| ---- | --------------------------------------------------------- |
| `0`  | OK.                                                       |
| `1`  | No hay sesión activa. Corre [`fhiron login`](/cli/login). |
| `2`  | Error de red o el endpoint `/api/tenant/me` no respondió. |

## Modo degradado

Si el endpoint `/api/tenant/me` aún no está disponible en el servidor (despliegue parcial), el CLI cae a modo degradado y muestra lo que sabe localmente (tenant slug, email guardado en `~/.fhiron/config.json`) sin las métricas en vivo. Esto previene que un downtime parcial bloquee tu flujo.

## Usos típicos

* **Pre-commit hook**: validar que tienes cuota antes de correr `fhiron validate` masivo.
* **Dashboard de equipo**: `fhiron status --json | jq` alimentando un panel interno.
* **Alerta**: shell script que ejecuta diariamente y notifica si `usage.month / plan.validationsPerMonth > 0.8`.