Modo Interativo

O modo padrão do ChatCLI é o interativo. Para iniciá-lo, basta executar o comando no seu terminal sem nenhum argumento:

❯
./chatcli

Você será saudado com uma tela de boas-vindas e um prompt ( ❯ ), pronto para receber suas perguntas ou comandos.

🤖 Você está conversando com gpt-4o-mini (OPENAI)

❯
me ajude a listar todos os containers docker ativos

Qualquer texto que não comece com / ou @ será tratado como um prompt para a Inteligência Artificial.

Comandos Essenciais

Os comandos internos são seu centro de controle para o ChatCLI. Eles sempre começam com uma barra ( / ).

  Comando            │ Descrição                                                                                                                      
───────────────────┼────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
/help              │ Exibe a tela de ajuda completa com todos os comandos e opções disponíveis.                                                     
/exit ou /quit     │ Encerra a aplicação do ChatCLI de forma segura.                                                                                
/newsession        │ Limpa o histórico da conversa atual, permitindo que você inicie um novo diálogo do zero.                                       
/config ou /status │ Mostra a configuração atual, incluindo o provedor e modelo de IA ativos, e chaves de ambiente (com valores sensíveis ocultos).
/reload            │ Recarrega a configuração do arquivo  .env  sem precisar reiniciar a aplicação.                                                 
/switch            │ Abre um menu interativo para trocar o provedor de LLM ou alterar o modelo atual.

Uma Breve Visão dos Comandos Avançados

Além dos comandos essenciais, o poder do ChatCLI reside em sua capacidade de entender o contexto e executar ações. Estes são os dois principais tipos de comandos avançados:

Comandos de Contexto ( @ )

Estes comandos, que começam com @ , são usados para injetar informações dinâmicas no seu prompt.

  • @file : Anexa o conteúdo de um arquivo ou a estrutura de um diretório.
  • @git : Fornece à IA o estado atual do seu repositório Git.
  • @command : Executa um comando no seu terminal e usa a saída como contexto.

Estes comandos serão detalhados na próxima seção.

Modo Agente ( /agent )

Este é o modo mais poderoso do ChatCLI. Em vez de apenas obter respostas, você pode delegar uma tarefa.

❯
/agent organize meus arquivos .log na pasta ‘~/logs’ em subpastas por data

A IA irá criar um plano de execução, que consiste em uma série de comandos de shell, e pedir sua aprovação antes de executá-los.

Modo Coder (/coder)

Além do modo /agent, o ChatCLI tem o modo especializado /coder para tarefas de engenharia de software (leitura/edição de arquivos, refatoração, rodar testes, etc).

No /coder, quem chama as ferramentas é a IA – ela emite chamadas do plugin @coder em um formato estrito (<tool_call>). Você dá o objetivo (“corrija testes”, “refatore X”) e a IA faz o resto.

❯
/coder corrija os testes falhando

Veja o guia completo: Modo Coder (/coder) e o detalhe do plugin: Plugin @coder

Prática: exemplos de chamadas do @coder (pela IA)

No modo /coder, visualize o <tool_call> como ordens de ferramenta que a IA emite para o ChatCLI executar. Exemplos (como texto, não código):

  • <tool_call name="@coder" args="tree --dir ."/>
  • <tool_call name="@coder" args="search --term 'FAIL' --dir ."/>
  • <tool_call name="@coder" args="read --file cli/agent_mode.go"/>
  • <tool_call name="@coder" args="exec --cmd 'go test ./...'"/>

Observe: em /coder, sempre é a LLM quem emite o @coder – o usuário somente descreve objetivos.

Próximos Passos

Agora que você conhece o básico, vamos mergulhar na funcionalidade que torna o ChatCLI tão poderoso: a adição de contexto.

➡️ Próximo: Adicionando Contexto ( @ Comandos)