Primeiros passos

Baixe o MXterm Pro na página de download. No Mac, você recebe um DMG que roda nativamente em Apple silicon e Intel e exige macOS 10.15 ou posterior. No Windows, a página de download oferece um instalador para Windows 10 ou 11 em x64; não há build para ARM64. O restante desta página foi conferido no app para macOS, e onde se sabe que o Windows é diferente, o texto avisa.

Depois que você clica em um botão de download no site, um popup Install in three steps mostra os passos para o arquivo escolhido. São os mesmos passos abaixo.

1. Abra o DMG que você baixou.
2. Arraste MXterm Pro para Aplicativos.
3. Abra o MXterm Pro pela pasta Aplicativos.
4. Se o macOS perguntar se você quer abrir um app baixado da internet, escolha Abrir.

No macOS, o app é assinado com um Apple Developer ID e notarizado pela Apple.

No Windows:

1. Execute o .exe que você baixou.
2. Se o Windows SmartScreen mostrar O Windows protegeu seu computador, clique em Mais informações e depois em Executar assim mesmo. O instalador ainda está sem assinatura de código, então o Windows mostra o editor como Editor desconhecido.
3. Siga os passos do instalador.

Na primeira vez que o app abre, aparece um tour de seis slides chamado Bem-vindo ao MXterm Pro. Clique em Avançar para percorrê-lo ou em Pular tour para fechar; o menu de idioma no cabeçalho lista todos os idiomas que o app oferece, e escolher um deles troca o tour e o app para esse idioma. O tour abre sozinho uma vez só e não volta depois que você o fecha; você pode revê-lo no menu do logo, em Tour de boas-vindas.

Atrás do tour, a janela tem uma única aba, New Tab, mostrando o Composer do espaço de trabalho. A interface começa no primeiro idioma da lista de idiomas do seu sistema que o app oferece, e em inglês se nenhum deles for oferecido; um idioma que você escolheu antes é mantido. O app oferece English, Tiếng Việt, 简体中文, 日本語, 한국어, Español, Français, Türkçe, Bahasa Indonesia, Português (Brasil) e Deutsch. Você pode mudar depois em Configurações, onde cada idioma aparece com o próprio nome.

Um espaço de trabalho é uma aba com uma grade de painéis de terminal que começam todos na mesma pasta. Nada roda até você criá-lo.

1. Em Pasta de trabalho, digite um caminho ou clique em Procurar. Ela começa na sua pasta pessoal, e as pastas que você usou antes aparecem em Recentes.
2. Em Quantos terminais?, escolha 1, 2, 4, 6, 8, 9, 10, 12, 16 ou 20. A pré-visualização abaixo mostra a grade que você vai ter. Layout alterna entre Horizontal (uma grade) e Vertical (uma fileira de colunas altas, com os painéis lado a lado). O Vertical oferece de 1 a 6 painéis, e uma quantidade que ele não oferece cai para a maior abaixo dela.
3. Em Agentes de IA, use os botões − e + para definir quantos painéis executam cada agente. A lista começa com Claude Code, Codex, Grok e Gemini CLI, depois vem a linha Terminal (Plain Shell), depois o OMP; os outros agentes vêm em seguida, com os instalados primeiro. Um agente cuja CLI o app não encontra é marcado como Não instalado e tem um botão Instalar que abre o guia de instalação desse agente; o MXterm Pro nunca executa a instalação por você. Para o Cursor Agent, essa CLI é cursor-agent. Enquanto o app ainda está verificando, ou se a verificação falhou (aparece um link Tentar novamente), nenhum agente pode ser marcado e todo painel é um shell simples.
4. Os painéis que você deixar sem agente executam um shell simples. A linha Terminal (Plain Shell) permite escolher esse shell e definir explicitamente o número de painéis simples.
5. Revise as três opções abaixo da pré-visualização (veja a tabela abaixo), depois clique em Criar espaço de trabalho ou pressione Cmd+Enter (Ctrl+Enter no Windows).

