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

# Visão geral do CLI

> Instale o CLI mka1, habilite a conclusão automática do shell e execute seu primeiro comando da API MKA1 pelo terminal.

`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

Binários pré-compilados para todas as plataformas suportadas estão disponíveis em [downloads.mka1.com](https://downloads.mka1.com/download.html). As URLs `*-latest` sempre redirecionam para a versão mais recente, então você pode salvá-las em scripts e CI.

| Plataforma | Arquitetura             | Download                                                                                                 |
| ---------- | ----------------------- | -------------------------------------------------------------------------------------------------------- |
| 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
```

Troque `arm64` por `x86_64` em Macs 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

Baixe [`mka1_windows_x86_64-latest.zip`](https://downloads.mka1.com/windows/mka1_windows_x86_64-latest.zip), extraia e adicione a pasta contendo `mka1.exe` ao seu `PATH`.

## Verifique a instalação

Imprima a versão do CLI para confirmar que o binário está no seu `PATH`:

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

Todo comando aceita `--help`, que imprime uma descrição, uso e as flags disponíveis:

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

## Habilite a conclusão automática do shell

As conclusões são geradas sob demanda e cobrem subcomandos, flags e valores enum conhecidos.

<CodeGroup>
  ```bash bash theme={null}
  # Temporário, para o shell atual:
  source <(mka1 completion bash)

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

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

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

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

  # Ou instale permanentemente:
  mka1 completion fish > ~/.config/fish/completions/mka1.fish
  ```

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

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

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

mka1 llm responses create \
  --model meetkai:functionary-pt \
  --input '"Escreva um resumo de uma frase da API MKA1."'
```

Para uma configuração persistente que armazena segredos no keychain do seu sistema operacional, veja [autentique o CLI](/pt/docs/cli/authentication).

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

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

Use quando não tiver certeza de qual subcomando ou nome de flag utilizar.

## Próximos passos

* [Autentique o CLI](/pt/docs/cli/authentication) — configure credenciais e identidade do usuário final.
* [Comandos](/pt/docs/cli/commands) — um tour pelos grupos de comandos com exemplos práticos.
* [Envie corpos de requisição](/pt/docs/cli/request-body) — misture flags individuais, `--body` e stdin.
* [Formate e filtre a saída](/pt/docs/cli/output-formats) — alterne entre JSON, YAML, tabela e TOON, e transforme resultados com jq.
* [Depure e inspecione](/pt/docs/cli/diagnostics) — visualize requisições com `--dry-run`, trace com `--debug` e habilite o modo agente.