QuickTerminal - Guia

Primeiros passos

1. Abra o app — você chega à tela inicial com suas sessões salvas e um botão para iniciar uma nova conexão.
2. Inicie um shell local — toque em Local Shell para abrir imediatamente uma sessão de terminal na sua máquina.
3. Crie uma sessão remota — toque em New Session, escolha um protocolo (SSH, Telnet, Mosh, Serial, AWS SSM ou GCP IAP) e insira os detalhes da conexão.
4. Salve a sessão — dê um nome e atribua um grupo. Reconecte com um único toque a qualquer momento.
5. Explore a Command Palette — pressione Ctrl + Shift + P para acessar todas as ações em uma lista pesquisável.

Visão geral da interface

Barra lateral

A barra lateral retrátil organiza seu espaço de trabalho:

• Sessões — todas as sessões salvas agrupadas por projeto ou ambiente
• SFTP — abra o navegador gráfico de arquivos para a conexão ativa
• Snippets — sua biblioteca de comandos salvos
• AI Agent — abra o painel do assistente AI
• Configurações / Ajuda — na parte inferior da barra lateral

Área do Terminal

A área de trabalho central mostra:

• O terminal ativo com entrada e saída completas
• Uma barra de abas para alternar entre várias sessões abertas
• A barra de status na parte inferior mostrando o estado da conexão, protocolo e timer da sessão
• Uma visualização em painéis divididos opcional para executar vários terminais lado a lado

Command Palette

Pressione Ctrl + Shift + P para abrir a Command Palette. Digite para filtrar as ações e pressione Enter para executá-las. Todos os recursos do QuickTerminal estão acessíveis pela palette.

Shell local

O QuickTerminal inclui um shell local totalmente integrado para executar comandos em sua própria máquina.

• Detecção de shell — detecta e usa automaticamente seu shell padrão (bash, zsh, fish, PowerShell)
• Rastreamento do diretório de trabalho — a barra de status sempre mostra seu diretório atual
• Histórico de comandos — histórico persistente entre sessões, pesquisável com Ctrl + R
• Variáveis de ambiente — herda seu perfil de shell e ambiente automaticamente

$ echo "Welcome to QuickTerminal"
Welcome to QuickTerminal
$ ssh user@server.example.com
# Or create a saved session for one-tap reconnection

Conexões SSH

SSH é o protocolo principal para acesso remoto seguro. O QuickTerminal oferece suporte a todos os recursos modernos do SSH.

Autenticação

• Senha — insira credenciais na hora da conexão ou salve-as com segurança na sessão
• Baseada em chave — use chaves RSA, Ed25519 ou ECDSA. Importe de arquivo ou gere novos pares de chaves
• Agent forwarding — encaminhe seu SSH agent local ao host remoto para acesso multi-hop contínuo
• Keyboard-interactive — oferece suporte a autenticação de dois fatores e prompts de desafio-resposta

Port Forwarding

• Encaminhamento local — tunele uma porta remota para sua máquina local
• Encaminhamento remoto — exponha um serviço local ao host remoto
• Encaminhamento dinâmico — crie um proxy SOCKS através do túnel SSH

Configuração de sessão

# Example session fields
Host:       server.example.com
Port:       22
Username:   deploy
Auth:       Key (Ed25519)
Forwarding: Local 8080 → remote 80

Outros protocolos

Telnet

Configure o host e a porta. As conexões Telnet não são criptografadas; use apenas em redes confiáveis ou para equipamentos que o exigem.

Mosh

Requer o servidor Mosh instalado no host remoto. O QuickTerminal gerencia o handshake SSH inicial e a configuração de sessão UDP automaticamente. Ideal para condições de rede móveis ou instáveis.

Serial

Selecione a porta serial, o baud rate (9600, 19200, 38400, 57600, 115200, etc.), bits de dados, bits de parada, paridade e controle de fluxo. O terminal exibe dados seriais brutos e oferece suporte ao envio de sinais de break.

AWS SSM

Autentique-se com suas credenciais AWS ou função IAM. Selecione a instância de destino por ID ou nome. O QuickTerminal invoca o plugin de sessão SSM para estabelecer a conexão.

GCP IAP

Autentique-se com sua conta Google Cloud. Selecione o projeto, a zona e a instância. O QuickTerminal cria o túnel através do IAP usando suas permissões IAM.

Navegador SFTP

O navegador SFTP integrado oferece um gerenciador gráfico de arquivos para qualquer host conectado via SSH.

• Navegar por diretórios — navegue no sistema de arquivos remoto com uma visualização em árvore e lista familiar
• Fazer upload de arquivos — arraste e solte arquivos da sua máquina local ou use o botão de upload
• Baixar arquivos — selecione arquivos e baixe-os para um diretório local
• Editar remotamente — abra arquivos de texto em um editor integrado e salve diretamente no servidor
• Permissões — visualize e modifique permissões, propriedade e timestamps dos arquivos
• Pesquisar — encontre arquivos por nome dentro da árvore do diretório atual

