Configurações

O que cada campo, chave e configuração faz: 140 controles nesta página. É o texto por trás do ⓘ ao lado de cada rótulo nos apps: no computador, passe o ponteiro ou clique (ou pressione F1 no campo); no celular, toque nele.

A linha sob cada nome traz o identificador que o código usa e diz quando só um dos apps tem o controle.

Configurações: Aparência

Onde: Configurações › Aparência.

Tema do app

settings.appTheme

Cores claras ou escuras para o próprio app. “Sistema” segue a configuração clara ou escura do seu computador ou celular.

• Padrão: Sistema.

Tema de cores

settings.appThemeName

As cores do próprio app: Sternway (azul profundo), Arctic (cinza-azulado frio), Solar (creme quente e verde-azulado), Graphite (cinza neutro), Forest (verde) ou Alto contraste (preto e branco com cores fortes). Cada um tem uma versão clara e uma escura, e “Tema do app” escolhe qual. Todo tema mantém o texto legível sobre seus fundos. O terminal tem um tema próprio.

• Padrão: Sternway.

Cor de destaque

settings.appAccent

A cor dos botões, dos links, da linha selecionada e do contorno do que está com o teclado. “Cor do tema” usa a do próprio tema de cores; uma amostra ou “Cor personalizada” coloca qualquer outra no lugar. Uma cor difícil de ler sobre os fundos do tema fica só o bastante mais clara ou mais escura para ser lida.

• Padrão: Cor do tema.

Idioma

settings.language

O idioma dos menus, botões e mensagens: inglês, espanhol, alemão, francês, português do Brasil ou japonês, cada um listado no próprio nome. “Padrão do sistema” segue o idioma do seu computador ou celular, e o inglês é usado quando o Sternway não tem esse idioma. Datas, horas, números e tamanhos de arquivo também seguem o idioma. Definido por dispositivo.

• Padrão: Padrão do sistema.
• Atenção: Documentos longos gerados, como os avisos de terceiros, ficam em inglês.

Tamanho da interface

settings.interfaceSize · Só no computador

O tamanho do texto, dos botões e do espaçamento em todo o app: Compacto, Padrão ou Grande. O tamanho da fonte do terminal é separado (Configurações › Terminal). Definido por computador, porque as telas variam.

• Padrão: Padrão.

Usar a barra de título do sistema

settings.systemTitleBar · Só no computador

O Sternway desenha a própria barra no topo da janela, com o menu, as abas e os botões da janela. Ative isto para ter de volta a barra de título e a barra de menus do seu sistema operacional, por exemplo quando a janela não se move, não redimensiona ou não se encaixa como suas outras janelas. Definido por computador. Entra em vigor quando o Sternway é iniciado de novo.

• Padrão: Desativado.

Formulários abrem como

settings.forms.defaultMode

Como “Novo host” e os outros editores abrem. Um assistente pergunta uma coisa por vez; o formulário completo mostra todos os campos de uma vez. Qualquer um pode alternar para o outro enquanto está aberto.

• Padrão: Formulário completo no desktop, assistente no celular.

Tema do terminal

settings.terminalThemeId

As cores dos terminais que não têm tema próprio. “Acompanhar o tema do app” segue a aparência clara ou escura do app. Um host ou grupo pode definir o próprio tema, e um tema escolhido dentro de uma sessão vale para aquela sessão.

• Padrão: Acompanhar o tema do app.

Manter o texto legível

settings.keepTextReadable

Clareia o texto cuja cor está próxima demais da cor do fundo até que possa ser lido (um contraste de 3:1). Alguns temas têm essas cores de propósito: o preto e o preto brilhante do Solarized são tons do próprio fundo, e um programa que imprimisse com elas ficaria invisível. Cores que já são legíveis não são alteradas, e o tema em si não é alterado. Desative para ver todas as cores exatamente como o tema as define.

• Padrão: Ativado.

Nome

theme.name

Como o tema personalizado se chama nas listas de temas. Obrigatório, até 64 caracteres.

• Exemplo: Solarized, do meu jeito

Cor

theme.color

Uma cor do tema, como valor hexadecimal. Fundo e primeiro plano são obrigatórios; uma cor deixada em “Padrão” é calculada a partir dessas duas (o cursor usa o primeiro plano) ou da paleta padrão de 16 cores.

• Exemplo: #1a2b3c

Colar JSON

theme.paste · Só no celular

Cole um tema para importá-lo: um tema exportado do Sternway como JSON, ou o texto XML de um arquivo .itermcolors do iTerm2 (abra o arquivo em um editor de texto e copie tudo). As cores são verificadas primeiro, e o tema é adicionado aos seus temas personalizados sem substituir um com o mesmo nome.

Configurações: Terminal

Onde: Configurações › Terminal.

Fonte

settings.fontFamily

A fonte do terminal. Incluídas: JetBrains Mono, Fira Code, Cascadia Code, Source Code Pro e Hack. No desktop, você também pode digitar o nome de qualquer fonte instalada no computador.

• Padrão: JetBrains Mono.

Tamanho da fonte

settings.fontSize

O tamanho do texto do terminal em pixels inteiros, de 6 a 72. Um host ou uma única sessão pode usar o próprio. Até você definir um tamanho, cada dispositivo usa o próprio padrão; um tamanho definido aqui é usado em todos os seus dispositivos.

• Padrão: 10 no celular, 12 no tablet, 14 no computador.

Altura da linha

settings.lineHeight

O espaço que cada linha do terminal ocupa, como múltiplo do tamanho da fonte, de 0,8 a 2. Aumente se as linhas parecerem apertadas.

• Padrão: 1,2.

Texto em negrito

settings.boldText

Se o texto que os programas marcam como negrito é desenhado em negrito. Desative se o negrito parecer borrado na sua fonte.

• Padrão: Ativado.

Texto em negrito usa cores brilhantes

settings.boldIsBright

Desenha o texto em negrito na variante brilhante da sua cor, como os terminais antigos faziam. Desativado, o texto em negrito mantém a cor e só fica mais pesado, que é o que a maioria dos terminais faz hoje e para o que os temas são feitos: no Solarized, por exemplo, as cores brilhantes são cinzas, então o nome de uma pasta em azul negrito ficaria cinza. Ative se um programa que você usa depende do negrito para significar “mais brilhante”.

• Padrão: Desativado.

Cursor

settings.cursorStyle

O formato do cursor de texto: um bloco preenchido, um sublinhado ou uma barra fina.

• Padrão: Bloco.

Cursor piscante

settings.cursorBlink

Se o cursor pisca. Desative se o movimento distrair você.

• Padrão: Ativado.

Preenchimento automático

settings.autocomplete

Mostra sugestões enquanto você digita em um prompt: os comandos instalados no host, seus subcomandos e opções, valores que se encaixam no argumento (branches depois de “git checkout”, serviços depois de “systemctl restart”, arquivos e pastas), seus snippets salvos de uma linha e comandos que você executou neste host antes. O comando completo mais provável do seu histórico aparece em cinza depois do cursor; a lista abaixo do cursor traz as alternativas. Escolher uma a digita sem pressionar Enter. Nada é sugerido em um programa de tela cheia como o vim nem em uma solicitação de senha. Sessões Telnet, serial e Mosh recebem só histórico, snippets e as descrições de comandos integradas, assim como um terminal local no Windows rodando Git Bash ou uma distribuição WSL (ali o app não tem um shell próprio a consultar); no PowerShell e no Prompt de Comando nada é sugerido. No desktop, também oferece a senha salva do host em uma solicitação de senha. Um host pode desativar as sugestões para si.

• Padrão: Ativado.
• Atenção: Um servidor que permite só um canal por conexão não pode ser consultado, então as sugestões são desativadas para esse host neste dispositivo, com um aviso.

Buscar comandos e opções no host

settings.autocompleteHostLookup

