Terminal Opener
Use scripts/open-terminal.js para preservar um executável e cada argumento como
entradas separadas de processo. Nunca interpole uma string de comando shell. Mantenha cada
spawn com shell: false. Use por padrão um plano que não lança. Use --launch apenas
após o usuário solicitar explicitamente uma janela real e o argv ter sido revisado.
O processo lançado herda todo o ambiente do processo chamador,
incluindo variáveis que contêm segredos. O lançador não filtra o
ambiente. Execute-o a partir de um shell cujo ambiente seja seguro para expor ao
comando alvo.
Lançar um comando
Passe as opções do lançador antes de --, depois passe exatamente um executável seguido por
seu array de argumentos:
node skills/terminal-opener/scripts/open-terminal.js \
--launch \
--cwd /absolute/host/path \
-- ssh -t exemplo.test comando-com-argumentos
Execute o modo normal primeiro. Deixe o WezTerm tentar seu mux com uma nova janela, depois deixe o
lançador cair no fallback para um processo wezterm start destacado se o mux não estiver
disponível. Quando o fallback for usado, leia muxFailure da saída JSON (ou da
linha de falha legível por humanos) para diagnosticar por que o caminho do mux falhou.
Recuperar da configuração do terminal
Adicione --recover ou --standalone quando a configuração do usuário ou o estado do mux puder
interferir no comando solicitado. Inicie um processo WezTerm destacado com:
--skip-config start --always-new-process
Espere que o modo de recuperação ignore intencionalmente toda a configuração do terminal do usuário.
Inspecionar antes do lançamento
Omita --launch (ou adicione --dry-run) e adicione --json para inspecionar o exato
executável, argv, diretório de trabalho, adaptador de terminal, lançamento primário e
fallback sem abrir uma janela. Trate o plano JSON como o limite de composição
para chamadores.
Execute --detect --json sem um comando para verificar a disponibilidade do terminal. Siga
a action retornada quando o adaptador estiver ausente ou não for compatível. Use WezTerm
para o adaptador atual; trate outros terminais solicitados como planos não compatíveis,
não como comandos a serem executados.