O Composer sempre oferece Claude Code, Codex, OpenCode, GitHub Copilot, Qwen Code, Amp, Gemini CLI, Cursor Agent, Antigravity, OMP (Oh My Pi) e Grok. Outros agentes, como Aider, Goose, Kimi Code e Devin, aparecem só depois que o MXterm Pro encontra a CLI deles na sua máquina. O Composer começa com 2 terminais e só coloca neles os agentes que você instalou. Com Claude Code e Codex instalados, ele propõe um de cada. Caso contrário, os dois primeiros agentes instalados da lista dividem os painéis, metade (arredondada para cima) para o primeiro; com um agente instalado, ele fica com metade e o resto são shells simples, e sem nenhum todo painel é um shell simples. Quando você clica em Criar espaço de trabalho, o Composer lembra dessa escolha (agentes, terminais simples, layout e quantidade de painéis) e parte dela na próxima vez, ajustada à quantidade de painéis que você escolher; um agente lembrado que não está mais instalado vira um shell simples. Confira as linhas de Agentes de IA antes de criar o espaço de trabalho.

Se a pasta já tem sessões de agentes, uma lista Retomar sessões aparece abaixo do campo da pasta. Marque uma sessão para reabri-la no próprio painel. Um espaço de trabalho tem no máximo 20 painéis, então a marcação para quando você chega a esse número. Uma sessão marcada tem prioridade sobre a opção de retomar para o painel dela.

Se a pasta for um repositório git sem nenhum commit ainda, Isolar funcionalidades em git worktrees primeiro faz o commit de um .gitkeep vazio como Initial commit, porque um worktree precisa de um commit para partir. Nada mais na pasta é adicionado ao stage nem commitado.

O Composer tem duas colunas, a pasta de trabalho à esquerda e os terminais à direita, enquanto a aba for larga o bastante. Quando não for, por exemplo com a barra lateral e o painel direito abertos, as colunas se empilham em uma só.

Há mais sobre agentes e worktrees em Agentes de código e Control Room (antes War Room).

O Bypass Mode manda os agentes pularem os prompts de aprovação, então eles executam comandos e alteram arquivos sem perguntar antes. Ele fica desativado até você ativá-lo: de fábrica, seus agentes param e perguntam.

Se você usava uma versão anterior, o Composer mostra um aviso até você dispensá-lo ou mudar a caixa: O Bypass Mode agora vem desativado por padrão. Os agentes vão perguntar antes de executar comandos ou editar arquivos. Ative-o de novo pelo interruptor abaixo. Se você já tinha marcado ou desmarcado a caixa por conta própria, a sua escolha é mantida.

Para ativá-lo:

1. Para abrir o Composer, pressione Cmd+T (Ctrl+T no Windows) ou clique em + depois da última aba e escolha Nova aba.
2. Marque Ativar Bypass Mode (aprovar permissões da CLI automaticamente).

O Bypass Mode adiciona a flag própria de cada agente compatível para pular aprovações, que o MXterm Pro conhece para 14 agentes. Os outros, incluindo OpenCode, GitHub Copilot, Amp, Cursor Agent, Antigravity e OMP, iniciam com o comando normal, com o Bypass Mode ativado ou não.

A escolha é salva assim que você a muda. Todo painel de agente iniciado depois disso a segue, inclusive painéis reabertos na próxima vez que você abrir o app. A caixa no Composer é o interruptor do bypass por flag. O Goose não tem flag, então o modo automático dele é uma variável de ambiente oferecida só nas Configurações.