Permite que o preenchimento automático pergunte ao host o que ele tem: quais comandos estão instalados, as opções na página de manual de um comando e valores como branches do git, serviços, contêineres, usuários e nomes de arquivos. As perguntas são comandos fixos, somente leitura (por exemplo, “ls”, “man”, “git for-each-ref”, “systemctl list-units”), executados em segundo plano pela conexão que a sessão já tem, nunca digitados no seu terminal. O que você digita só é passado a eles como um nome ou caminho entre aspas, e nenhum programa é iniciado só para ler a ajuda dele. A lista de comandos instalados fica guardada neste dispositivo por um dia, para que a próxima sessão a tenha na hora. Com isto desativado, as sugestões vêm só do seu histórico, dos seus snippets e das descrições de comandos integradas.

• Padrão: Ativado.
• Atenção: As consultas rodam como o usuário com que você fez login e ficam visíveis para o host como qualquer outro comando (uma lista de processos ou um log de auditoria as mostra). Desative para um host em que nem comandos somente leitura podem rodar sem ser pedidos.

Tecla Tab

settings.autocompleteTab · Só no computador

O que o Tab faz enquanto a lista de sugestões está visível. “Sugestões do Sternway primeiro” insere a sugestão destacada, ou a primeira. “Completar do shell primeiro” envia o Tab ao shell como de costume e só insere uma sugestão depois que você entra na lista com a seta para baixo. Sem lista visível, o Tab sempre vai para o shell.

• Padrão: Sugestões do Sternway primeiro.

Copiar ao selecionar

settings.copyOnSelect

Copia o texto para a área de transferência assim que você o seleciona no terminal, como fazem os terminais do Linux.

• Padrão: Desativado.
• Atenção: Cada seleção substitui em silêncio o que estava na área de transferência.

Avisar antes de colar

settings.pasteWarning

Pergunta antes de colar texto com várias linhas ou grande (5 KB ou mais), porque cada linha colada pode ser executada como comando assim que chega.

• Padrão: Colagens de várias linhas.
• Atenção: Com “Nunca”, um bloco de comandos colado é executado na hora. Comandos escritos pelo assistente de IA sempre geram uma pergunta quando têm várias linhas.

Clique com o botão direito

settings.rightClick · Só no computador

O que o botão direito do mouse faz em um terminal: abrir o menu ou colar a área de transferência imediatamente, como faz o PuTTY.

• Padrão: Mostrar menu.

Sino

settings.bell

O que acontece quando um programa toca o sino do terminal (um preenchimento com Tab que falhou, por exemplo): um breve piscar, um som no desktop ou uma vibração no celular, ou nada.

• Padrão: Piscar.

Histórico de rolagem

settings.scrollback

Quantas linhas de saída anterior cada terminal guarda para rolar para trás, de 1.000 a 100.000. Mais linhas usam mais memória por terminal aberto.

• Padrão: 10.000 linhas.

TERM padrão

settings.defaultTermType

Como o app se identifica para os servidores (a variável TERM), o que decide as cores e teclas que os programas usam. Um host ou grupo pode substituí-la. Altere só se programas de tela cheia se comportarem mal em todo lugar. As opções são xterm-256color, xterm, vt100 e linux (o console do Linux).

• Padrão: xterm-256color.

Separadores de palavras

settings.wordSeparators

Os caracteres que terminam uma palavra quando você clica duas vezes (toca duas vezes no celular) para selecioná-la. Remova um caractere para que ele seja selecionado como parte da palavra.

• Padrão: Um espaço e ( ) [ ] { } ’ “ , ; :

Ligaduras da fonte

settings.ligatures · Só no computador

Desenha pares como -> e != como um único símbolo unido, nas fontes que os têm. Muda só a aparência, não o que é enviado.

• Padrão: Desativado.

Destaque inteligente

settings.smartHighlight

O Sternway colore o que reconhece na saída simples: endereços, caminhos, tamanhos, datas, níveis de log, as colunas de uma listagem de arquivos e mais, cada um em uma cor do tema do terminal, então outro tema os recolore. As cores dos próprios programas nunca são alteradas: só o texto que um programa imprimiu na cor padrão é pintado. É só exibição, então cópia, busca, logs e o que é enviado não são afetados. Programas de tela cheia como vim e less, e a linha em que você está digitando, não são tocados. Cada tipo pode ser desativado abaixo; um host pode definir o seu, e uma sessão pode ser alternada pelo menu dela.

• Padrão: Ativado.

Listagens de arquivos (ls -l)

settings.smartSet.listing

Em uma listagem longa de arquivos: as letras de permissão, proprietário e grupo, tamanho e data, e o nome conforme o que ele é (uma pasta, um link, um programa), quando o ls não coloriu o próprio nome.

• Padrão: Ativado.
• Exemplo: ls -l | head

Diffs

settings.smartSet.diff

Linhas adicionadas e removidas e os cabeçalhos @@ de um diff unificado que foi impresso sem cor. Uma linha que começa com + ou - só é colorida dentro de um diff.

• Padrão: Ativado.
• Exemplo: git diff –no-color

Logs de servidor web

settings.smartSet.http

Em linhas de log de acesso: o método da requisição e o código de status conforme a classe (2xx, 3xx, 4xx, 5xx).

• Padrão: Ativado.
• Exemplo: “GET /health HTTP/1.1” 200

Links e endereços de e-mail

settings.smartSet.links