Agentes AI

Os agentes AI do QuickTerminal ajudam você na composição de comandos, análise de saída e automação de tarefas.

O que os agentes AI podem fazer

• Geração de comandos — descreva o que deseja em linguagem natural e o agente sugerirá o comando certo
• Explicação de saída — cole ou envie a saída do terminal ao agente para uma análise legível
• Diagnóstico de erros — compartilhe mensagens de erro e obtenha correções sugeridas com explicações
• Automação multi-etapa — descreva um fluxo de trabalho e o agente gerará uma sequência de comandos
• Geração de scripts — peça ao agente para criar shell scripts para tarefas repetitivas

Usando o painel do agente

1. Abra o painel AI Agent na barra lateral ou pressione Ctrl + Shift + A.
2. Digite sua solicitação em linguagem natural.
3. Revise o comando ou explicação sugeridos.
4. Clique em Insert para colar o comando no seu terminal, ou Copy para copiá-lo.

Snippets

Snippets permitem salvar, organizar e inserir rapidamente comandos usados com frequência.

Criando um snippet

1. Abra o painel Snippets na barra lateral.
2. Toque em New Snippet.
3. Insira o comando, um nome e uma descrição opcional.
4. Use a sintaxe ${variable_name} para templates parametrizados.
5. Salve em sua biblioteca de snippets.

Variáveis de template

# Snippet with variables
$ ssh ${user}@${host} -p ${port:22}
# ${port:22} uses 22 as default if not specified

Ao inserir um snippet parametrizado, o QuickTerminal pede para você preencher cada variável antes de inserir o comando final.

Organizando snippets

• Atribua tags para agrupar snippets relacionados (ex.: deployment, monitoring, database)
• Pesquise snippets por nome, conteúdo ou tag
• Fixe seus snippets mais usados para acesso rápido no topo da lista

Command Palette

A Command Palette é um lançador universal de ações acessível de qualquer lugar no QuickTerminal.

• Pressione Ctrl + Shift + P para abrir
• Digite para filtrar as ações — a correspondência aproximada encontra rapidamente o que você precisa
• As ações incluem: criação de sessões, abertura do SFTP, alternância de configurações, execução de snippets e mais
• As ações usadas recentemente aparecem no topo para acesso rápido

# Example palette actions
New SSH Session
Open SFTP Browser
Insert Snippet...
Toggle Split Pane
Open AI Agent
Manage Execution Policies

Execution Policies

As Execution Policies permitem definir regras de segurança que protegem contra comandos acidentais ou destrutivos.

Tipos de política

Configurando políticas

1. Vá em Settings > Execution Policies.
2. Toque em New Policy.
3. Defina o pattern — um prefixo de comando, regex ou palavra-chave para correspondência.
4. Escolha a ação (block, confirm, sandbox ou log).
5. Defina o escopo — aplicar a todas as sessões, grupos específicos ou sessões individuais.

Configurações

Aparência

• Tema — modos Claro e Escuro com detecção da preferência do sistema
• Família da fonte — escolha sua fonte monoespaçada preferida para o terminal
• Tamanho da fonte — tamanho ajustável do texto do terminal
• Esquema de cores — selecione entre paletas de cores integradas ou importe esquemas personalizados

Terminal

• Buffer de scrollback — configure quantas linhas de histórico manter na memória
• Estilo do cursor — bloco, sublinhado ou barra
• Comportamento do bell — flash visual, som do sistema ou silencioso
• Copiar ao selecionar — copia automaticamente o texto destacado para a área de transferência

Conexões

• Porta SSH padrão — defina uma porta padrão personalizada para novas sessões SSH
• Intervalo Keep-alive — envia pacotes periódicos para evitar timeouts de conexão
• Reconectar ao desconectar — tenta automaticamente restaurar conexões interrompidas

Execution Policies

• Gerencie regras de block, confirm, sandbox e log
• Ative ou desative políticas por grupo de sessão

Atalhos de teclado

Dicas e truques

Solução de problemas

Privacidade

• O QuickTerminal não requer conta ou login.
• Não são coletados dados de uso, analytics ou telemetria.
• Todas as credenciais são criptografadas usando keystores nativos da plataforma.
• Os agentes AI são executados inteiramente no dispositivo — nenhum dado é enviado a servidores externos.
• O histórico de sessão e os snippets são armazenados localmente em seu dispositivo.
• As transferências SFTP são diretas entre seu dispositivo e o host remoto.
• O app funciona totalmente offline para shell local e conexões seriais.