• Nova aba: pressione Cmd+T (Ctrl+T). A aba abre no Composer e não inicia nenhum shell até você criar o espaço de trabalho. Clicar em + no fim da faixa de abas abre um menu, descrito a seguir; a primeira linha dele, Nova aba, faz o mesmo que Cmd+T.
• Menu +: um campo de busca fica no topo; digitar filtra pastas e agentes, e Enter abre a primeira correspondência. Novo terminal abre uma aba com um shell simples na pasta da aba ativa quando ela é uma aba local com pasta, senão na sua pasta mais recente, senão na sua pasta pessoal. Novo terminal em ~ faz o mesmo na sua pasta pessoal quando ela é diferente, e Abrir pasta… pergunta primeiro por uma pasta. Em Recentes, até seis pastas recentes abrem cada uma uma aba de terminal nessa pasta (uma busca lista todas as correspondências). Em Agentes em e o nome da pasta, cada agente instalado abre uma aba com um painel executando-o nessa pasta, sem worktree e sem retomar. Se nenhum agente estiver instalado, uma linha leva você a Configurações → Agentes. Toda linha, exceto Nova aba, abre exatamente uma aba com um painel, e valem os limites do plano Free como em qualquer nova aba.
• Nome: uma aba de espaço de trabalho recebe o nome da pasta. Clique duas vezes em uma aba para renomeá-la; Enter salva e Esc cancela.
• Troca: clique em uma aba, pressione Cmd+1 a Cmd+8 para ir a uma aba pelo número, ou Cmd+← / Cmd+→ no macOS para a aba anterior ou seguinte (Ctrl+Alt+← / Ctrl+Alt+→ no Windows).
• Ordem: arraste uma aba para movê-la, ou pressione Cmd+↑ (Ctrl+↑ no Windows) para mover a aba ativa uma posição para a esquerda. Cmd+Shift+← e Cmd+Shift+→ a movem para a esquerda ou para a direita, mas o macOS pode capturá-los antes de o app os receber. Cmd+↓ não move uma aba: ele rola o painel em foco até o fim e foca a entrada dele. A lista da barra lateral mantém a mesma ordem.
• Largura: uma aba tem no máximo 220px de largura, e um nome mais longo é cortado. Passe o mouse sobre ela para ver o nome inteiro.
• Janela própria: clique com o botão direito em uma aba e escolha Mover aba para nova janela (oferecido quando a janela tem mais de uma aba). Mover para a janela principal a traz de volta, e Merge All Windows no ícone da barra de menus junta tudo de novo. Veja Painéis e divisões.
• Fechar: passe o mouse sobre uma aba e clique no ×. Se a aba tiver mais de um terminal, Confirmar o fechamento da aba do espaço de trabalho pergunta antes, e Fechar aba encerra todos os processos dela. Uma aba com um terminal fecha na hora.
• Fechar a última aba traz o Composer de volta.

A barra lateral à esquerda lista seus espaços de trabalho em Espaços de trabalho. Cada linha tem um ícone de projeto e duas linhas: o nome, depois o número de painéis e, quando as conversas são conhecidas, os tokens que elas usaram neste Mac (até os últimos 30 dias) e o custo a preços de tabela, como 6 Panes · 1.7M · $0.41. Passe o mouse sobre um espaço de trabalho e use o menu ⋮ dele para Renomear ou Fechar, ou arraste para reordenar. Novo espaço de trabalho abre uma nova aba do Composer. Espaços de trabalho, Terminais e o grupo Máquinas e SSH começam como três partes iguais da altura da barra lateral, com linhas em cartões suaves. Arraste a linha entre duas seções para redimensioná-las e dê dois cliques nela para restaurá-la. As alturas são mantidas quando você oculta a barra lateral e quando reinicia. Máquinas e SSH compartilham uma altura, porque só uma das duas fica aberta por vez. Abaixo dos espaços de trabalho, Terminais lista os terminais do espaço de trabalho ativo, com o agente e o número de tokens dele na segunda linha, seguidos do branch git da pasta do painel quando um é conhecido (não em painéis SSH nem em painéis de outros computadores); clique em um para focar o painel dele. A chave Todos | Recentes muda a lista: Recentes mostra todos os painéis de todas as abas deste Mac, com a saída mais recente primeiro, e a ordem fica parada enquanto você usa, então um clique cai na linha que você mirou (os painéis de outras máquinas não aparecem ali). Passe o mouse sobre um título cortado para vê-lo inteiro. Embaixo deles, Máquinas lista os outros computadores com MXterm Pro que você pareou (veja Painéis e divisões) e começa aberta só quando há uma pareada; um botão de configurações no cabeçalho abre as Configurações em Acesso remoto e dispositivos. Abra uma máquina para ver as abas dela como cartões com os painéis, cada painel em um de cinco estados, como no celular, e, para uma aba cuja Control Room está ativa, uma linha que você pode abrir para ler as últimas 100 mensagens (somente leitura). O menu ⋯ de uma máquina também oferece Nova Control Room… e Nova sessão… (veja Painéis e divisões). Você pode fixar uma máquina ou uma aba e arrastar as linhas para reordená-las; se um endereço salvo parar de funcionar, o MXterm Pro tenta por conta própria os outros endereços conhecidos da máquina (rede local ou Tailscale). Uma aba que você abriu de outra máquina termina a segunda linha em Espaços de trabalho com o nome dessa máquina e como ela é alcançada, como 4 Panes · Mac Thuy · Tailscale, e os painéis dela em Terminais mostram os próprios nomes e agentes, com o nome da máquina no fim. Abaixo, SSH lista seus hosts SSH salvos: clique em um para abri-lo em uma nova aba. O cabeçalho dessa seção tem um botão Novo host e um botão que abre o gerenciador de SSH e SFTP. Na parte de baixo ficam Configurações e a versão do app.

