Interação e entrada

O Jarvis Code CLI roda como uma TUI (interface de terminal) interativa construída em torno de três componentes: a caixa de entrada, a visão da conversa e a barra de status. Esta página cobre como digitar texto, colar mídia, percorrer o fluxo de aprovação e alternar entre modos.

Noções básicas da caixa de entrada

A caixa de entrada aceita texto livre. Pressione Enter para enviar ou Shift-Enter / Ctrl-J para inserir uma quebra de linha. Com a caixa de entrada vazia, pressione ↑ / ↓ para percorrer o histórico de entrada do diretório de trabalho atual, incluindo comandos de shell anteriores.

Sair do CLI: pressione Ctrl-D com a caixa de entrada vazia, pressione Ctrl-C duas vezes em repouso ou digite /exit. Pressionar Ctrl-C ou Esc durante a saída em streaming interrompe o turno atual — não encerra o programa.

Colar imagens e vídeo

O Jarvis Code CLI aceita colar imagens e vídeo diretamente na caixa de entrada, então você pode discutir capturas de tela, mockups de UI, diagramas de arquitetura ou demonstrações de código sem precisar enviar ou converter arquivos antes.

A entrada de vídeo é uma capacidade distintiva do Jarvis Code — você pode colar um trecho de vídeo e pedir que o modelo analise seu conteúdo, o fluxo de UI ou uma explicação de código.

Como colar:

• macOS / Linux: Ctrl-V
• Windows: Alt-V

Depois de colar, a caixa de entrada mostra um marcador que você pode editar como texto normal; no envio, o marcador é substituído pelo conteúdo real. Uma área de transferência com texto puro cai no comportamento de colagem comum. O suporte a mídia depende das capacidades multimodais do modelo atual (image_in / video_in); vem habilitado por padrão quando você está autenticado em uma conta Jarvis Code.

Comandos de barra

Digite / para abrir o menu de autocompletar — ele filtra conforme você digita, Esc fecha o menu e uma entrada sem correspondência é enviada ao agente como mensagem comum. Comandos comuns:

Comando	Ação
/new	Inicia uma nova sessão
/sessions	Percorre e retoma sessões anteriores
/compact	Compacta o contexto da sessão atual
/undo	Desfaz prompts recentes
/model	Troca o modelo usado na sessão atual
/plan	Alterna o Plan mode (planejar primeiro, executar depois)
/yolo	Alterna o YOLO mode (aprova automaticamente chamadas de ferramenta comuns)
/goal	Inicia ou gerencia o modo de metas
/help	Mostra todos os comandos

Agent Skills ativas são registradas automaticamente como comandos de barra: skills externas comuns são invocadas com /skill:<name>, sub-skills externas aparecem como comandos com ponto, por exemplo /parent.child, e skills embutidas aparecem diretamente como /<name> no painel de comandos de barra. Se o nome de uma skill externa não conflitar com um comando de barra do sistema, você também pode omitir o prefixo skill: e digitar /<name> diretamente.

Dentro de um prompt mais longo, digitar / depois de um espaço em branco — inclusive no início de uma linha posterior — abre um menu de autocompletar só de skills. Você pode referenciar várias skills em um mesmo prompt assim: o Jarvis Code as ativa em conjunto e as executa com o prompt em um único turno (um /undo desfaz o envio inteiro), e o texto do prompt é enviado sem alteração. Uma menção a skill dentro de um prompt nunca carrega argumentos — a ativação é apenas por nome; argumentos continuam sendo um conceito à parte, na forma /skill:<name> args. Comandos embutidos e de plugin continuam funcionando apenas no início absoluto da entrada.

Alguns comandos só estão disponíveis quando o agente está em repouso — você precisa pressionar Esc para interromper a saída em streaming ou a compactação de contexto antes de usá-los. Comandos de alternância de modo e de consulta, como /yolo, /plan, /help e /btw, estão sempre disponíveis. Para a lista completa, veja Comandos de barra.

Referências de arquivo

Digite @ para acionar o autocompletar de caminhos de arquivo; o caminho selecionado é inserido na forma relativa e o agente carrega o conteúdo do arquivo diretamente quando lê sua mensagem.

• Onde funciona: em diretórios com e sem git; caminhos ocultos são incluídos, .git fica de fora
• Sugestões de pasta: terminam com /, então você pode continuar completando caminhos dentro delas
• Fallback: enquanto o auxiliar de busca rápida ainda está baixando, o Jarvis Code cai em uma varredura básica do sistema de arquivos

Referências @ e comandos de barra são dois mecanismos separados: @ dá contexto de arquivo ao agente, enquanto / invoca recursos embutidos ou skills. Depois de um espaço em branco, / oferece apenas autocompletar de skills; use / no início para comandos embutidos e de plugin.

Fluxo de aprovação

Quando o agente chama uma ferramenta com efeitos colaterais — modificar arquivos, executar comandos — a TUI exibe um painel de aprovação para sua confirmação.

