mka1 é a interface de linha de comando oficial para a API MKA1.
Toda operação que você pode chamar pela API REST está disponível como um comando, com flags, redirecionamento de stdin, múltiplos formatos de saída e um explorador de comandos interativo.
Use para:
- Automatizar chamadas pontuais de API e jobs de CI sem precisar de um SDK.
- Inspecionar dados em tempo real rapidamente — listar respostas, baixar arquivos, buscar em um vetor store.
- Prototipar corpos de requisição antes de migrá-los para os SDKs TypeScript, C# ou Python.
Instalação
O script de instalação é o caminho mais rápido para obter omka1. Ele detecta sua plataforma, baixa o build correspondente, verifica o checksum e instala o mka1 em um diretório que está no seu PATH.
MKA1_INSTALL_DIR para escolher o diretório de instalação e MKA1_VERSION para fixar uma versão específica em vez da mais recente.
Para instalar manualmente, binários pré-compilados para todas as plataformas suportadas estão disponíveis em downloads.mka1.com. Os arquivos em latest/ sempre contêm a versão mais recente, então você pode referenciá-los em scripts e CI.
Cada arquivo é nomeado como
mka1_<os>_<arch>.<ext>. Para fixar uma versão, use https://downloads.mka1.com/mka1-cli/v<VERSION>/mka1_<os>_<arch>-v<VERSION>.<ext>.
macOS
arm64 por x86_64 em Macs Intel.
Linux
x86_64 por arm64 em máquinas Arm de 64 bits. Os builds i386 são publicados apenas como pacotes .deb e .rpm.
Windows
Baixemka1_windows_x86_64.zip, extraia e adicione a pasta contendo mka1.exe ao seu PATH. Use o zip arm64 ou i386 se corresponder à sua máquina.
Verifique um download
Todo diretório de release publica um arquivoSHA256SUMS que cobre cada arquivo daquela versão. Execute a verificação na pasta que contém o download:
sha256sum -c no lugar de shasum -a 256 -c. O script de instalação faz essa verificação para você.
Para automação, latest/manifest.json informa a versão atual junto com a URL, o tamanho e o SHA-256 de cada arquivo.
Verifique a instalação
Imprima a versão do CLI para confirmar que o binário está no seuPATH:
--help, que imprime uma descrição, uso e as flags disponíveis:
Habilite a conclusão automática do shell
As conclusões são geradas sob demanda e cobrem subcomandos, flags e valores enum conhecidos.Execute sua primeira requisição
Autentique-se uma vez e então chame qualquer endpoint. O caminho mais rápido é definir sua chave em uma variável de ambiente e gerar uma resposta:Explore de forma interativa
mka1 explore inicia uma interface de terminal que permite navegar por todos os grupos de comandos, inspecionar as flags de cada comando e executá-los sem sair do shell:
Próximos passos
- Autentique o CLI — configure credenciais e identidade do usuário final.
- Comandos — um tour pelos grupos de comandos com exemplos práticos.
- Envie corpos de requisição — misture flags individuais,
--bodye stdin. - Formate e filtre a saída — alterne entre JSON, YAML, tabela e TOON, e transforme resultados com jq.
- Depure e inspecione — visualize requisições com
--dry-run, trace com--debuge habilite o modo agente.