Oculte ou mostre a barra lateral com Cmd+B no macOS (Ctrl+B no Windows) ou com o botão da barra lateral à esquerda da barra de título. Há mais atalhos em Atalhos de teclado, e a divisão e a organização dos painéis estão em Painéis e divisões.

Tudo o que está nesta página funciona no plano Free. O Free não tem limite de painéis: você pode abrir quantos painéis quiser, em todas as abas e janelas. Além dos painéis, o Free limita seis coisas por padrão, e uma licença Pro remove todos os limites. O Pro também adiciona My Devices (abra seus outros Macs conectados sem código nem senha) e uma senha de acesso Permanente (não expira).

Esses são os números padrão. O mxterm.net pode alterá-los para o Free dentro de faixas fixas, e uma alteração pode expirar; depois disso, os padrões voltam a valer. O limite é verificado quando você adiciona algo: reduzi-lo nunca fecha o que já está aberto ou salvo, e adicionar uma segunda máquina no Free abre a janela de upgrade, enquanto as máquinas que você já tem continuam salvas. O mesmo vale para uma segunda Control Room com membros: uma sala sem membros não conta, e as salas que você já tem continuam. O próprio app aplica os limites de Control Room e de máquinas. 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. Os dois limites de controle remoto recusam só algo novo: um computador já pareado e um painel já compartilhado continuam como estão.

O acesso remoto tem mais uma linha do Pro: o Free pode ativar uma senha de acesso que dura até 8 horas (Temporária), enquanto uma senha Permanente, ou uma Temporária com mais de 8 horas (até 7 dias), exige o Pro. Uma senha tem pelo menos 6 caracteres. Veja Configurações.

Navegar, editar, enviar e baixar arquivos por SFTP é grátis, e o Token Meter também.

Quando você chega a um limite, uma janela o identifica e oferece Obter o MXterm Pro, Inserir chave de licença ou Agora não. Os planos estão em Preços; a ativação de uma chave está descrita em Configurações.

Fechar a única janela do MXterm Pro encerra o app, em qualquer plataforma. Ele não continua rodando em segundo plano: todo terminal e todo agente de todas as abas é parado. Encerrar interrompe toda conexão ativa. O MXterm Pro foi feito para salvar seus compartilhamentos e restaurá-los na próxima abertura, quando o mesmo painel estiver rodando de novo; um compartilhamento que não pode ser verificado é descartado, nunca ampliado.

Se você abriu uma segunda janela, fechar uma delas não encerra o app. Uma janela que ainda tem terminais pergunta antes Fechar esta janela? e oferece mover as abas dela para a outra janela em vez de encerrá-las. Só o fechamento da última janela encerra o app.

Enquanto o app está rodando, o ícone dele na barra de menus (a bandeja do sistema no Windows) traz a janela para a frente quando você clica, e o menu dele tem Show MXterm Pro, Merge All Windows, Check for Updates… e Quit.

Quando você abre o app de novo, suas abas de espaço de trabalho voltam com o layout dos painéis, e cada painel começa de novo na própria pasta. Um painel do Claude Code reabre a própria conversa pelo id quando o app se lembrava de uma, e começa uma conversa nova caso contrário. Os painéis do Gemini CLI, OMP e Grok são iniciados com --resume e os do Codex com codex resume, para você retomar a conversa anterior; os outros painéis começam do zero. Abas que ainda estavam no Composer não são restauradas.

O app também registra, a cada 3 segundos mais ou menos, o que cada painel está executando. Para o Claude Code e o OMP, ele guarda a conversa que estava aberta, então o painel reabre essa e não um seletor nem a mais recente da pasta. Se essa conversa não existir mais, o Claude Code, o OMP e o Grok tentam de novo com um --resume simples na maioria dos shells, em vez de parar em um prompt vazio. Se você iniciou um agente por conta própria em um painel de terminal simples, o painel volta executando esse agente, retomado do mesmo jeito, mas sem a flag do Bypass Mode. No Windows, o app não lê o que um painel está executando, então nada disso é registrado lá.