• Aprovar: selecione com as setas e pressione Enter, ou pressione 1 / 2 / 3 para escolher diretamente
• Rejeitar: Esc, Ctrl-C ou Ctrl-D
• Approve for this session: aprova automaticamente o mesmo tipo de chamada pelo resto da sessão
• Regras permanentes: adicione entradas de allow / deny em Arquivos de configuração

Aprovações não são acionadas para chamadas de ferramenta comuns no YOLO mode (modo YOLO), nem para escritas em arquivos de plano no Plan mode (modo de planejamento).

YOLO / Auto mode

YOLO mode (/yolo) aprova automaticamente chamadas de ferramenta comuns, o que o torna adequado para tarefas em lote que você sabe serem seguras. Ele ainda pergunta antes de ações sensíveis — acessar arquivos sensíveis como .env ou chaves SSH, ou sair do Plan mode — e o agente ainda pode fazer perguntas a você.

Auto mode (/auto) é o modo totalmente sem supervisão: toda aprovação de ferramenta é tratada automaticamente, incluindo arquivos sensíveis e saídas de plano, e o agente nunca faz perguntas — ele decide tudo sozinho.

WARNING

O YOLO mode pula a confirmação de escritas em arquivos e de execução de comandos. Use-o apenas em diretórios de trabalho nos quais você confia.

Alternância de modos

Plan mode

No Plan mode o agente primeiro produz um plano de ação e espera sua aprovação antes de modificar qualquer arquivo — útil para tarefas complexas ou de alto risco.

• Alternar: Shift-Tab ou /plan
• Limpar o plano atual: /plan clear (apenas em repouso)

Depois de produzir um plano, o agente pausa para sua revisão — você pode aprovar, rejeitar ou pedir alterações. Sair do Plan mode exige sua confirmação mesmo com o YOLO mode ativo. O Auto mode é a exceção: saídas de plano são aprovadas automaticamente e marcadas como "Auto-approved" na transcrição.

Shell mode

O shell mode (modo shell) permite executar comandos de terminal sem sair da conversa. A saída do comando é escrita no contexto da conversa, então o agente vê os resultados nos turnos seguintes.

• Entrar: digite ! na caixa de entrada vazia, ou cole um comando que comece com !.
• Sair: pressione Backspace ou Esc na caixa de entrada vazia; enviar um comando também devolve você ao modo normal automaticamente.
• Executar em segundo plano: enquanto um comando roda, pressione Ctrl+B para movê-lo para uma tarefa em segundo plano.
• Recuperar comandos anteriores: com a caixa de entrada vazia no shell mode, pressione ↑ para percorrer comandos de shell anteriores; recuperar um mantém você no shell mode, então ele roda como comando de novo.
• Saída longa: quando a saída de um comando finalizado é muito longa, o cartão de saída é recolhido automaticamente; pressione Ctrl-O para expandir ou recolher junto com a saída de ferramentas.

No shell mode a caixa de entrada mostra um prompt ! à esquerda e a borda fica violeta. Por exemplo, você pode executar !gh auth login para autenticar no GitHub CLI sem abrir outro terminal; a saída fica retida no contexto da conversa.

Outros controles de modo

O comando /permission abre um seletor entre os modos de aprovação manual, YOLO e Auto. O /swarm alterna o modo swarm ou executa uma tarefa nele, e o /workflow gerencia o modo Dynamic Workflow.

O Tower mode é um modo experimental do engine v2 controlado por /tower; ele pode reportar status, ligar ou desligar o modo, definir um objetivo ou encerrar uma torre em execução. Veja Modo Tower para o modelo de colaboração dele. Quando ativo, o rodapé mostra tower; o rodapé também mostra os modos auto, yolo, plan, swarm e Dynamic Workflow quando ativos. O /status informa se o Plan mode está ligado e, quando o experimento está disponível, se o Tower mode está ligado.

Durante a saída em streaming

A caixa de entrada continua utilizável enquanto o agente pensa ou chama ferramentas, e aceita as seguintes ações extras:

• Ctrl-S: injeta o conteúdo da caixa de entrada no turno em execução imediatamente, sem esperar que ele termine
• Esc / Ctrl-C: interrompe o turno atual
• Ctrl-O: alterna globalmente o estado recolhido/expandido da saída de ferramentas e dos resumos de compactação

Editor externo

Pressione Ctrl-G para enviar o conteúdo atual da entrada a um editor externo. Ao salvar e fechar, o texto é escrito de volta na caixa de entrada; se você fechar sem salvar, o conteúdo original é preservado. Isso é prático quando você precisa digitar blocos grandes de texto ou conteúdo com formatação complexa.

Prioridade do editor: configuração de /editor → variável de ambiente $VISUAL → variável de ambiente $EDITOR. Se nenhuma estiver definida, execute /editor primeiro para escolher um padrão.

Próximos passos

• Atalhos de teclado — tabela de referência rápida completa de todos os atalhos
• Comandos de barra — todos os comandos embutidos com descrições e aliases
• Sessões e contexto — como retomar sessões, compactar contexto e exportar conversas