Configurações
As Configurações abrem em uma janela sobre seus espaços de trabalho, e seus terminais continuam rodando por trás dela. Esta página percorre cada categoria na ordem em que o app as lista.
Abrir as Configurações
Pressione Cmd+, (Ctrl+, no Windows) ou clique em Configurações na parte de baixo da barra lateral. A janela abre em Appearance. Alguns botões em outros lugares abrem outra categoria: o link de configurações no popover do Token Meter abre Token Meter, o botão Inserir chave de licença no aviso de upgrade abre License & Activation, e a engrenagem no cabeçalho de Máquinas e o ícone de chave na barra de título (exibido enquanto a senha de acesso está ativa) abrem Remote Access & Devices. Feche com Esc, com o botão × ou clicando fora da janela.
| Categoria | O que ela reúne |
|---|---|
| Geral | Se o MXterm Pro abre quando você entra no computador |
| Appearance | Idioma da interface (onze opções), contraste do texto, escurecimento de painéis inativos, cor do painel em foco, modo claro ou escuro, tema |
| Terminal | Fonte e texto, copiar ao selecionar, shell padrão, diretório de trabalho do SSH, linha de status do Claude Code, visão de chat |
| Agentes | Quais CLIs de agentes estão instaladas e se a Control Room (antes War Room) e o MCP estão configurados para cada uma |
| Notifications | Som, banners e o selo do Dock, quais eventos notificam e a opção de ligar ou desligar por agente |
| Token Meter | Qual provedor fica fixado primeiro, os limites do plano para Claude e Codex e as chaves de API para ver o saldo das contas |
| Shortcuts | A lista de atalhos de teclado com caixa de busca, redefinição de atalhos e Restaurar todos os padrões. Veja Atalhos de teclado |
| Conta | Entrar na sua conta MXterm e aprovar os dispositivos que pedem para entrar nela |
| License & Activation | Ativar uma licença Pro neste computador, com uma chave ou com a sua conta MXterm, e liberar a vaga dele |
| Remote Access & Devices | Compartilhar os painéis deste computador com dispositivos pareados: o servidor host, a chave da rede local, iniciar com o app e impedir que o computador entre em repouso, o código de pareamento, a senha de acesso, os dispositivos pareados, por quanto tempo as imagens recebidas de outros dispositivos são mantidas |
| Meus dispositivos | Abrir seus outros Macs conectados à mesma conta, sem código de pareamento nem senha (Pro) |
| Privacidade | O relatório de uso e o arquivo de diagnóstico |
| Feedback | Enviar por e-mail uma sugestão, uma ideia de recurso ou um relatório de bug |
| Updates & About | Sua versão e o número do build, verificação de atualizações, uma prévia do cartão de atualização, licenças de código aberto |
A maioria dos nomes de categoria aparece em inglês em todos os idiomas da interface. Geral, Agentes, Conta, Meus dispositivos, Privacidade e Feedback têm tradução própria: a interface em vietnamita mostra Chung, Agents (sem mudança), Tài khoản, Máy của tôi, Quyền riêng tư e Góp ý.
Geral
Há uma única configuração: Abrir ao iniciar sessão, que inicia o MXterm Pro quando você entra no computador. O interruptor reflete o que o seu sistema operacional tem registrado no momento. Se você o desligar em outro lugar, como nos Ajustes do Sistema do macOS, isso aparece aqui.
Appearance
| Configuração | Opções | Padrão |
|---|---|---|
| Display Language / Ngôn ngữ | English, Bahasa Indonesia, Tiếng Việt, 简体中文, 日本語, 한국어, Español, Français, Türkçe, Português (Brasil), Deutsch | O primeiro idioma da lista de idiomas do seu sistema que o MXterm Pro tem; se nenhum, inglês |
| Contraste mínimo do texto | Desligado (tema como vem de fábrica), 3:1, 4.5:1, 7:1 | 4.5:1 |
| Escurecer painéis inativos | Um controle deslizante de Desligado a 70%, com um botão Padrão | 40% |
| Cor do painel em foco | Branco suave, Cinza claro, Azul, Verde, Violeta, Âmbar, Vermelho | Branco suave |
| Tema | MXterm Classic, MX Dark Pro, MXterm Midnight, Tokyo Night, Catppuccin Macchiato, One Dark Pro, MXterm Ember, Solarized Dark, MXterm Black, MXterm Slate | MXterm Classic |
O Contraste mínimo do texto clareia as cores do terminal que ficam perto demais do fundo, e o resto da paleta do tema continua como está. A Cor do painel em foco é a cor da borda que marca o painel ativo, e o Escurecer painéis inativos define o quanto os outros painéis esmaecem. Um painel sozinho na aba nunca é escurecido. O MXterm Black e o MXterm Slate não esmaecem os painéis inativos para cinza: eles os escurecem com preto, e o mesmo controle deslizante define o quanto. Todos os dez temas são escuros. O tema vale para a barra lateral, as abas e todos os painéis de terminal, e você o escolhe à mão.
Display Language / Ngôn ngữ é um menu só: ele mostra o idioma atual e, ao abri-lo, lista os onze. Inglês, indonésio, vietnamita e chinês vêm primeiro, depois japonês, coreano, espanhol, francês, turco, português (Brasil) e alemão. Cada linha mostra o nome do idioma na própria língua, com o nome em inglês esmaecido ao lado quando os dois diferem, e uma marca indica o idioma atual. Não há bandeiras. Chinês simplificado, japonês, coreano, espanhol, francês e turco foram adicionados na 1.1.11, e indonésio, português (Brasil) e alemão depois disso. A escolha vale na hora.
Terminal
| Configuração | Opções | Padrão |
|---|---|---|
| Fonte (em Texto) | Padrão (Monaco), System Monospace, Menlo, Monaco e outras fontes do Mac, Consolas no Windows e DejaVu Sans Mono e Ubuntu Mono no Linux (a lista mostra todas em qualquer sistema, cada uma marcada com a sua plataforma); JetBrains Mono, Fira Code e Cascadia Code se você as instalar; Custom… para o nome de qualquer família de fonte | Padrão (Monaco) |
| Tamanho | 8 a 32 px | 12 px |
| Altura da linha | 1.0 a 2.0 | 1.14 |
| Colunas mínimas | Desligado (0), ou de 10 a 200 em passos de 10 | 80 |
| Ligaduras | Ligadas ou desligadas. Só funciona com uma fonte com ligaduras, como JetBrains Mono, Fira Code ou Cascadia Code | Desligadas |
| Copiar ao selecionar | Ligado, desligado. Copia para a área de transferência o texto do terminal que você destacou | Desligado |
| Shell | No macOS: Padrão, zsh, bash, fish. No Windows: Padrão (PowerShell), PowerShell, Prompt de Comando e, quando instalados, PowerShell 7, Git Bash e WSL. Um shell que não está instalado aparece esmaecido | Padrão |
| Diretório de trabalho padrão do SSH | Diretório pessoal (~), Caminho de diretório personalizado | Diretório pessoal (~) |
| Manage Claude Code's status line (na seção Linha de status do agente) | Ligado, desligado | Ligado |
| Visão de chat (experimental) | Ligada, desligada | Desligada |
As configurações de texto valem de imediato para os terminais abertos, e Restaurar o padrão as devolve ao original. No macOS, as fontes que o computador não tem aparecem marcadas como não instaladas na lista. No Windows o app não consegue ler a lista de fontes instaladas, então cada fonte citada aparece marcada como disponibilidade desconhecida. Shell só afeta os painéis criados depois da mudança; os terminais em execução mantêm o shell que já têm.
Colunas mínimas impede que um programa seja espremido. Um painel mais estreito que esse número de colunas mostra texto menor, em passos de meio pixel, para que o programa continue recebendo essas colunas; um programa em tela cheia que foi informado de que o painel tem 13 colunas quebra a saída nessa largura, e a quebra permanece quando o painel é alargado de novo. O texto volta a crescer quando o painel fica largo o bastante, e nunca passa de Tamanho (ou do zoom do próprio painel). Se ajustar as colunas exigir texto menor que 8 px, o painel não é reduzido e o programa recebe o número real de colunas, como com a configuração desligada. Ela vem ativada por padrão, em 80, e vale para painéis deste computador. Diminua em passos de 10, até Desligado (0), para desativá-la. Restaurar o padrão a devolve a 80.
O Diretório de trabalho padrão do SSH define onde começa uma conexão aberta pelo SSH & SFTP Manager. Um diretório padrão salvo no próprio host tem prioridade. O Remember Last Session Directory foi removido na 1.0.22: ele sempre se comportou como o Diretório pessoal (~), porque o app nunca registrou um último diretório. Veja SSH e SFTP.
Com o Manage Claude Code's status line ligado, o app grava uma entrada statusLine em ~/.claude/settings.json, e os painéis do Claude Code passam a mostrar se o Claude Code chegou ao servidor MCP do MXterm Pro e quanto do contexto da sessão está em uso. Se você já tem uma linha de status personalizada, ela não é alterada.
Com a Visão de chat (experimental) ligada, os painéis que executam Claude Code, Codex, omp ou Grok podem alternar entre o terminal e um chat legível da conversa, lido do arquivo de transcrição do próprio agente. Alterne um painel pelo cabeçalho dele ou com Cmd+Shift+J (Ctrl+Shift+J no Windows). Um novo painel de agente abre na visão que você escolheu por último, que é o chat até você escolher o Terminal, e cada painel guarda a visão em que estava por último. O chat é uma camada por cima, então alternar nunca mexe no programa em execução.
Agentes
Agentes tem uma linha para cada um dos 27 agentes de código que o MXterm Pro pode iniciar, listados na página Agentes. Atualizar faz uma nova verificação. Cada linha mostra:
- Instalado ou Não instalado. O MXterm Pro procura o executável do agente nos mesmos lugares que o Composer do espaço de trabalho. Ele só olha os nomes dos arquivos nessas pastas e nunca executa o programa. No Cursor Agent o arquivo é
cursor-agent, e nãocursor, que é o launcher do editor. - Se o agente chegou à Control Room: Fora de uma Control Room,
N panes in a room · M connectedou Em uma sala, mas ainda não chamou o MXterm. Os painéis são contados pelo agente com que foram abertos, então um shell comum em que você digitou o nome do agente por conta própria não entra na conta. - Se o MXterm Pro configura suas ferramentas MCP para aquele agente: O MXterm configura suas ferramentas para este agente (Claude Code, Codex, Gemini CLI, Grok e OMP) ou Configuração de ferramentas não verificada para os outros, que podem precisar da configuração manual descrita em Agentes de código e Control Room.
- A Flag para ignorar permissões que o Bypass Mode adiciona, para os agentes que têm uma. Para o Goose, que não tem flag, a linha mostra no lugar a variável de ambiente
GOOSE_MODE=auto. - Para um agente que não está instalado, Como instalar abre o comando de instalação com Copiar comando e um link para a página do fornecedor. O MXterm Pro nunca executa a instalação por você. Os agentes cujo fornecedor não dá nenhum comando de instalação, como Amp, Cursor Agent, Antigravity e Aider, mostram no lugar um link para a página do fornecedor.
Worktrees criados pelo MXterm é um cartão na tela Agentes. Ele lista as pastas em .worktrees/ que o MXterm criou para agentes ou abas isoladas, encontradas pelas suas pastas recentes. Clique em Mostrar lista para carregá-la: nada é analisado em segundo plano e nada é removido automaticamente. Cada linha mostra o branch, o caminho, o tamanho, há quanto tempo a pasta mudou e uma etiqueta: Seguro para remover, Alterações não confirmadas, Não mesclado ou Em uso (há um painel aberto nela, então feche o painel primeiro). Remover pede confirmação, e pede uma segunda vez quando alterações não confirmadas ou commits não mesclados seriam perdidos; o branch sempre é mantido. Limpar entradas obsoletas aparece quando o git ainda lista um worktree cuja pasta sumiu.
Mostrar contas conectadas vem desligado por padrão. Ligado, o MXterm Pro lê o e-mail da conta no arquivo do próprio agente (~/.claude.json, ~/.codex/auth.json, ~/.gemini/google_accounts.json e ~/.grok/auth.json; o Claude Code e o Codex seguem CLAUDE_CONFIG_DIR e CODEX_HOME quando definidos) e o mostra na linha desse agente, ou Nenhuma conta encontrada. Só o e-mail é lido: nunca um token, e nunca o Keychain. Ao desligar, os e-mails saem da memória na hora.
Notifications
| Configuração | Padrão | O que faz |
|---|---|---|
| Notificações de agentes | Ligado | É o interruptor geral. Desligado, o aviso sonoro, os banners e o selo do Dock ficam em silêncio |
| Notificações sonoras | Ligado | Toca um som quando um agente está bloqueado ou termina uma tarefa |
| Notificações do sistema na área de trabalho | Ligado | Mostra um banner do sistema; ao clicar nele, esse painel é aberto |
| Só com o MXterm Pro em segundo plano | Desligado | Desligada, você também recebe um banner de um painel em outra aba enquanto trabalha nesta janela |
| Mostrar texto do terminal nos banners | Desligado | Acrescenta o título do terminal do agente ao texto do banner |
| Selo do Dock | Ligado | A contagem de painéis esperando por você. Somente no macOS; no Windows o interruptor não tem efeito |
| Avisar quando | Os três ligados | Um agente terminar, Um agente precisar de você, Um agente parar inesperadamente |
| Notificações por agente | Ligado para cada agente | Uma opção para cada agente liga ou desliga os alertas separadamente: Claude Code, Codex, OpenCode, Qwen Code, Gemini CLI, Cursor Agent, OMP, Grok e Goose |
Só os nove agentes cujo estado o MXterm Pro consegue ler aparecem na lista por agente. Painéis de shell comum não enviam notificações. O que um banner diz e para onde um clique leva você está em Agentes de código e Control Room.
Token Meter
Fixado no topo vem primeiro. É um menu que escolhe qual provedor o popover do Token Meter lista primeiro: Claude Code, Codex, Gemini, Outros agentes, DeepSeek, Moonshot, Kimi, MiniMax, OpenRouter ou Z.ai, ou Nenhum (ordem fixa). O Claude Code vem fixado por padrão. O popover continua listando todos os provedores que você configurou, e o valor na barra de título não segue o que está fixado: ele continua seguindo o limite mais perto de acabar.
Em Limites do plano há dois interruptores, ambos desligados por padrão.
- Mostrar as porcentagens reais de limite do Claude: o app lê o login do Claude Code no Keychain do macOS por meio da ferramenta
securitydo sistema, então o macOS não pergunta a cada vez, e chamaapi.anthropic.compara ler o uso do seu plano. O token fica só na memória, e suas transcrições não são enviadas. Com o interruptor desligado, o medidor mostra os tokens usados em vez de uma porcentagem. Se o macOS recusar a leitura, o interruptor fica desligado até você ligá-lo de novo. Se o Claude Code não estiver conectado neste Mac, executeclaudeem um terminal para entrar e tente de novo. Iniciar o MXterm Pro comMXTERM_DISABLE_KEYCHAIN=1bloqueia a leitura, seja qual for o estado do interruptor, para máquinas em que acessar o item do keychain de outro app não é permitido. Isso funciona só no macOS. O interruptor ainda aparece no Windows, mas o app não consegue ler o login do Claude Code lá, então informa que o Claude Code não está conectado, esteja ele ou não. - Limites do Codex em tempo real: o app lê o login do ChatGPT do próprio Codex em
~/.codex/auth.jsone o envia somente parachatgpt.com. Ele nunca altera nem renova esse login, e um login que o Codex guarda no keychain do sistema não é lido, então executecodex loginse a tela disser que não há nenhum. Com o interruptor desligado, os limites do Codex ainda aparecem, lidos dos arquivos de sessão dele nesta máquina, portanto só tão atuais quanto o seu último turno no Codex.
Mais abaixo, Provedores de conta aceita uma chave de API para DeepSeek, Moonshot, Kimi, MiniMax, OpenRouter e Z.ai, para que o medidor mostre o que sobrou nessas contas. Cole uma chave e clique em Salvar; a linha então mostra Chave salva · …abcd, com os quatro últimos caracteres, e Remover apaga a chave. Moonshot, MiniMax e Z.ai também têm um menu Região: Internacional ou China para a Moonshot, Global ou China para a MiniMax e a Z.ai, com a primeira opção como padrão. Na Z.ai, uma chave só funciona na própria região. Se a CLI do Kimi Code já estiver conectada neste computador, a linha do Kimi aproveita esse login em ~/.kimi-code e avisa; uma chave que você colar tem precedência. A tela informa para onde as chaves vão: As chaves ficam no macOS Keychain e são enviadas apenas a esse provedor. No Windows as chaves são guardadas pelo repositório de credenciais do sistema, e não pelo Keychain do macOS, embora o texto da tela ainda diga macOS Keychain.
O que o próprio medidor mostra está em Token Meter.
Conta
Conta é onde você entra na sua conta MXterm. Sem login, o cartão mostra Conta MXterm, com a linha Entre para ver e controlar suas outras máquinas sem configurar um compartilhamento toda vez. e um botão Entrar com a conta MXterm. O botão abre o navegador e mostra Aguardando o navegador… até você terminar. Se falhar, o cartão diz Não foi possível entrar: seguido do motivo. Com o login feito, o cartão mostra Conectado como e o seu e-mail, com um botão Sair.
Enquanto você está conectado, um cartão Dispositivos aguardando para entrar lista os dispositivos que pediram para entrar nesta conta. Confira se o código é o mesmo que o outro dispositivo mostra, digite os últimos 4 dígitos dele e clique em Aprovar. O cartão fica oculto quando nada está esperando.
Entrar é grátis. É também o que permite ativar o Pro com uma vaga da sua equipe em License & Activation, e Meus dispositivos precisa disso.
License & Activation
O Pro é liberado por computador, ativando aqui a sua chave de licença, ou com a sua conta MXterm quando uma vaga de uma licença foi dada a ela.
- Abra as Configurações e escolha License & Activation.
- Cole a chave do e-mail de compra (ela tem este formato:
MXTERM-XXXX-XXXX-XXXX-XXXX) no campo em Ativar chave de licença. - Clique em Ativar.
Recebeu uma vaga da sua equipe? Sob o campo da chave, Entrar no MXterm conecta você pelo navegador, e depois Ativar como seguido do seu e-mail ativa este computador com a sua conta, sem chave. Se a sua conta tem vagas em mais de uma licença, a tela pede que você escolha uma. Um computador ativado assim nunca mostra a chave para você.
A ativação entra em contato com o mxterm.net. Ela envia a chave, um hash do ID de hardware deste computador, o nome do computador, a versão do app e o sistema operacional. O servidor contabiliza este computador no limite de dispositivos da sua licença e devolve um token de licença assinado, que o app guarda. Depois disso, o app verifica a licença de novo online a cada inicialização (no máximo uma vez por hora) e a cada 24 horas enquanto está em execução. Se o mxterm.net não puder ser alcançado, nada muda e o Pro continua funcionando offline. O Pro só é retirado quando o servidor dá a mesma recusa clara duas vezes seguidas. Colar uma chave errada ou com erro de digitação não tira uma licença válida que este computador já tem: o formulário mostra o erro e a licença continua como estava. Quando uma licença é retirada, pela verificação online, por Desativar dispositivo ou por Remover deste dispositivo mesmo assim, ela é retirada em todo o app ao mesmo tempo, sem reiniciar.
Depois de ativada, a tela mostra a licença como Ativa, com a data de ativação e, em Limites de dispositivos, quantos dispositivos estão em uso dentro do seu limite. Quando o servidor não informou o limite, a tela mostra — em vez de um número que teria de inventar. Ainda sem chave? Clique em Obter o MXterm Pro nessa tela ou veja os Preços.
Se uma verificação online retirar o Pro deste computador, a tela diz por quê: um reembolso foi feito, a licença foi revogada, a chave não é mais válida, ou este computador foi removido da licença porque a vaga dele foi para outro. Informe a chave de novo para recuperar uma vaga.
| Se a ativação disser | Faça isto |
|---|---|
| This license is already active on the maximum number of devices. | Libere um dispositivo em sua conta e ative a licença de novo. |
| License not found. Check the key from your purchase email. | Copie a chave do e-mail de novo, com cuidado para não incluir caracteres extras. |
| Could not reach mxterm.net. Check your connection and try again. | A ativação precisa de rede uma vez. Tente de novo quando estiver online. |
| Your license was accepted, but this app build could not confirm it. Please update MXterm Pro and try again, or contact support if it persists. | A chave funcionou. Atualize o MXterm Pro para a versão mais recente e ative de novo; o mesmo computador não ocupa uma segunda vaga. Se continuar acontecendo, fale com o suporte. |
Desativar dispositivo libera a vaga deste computador para você usá-la em outro lugar. Ele pergunta antes (Desativar este dispositivo? / Isso libera a vaga deste dispositivo na sua licença, para você ativá-la em outro computador. Os recursos Pro param neste dispositivo.), e ao confirmar aparece Liberando a vaga… enquanto avisa o mxterm.net, e depois A vaga deste dispositivo foi liberada. Você pode ativar sua licença em outro computador.
Acesso remoto e dispositivos
Esta categoria é o lado do host de Painéis em outro MXterm: ela permite que outros dispositivos vejam os painéis que você escolher e, se você permitir, digitem neles. Ela ocupa toda a janela de Configurações como uma tela própria, chamada Acesso remoto e dispositivos pareados, com uma seta de voltar e três abas: Conectar, Dispositivos e Avançado. A engrenagem no cabeçalho de Máquinas, na barra lateral, abre essa tela direto. O servidor fica parado até você clicar em Iniciar servidor, a menos que Iniciar o servidor host quando o MXterm abrir esteja ativado. Em Avançado, Excluir imagens recebidas de outros dispositivos após remove as imagens que um celular, um iPad ou outro computador enviou para este Mac depois de 7 dias por padrão (Desligado, ou 1, 3, 7, 14 ou 30 dias). Limpar agora executa isso na hora e pergunta antes quando a opção está Desligado. O histórico da Control Room e seus próprios anexos nunca são tocados, e as imagens que um celular cola em um painel são sempre removidas após 24 horas.
- Um selo mostra a rede que o servidor usaria: VPN mesh Tailscale (acesso em qualquer lugar), Rede Wi-Fi local (somente LAN) ou Somente este Mac (offline). O MXterm Pro escolhe um endereço do Tailscale se o computador tiver um. Um endereço privado de rede local (
10.x,172.16a172.31.xou192.168.x) só é usado quando Permitir dispositivos na minha rede local (sem criptografia) está ativado, e então além do Tailscale. Quando um endereço de rede local e um endereço do Tailscale respondem, o de rede local aparece primeiro e conduz o QR de pareamento. Esse interruptor vem desativado por padrão. Caso contrário, o servidor fica em127.0.0.1, que só este computador alcança. Se o único endereço alcançável for de rede local e o interruptor estiver desativado, Iniciar servidor se recusa e diz o motivo. O servidor nunca aceita conexões em um endereço público. - Iniciar servidor e Parar servidor ligam e desligam o listener, e o título do card mostra a rede: Servidor host · Tailscale, Servidor host · Rede local ou Servidor host · Local. Enquanto roda, o painel mostra Vinculado a seguido do endereço. A porta é 6868. O MXterm Pro tenta primeiro a porta que usou da última vez, depois a faixa de 6868 a 6877, então um endereço salvo continua funcionando, a menos que outro programa tenha ocupado essa porta. Se as dez estiverem ocupadas, o painel avisa.
- Sob os controles do servidor, Permitir dispositivos na minha rede local (sem criptografia) vem desativado por padrão. Desativado, o servidor escuta só no Tailscale, que criptografa. Ativado, ele escuta no seu endereço Tailscale e também em cada endereço privado de rede local deste computador, em texto simples, então qualquer pessoa nesse Wi-Fi que consiga observar o tráfego pode copiar o token de um dispositivo pareado e abrir os painéis que você compartilha. Ativá-lo pede confirmação e não inicia o servidor. Desativá-lo para um servidor que estava escutando na rede local. As versões anteriores usavam a rede local por conta própria; agora ela fica desativada até você permitir.
- Permitir bypass remoto, ao lado, vem desativado por padrão. Desativado, um dispositivo que pede para abrir uma nova sessão nunca pode pular as verificações de permissão do agente, mesmo que tenha permissão para criar sessões. Ativado, um pedido que solicita bypass o recebe, e este Mac mostra qual sessão foi aberta assim.
- O cartão de pareamento é uma coluna única e centralizada. Primeiro vem o código de pareamento de 6 caracteres, numa caixa só com a contagem regressiva (ele expira em 5 minutos). Dois botões de ícone ficam no fim da caixa: copiar, que coloca o código na sua área de transferência, e Novo código, um ícone de atualizar que gera outro. Quando não há código válido, o app gera um para você. Com o host desligado, uma linha curta embaixo do interruptor dá uma dica de como conectar: pela rede local, depois que o interruptor for ligado, com o endereço deste Mac (ou um lembrete para ativar Permitir dispositivos na minha rede local (sem criptografia)), e pelo Tailscale, que ela diz ter encontrado ou como obter. Abaixo do código, uma linha diz para apertar Novo código para mostrar o QR code: o QR code, que leva o endereço e o código, para ler com o app MXterm em um celular, só aparece depois que você aperta esse botão. Depois vem cada endereço para abrir no outro dispositivo, com o nome da sua rota e um botão de copiar no fim da linha. Um dispositivo com login na mesma conta MXterm também pode pedir pareamento sem código: o Mac mostra um aviso Permitir / Negar com dígitos para você comparar com os que o dispositivo mostra, e Permitir faz o pareamento. O pedido expira em 90 segundos, e um dispositivo de outra conta é recusado.
- Em uma rede local, a conexão não é criptografada, e o painel avisa que qualquer pessoa nesse Wi-Fi que obtiver o token pode abrir os painéis que você compartilha. Use uma rede de confiança, ou o Tailscale, que criptografa. Quando o Tailscale não está instalado, o painel oferece Instalar o Tailscale; quando está instalado mas não conectado, o painel diz para você entrar. Abaixo de qualquer uma das duas mensagens, o link Como usar o Tailscale com o MXterm Pro abre no mxterm.net um guia sobre qual endereço o host usa. Enquanto o host roda com o acesso pela rede local ativado, o MXterm Pro foi feito para se anunciar por Bonjour, para que celulares próximos o encontrem; o anúncio não leva token e não dá nenhum acesso.
- Conectados agora lista cada dispositivo conectado a um painel compartilhado neste momento, com o painel e a hora da conexão, e um botão Desconectar. Desconectar encerra a sessão desse dispositivo somente nesse painel e o mantém fora até você compartilhar o painel de novo. O pareamento dele continua.
- Dispositivos remotos autorizados lista cada dispositivo pareado com seu tipo, Navegador ou App MXterm, quando foi pareado e quando foi visto pela última vez. Revogar remove um dispositivo. Cada dispositivo tem um interruptor Pode criar novas sessões, desativado em todo dispositivo recém-pareado. Ativado, esse dispositivo pode abrir um novo painel neste computador a partir da própria tela. Cada dispositivo também tem Pode gerenciar Control Rooms, desativado por padrão: ativado, o app MXterm nesse celular ou computador pode criar uma Control Room, escolher o coordenador dela, adicionar ou remover membros e excluir uma sala (a sala principal de uma aba não pode ser excluída) a partir da própria tela. Os limites do plano Free para salas e membros valem ali como neste computador. Antes disso, o app MXterm no celular mostra quais agentes estão instalados neste computador, encontrados pela mesma varredura de Configurações → Agentes; um agente que a varredura não conseguiu verificar continua sendo oferecido. Cada dispositivo também tem Ocultar todos os painéis: enquanto está ativado, esse dispositivo não vê nenhum painel deste computador e não pode abrir nem digitar em nenhum. Limpar dispositivos sem uso há 30+ dias remove os inativos com um clique. Um dispositivo de qualquer tipo que fique 30 dias sem uso para de funcionar sozinho, e cada uso reinicia a contagem dos 30 dias. Um app MXterm que você pareou continua pareado quando este host reinicia: o host guarda um hash do token dele, nunca o token.
O globo na barra de título abre o mesmo código de pareamento, o mesmo QR code e os mesmos endereços sem entrar em Configurações. Cada endereço aparece primeiro, com a sua rota (Rede local ou Tailscale, a rede local primeiro quando as duas respondem) e um botão de copiar no fim da linha. Abaixo dos endereços, o código fica centralizado numa caixa só com a contagem regressiva, um ícone de copiar e um botão de ícone Novo código. O QR code não aparece de início: uma linha embaixo da caixa diz para apertar Novo código, e o QR code surge embaixo da caixa depois que você aperta. O app gera um código para você quando não há nenhum. Abrir o menu pelo teclado e pressionar Enter não alterna o interruptor geral; use antes uma seta ou Tab. Um clique em qualquer lugar fora fecha o menu. Sem nenhuma rota ainda, o menu oferece o próximo passo do Tailscale: Baixar o Tailscale quando ele não está instalado, Abrir o Tailscale quando está instalado mas desligado, e um link Como funciona. Quando o Tailscale conecta, o menu avisa e, se ainda não houver outro dispositivo lá, pede que você entre no Tailscale no celular com a mesma conta. O cartão do Cloudflare WARP aparece no menu só enquanto o WARP está de fato bloqueando o Tailscale.
Mais um card pode aparecer em Configuração e servidor. Um card do Cloudflare WARP aparece só quando o WARP está instalado (ou para avisar sobre outra VPN que leva todo o tráfego). O WARP pode bloquear o Tailscale mesmo com o Tailscale mostrando Conectado, e o interruptor do card adiciona à lista de exclusão do WARP os endereços de que ele precisa e, ao ser desativado, remove exatamente o que adicionou.
Nada é compartilhado por padrão. Você compartilha um painel pelo globo no cabeçalho dele. Escolha Controle (os dispositivos pareados podem ver e digitar, um dispositivo por vez) ou Somente visualização (eles não podem digitar), e depois a duração: 30 minutos, 1 hora, 8 horas ou até você encerrar. Para compartilhar todos os painéis da janela principal, ative Compartilhar todos os painéis no globo da barra de título, que aparece enquanto o servidor host está em execução. Escolha antes Controle ou Ver no interruptor de duas partes da linha e um prazo no menu suspenso dela (1 hora, 4 horas, 8 horas ou Até desligar); as duas escolhas ficam salvas. Na primeira vez é Ver por 1 hora, e Controle é um clique, sem confirmação. Painéis que você abre enquanto ele está ativo também são compartilhados, o compartilhamento termina sozinho no prazo, e desativá-lo deixa de compartilhar só os painéis que ele compartilhou. Enquanto ele está ativo, a linha mostra quantos painéis estão compartilhados agora, contando os painéis que você compartilhou à mão. O limite do plano Free de painéis compartilhados ao mesmo tempo continua valendo, e o menu diz quantos painéis não conseguiu compartilhar.
No plano Free, por padrão, 1 outro computador pode ser pareado para controlar este, e até 5 painéis podem ser compartilhados ao mesmo tempo. O app MXterm para celular (iPhone, iPad) não conta para o limite de 1 outro computador que pode controlar este Mac. Só contam os outros computadores que rodam o MXterm; os navegadores não contam. Sob o código de pareamento aparece uma nota, por exemplo Free: computadores que controlam este, 1 de 1. Celulares e tablets não têm limite., com um botão de upgrade quando o limite é atingido. Um novo computador além do limite é recusado ao parear, e permitir um a partir de uma solicitação de pareamento abre o aviso de upgrade. Compartilhar um sexto painel também abre o aviso de upgrade. Nenhum dos limites remove um pareamento ou um compartilhamento que já existe. O mxterm.net pode alterar esses números. O Pro não tem limite em nenhum dos dois. Veja Preços.
O host encerra o compartilhamento quando o prazo termina, e alternar entre os dois modos mantém o tempo restante. Enquanto um painel está compartilhado, o botão no cabeçalho dele (um olho quando está em Somente visualização) mostra o tempo restante, se o compartilhamento tem prazo, e quantos dispositivos estão conectados. O MXterm Pro foi feito para restaurar os compartilhamentos depois de uma reinicialização, quando cada painel estiver rodando de novo. Veja Painéis em outro MXterm.
Notificações no celular (em breve)
- As notificações no celular ainda não estão disponíveis. Isto descreve como foram projetadas para funcionar, e quando forem lançadas só o status vai mudar.
- O Mac tem um interruptor, Avisar meu telefone quando um agente precisar de mim ou terminar, em Configurações → Acesso remoto e dispositivos → Avançado. Vem desativado por padrão e exige que você esteja conectado à sua conta MXterm. Enquanto estiver desativado, o Mac não envia nada. O app do iPhone ainda não se registra para essas notificações, então nenhum telefone recebe nada hoje.
- Você é avisado quando um agente precisa de você e quando um agente termina.
- Enquanto você está no Mac, o Mac não envia nada. Ficar 2 minutos sem entrada de teclado ou mouse conta como ausente. Um segundo interruptor, abaixo do primeiro, Avisar também meus outros dispositivos enquanto estou neste computador, vem desativado por padrão; ative-o para ser avisado mesmo assim, por exemplo para testar. Ele só funciona enquanto o primeiro interruptor estiver ativado.
- A notificação traz só o agente, a pasta, os nomes do painel e da aba dele e, quando um agente termina, quanto tempo ele trabalhou, nunca texto do terminal, prompts, comandos nem caminhos. O nome do painel é o que você deu a ele, ou o nome do agente se você não deu nenhum; um título que um programa define no terminal nunca é enviado. Ela também pode levar uma linha curta com a pergunta que um agente faz (só uma pergunta simples, nunca um pedido de permissão; no máximo 120 caracteres; links, caminhos de arquivo, endereços de e-mail e chaves são removidos no seu Mac, e uma linha que mencione senha, token ou segredo não é enviada). Essa linha vem ativada por padrão quando as notificações no celular estão ativadas; desative em Configurações → Acesso remoto e dispositivos → Avançado, ao lado do interruptor das notificações no celular. Esses nomes e essa linha passam pelo servidor do MXterm e pela Apple até chegar à tela de bloqueio do seu celular; o MXterm não os guarda. Para uma pergunta simples (nunca um pedido de permissão), ela também pode levar um id dessa pergunta, para que um celular possa respondê-la.
- Em um pedido de permissão, o banner pode oferecer Aprovar e Negar, e o celular precisa estar desbloqueado. O iOS limita o que roda com o app fechado, então uma ação pode esperar até você abrir o app.
- Você escolhe quais eventos, quais computadores e quais horários de silêncio.
- São gratuitas em todos os planos. Começam no iPhone, e o Apple Watch espelha o banner.
- As notificações são enviadas pelo serviço de push da Apple. Para saber o que o mxterm.net guarda, veja a política de privacidade.
Acesso autônomo
Acesso autônomo é um card em Acesso remoto e dispositivos para acessar este computador quando ninguém está na frente dele. Ele tem dois interruptores e, sob cada um, diz o que está acontecendo agora.
- Iniciar o servidor host quando o MXterm abrir vem desativado por padrão. Ativado, o MXterm Pro inicia o servidor host a cada abertura. Junto com Abrir ao iniciar sessão em Geral, o computador volta a ficar acessível depois de uma reinicialização. Os compartilhamentos são restaurados quando cada painel volta, então uma reinicialização, por si só, não encerra um compartilhamento.
- Manter este Mac ativo enquanto um painel estiver compartilhado vem ativado por padrão (Manter este computador ativo enquanto um painel estiver compartilhado no Windows). Ela impede a suspensão por inatividade enquanto o servidor host roda e pelo menos um painel está compartilhado. A tela ainda pode apagar.
Se a rede não estiver disponível quando o MXterm abrir, a inicialização tenta de novo após 5 segundos, depois 10 segundos, depois a cada 15 segundos. Ela desiste após 5 minutos se ainda não houver rede ou se a inicialização continuar falhando, e o card diz o motivo. Clicar em Iniciar servidor ou Parar servidor, ou desativar o interruptor, encerra as tentativas.
Se a última inicialização foi no Tailscale, o MXterm Pro espera o Tailscale durante esses 5 minutos em vez de iniciar em um endereço de rede local. Quando Permitir dispositivos na minha rede local está desativado, ele nunca inicia na rede local: depois de 5 minutos sem o Tailscale, o card diz O servidor não foi iniciado: o Tailscale não conectou em 5 minutos e o acesso pela rede local está desativado. Com o interruptor ativado, ele só usa o endereço da rede local quando o tempo acaba.
O computador só é mantido ativo enquanto três condições forem verdadeiras: o servidor está rodando, pelo menos um painel está compartilhado e o interruptor está ativado. O MXterm Pro verifica de novo a cada 15 segundos e sempre que um compartilhamento, o servidor ou o interruptor muda, então um painel fechado enquanto compartilhado deixa o computador suspender de novo em cerca de 15 segundos.
Isso só impede a suspensão por inatividade. Não impede uma suspensão que você mesmo causa, como fechar a tampa de um notebook (um Mac na bateria ainda suspende quando você fecha a tampa). Se o sistema recusar, o card mostra O sistema recusou manter a máquina ativa: seguido do motivo.
| Sistema | Como ele fica ativo | Observação |
|---|---|---|
| macOS | Uma power assertion do tipo PreventUserIdleSystemSleep, listada por pmset -g assertions como MXterm Pro: a pane is shared for remote access enquanto está ativa | O sistema a libera quando o MXterm é encerrado ou trava |
| Windows | SetThreadExecutionState com ES_CONTINUOUS e ES_SYSTEM_REQUIRED, chamada a partir de uma única thread dedicada | Lido no código, não verificado em uma máquina Windows |
| Linux | Nada é mantido | O interruptor não aparece |
Senha de acesso
O card Senha de acesso permite que um novo dispositivo seja pareado com uma senha, em vez de um código lido nesta tela. Um dispositivo pareado assim recebe o próprio token, que você pode revogar em Dispositivos remotos autorizados, exatamente como no pareamento por código. A senha não abre nada que um código de pareamento não abra. Ela vem desativada por padrão.
A senha é aceita pelo Tailscale e, quando você permite, pela rede local, onde trafega sem criptografia. Ela nunca é aceita no endereço de loopback deste Mac. Quando o servidor está parado ou escuta só em 127.0.0.1, o card diz por que a senha não consegue parear nada agora.
Digite uma senha de pelo menos 6 caracteres e clique em Salvar, que fica à direita do campo, ou clique no botão de dado ao lado (Gerar) para uma frase secreta aleatória. Enquanto a senha está ativa, o cartão mostra um selo verde Ativada, e Alterar a senha abre o mesmo campo com os mesmos dois botões. Uma senha gerada é mostrada uma única vez e não pode ser mostrada de novo. Ela é guardada como hash Argon2id no armazenamento de credenciais do sistema (o Keychain no macOS), nunca em um arquivo. Trocar a senha não desconecta os dispositivos que já estão pareados.
| Modo | O que faz | Free | Pro |
|---|---|---|---|
| Temporária | Fica ativa por um tempo definido e depois se desativa sozinha. O prazo é um horário no relógio, então uma reinicialização não o estende | 1 hora ou 8 horas (o padrão) | 1 hora, 8 horas, 1 dia ou 7 dias |
| Permanente | Sem limite de tempo: continua ativa, mesmo após reinicializações, até você desativar. Você confirma antes, porque qualquer pessoa na sua tailnet que souber a senha pode parear um novo dispositivo | Indisponível: tem um selo Pro, e Ativar abre o aviso de upgrade | Disponível. É o modo em que uma licença Pro começa |
Enquanto a senha está ativa, um ícone de chave aparece na barra de título: verde para Temporária, com o tempo restante ao passar o mouse, e âmbar para Permanente e para uma Temporária prestes a expirar. Clique nele para abrir Acesso remoto e dispositivos. Nada aparece enquanto a senha está desativada.
O host limita as tentativas de adivinhar. Depois de 3 tentativas erradas de um mesmo endereço, cada nova tentativa bloqueia esse endereço por mais tempo, começando em 5 segundos e dobrando até 15 minutos. Ele também permite no máximo 20 tentativas erradas a cada 10 minutos somando todos os endereços.
As três ações abaixo ficam em Zona de perigo, um título em que você clica para abrir, centralizado no cartão. Desativar (os dispositivos ficam) é verde: impede que a senha pareie novos dispositivos, e os dispositivos que ela já pareou continuam pareados. Terminar a sessão de todos os dispositivos revoga todos os navegadores e apps MXterm pareados e os desconecta de todos os painéis, e deixa a senha como está. Desativar e terminar a sessão de todos os dispositivos faz as duas coisas. As ações de desativar só aparecem enquanto a senha está ativa. Cada uma pede confirmação.
Para parear outro MXterm com esta senha, abra a seção Máquinas dele. O formulário de adicionar host e a caixa de diálogo Parear de novo oferecem Código e Senha. Escolha Senha e use o endereço Tailscale deste computador (100.x.y.z) para um pareamento criptografado, com o Tailscale rodando nas duas máquinas; um endereço de rede local também funciona, mas não é criptografado. O erro não diz se a senha estava errada ou se o host não tem senha ativada.
Meus dispositivos
Meus dispositivos conecta a outro Mac que tenha entrado na mesma conta MXterm, sem código de pareamento nem senha. Exige uma conta conectada e o Pro. Sem login, pede que você entre primeiro e oferece um botão Conta. No Free, mostra Meus dispositivos é um recurso Pro com Fazer upgrade para o Pro.
Caso contrário, lista os outros dispositivos confiáveis da sua conta, com um botão de atualizar. Cada linha mostra o nome do dispositivo e uma etiqueta Vinculado depois de conectado, o interruptor Pode criar novas sessões, um campo de endereço e um botão Conectar, e um botão Abrir quando ele está vinculado. Digite o endereço do host do outro Mac, por exemplo http://192.168.1.50:6868, e clique em Conectar. Sem nenhum outro dispositivo, a tela diz Nenhum outro dispositivo confiável ainda: entre na mesma conta em outro Mac, e ele aparece quando vincular este de volta.
Privacidade
O envio de dados de uso saiu de Atualizações e sobre e foi para a própria categoria Privacidade na 1.0.22, junto com uma forma de gerar um arquivo para o suporte.
Compartilhar dados de uso anônimos vem ativado por padrão e vale só para versões oficiais. Uma vez por abertura, ele envia um único evento app_open ao Google Analytics com a versão do app e seu sistema operacional, e nada mais ao Google Analytics no resto daquela execução: não há sinal de atividade repetido. Uma vez por dia, envia a versão, Free ou Pro, a versão do sistema, o tipo de CPU, o número de aberturas, se a última execução travou e quantas vezes os avisos de upgrade foram exibidos e clicados. Quando algo falha, envia qual de uma lista fixa de falhas conhecidas foi, com um código de motivo. Tudo vem com um ID aleatório que não está ligado a você. Ele nunca envia saída do terminal, caminhos de arquivo, hosts ou nomes de usuário SSH, nem chaves de licença. Desative o interruptor para parar o envio. A lista completa do que é enviado está em Telemetria.
O mesmo interruptor também controla as contagens de uso: uma vez por dia, junto com a verificação diária, o app envia contagens e faixas sobre quais recursos você usa, nunca o que você digita ou abre. A lista completa está em Telemetria. Desativar o interruptor interrompe novos envios de uso, e as contagens de uso são mantidas por 400 dias.
Você também pode desativar fora do app, o que é útil em uma máquina que você configurou para outra pessoa. Inicie o MXterm Pro com DO_NOT_TRACK ou MXTERM_TELEMETRY_DISABLED definido com qualquer valor não vazio diferente de 0, false ou no. A variável de ambiente prevalece sobre o interruptor: ele fica esmaecido e rotulado Desativado por …, com o nome da variável.
O card Arquivo de diagnóstico para o suporte gera um arquivo para enviar junto com um pedido de suporte: Informações do app e erros recentes, sem detalhes sensíveis. Nada é enviado até você enviar: leia aqui primeiro. A partir do MXterm Pro 1.1.74, Enviar para a MXterm abre o Feedback como um relatório de bug com este arquivo já marcado; nada é enviado até você clicar em Enviar ali. Visualizar mostra o texto do arquivo no painel, com os botões Copiar e Enviar e-mail ao suporte, para você ler antes de qualquer coisa ser salva ou enviada. Salvar arquivo… abre uma caixa de diálogo para salvar que sugere mxterm-diagnostics-YYYY-MM-DD.json na sua área de trabalho e depois oferece Mostrar no Finder (Mostrar no Explorador de Arquivos no Windows) e Enviar e-mail ao suporte.
- Ele contém a versão do app e se é uma versão oficial ou de desenvolvimento, o tempo de atividade, seu plano e idioma, seu sistema, a versão dele e seu processador, se a telemetria está ativada, se a última execução travou, contagens de hosts SSH salvos, abas e painéis, quais agentes você usa, quais provedores do Token Meter estão configurados e as falhas recentes de uma lista local de 14 dias.
- Sua pasta pessoal aparece como
~, e de cada falha só são mantidos valores no formato de identificador. - Ele nunca contém saída do terminal, comandos, caminhos de arquivo, nomes de host, chaves de licença nem endereços de e-mail.
- O arquivo pronto é verificado antes de ser gravado. Se algo nele falhar na verificação de privacidade, nada é salvo e o painel diz qual regra o impediu.
Feedback
Feedback é como você envia uma mensagem à equipe do MXterm. Escolha o que é: Sugestão (uma ideia ou um comentário), Melhorar um recurso (algo funciona, mas poderia funcionar melhor) ou Relatar um bug. Depois escreva sua mensagem e clique em Enviar (as versões anteriores mostram Escrever o e-mail no lugar; veja abaixo).
A partir do MXterm Pro 1.1.57 no Mac (1.1.58 no Windows e no Linux), Enviar entrega a mensagem ao mxterm.net: seu nome, e-mail e mensagem, o tipo, a versão do app, seu sistema operacional e o idioma do app, e o arquivo de diagnóstico somente se você marcar (mantido por 90 dias). Nosso provedor de e-mail a processa, e é possível enviar até 3 por hora. Se o envio falhar, o app oferece abrir seu app de e-mail.
Nas versões anteriores, seu app de e-mail abre com uma mensagem endereçada a support@mxterm.net. O assunto indica o tipo, como [MXterm 1.1.31] Bug report; os outros dois são Suggestion e Feature improvement. O corpo fica vazio acima de um pequeno rodapé com a versão do MXterm Pro, seu sistema operacional e o idioma do app.
Nessas versões, o MXterm Pro não envia nada por conta própria: o e-mail só sai quando você aperta Enviar no seu app de e-mail. Usar a página de contato abre a página de contato no mxterm.net. Para um bug, o painel sugere anexar um arquivo de diagnóstico, e Abrir Privacidade leva você até Arquivo de diagnóstico para o suporte.
Atualizações e sobre
O app verifica no mxterm.net se há uma nova versão 5 segundos depois de abrir, e depois a cada 4 horas.
Quando há uma atualização, um botão Update to vX.Y.Z (o rótulo continua em inglês) aparece na parte de baixo da barra lateral, abaixo de Configurações. Clique nele para baixar. Ele mostra Downloading… com a porcentagem e depois muda para Restart to update. Se o download falhar, vira Retry update, com o erro na dica (tooltip). Um pequeno cartão no canto inferior esquerdo da janela também avisa quando uma atualização está pronta, em uma nota curta dizendo que suas abas e chats reabrem depois da atualização. Se ainda há painéis em execução, uma linha diz quantos e sugere atualizar quando terminarem; um reinício encerra os comandos em execução. Feche-o com o × (não durante o download); ele volta quando houver uma versão mais nova. Prévia, em Atualizações e sobre, mostra o cartão com uma versão de exemplo: os botões só simulam, nada é baixado e o app não reinicia.
Para verificar por conta própria, clique em Buscar atualizações em Atualizações e sobre, ou escolha Check for Updates… no menu do ícone do MXterm Pro na barra de menus (a bandeja do sistema no Windows). O painel mostra sua versão com o número da build, como v1.1.31 · build 2573, e se você está em dia. Se uma verificação falhar, aparece Não foi possível buscar atualizações: seguido do motivo, e se um download falhar, aparece Falha no download: seguido do motivo, em vez de parecer que você está em dia. Quando há uma versão disponível, ele mostra as notas da versão e Baixar e instalar, e depois Reiniciar para aplicar quando o download termina. Ver registro de atualização mostra o que o atualizador fez.
Há um único canal de versões e não há como mudá-lo. Esta categoria também tem Licenças de código aberto, a lista das bibliotecas nas quais o MXterm Pro se baseia.