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

# Visión general

> Fhiron CLI — automatiza validación FHIR® contra CL Core v1.9.4 desde la terminal, CI/CD y pre-commit hooks.

Fhiron expone su motor de validación a través de **tres canales hermanos**, no de canales en competencia:

| Surface      | Cuándo usarlo                                                                                                                       | Paquete                                                                        |
| ------------ | ----------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
| **MCP**      | Conversación y razonamiento dentro de un agente (Claude Code, Cursor, Continue.dev, Gemini Code Assist, Grok-Studio, JetBrains AI). | [`@fhiron/mcp-connector`](https://www.npmjs.com/package/@fhiron/mcp-connector) |
| **CLI**      | Automatización en CI/CD, pre-commit hooks, sanity checks en terminal, headless servers donde no hay agente.                         | [`@fhiron/cli`](https://www.npmjs.com/package/@fhiron/cli)                     |
| **SDK**      | Validación embebida en el runtime de tu aplicación (Node/TypeScript), en el camino crítico antes de persistir o reenviar.           | [`@fhiron/sdk`](https://www.npmjs.com/package/@fhiron/sdk)                     |
| **API REST** | Integración programática directa desde cualquier lenguaje (Python, Go, lo que sea).                                                 | `https://fhiron.cl/api/validate`                                               |

Los tres consumen la misma API, descuentan la misma cuota del tenant y usan el mismo motor (CL Core v1.9.4 + perfiles MINSAL). La elección depende de **dónde estás parado** cuando necesitas validar, no de qué tipo de developer eres.

<Note>
  El CLI de Fhiron es gratuito para uso de desarrollo con el [plan Free](https://fhiron.cl/pricing): 1.000 validaciones al mes, sin tarjeta de crédito. Para uso institucional y cumplimiento de la Ley 21.668, revisa [fhiron.cl/ley-21668](https://fhiron.cl/ley-21668).
</Note>

## Qué hace el CLI

```bash theme={null}
fhiron init      # crea fhiron.config.json en tu proyecto
fhiron login     # autentica vía device-code (browser)
fhiron lint      # linter local, sin red, sin cuota
fhiron validate  # valida contra el servidor de Fhiron (descuenta cuota)
fhiron status    # plan, cuota usada, FHIR Score
```

Cinco comandos. Zero dependencies de runtime (el linter de CL Core viene embebido). Mismo motor que el MCP connector.

## Caso de uso típico: gate de merge

El cliente abre un PR que toca recursos FHIR. GitHub corre 4 líneas de YAML que llaman al CLI. Si los recursos rompen CL Core 1.9.4, el check queda rojo y el merge se bloquea. Sin Postman, sin curl manual, sin reviews humanos buscando errores de namespace.

```yaml theme={null}
- run: npx @fhiron/cli lint  "fhir/**/*.json"
- run: npx @fhiron/cli validate "fhir/**/*.json"
  env:
    FHIRON_API_KEY: ${{ secrets.FHIRON_API_KEY }}
```

Ver [Validate](/cli/validate) para más casos.

## Próximo paso

Empieza por la [instalación](/cli/instalacion): toma menos de un minuto.