O que é CLI?

Interagir com uma ferramenta por comandos

CLI significa Command-Line Interface, ou interface de linha de comando, uma forma de utilizar um programa por instruções textuais. Você informa a ação e seus parâmetros, e a ferramenta devolve resultados ou solicita informações adicionais.

O Git, por exemplo, oferece comandos para consultar o repositório e registrar alterações. A interface textual permite executar essas funções no terminal e também em scripts. O comportamento continua dependendo da operação solicitada e do ambiente de execução.

Uma CLI pode coexistir com uma interface gráfica ou uma API. São formas diferentes de acessar funções de uma ferramenta. Ter uma CLI não significa que todo comando possa executar sem interação, pois alguns podem solicitar confirmação ou autenticação.

Como ler uma linha de comando

git status --short

git identifica o programa. status é o subcomando que consulta o estado do repositório, e --short solicita uma saída compacta. Esse exemplo é de leitura e não registra nem publica alterações.

Argumentos posicionais fornecem valores conforme a posição esperada, como um caminho de arquivo. Opções ajustam o comportamento e frequentemente começam com hífens. Uma opção também pode receber um valor, por isso a documentação da ferramenta determina como interpretar a linha.

Saída de texto e código de saída

Programas de terminal podem escrever resultados na saída padrão e diagnósticos na saída de erro. Também devolvem um código ao processo que os iniciou. Em muitas ferramentas, zero indica sucesso e outro valor indica uma condição que precisa ser tratada.

O significado exato depende do programa. Uma ferramenta de busca pode usar um código distinto para “nenhum resultado” sem representar uma falha interna. Scripts precisam seguir essa convenção em vez de procurar apenas uma palavra no texto impresso.

Quando houver saída estruturada, como JSON, ela costuma ser mais adequada para outro programa interpretar. Uma tabela feita para leitura humana pode mudar de espaçamento ou formatação. Confira as opções documentadas antes de automatizar sua leitura.

CLI, shell e terminal

Ao digitar git status --short no terminal, você fornece ao shell a linha que ele interpreta para iniciar o Git. O Git reconhece seu subcomando e a opção, executa a consulta e escreve o resultado apresentado no terminal. A CLI define os comandos e parâmetros aceitos nessa interação.

Antes de usar um comando pela primeira vez, consulte a opção --help e confirme em qual pasta ele será executado. Para inspecionar o efeito de git clean, use git clean -n e revise a lista antes de executar a remoção. Se o caminho tiver espaços, informe-o entre aspas para que o shell o interprete como um argumento só. O verbete de terminal explica essa interação.

Aplicação na formação

Developer Workspace

A CLI permite executar ferramentas do projeto com comandos, argumentos e opções.

Conhecer a formação →