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
El script de instalación es la forma más rápida de obtenermka1. Detecta tu plataforma, descarga el build correspondiente, verifica su checksum e instala mka1 en un directorio que está en tu PATH.
MKA1_INSTALL_DIR para elegir el directorio de instalación y MKA1_VERSION para fijar una versión específica en lugar de la más reciente.
Para instalar manualmente, hay binarios precompilados para cada plataforma soportada en downloads.mka1.com. Los archivos en latest/ siempre contienen la versión más reciente, por lo que puedes referenciarlos en scripts y CI.
Cada archivo se nombra como
mka1_<os>_<arch>.<ext>. Para fijar una versión, usa https://downloads.mka1.com/mka1-cli/v<VERSION>/mka1_<os>_<arch>-v<VERSION>.<ext>.
macOS
arm64 por x86_64 en Macs con Intel.
Linux
x86_64 por arm64 en máquinas Arm de 64 bits. Los builds i386 se publican solo como paquetes .deb y .rpm.
Windows
Descargamka1_windows_x86_64.zip, extrae el archivo y agrega la carpeta que contiene mka1.exe a tu variable de entorno PATH. Usa el zip arm64 o i386 si corresponde a tu máquina.
Verifica una descarga
Cada directorio de release publica un archivoSHA256SUMS que cubre cada archivo de esa versión. Ejecuta la comprobación desde la carpeta que contiene tu descarga:
sha256sum -c en lugar de shasum -a 256 -c. El script de instalación hace esta comprobación por ti.
Para automatización, latest/manifest.json informa la versión actual junto con la URL, el tamaño y el SHA-256 de cada archivo.
Verifica la instalación
Imprime la versión de la CLI para confirmar que el binario está en tuPATH:
--help, que imprime una descripción, uso y los flags disponibles:
Habilita la autocompletación de comandos
Las autocompletaciones se generan bajo demanda y cubren subcomandos, flags y valores conocidos de enums.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: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:
Próximos pasos
- Autenticar la CLI — configura credenciales e identidad del usuario final.
- Comandos — un recorrido por los grupos de comandos con ejemplos prácticos.
- Pasar cuerpos de solicitud — combina flags individuales,
--bodyy stdin. - Formatear y filtrar la salida — alterna entre JSON, YAML, tabla y TOON, y transforma resultados con jq.
- Depurar e inspeccionar — previsualiza solicitudes con
--dry-run, rastrea con--debugy habilita el modo agente.