Endereços web e outros que começam com um esquema (https://, ssh://, …) e endereços de e-mail, sublinhados. Os links continuam clicáveis como antes.

• Padrão: Ativado.
• Exemplo: https://example.com

Endereços IP e MAC

settings.smartSet.addresses

Endereços IPv4, IPv6 e de hardware (MAC). Quatro números que fazem parte de uma versão (versão 1.2.3.4, curl-8.5.0.1) não são tomados por um endereço.

• Padrão: Ativado.
• Exemplo: 10.0.0.5, fe80::1, 00:15:5d:0a:1b:2c

IDs e hashes

settings.smartSet.ids

UUIDs, hashes de commit e de digest e números 0x, atenuados para que o texto ao redor seja lido com mais facilidade.

• Padrão: Ativado.
• Exemplo: 9fceb02d, 0x7ffe

Datas e horas

settings.smartSet.dates

Datas e carimbos de data/hora (ISO, syslog, listagens de arquivos, logs web), atenuados. Um horário só conta com os segundos: 19:36:01, não 19:36.

• Padrão: Ativado.
• Exemplo: 2026-10-07 19:36:01, Apr 15 19:36

Níveis de log e resultados

settings.smartSet.levels

ERROR, WARN, INFO, OK, DEBUG e similares, e palavras que dizem como algo terminou: failed, denied, refused, deprecated, passed, active (running). Uma palavra de nível em minúsculas só conta onde está marcada como tal (error:, [warn], level=info), não em uma frase.

• Padrão: Ativado.
• Exemplo: ERROR, [warn], Permission denied

Chaves JSON e YAML

settings.smartSet.data

A chave no início de uma linha “chave: valor”, as chaves entre aspas de um JSON e true, false e null nessa linha.

• Padrão: Ativado.
• Exemplo: “name”: “web-01”

Caminhos de arquivo

settings.smartSet.paths

Caminhos absolutos e caminhos sob ~/. Um caminho que termina em / é colorido como pasta. Um único componente só conta para uma pasta do sistema (/etc, /var), então “and/or” e “n/a” não são tocados.

• Padrão: Ativado.
• Exemplo: /var/log/nginx/, ~/src/app.conf

Tamanhos e números

settings.smartSet.numbers

Números com unidade (12K, 3.4G, 85%, 340ms) e números dispostos em coluna. Um número em uma frase, versão ou nome não é tocado.

• Padrão: Ativado.
• Exemplo: 3.4G, 85%

Texto entre aspas

settings.smartSet.strings

Texto entre aspas duplas, aspas simples ou crases. Um apóstrofo dentro de uma palavra não inicia uma citação.

• Padrão: Ativado.
• Exemplo: echo “hello world”

Opções de comando

settings.smartSet.options

Opções longas (–verbose), uma opção curta no início de uma linha de ajuda recuada e o nome em nome=valor.

• Padrão: Ativado.
• Exemplo: –verbose, TERM=xterm

Destacar palavras-chave

settings.keywordHighlight

Colore as correspondências das suas próprias regras abaixo na saída do terminal, cada uma na cor que você deu a ela. Suas regras têm prioridade sobre o destaque inteligente e também colorem texto que um programa coloriu por conta própria. Como o destaque inteligente, é só exibição e pinta a tela normal, não programas de tela cheia como o vim. As regras são sincronizadas com seus outros dispositivos; elas são editadas no desktop.

• Padrão: Desativado.

Expressão regular

settings.keywordPattern · Só no computador

O texto a colorir, como expressão regular, comparado sem considerar maiúsculas. Quando duas regras correspondem ao mesmo texto, vale a que está mais acima na lista. O editor aceita até 64 regras; uma regra cujo padrão não é uma expressão válida é ignorada.

• Exemplo: error|failed, ou \bWARN(ING)?\b

Shell local

settings.localShellPath · Só no computador

O programa que um terminal local (um neste computador, não em um servidor) executa. Deixe vazio para o padrão do sistema: seu shell de login no Linux e no macOS, PowerShell no Windows (PowerShell 7 quando instalado; senão, Windows PowerShell). A lista contém os shells encontrados neste computador (no Windows: PowerShell, Prompt de Comando, Git Bash e cada distribuição WSL); “Personalizado…” aceita qualquer outro programa pelo caminho completo. “Novo terminal local em”, no menu + da faixa de abas, inicia qualquer shell listado para uma aba sem alterar esta configuração. O preenchimento automático não é oferecido no PowerShell nem no Prompt de Comando, e um espaço de trabalho restaurado não muda de pasta em um terminal local no Windows.

• Padrão: Padrão do sistema.
• Exemplo: /bin/zsh, ou C:\Program Files\PowerShell\7\pwsh.exe

Programa de shell

settings.localShellCustom · Só no computador

O caminho completo do programa que os terminais locais executam, para um shell que a lista acima não mostra. “Procurar…” escolhe o arquivo. Esvazie para voltar ao padrão do sistema.

• Exemplo: /usr/bin/fish, ou D:\tools\nu.exe

Option como Meta

settings.optionAsMeta

Faz a tecla Option (Alt) funcionar como a tecla Meta que shells e editores esperam, para que Option+B volte uma palavra em vez de digitar um caractere especial. No celular, vale para um teclado físico.

• Padrão: Desativado.

Imagem de fundo

settings.terminalBackground · Só no computador

Uma imagem atrás do texto de cada terminal. “Escolher imagem…” aceita um arquivo PNG, JPEG ou WebP de até 8 MB, 8.192 pixels por lado e 24 milhões de pixels no total; um PNG ou WebP animado se mexe como em qualquer outro lugar. O Sternway guarda uma cópia no perfil deste computador, então mover ou apagar o original não muda nada. Onde a imagem deixaria o texto difícil de ler, a cor de fundo do terminal é colocada por cima só o bastante para que cada cor legível do tema fique em 4,5:1. Só neste computador: não é sincronizada, e um backup só a leva quando “Incluir nos backups” está ativado.

• Padrão: Nenhuma imagem.
• Atenção: Um arquivo é verificado pelo conteúdo, não pelo nome: um SVG, um GIF ou qualquer coisa que não seja um dos três formatos é recusado, assim como uma imagem grande demais para ser desenhada.

Opacidade da imagem

settings.terminal.backgroundOpacity · Só no computador

Quanto a imagem de fundo aparece, de 5 a 100 por cento em passos de 5. Onde isso deixaria o texto difícil de ler, a imagem é escurecida mais, então o texto sempre fica legível. Guardado neste computador.

• Padrão: 30 %.

Desfoque da imagem

settings.terminal.backgroundBlur · Só no computador

Desfoca a imagem de fundo, de 0 a 20 pixels, para que os detalhes não disputem com o texto. Guardado neste computador.

• Padrão: Sem desfoque (0).

Incluir nos backups

settings.terminal.backgroundInBackups · Só no computador

Coloca a imagem de fundo, sua opacidade e seu desfoque nos backups criptografados que você exporta (Configurações › Backups), então restaurar um deles em outro computador traz a imagem de volta. Um backup de só alguns cofres, como os de uma equipe, nunca a leva.

• Padrão: Desativado: a imagem fica neste computador.

Configurações: Conexões e SSH

Onde: Configurações › Conexões e SSH; Configurações › Segundo plano e keep-alive.

Tempo limite de conexão

settings.ssh.connectTimeoutSec

Quanto tempo esperar pela resposta de um servidor, e depois pelo handshake de login, antes de desistir. Aumente para links lentos ou distantes. De 1 a 300 segundos; um host ou grupo pode definir o seu.

• Padrão: 15 segundos.

Reconexão automática

settings.ssh.autoReconnect

Quando uma sessão cai inesperadamente, conecta de novo sem perguntar: 5 tentativas rápidas, esperando 1, 2, 4, 8 e 16 segundos, e depois uma tentativa por minuto enquanto a aba dela estiver aberta, e na hora quando a rede muda ou o dispositivo desperta. No celular ele espera enquanto o app está em segundo plano, a não ser que Manter sessões ativas em segundo plano esteja ligado. Um redirecionamento de portas em execução cuja conexão cai também tenta de novo: até 10 tentativas em cerca de 5 minutos, e na hora quando a rede deste computador ou celular muda. Um host ou grupo pode definir o seu.

• Padrão: Ativado.

Chaves de host desconhecidas

settings.ssh.hostKeyPolicy

Todo servidor comprova quem é com uma chave de host, e o app a memoriza (Hosts conhecidos). Isto decide o que acontece na primeira vez que um servidor é visto: “Perguntar” mostra a impressão digital e permite aceitá-la; “Estrito” recusa qualquer servidor que ainda não seja conhecido. Um servidor cuja chave mudou é sempre bloqueado com um aviso, seja qual for a escolha. Você só pode continuar escolhendo Substituir chave.

• Padrão: Perguntar.
• Atenção: Com “Perguntar”, aceitar uma impressão digital sem conferi-la é como uma conexão é interceptada. Compare-a com o que o administrador do servidor fornecer.

Encaminhamento de agente

settings.ssh.agentForwarding

Permite que um servidor em que você está use suas chaves para fazer login em outro servidor, sem que as chaves privadas saiam deste dispositivo. Este é o padrão para hosts que não definem o seu. “Chave de autenticação” oferece só a chave com que você fez login; “Todas as chaves” oferece as chaves do host e dos seus hosts de salto. Isso é solicitado apenas em sessões de terminal, não no SFTP nem em encaminhamentos de porta. “Chave de autenticação” não oferece nada quando você fez login com senha ou com uma chave do agente SSH deste computador. “Todas as chaves” deixa de fora chaves de segurança (hardware) e chaves criptografadas cuja frase secreta não está salva nem lembrada; ela não as solicita.

• Padrão: Desativado.
• Atenção: Enquanto você estiver conectado, qualquer pessoa com direitos de administrador no servidor pode fazer login em outro lugar como você. Deixe desativado aqui e ative por host para servidores em que você confia.

Usar o agente SSH deste computador

settings.ssh.systemAgent · Só no computador

Também faz login com as chaves de um agente SSH deste computador, para todos os hosts, além da chave ou senha que o host tem no Sternway. As chaves ficam no agente: o Sternway só pede que ele assine. O agente é escolhido em “Agente SSH”: o do sistema, o 1Password, o Bitwarden ou um socket que você indicar. Nada acontece quando esse agente não está rodando. Esta configuração pertence a este computador e não é sincronizada.

• Padrão: Desativado.
• Atenção: Um servidor que permite poucas tentativas de login pode recusar a conexão quando o agente tem muitas chaves: cada uma oferecida conta como uma tentativa.
• Mais: Leia mais (em inglês)

Agente SSH

settings.ssh.agentSource · Só no computador

O agente com que “Usar o agente SSH deste computador” faz login. “Agente do sistema (SSH_AUTH_SOCK)” é o que seu terminal usa: no Linux e no macOS, o agente indicado por SSH_AUTH_SOCK; no Windows, o serviço OpenSSH Authentication Agent, ou o Pageant quando SSH_AUTH_SOCK indica o pipe dele. “1Password” e “Bitwarden” são os agentes desses gerenciadores de senhas depois de ativados nas configurações deles: o Sternway encontra o socket sozinho. No Windows, os dois usam o pipe do agente OpenSSH, o mesmo do agente do sistema. “Socket ou pipe personalizado” usa o caminho em “Socket ou pipe do agente”. Cada opção diz se o agente dela está rodando; “Testar” lista as chaves que ele tem.

• Padrão: Agente do sistema (SSH_AUTH_SOCK).
• Atenção: Um gerenciador de senhas pede, na própria janela, que você aprove cada login com uma das chaves dele. A conexão espera sua resposta.
• Mais: Leia mais (em inglês)

Socket ou pipe do agente

settings.ssh.agentPath · Só no computador

O socket de outro agente SSH, para “Socket ou pipe personalizado”: um caminho completo como /run/user/1000/gnupg/S.gpg-agent.ssh ou, no Windows, um pipe nomeado como \\.\pipe\openssh-ssh-agent. Só é usado um socket ou pipe neste computador, nunca um endereço de rede. Digitar um caminho aqui escolhe “Socket ou pipe personalizado”. Vazio, essa opção usa o agente do sistema.

• Padrão: Vazio.
• Mais: Leia mais (em inglês)

Manter em sincronia com ~/.ssh/config

settings.ssh.configLink · Só no computador

Mostra todos os hosts do seu arquivo de configuração do OpenSSH (e dos arquivos que ele inclui) em uma pasta “SSH config” e a mantém atualizada: uma alteração no arquivo aparece em segundos. Editar um desses hosts no Sternway grava a alteração de volta no arquivo, linha por linha, mantendo seus comentários, a ordem e as configurações que o Sternway não usa como estavam. ProxyCommand, ProxyJump, IdentityFile, IdentitiesOnly, User, Port, ForwardAgent, os encaminhamentos e ServerAliveInterval são usados ao conectar; os detalhes de um host listam o que mais o arquivo diz que o Sternway não usa. Hosts de arquivos incluídos são mostrados, mas nunca alterados. A pasta fica neste computador: não é sincronizada.

• Padrão: Desativado.
• Atenção: Um ProxyCommand executa um programa neste computador a cada conexão com esse host, exatamente como o ssh faria. As edições são gravadas no seu ~/.ssh/config real.

Mostrar quais hosts respondem

settings.hosts.reachability

Um ponto ao lado de cada host da lista diz se a porta SSH dele aceita conexões agora: verde com o tempo que levou, vermelho quando não responde. O app verifica só os hosts que estão na tela, cada um mais ou menos uma vez por minuto, abrindo uma conexão TCP com a porta SSH e fechando-a na hora: sem handshake SSH, sem login, sem senha nem chave, então nunca dispara um pedido de dois fatores nem conta como login com falha. Um host atrás de um host de salto ou de um proxy, ou que precisa de port knocking, aparece como desconhecido: verificá-lo exigiria fazer login nos saltos ou bater nas portas.

• Padrão: Desativado.
• Atenção: Cada verificação é uma conexão que o servidor vê e pode registrar. Muitos hosts na tela, ou uma lista aberta por horas, se acumulam: uma regra rígida do Fail2Ban ou do firewall que conte conexões (não logins com falha) poderia bloquear este dispositivo.

Permitir algoritmos legados

settings.ssh.legacyAlgorithms

Oferecer também métodos de criptografia antigos (troca de chaves e assinaturas SHA-1, cifras CBC, chaves de host ssh-rsa) a todos os servidores. Prefira ativar isso só para o host antigo que precisa, nas configurações Avançadas desse host no desktop.

• Padrão: Desativado.
• Atenção: Esses métodos são fracos.

Troca de chaves pós-quântica

settings.ssh.pqc

Preferir uma forma mais nova de combinar as chaves de criptografia da sessão (o método chamado mlkem768x25519), que também resiste a um futuro computador quântico, quando o servidor tiver suporte. Os métodos habituais continuam sendo oferecidos. Desative apenas se os servidores se comportarem mal com ele.

• Padrão: Ativado.

Intervalo de keepalive

settings.ssh.keepaliveIntervalSec

Um keep-alive é uma pequena mensagem “você está aí?” enviada enquanto uma conexão está ociosa, para que os roteadores não a derrubem e um link morto seja percebido. Este é o tempo entre elas, de 0 a 3600 segundos. Vale a partir da próxima conexão; um host ou grupo pode definir o seu.

• Padrão: 30 segundos.
• Atenção: Desativado significa que uma conexão morta em silêncio só é percebida quando você digita.

Keepalives perdidos permitidos

settings.ssh.keepaliveCountMax

Quantos keep-alives seguidos podem ficar sem resposta antes de a conexão ser considerada perdida e fechada (a reconexão automática assume em seguida, se ativada). Com os padrões, isso dá cerca de um minuto e meio. De 1 a 100.

• Padrão: 3.

Manter sessões ativas em segundo plano

settings.background.keepAlive · Só no celular

Mantém suas conexões rodando depois que você sai do app, executando um serviço do Android com uma notificação que também tem botões para desconectar. No iOS, o sistema só permite um curto período de tolerância.

• Padrão: Ativado.
• Atenção: Com isto desativado, o sistema pode fechar suas conexões logo depois que você muda de app.

Mostrar a tela de conexão

settings.terminal.connectScreen

Enquanto uma sessão conecta, uma tela no lugar dela mostra o caminho deste dispositivo até o host (passando por cada host de salto ou proxy), a etapa em que está e tudo o que precisa perguntar: uma chave de host desconhecida, uma senha, uma frase secreta, um código. “Sempre” a mostra em toda conexão, e quanto tempo ela fica para uma conexão rápida é definido pela configuração “Animação de conexão” abaixo. “Só quando demorar mais que um instante” deixa uma conexão rápida sem ela, e ainda a mostra na hora quando há uma pergunta ou uma falha. “Nunca” volta ao pequeno texto de estado no cabeçalho da sessão, e as perguntas são feitas em caixas de diálogo.

• Padrão: Sempre.

Animação de conexão

settings.terminal.connectPace

Como a tela de conexão mostra o caminho até um host. Uma conexão em rede local fica pronta em uma fração de segundo, rápido demais para ver, então a tela percorre o caminho no próprio ritmo: deste dispositivo, passando por cada host de salto, até o host, cada verificação por vez, parando um instante enquanto cada uma é marcada na lista, e cerca de um segundo em cada host de salto, onde a lista mostra essa máquina concluída e a próxima começando antes de seguir; depois mostra o estado concluído e passa para o terminal. “Completa” leva cerca de 5 segundos para uma conexão direta, cerca de 8 segundos com um host de salto e cerca de 11 com dois, tempo suficiente para ler a imagem e a lista; uma cadeia longa de hosts de salto nunca leva mais de 12 segundos. “Rápida” leva cerca de 3 segundos para uma conexão direta e cerca de 4,5 segundos com um host de salto, com meio segundo em cada host de salto, nunca mais de 8. “Desativada” mostra a tela só enquanto a conexão está de fato sendo feita. A conexão em si nunca é atrasada: a sessão fica pronta por baixo assim que ficaria de qualquer forma, o que você digitar nesse meio-tempo chega a ela, e qualquer tecla, clique ou toque encerra a animação quando a sessão está pronta. Uma reconexão nunca é mais lenta que Rápida, um terminal local pula a tela e, com a redução de movimento ativada no sistema, nada se move: cada etapa é simplesmente mostrada por um instante.

• Padrão: Completa.

Eco local em conexões lentas

settings.terminal.localEcho

Mostra na hora o que você digita, sublinhado, em vez de esperar o host devolver, como faz o Mosh; depois o eco do próprio host toma o lugar. “Quando a conexão está lenta” começa assim que o que você digita leva mais de 100 ms para voltar deste host, medido enquanto você digita; “Sempre” desde a primeira tecla. Só a digitação simples no fim de uma linha é mostrada antes, uma tecla por vez e só depois que o host devolveu uma tecla digitada nessa linha: uma tecla de controle, uma seta, Backspace ou uma colagem esperam o host, assim como tudo num programa de tela cheia, como um editor.

• Padrão: Desligado.
• Atenção: Nunca num pedido de senha ou frase-senha, e nunca para o que é digitado antes de o host devolver algo na linha: o que se digita antes de um pedido sem eco não é mostrado. Um palpite que o host não devolve em cerca de um segundo (ou três tempos de eco numa conexão lenta) é retirado, e nada mais é adivinhado até o programa escrever uma nova linha. Quando o host mostra outra coisa (um shell que completa ou colore a linha), os palpites são retirados na hora.

Texto preditivo e digitação por deslize

settings.terminal.predictiveText · Só no celular

Permite que o teclado na tela trate o terminal como um campo de texto comum: ele sugere palavras, as corrige e aceita digitação por deslize. Cada letra continua sendo enviada assim que aparece, e uma correção chega como apagamentos seguidos da palavra corrigida. Desativado, “Modo do teclado” decide o que é pedido ao teclado, e no modo “Texto simples” uma correção que o teclado faz por conta própria não é aplicada. Uma solicitação de senha no host transforma o campo em um do tipo senha, esteja isto ativado ou não.

• Padrão: Desativado.
• Atenção: Com isto ativado, uma correção automática reescreve o que você digitou no prompt, e um teclado pode atrasar uma letra enquanto decide uma palavra.

Modo do teclado

settings.terminal.keyboardMode · Só no celular

Que tipo de campo o terminal diz ser ao teclado na tela, enquanto “Texto preditivo e digitação por deslize” está desativado. Os teclados decidem a partir disso o que oferecem. “Texto simples (recomendado)” indica texto comum com as sugestões desativadas: o teclado mantém os emojis, a área de transferência, a barra de sugestões, onde houver, e a digitação por deslize. O terminal protege contra o que isso poderia custar. Enquanto o host pede uma senha ou frase secreta, o campo vira o Estrito sozinho, e uma linha acima das teclas diz “Digitação de senha: sugestões desativadas”; ele volta quando a solicitação é respondida, cancelada ou desaparece. O teclado é instruído a não usar maiúsculas automáticas e a não abrir um editor de tela cheia; enquanto uma senha é pedida, também a não aprender o que é digitado. E um comando chega como foi digitado: uma palavra que o teclado corrige sozinho ao pressionar espaço ou pontuação não é alterada na linha de comando, dois espaços continuam dois espaços, e só uma sugestão em que você toca substitui a palavra antes do cursor. “Terminal (como o Termux)” não indica tipo de campo algum, que é o que o Termux faz por padrão: só pressionamentos de tecla, nada é sugerido nem corrigido. “Estrito” indica um campo do tipo senha: o teclado envia cada tecla na hora, oculta ali emojis e sugestões e não aprende o que é digitado. Em todos os modos, a linha de teclas, Ctrl e Alt, Backspace, Enter e a tecla de emoji funcionam igual, e o que é digitado é enviado como UTF-8. A mudança vale na hora, também para sessões abertas; “Teclado” nas Ferramentas do terminal de uma sessão altera a mesma configuração sem sair da sessão. Apenas Android.

• Padrão: Texto simples (recomendado). Uma instalação que nunca alterou esta configuração passa de Estrito para Texto simples com a atualização; um modo que foi escolhido é mantido.
• Atenção: Uma solicitação de senha é reconhecida pelas palavras (“password”, “passphrase”, “PIN”, “passcode” antes de dois-pontos no fim da linha). Um programa que pede um segredo com outras palavras não é reconhecido: mude para Estrito antes ou use Compor com “Ocultar o que eu digito”. Os teclados variam; se a digitação der errado em um modo, tente outro.

Agitar

settings.terminal.shakeAction · Só no celular

O que uma agitada firme do celular envia ao terminal que está na tela, como os botões de volume, que enviam Para cima e Para baixo. “Seta para cima” recupera o comando anterior, “Tab” completa, “Esc” e “Ctrl+C” são as teclas com esses nomes. O sensor de movimento só é lido enquanto um terminal está aberto e isto não está Desativado, e no máximo uma agitada por segundo conta. Apenas Android.

• Padrão: Desativado.
• Atenção: Uma agitada também acontece sem querer (caminhando, em um trajeto com solavancos). “Ctrl+C” interrompe o que estiver rodando.

Desconectar depois de sair do app

settings.background.disconnectAfterMin · Só no celular

Fecha todas as sessões, navegadores de arquivos e encaminhamentos de porta depois que o app fica em segundo plano por este tempo. Use para que uma sessão esquecida não fique aberta o dia todo. De 0 a 1440 minutos; 0 nunca desconecta.

• Padrão: Nunca.
• Atenção: Tudo o que ainda estiver rodando nessas sessões, e o trabalho não salvo nelas, é interrompido.

Manter wake lock enquanto houver sessões ativas

settings.background.wakeLock · Só no celular

Impede que o processador do celular entre em suspensão enquanto há conexões abertas, para que elas não congelem com a tela desligada. Gasta bateria.

• Padrão: Ativado.

Manter Wi-Fi lock enquanto houver sessões ativas

settings.background.wifiLock · Só no celular

Impede que o celular coloque o Wi-Fi em suspensão enquanto há conexões abertas. Gasta bateria.

• Padrão: Ativado.

Configurações: links

Onde: Configurações › Conexões e SSH.

Abrir links ssh:// com o Sternway

settings.links.handleSsh

Faz deste app o que o sistema abre quando você clica em um link ssh:// em um navegador, wiki ou chat. Um link nunca conecta sozinho: o app mostra o host, o usuário e a porta que ele indica e espera você escolher Conectar. Uma senha em um link nunca é usada, e nada em um link é executado. Enquanto isto estiver desativado, o app não fica registrado e ignora qualquer link com que for iniciado.

• Padrão: Desativado.
• Atenção: Qualquer pessoa pode colocar um link ssh:// em uma página. Leia o host na confirmação antes de conectar: um link pode indicar um servidor que só parece ser o seu.

Configurações: SFTP

Onde: Configurações › SFTP.

Mostrar arquivos ocultos

settings.sftp.showHidden

Lista arquivos cujos nomes começam com ponto (.bashrc, .ssh) em um novo painel de arquivos. O menu de cada painel pode alternar isso para aquele painel.

• Padrão: Desativado.

Quando um arquivo já existir

settings.sftp.conflictDefault

O que uma transferência faz quando o destino já tem um arquivo com esse nome: perguntar a cada vez, substituí-lo, ignorá-lo ou manter ambos (o novo recebe um número).

• Padrão: Perguntar.
• Atenção: “Substituir” sobrescreve arquivos existentes sem perguntar.

Verificar transferências retomadas

settings.sftp.verifyResumed

Quando uma transferência continua depois de uma pausa, nova tentativa ou conexão perdida, o arquivo concluído é comparado com o original antes de receber o nome: um SHA-256 das duas cópias. Este dispositivo calcula o seu; o host é solicitado a executar “sha256sum” na cópia dele, e nada mais. Quando o host não tem esse comando ou não permite um segundo canal, e quando isto está desativado, só o tamanho é comparado; a transferência então diz “verificado pelo tamanho”.

• Padrão: Ativado.
• Atenção: Uma soma de verificação lê o arquivo inteiro de novo dos dois lados, então um arquivo muito grande demora mais para terminar. Uma transferência que nunca foi interrompida não é verificada dessa forma, exceto uma cópia de um host direto para outro (dois painéis em dois hosts), em que cada arquivo é verificado por SHA-256 quando os dois hosts têm “sha256sum” e, caso contrário, pelo tamanho, independentemente desta opção.

Descartar transferências inacabadas após

settings.sftp.unfinishedDays

Uma transferência que falha, ou que está pausada ou ainda copiando quando o app fecha, deixa o arquivo que estava gravando ao lado do destino como “nome.sternwaypart” e aparece em Inacabadas, em Transferências, com Retomar e Descartar. Depois deste número de dias, o arquivo parcial é removido e a entrada some. Um arquivo parcial em um host é removido na próxima vez que os arquivos desse host forem abertos; um em um host usado só por conexão rápida não é acompanhado e precisa ser removido manualmente.

• Padrão: 7 dias. Pode ser de 0 a 365.
• Exemplo: 0 (mostrado como “Nunca”) mantém as transferências inacabadas até você descartá-las.
• Atenção: Descartar remove o que foi copiado até então; a transferência recomeça do início.

Mover arquivos excluídos para a lixeira

settings.sftp.trash · Só no computador

Excluir arquivos ou pastas em um host os move para uma pasta chamada .sternway-trash na sua pasta pessoal nesse host, onde a Lixeira (no menu do painel) os lista com Restaurar e Excluir permanentemente. Mover é uma renomeação no host: nada é copiado, então uma pasta grande vai na hora. Os arquivos neste computador não são afetados.

• Padrão: Ativado.
• Atenção: Os itens na lixeira continuam ocupando espaço no host até você esvaziá-la. Um item em um disco diferente do da sua pasta pessoal não pode ser movido para lá; nesse caso, você é perguntado se quer excluí-lo de vez. Desativado: excluir remove os arquivos de vez, sem volta.

Pasta de download

settings.sftp.downloadDir · Só no computador

Onde Baixar coloca os arquivos neste computador e onde o painel local abre. Definido por computador. Sem pasta definida, Baixar pede uma a cada vez, começando na sua pasta Downloads, e o painel local abre na sua pasta pessoal.

• Padrão: Nenhuma: perguntar a cada vez.

Abrir com

settings.sftp.openWith · Só no computador

Qual programa “Abrir com” inicia para uma extensão de arquivo. Digite a extensão (com ou sem o ponto; maiúsculas não importam) e o programa: o caminho completo ou um comando no seu PATH. O programa recebe o arquivo baixado como único argumento. No Windows, deve ser um programa (.exe), não um iniciador .cmd ou .bat.

• Padrão: Nenhum programa definido.
• Exemplo: .log → /usr/bin/code, ou .log → C:\Windows\System32\notepad.exe

Configurações: Segurança

Onde: Configurações › Segurança.

Bloqueio automático

settings.security.autoLockMinutes

Bloqueia o app depois deste tempo sem uso, quando há um bloqueio do app definido. As sessões continuam rodando por trás do bloqueio. De 0 a 1440 minutos; 0 desativa o bloqueio automático.

• Padrão: 5 minutos.

Bloquear quando o sistema entrar em suspensão

settings.security.lockOnSleep

No desktop: bloquear o app quando o computador entra em suspensão ou a tela é bloqueada. No celular: bloquear assim que você sai do app. Só tem efeito quando há um bloqueio do app definido.

• Padrão: Ativado.

Limpar a área de transferência após copiar um segredo

settings.security.clipboardClearSec

Quando você copia uma senha ou outro segredo do app, a área de transferência é esvaziada depois deste tempo, se ainda contiver esse segredo. De 0 a 3600 segundos; 0 nunca a limpa.

• Padrão: 60 segundos.
• Atenção: “Nunca” deixa os segredos copiados na área de transferência, onde outros apps e gerenciadores de área de transferência podem lê-los. Uma chave privada copiada é apagada em até 60 segundos no desktop de qualquer forma.

Sincronizar chaves e identidades

settings.sync.syncCredentials

Se as chaves privadas, identidades, certificados e senhas salvas do seu cofre pessoal vão para seus outros dispositivos, criptografados, pelo seu servidor. Os cofres de equipe sempre são sincronizados. Esta opção é por dispositivo.

• Padrão: Ativado.
• Atenção: Desativado significa que essas chaves e senhas existem só neste dispositivo: se perder o dispositivo, elas se perdem.

Verificar vazamentos de novas senhas

settings.security.leakedPasswordCheck

Ao definir a senha da conta, verifica se ela aparece em vazamentos de dados conhecidos. Só os 5 primeiros caracteres de uma forma embaralhada da senha (o hash) são enviados a api.pwnedpasswords.com, que responde com todos os hashes vazados que começam assim; a comparação é feita aqui, e a senha em si nunca sai do dispositivo. Uma correspondência só gera um aviso.

• Padrão: Desativado.

Bloquear capturas de tela

settings.security.blockScreenshots · Só no celular

No Android, bloqueia capturas e gravações de tela em todo o app e oculta a prévia dele no seletor de apps. Uma chave privada sendo importada, o kit de recuperação e a tela de bloqueio ficam protegidos mesmo com isto desativado.

• Padrão: Desativado.

Configurações: IA

Onde: Configurações › IA.

Assistente de IA

settings.aiEnabled

Mostra os controles de IA: “Escrever um comando” e “Explicar ou perguntar” no terminal, e “Gerar” no editor de snippets. Nada é enviado a lugar nenhum até você usar um deles, e é preciso um provedor abaixo.

• Padrão: Desativado.

Sempre mostrar uma prévia antes de enviar

settings.ai.previewBeforeSend

Antes de cada pedido à IA, mostra exatamente o que será enviado: seu pedido e o texto do terminal selecionado, se houver, com os segredos já substituídos por [REDACTED]. Com eles vão as instruções fixas do Sternway para o pedido e, quando o pedido os leva, o sistema e o shell do host. Nada sai até você tocar em Enviar. Os segredos são ocultados neste dispositivo com isto ligado ou não: senhas, chaves e tokens pela aparência, e as senhas, chaves privadas, frases secretas e chaves de API salvas nos seus cofres pelo valor exato.

• Padrão: Ativado.
• Atenção: Desligado, o pedido sai assim que você pergunta. A ocultação não conhece um segredo que nunca viu: um que não está salvo em nenhum cofre e não parece um segredo é enviado como foi digitado.

Usar um provedor de IA

settings.ai.enable

Conecta o assistente a um modelo que você escolher, com sua própria chave de API ou seu próprio servidor. Definido por dispositivo.

• Padrão: Desativado.
• Atenção: Desativar esquece o endereço, o modelo e a chave de API salva.

Provedor

settings.ai.kind

Qual serviço responde. “Anthropic” e “OpenAI” usam as APIs dessas empresas; “OpenAI” também serve para a maioria dos servidores locais e auto-hospedados (Ollama, LM Studio, OpenRouter). “Sternway” usa a IA do servidor em que você entrou e não precisa de chave.

• Padrão: Anthropic.

URL base

settings.ai.baseUrl

O endereço da API do provedor. O app procura em /v1, a menos que o endereço já tenha uma versão no caminho, como /v1 ou /v1beta. Um endpoint completo colado (terminando em /chat/completions, /messages ou /models) é reduzido à base. 0.0.0.0 é acessado como 127.0.0.1.

• Padrão: https://api.anthropic.com ou https://api.openai.com, conforme o provedor.
• Exemplo: https://api.openai.com, ou http://localhost:1234 para um modelo neste computador
• Atenção: O http:// simples só é aceito para este dispositivo e redes privadas; por ele, sua chave e seus prompts trafegam sem criptografia.

Modelo

settings.ai.model

O nome exato do modelo a consultar, como o provedor o lista. “Testar conexão” mostra os nomes que o provedor oferece.

• Exemplo: claude-sonnet-5-5, ou o nome que seu servidor local listar

Chave de API

settings.ai.apiKey

O segredo que seu provedor deu a você para cobrar e autorizar as requisições. Um servidor local geralmente não precisa de nenhum.

• Atenção: Armazenada só neste dispositivo, sem sincronização. No desktop, nunca é exibida de novo depois de salva; digite uma nova chave para substituí-la.

Configurações: Atualizações, Logs, Perfis

Onde: Configurações › Atualizações, Logs, Perfis (computador).

Permitir verificação de atualizações

settings.updater.enabled · Só no computador

Permite que o botão “Verificar atualizações” abaixo pergunte ao seu feed de atualizações se existe uma versão mais nova. O app nunca verifica sozinho, nem ao iniciar nem depois: uma verificação só acontece quando você pressiona o botão. Nada é baixado ou instalado; uma versão mais nova é mostrada com um link para a página de download.

• Padrão: Desativado.

URL do feed de atualizações

settings.updater.feedUrl · Só no computador

O endereço https do feed de atualizações assinado publicado por quem compila a sua cópia do Sternway. A assinatura do feed é verificada com uma chave embutida no app.

• Padrão: Nenhuma.
• Exemplo: https://updates.example.com/sternway.json

Registrar sessões em …

settings.logging.vault · Só no computador

Registra o que as sessões dos hosts deste cofre exibem, para você ler depois em Logs. Um host pode optar por não participar, e sessões Mosh nunca são registradas. Em um cofre compartilhado, a opção vale para todos que o usam. Os logs ficam no dispositivo que os registrou, a menos que “Sincronizar logs de sessão” esteja ativado.

• Atenção: Desativar exclui todos os logs já armazenados do cofre, neste dispositivo e no servidor. Um log contém o que apareceu na tela, inclusive segredos que um comando tenha impresso.

Sincronizar logs de sessão

settings.sync.syncLogs

Se os logs de sessão que este dispositivo registra saem dele. Desativado, um log e o que ele registrou ficam só neste dispositivo. Ativado, enquanto você estiver na conta, os logs dos seus cofres sincronizados são enviados ao seu servidor criptografados com a chave do cofre e podem ser lidos nos seus outros dispositivos e, no caso de um cofre de equipe, pelos membros dele. Esta opção é por dispositivo. Logs que outro dispositivo escolheu sincronizar continuam sendo recebidos aqui de qualquer forma.

• Padrão: Desativado.
• Atenção: Um log contém o que apareceu na tela, inclusive segredos que um comando tenha impresso. Desativar isto depois impede o envio de novos logs; os que já estão no servidor ficam lá até você excluí-los.

Mostrar minha atividade para minha equipe

settings.team.sharePresence

Enquanto isto estiver ativado e você estiver conectado a um host que fica em um cofre de equipe, os outros membros desse cofre veem que você está nele (suas iniciais no host). Só o ID do host e o ID do cofre são enviados, pelo seu servidor de sincronização, e só para membros que podem abrir esse cofre; nada sobre o que você digita ou vê. Isso é esquecido até um minuto depois que você se desconecta. Hosts do seu cofre pessoal nunca são informados. Você continua vendo a atividade dos colegas quando isto está desativado.

• Padrão: Ativado.
• Atenção: Desativado: nada sobre sua atividade é enviado. O que já tinha sido mostrado é retirado na hora.

Nome do novo perfil

settings.profileName · Só no computador

Um perfil é uma cópia totalmente separada dos dados do app: seus próprios hosts, chaves, conta e configurações. Use um para o trabalho e outro para casa. Até 64 caracteres, no máximo 32 perfis.

• Exemplo: Trabalho

Configurações: Notificações

Onde: Configurações › Notificações.

Notificações

settings.notifications.enabled

A chave geral. Ativada, o Sternway lista o que aconteceu no sino e entrega ao sistema, como notificações, os tipos ativados abaixo. Desativada, nada é listado nem mostrado, com uma exceção: uma chave de host alterada ou uma conexão recusada por motivos de segurança continua sendo listada no sino.

• Padrão: Ativado.

Também quando o Sternway estiver em primeiro plano

settings.notifications.whenInFront

Normalmente, uma notificação do sistema só aparece quando você não está olhando: o app está atrás de outra janela (no celular: fora da tela) ou a sessão de que ela trata está em outra aba. Ative isto para receber a notificação do sistema sempre.

• Padrão: Desativado.

Tocar um som

settings.notifications.sound · Só no computador

Se uma notificação do sistema toca o som de notificação do sistema. O sistema ainda pode silenciá-la (Não perturbe, Assistente de foco).

• Padrão: Ativado.

Ocultar detalhes nas notificações do sistema

settings.notifications.hideDetails

Uma notificação do sistema passa a dizer só que tipo de coisa aconteceu (“Atividade do terminal”, “Uma sessão precisa de atenção”): sem nome de host, sem nome de arquivo e sem texto de um terminal. A lista no sino continua com os detalhes. Na tela de bloqueio do Android, o texto de uma notificação fica oculto de qualquer forma; com isto ativado, o nome do host também fica oculto ali.

• Padrão: Desativado: o nome do host aparece, inclusive na tela de bloqueio.
• Atenção: Uma linha correspondente ou uma mensagem de um programa remoto pode mostrar o que essa linha disser. Senhas, chaves e tokens que o Sternway reconhece são substituídos, mas ele não tem como conhecer todos os segredos.

Horário de silêncio

settings.notifications.quietHours

Um período do dia em que nenhuma notificação do sistema é exibida nem toca. O que acontecer nesse meio-tempo continua listado no sino.

• Padrão: Desativado.
• Exemplo: Das 22:00 às 07:00.

Silêncio a partir de

settings.notifications.quietFrom

Quando o horário de silêncio começa, no seu horário local. Um início posterior ao fim significa que o período passa da meia-noite.

• Padrão: 22:00.

Silêncio até

settings.notifications.quietUntil

Quando o horário de silêncio termina, no seu horário local. O mesmo horário do início significa nenhum horário de silêncio.

• Padrão: 07:00.

Comando demorado

settings.notifications.longCommandSec

“Notificar-me quando este comando terminar” só avisa sobre um comando que rodou pelo menos este tempo, para que cada ls não gere uma notificação. De 1 a 3600 segundos.

• Padrão: 10 segundos.

Em silêncio por

settings.notifications.quietMin

“Notificar-me quando ficar em silêncio” avisa quando uma sessão não exibe nada por este tempo: um build que terminou sem prompt, um download que travou, um programa parado esperando. Uma notificação por período de silêncio; uma nova saída reinicia a contagem. De 1 a 240 minutos.

• Padrão: 5 minutos.

Uma sessão foi desconectada

settings.notifications.sessionDisconnected

Uma sessão que estava conectada perdeu a conexão sem que você a fechasse. Avisado uma vez, também enquanto o Sternway tenta reconectar; a notificação tem Reconectar.

• Padrão: Ativado.

Uma sessão se reconectou

settings.notifications.sessionReconnected

A reconexão automática recuperou uma sessão que tinha caído. Desativado por padrão, porque a sessão simplesmente volta a funcionar.

• Padrão: Desativado.

Falha ao reconectar

settings.notifications.sessionReconnectFailed

O Sternway parou de tentar reconectar uma sessão que caiu porque uma tentativa precisa de você: a chave do host foi recusada, ou o login foi cancelado ou precisa de uma resposta. A notificação tem Reconectar.

• Padrão: Ativado.

Uma transferência terminou

settings.notifications.transferFinished

Uma transferência de arquivo terminou enquanto você não estava olhando (o Sternway não estava em primeiro plano) ou depois de rodar por mais de 10 segundos. Várias que terminam juntas geram uma só notificação.

• Padrão: Ativado.

Uma transferência falhou

settings.notifications.transferFailed

Uma transferência de arquivo parou com um erro. A notificação diz o motivo e tem Tentar de novo.

• Padrão: Ativado.

Uma transferência precisa de resposta

settings.notifications.transferNeedsAnswer

Uma transferência está esperando você dizer o que fazer com um arquivo que já existe. Ela permanece até você responder.

• Padrão: Ativado.

Uma regra de encaminhamento de porta parou

settings.notifications.forwardStopped

Uma regra que estava rodando parou sozinha (a conexão dela foi perdida), ou uma regra não conseguiu iniciar. Uma regra que você mesmo para não gera aviso.

• Padrão: Ativado.

Uma regra de encaminhamento de porta iniciou sozinha

settings.notifications.forwardAutoStarted

Uma regra configurada para iniciar com o app, ou com a conexão do host dela, foi iniciada.

• Padrão: Desativado.

A sincronização requer atenção

settings.notifications.syncFailed

A sincronização parou de um jeito que não se resolve sozinho: a senha foi alterada em outro lugar, este dispositivo foi removido da conta ou o servidor recusa. Estar offline não é isso; isso aparece na barra lateral.

• Padrão: Ativado, enquanto você estiver na conta.

Um novo dispositivo entrou na conta

settings.notifications.newDevice

Um dispositivo que não estava na sua conta agora está nela. O Sternway descobre isso na próxima vez que este dispositivo consultar a conta (depois de uma sincronização e a cada 15 minutos enquanto está rodando), não no momento em que acontece.

• Padrão: Ativado, enquanto você estiver na conta.
• Atenção: Se não foi você, revogue o dispositivo em Conta › Dispositivos e altere sua senha.

Adicionado a uma equipe

settings.notifications.teamJoined

Sua conta está em uma equipe em que não estava antes. O convite em si chega por e-mail e não pode ser mostrado aqui: o app só fica sabendo de uma equipe depois que você é membro.

• Padrão: Ativado, enquanto você estiver na conta.

Acesso à equipe alterado

settings.notifications.teamAccessChanged

Sua função em uma equipe mudou, você recebeu a oferta de ser proprietário dela, ou seu acesso a um dos cofres dela foi concedido, alterado ou retirado.

• Padrão: Ativado, enquanto você estiver na conta.

Removido de uma equipe

settings.notifications.teamRemoved

Sua conta não está mais em uma equipe; os cofres dela foram removidos deste dispositivo.

• Padrão: Ativado, enquanto você estiver na conta.

Uma sessão compartilhada precisa de resposta

settings.notifications.shareRequest

Alguém está esperando para entrar em uma sessão que você compartilha, ou pede para digitar nela.

• Padrão: Ativado.

Uma atualização está disponível

settings.notifications.appUpdate · Só no computador

Uma versão mais nova do Sternway foi encontrada. Só enquanto a verificação de atualizações estiver ativada em Configurações › Atualizações; o Sternway então verifica uma vez por dia.

• Padrão: Ativado.

Transferências inacabadas ao iniciar

settings.notifications.unfinishedTransfers

Quando o app abre e encontra transferências que uma execução anterior deixou inacabadas, avisa uma vez, para que possam ser retomadas ou descartadas.

• Padrão: Ativado.

Bloqueado durante transferências

settings.notifications.lockedWithTransfers

O app foi bloqueado enquanto ainda há transferências de arquivos em andamento. Elas continuam por trás do bloqueio.

• Padrão: Desativado.

Nome da regra

settings.notifications.ruleName

Como a notificação se chama quando a regra corresponde (“Erros encontrados em web-01”). Até 60 caracteres.

• Exemplo: Erros

A linha corresponde a

settings.notifications.rulePattern

Uma expressão regular. Uma sessão que tem “quando uma linha corresponder” ativado notifica quando uma linha da saída corresponde a ela. A notificação mostra só a linha correspondente, encurtada, com as senhas, chaves e tokens que o Sternway reconhece substituídos. Um padrão que poderia levar uma eternidade em algumas linhas (uma repetição dentro de outra, como (a+)+) é recusado, só os primeiros 1.000 caracteres de uma linha são examinados, e uma regra que se revela lenta é desativada até você alterá-la.

• Exemplo: error|failed (qualquer uma das palavras), ou ^Deploy finished (uma linha que começa com isso).
• Atenção: Linhas dentro de um programa de tela cheia (um editor, um paginador) não são comparadas.

Diferenciar maiúsculas e minúsculas

settings.notifications.ruleCase

Ativado, o padrão só corresponde a texto com as mesmas maiúsculas e minúsculas. Desativado, ERROR, Error e error são iguais.

• Padrão: Desativado.

Configurações: Tokens da CLI

Onde: Configurações › Tokens da CLI (computador).

Nome do token

settings.cli.tokenName · Só no computador

Para que serve o token, para você saber qual revogar depois: o script, a máquina ou a tarefa que o usa. Até 64 caracteres. O nome nunca faz parte do token em si.

• Exemplo: Script de backup no build-01

Listar hosts

settings.cli.scope.hosts · Só no computador

Permite que sternway-cli hosts liste seus hosts salvos: o nome, o endereço e o id de cada um. Nada mais sobre um host é entregue: nem nome de usuário, nem senha, nem chave, nem nota.

Abrir terminais

settings.cli.scope.connect · Só no computador

Permite que sternway-cli connect <host> abra neste app um terminal para um host salvo, como se você tivesse clicado duas vezes nele. O terminal abre no app, na sua frente: o comando não pode digitar nele nem lê-lo.

Executar snippets

settings.cli.scope.run · Só no computador

Permite que sternway-cli run <snippet> --hosts … execute um dos seus snippets salvos nos hosts indicados e mostre o que cada host imprimiu, como Snippets › Executar em hosts (a execução também aparece no app). Só executa snippets salvos, nunca um comando inventado pelo script; uma nota nunca é executada.

• Atenção: Quem tiver o token pode executar qualquer um dos seus snippets salvos em qualquer um dos seus hosts. Entregue-o só a um script de confiança, e só pelo tempo necessário.

Copiar arquivos (SFTP)

settings.cli.scope.sftp · Só no computador

Permite que sternway-cli cp copie um arquivo de um host para uma pasta deste computador ou (se o token não for somente leitura) deste computador para uma pasta de um host, pelo SFTP do host. Um arquivo que já existe fica como está, a menos que o comando diga –overwrite.

• Atenção: Uma cópia para um host pode substituir arquivos nele com –overwrite. Marque também Somente leitura se o script só precisa buscar arquivos.

Somente leitura

settings.cli.scope.readOnly · Só no computador

Limita as outras escolhas ao que não muda nada: listar hosts e copiar arquivos de um host. Com ela, o token nunca pode abrir um terminal, executar um snippet nem copiar um arquivo para um host nem substituir um arquivo deste computador (–overwrite), mesmo com essas opções marcadas. Não é uma permissão por si só: sozinha, não permite nada.

Pasta de arquivos

settings.cli.folder · Só no computador

A única pasta deste computador para onde vão os downloads do token e de onde saem os seus envios; escolhida ao criá-lo. Tudo fica dentro dela: sem caminhos com .., sem links simbólicos, sem arquivos nem pastas ocultos (nomes que começam com ponto). Assim um token nunca pode criar ~/.ssh/authorized_keys, /.bashrc ou uma entrada de inicialização automática, nem enviar uma chave privada. A pasta é criada com 0700. Precisa ser uma pasta nova ou vazia (ou a de outro token): nunca a pasta pessoal, uma pasta acima dela nem uma pasta que os programas leem (/.config, ~/Library, %APPDATA%).

• Padrão: Sternway dentro da sua pasta Downloads.

Expira após

settings.cli.expiry · Só no computador

Quando o token para de funcionar sozinho. Todo token expira; um ano é o máximo. Depois disso, o comando é recusado e você cria um novo token. Você pode revogar um token a qualquer momento antes.

• Padrão: 30 dias.