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

# Descripción general de la CLI

> Instala la CLI de mka1, habilita la autocompletación de comandos y ejecuta tu primer comando de la API de MKA1 desde la terminal.

`mka1` es la interfaz de línea de comandos oficial para la API de MKA1.
Cada operación que puedes llamar a través de la API REST está disponible como un comando, con flags, canalización de stdin, múltiples formatos de salida y un explorador interactivo de comandos.

Úsala para:

* Automatizar llamadas puntuales a la API y trabajos de CI sin necesidad de un SDK.
* Inspeccionar datos en vivo rápidamente — listar respuestas, descargar archivos, buscar en un vector store.
* Prototipar cuerpos de solicitud antes de llevarlos al SDK de TypeScript, C# o Python.

## Instalación

Binarios precompilados para cada plataforma soportada están disponibles en [downloads.mka1.com](https://downloads.mka1.com/download.html). Las URLs `*-latest` siempre redirigen a la versión más reciente, por lo que puedes guardarlas en scripts y CI.

| Plataforma | Arquitectura            | Descarga                                                                                                 |
| ---------- | ----------------------- | -------------------------------------------------------------------------------------------------------- |
| macOS      | arm64 (Apple silicon)   | [`mka1_darwin_arm64-latest.tar.gz`](https://downloads.mka1.com/darwin/mka1_darwin_arm64-latest.tar.gz)   |
| macOS      | x86\_64 (Intel)         | [`mka1_darwin_x86_64-latest.tar.gz`](https://downloads.mka1.com/darwin/mka1_darwin_x86_64-latest.tar.gz) |
| Linux      | x86\_64 (Debian/Ubuntu) | [`mka1_linux_x86_64-latest.deb`](https://downloads.mka1.com/linux/mka1_linux_x86_64-latest.deb)          |
| Linux      | x86\_64 (RHEL/Fedora)   | [`mka1_linux_x86_64-latest.rpm`](https://downloads.mka1.com/linux/mka1_linux_x86_64-latest.rpm)          |
| Windows    | x86\_64                 | [`mka1_windows_x86_64-latest.zip`](https://downloads.mka1.com/windows/mka1_windows_x86_64-latest.zip)    |

### macOS

```bash theme={null}
curl -fsSL https://downloads.mka1.com/darwin/mka1_darwin_arm64-latest.tar.gz \
  | tar -xz -C /usr/local/bin mka1
```

Cambia `arm64` por `x86_64` en Macs con Intel.

### Linux

```bash theme={null}
# Debian / Ubuntu
curl -fsSLo mka1.deb https://downloads.mka1.com/linux/mka1_linux_x86_64-latest.deb
sudo dpkg -i mka1.deb

# RHEL / Fedora / Amazon Linux
curl -fsSLo mka1.rpm https://downloads.mka1.com/linux/mka1_linux_x86_64-latest.rpm
sudo rpm -i mka1.rpm
```

### Windows

Descarga [`mka1_windows_x86_64-latest.zip`](https://downloads.mka1.com/windows/mka1_windows_x86_64-latest.zip), extrae el archivo y agrega la carpeta que contiene `mka1.exe` a tu variable de entorno `PATH`.

## Verifica la instalación

Imprime la versión de la CLI para confirmar que el binario está en tu `PATH`:

```bash theme={null}
mka1 version
```

Cada comando soporta `--help`, que imprime una descripción, uso y los flags disponibles:

```bash theme={null}
mka1 --help
mka1 llm responses create --help
```

## Habilita la autocompletación de comandos

Las autocompletaciones se generan bajo demanda y cubren subcomandos, flags y valores conocidos de enums.

<CodeGroup>
  ```bash bash theme={null}
  # Temporal, para la shell actual:
  source <(mka1 completion bash)

  # Permanente, para todo el sistema:
  mka1 completion bash > /etc/bash_completion.d/mka1
  ```

  ```zsh zsh theme={null}
  # Agrega a ~/.zshrc:
  source <(mka1 completion zsh)

  # O instala permanentemente:
  mka1 completion zsh > "${fpath[1]}/_mka1"
  ```

  ```fish fish theme={null}
  mka1 completion fish | source

  # O instala permanentemente:
  mka1 completion fish > ~/.config/fish/completions/mka1.fish
  ```

  ```powershell PowerShell theme={null}
  mka1 completion powershell | Out-String | Invoke-Expression
  ```
</CodeGroup>

## Ejecuta tu primera solicitud

Autentícate una vez y luego llama a cualquier endpoint.
El camino más rápido es establecer tu clave en una variable de entorno y generar una respuesta:

```bash theme={null}
export MKA1_BEARER_AUTH="Bearer <mka1-api-key>"

mka1 llm responses create \
  --model meetkai:functionary-es-mini \
  --input '"Escribe un resumen de una frase de la API de MKA1."'
```

Para una configuración persistente que almacene los secretos en el llavero de tu sistema operativo, consulta [autenticar la CLI](/es/docs/cli/authentication).

## Explora de forma interactiva

`mka1 explore` inicia una interfaz de usuario en la terminal que te permite explorar cada grupo de comandos, inspeccionar los flags de cada comando y ejecutarlo sin salir de la shell:

```bash theme={null}
mka1 explore
```

Úsalo cuando no estés seguro de qué subcomando o nombre de flag utilizar.

## Próximos pasos

* [Autenticar la CLI](/es/docs/cli/authentication) — configura credenciales e identidad del usuario final.
* [Comandos](/es/docs/cli/commands) — un recorrido por los grupos de comandos con ejemplos prácticos.
* [Pasar cuerpos de solicitud](/es/docs/cli/request-body) — combina flags individuales, `--body` y stdin.
* [Formatear y filtrar la salida](/es/docs/cli/output-formats) — alterna entre JSON, YAML, tabla y TOON, y transforma resultados con jq.
* [Depurar e inspeccionar](/es/docs/cli/diagnostics) — previsualiza solicitudes con `--dry-run`, rastrea con `--debug` y habilita el modo agente.