Skip to main content
A CLI do MKA1 Code executa o agente de programação no terminal. Seu executável é mka1-code; a CLI da MKA1 API usa mka1 para chamar operações da API.

​
Instale a CLI

No macOS, no Linux ou no WSL, execute o script de instalação em um terminal:
Bash
O script escolhe o build para o seu processador, verifica o checksum e instala o mka1-code em ~/.local/bin sem sudo. Ele não altera a configuração do seu shell. Se essa pasta não estiver no seu PATH, o script mostra uma linha export PATH para adicionar ao arquivo de inicialização do shell, como ~/.zshrc para Zsh ou ~/.bashrc para Bash. Abra um novo terminal e confirme que a CLI funciona:
CLI
Para atualizar a CLI, execute o script de instalação novamente. Para instalá-la em outra pasta, defina MKA1_INSTALL_DIR:
Bash

​
Instale um pacote baixado

No Windows, ou para instalar a distribuição da sua organização, baixe o pacote de CLI e instale-o manualmente. Para uma distribuição da organização, siga as etapas de download da organização e escolha o pacote de CLI. Nos demais casos, baixe o pacote para seu sistema operacional e processador. Estes links correspondem ao MKA1 Code 1.57.4.
Abra um terminal na pasta do executável baixado. Substitua <downloaded-file> pelo nome exato e copie o arquivo para um diretório de comandos do seu usuário:
CLI
O último comando deve mostrar a ajuda da CLI. O export vale apenas para o terminal atual. Para usar a CLI em novos terminais, adicione a mesma linha export PATH ao arquivo de inicialização do shell, como ~/.zshrc para Zsh ou ~/.bashrc para Bash.

​
Faça login e inicie uma sessão

Depois de instalar o executável, abra um terminal no diretório do projeto, faça login e inicie uma sessão interativa:
CLI
Confira os resultados individuais de doctor antes de começar. Ele identifica problemas de conta, catálogo de modelos, ambiente de execução e conectores. Descreva a tarefa no terminal, acompanhe o progresso e responda às perguntas ou solicitações de aprovação. Use /model para selecionar um modelo, @ para referenciar arquivos do projeto, /attach <caminho> para anexar uma imagem e /sessions para encontrar trabalhos anteriores. Use /help para ver os comandos interativos disponíveis. Para retomar o trabalho, encontre o identificador com /sessions e informe-o em --resume:
CLI

A saída de /help lista comandos para agentes, acesso à conta, consumo, plugins e diagnóstico.

​
Execute uma tarefa em um script

Para executar uma tarefa única, use run:
CLI
Adicione --output-format json quando outro programa precisar consumir o resultado. A CLI retorna um objeto de resultado quando a execução termina:
CLI
Uma execução não interativa não consegue responder a perguntas ou pedidos de aprovação. A CLI recusa solicitações que exigem essa interação, em vez de aguardar indefinidamente. Use uma sessão interativa para tarefas que precisam das suas decisões. Scripts devem conferir o status do resultado e o código de saída antes de considerar a tarefa bem-sucedida.

​
Encontre modelos e sessões anteriores

Fora da interface interativa, use:
CLI
whoami identifica a conta ativa. models --refresh atualiza o catálogo. sessions lista sessões recentes; adicione --all para incluir antigas ou --json para saída estruturada. Use o ID exibido com --resume para continuar a conversa correta. No modo interativo, /plan controla o planejamento e /permissions a política de aprovação. /compact resume o histórico e /usage mostra consumo. Ctrl + C para o turno ativo; sem um turno, a CLI pergunta se você quer sair. /exit fecha a interface.

​
Escolha o formato de saída

Erros de diagnóstico vão para a saída de erro padrão. Separe-os da saída estruturada em scripts. Uma resposta final não prova que os testes passaram: examine o estado da tarefa e o resultado do comando. Para um prompt salvo em arquivo, use a entrada padrão:
CLI
Inclua em task.txt a solicitação completa, as premissas do projeto e a saída esperada. Execute no diretório do projeto. Continue com Consumo e solução de problemas.