Instalação

macOS e Linux, x86_64 e arm64. Os pacotes pré-compilados não precisam de toolchain Rust. Em tempo de execução, o sshelf exige OpenSSH 8.4+, que é de onde vem o fornecimento automático de senha.

Homebrew (macOS ou Linux):

Instalador via shell (binário pré-compilado, detecta sua plataforma):

Detalhes completos e configuração de completions: Guia de instalação.

Por que eu construí isso

Eu administro algumas dezenas de máquinas (um homelab, alguns VPSes, algumas caixas atrás de um bastion), e vivia digitando ssh -J bastion -i ~/.ssh/some-key -p 2222 user@host de memória ou vasculhando meu histórico de shell para encontrá-lo. Todo gerenciador de SSH que tentei queria ou ser dono do ~/.ssh/config ou me dar uma conta e sincronizar meus hosts pelo servidor de alguém. Eu não queria nenhum dos dois. Eu queria um lançador que mantivesse sua própria lista, montasse o comando e saísse do caminho. E um lugar para guardar as senhas das poucas máquinas que não podem usar chaves, sem nunca colocá-las em um arquivo. Então eu o construí.

O que você obtém

Lançador com busca difusa

Digite para filtrar. Enter conecta. Seus hosts mais usados sobem para o topo sozinhos (frecência: contagem de uso, decaída por recência), e tag:prod / site:homelab estreitam a lista ainda mais. Ctrl-y copia o comando que ele montou em vez de executá-lo. Pelo shell, sshelf prod-web conecta pelo nome e sshelf - reconecta ao último host, ambos sem abrir a TUI.

Ele faz exec() no seu ssh

O sshelf monta o argv a partir do registro do host, derruba sua própria interface e então substitui a si mesmo pelo OpenSSH. Não há wrapper entre você e a sessão: um TTY real, seu ssh, suas flags sem config. Quando a sessão termina, você volta ao seu shell, não a um menu. O comando que ele executa é exatamente o que Ctrl-y mostra a você. Como o comando é montado.

Transferência de arquivos em dois painéis

Ctrl-t abre seus arquivos à esquerda e os do host à direita, por uma única conexão autenticada. Space marca, Ctrl-a marca tudo o que o filtro mostra, Ctrl-s envia o conjunto inteiro em qualquer direção, F7 cria um diretório. Um nome que o destino já possui é ignorado, nunca sobrescrito.

Encaminhamentos de porta em segundo plano

Ctrl-f abre um túnel Local, Remoto ou SOCKS que continua rodando depois que você sai do sshelf, e depois que você fecha o terminal. F4 lista todos eles em todos os hosts e interrompe o que você escolher. Eles são rastreados por pid e reconciliados com os processos que estão realmente rodando, então nada permanece em uma lista depois de morrer. Sem daemon, sem supervisor.

Modo tmux

Defina tmux = "window" ou "pane" e Enter abre o host em uma nova janela do tmux (nomeada com o nome do host) ou em um novo painel, em vez de substituir o sshelf. Encerre a sessão e o seletor ainda está ali, ainda rodando.

Sites e tags

F3 gerencia sites: um site agrupa hosts e pode carregar um bastion, usuário, porta e chave compartilhados que seus membros herdam no momento da conexão, preenchendo apenas os campos que um host deixa vazios. Tags são rótulos de forma livre nos quais você filtra. Ambos aparecem na lista, e um bastion herdado aparece no comando que o sshelf monta.

Senhas sem sshpass

Para os hosts que não podem usar chaves, o sshelf armazena a senha no chaveiro do seu sistema operacional (ou um cofre criptografado com age em uma máquina sem cabeça) e a fornece por meio de SSH_ASKPASS quando o ssh pede. Ele responde apenas a prompts com o formato de uma senha real ou prompt de passphrase, então um servidor não pode pescar o segredo com texto parecido. A senha nunca está em um arquivo, nunca em ps, nunca em uma linha de comando. Hosts que também querem um código de verificação recebem um prompt para ele antes de a conexão começar. Senhas, chaves e 2FA · Segurança.

Exportação para ssh_config

sshelf export escreve um fragmento de ssh_config próprio e dá a você uma única linha Include para colar em ~/.ssh/config você mesmo. Depois disso, ssh, scp, rsync, git comuns e qualquer coisa que leia a config do SSH (VS Code Remote-SSH, JetBrains Gateway) resolvem seus hosts do sshelf pelo nome, bastion e tudo. O arquivo é atualizado sempre que seus hosts mudam. O sshelf ainda não escreve nada em ~/.ssh.

Importe o que você já tem

sshelf import lê ~/.ssh/config, estritamente somente leitura, e copia os hosts que consegue modelar. sshelf import --tailscale executa sua própria CLI tailscale e transforma sua tailnet em hosts pesquisáveis, com nomes MagicDNS, a tailnet como um site e tags ACL como tags. Ambos são somente adição, então reexecutar um deles é sempre seguro, e nenhum acontece a menos que você peça.

sshelf doctor

Um comando para quando algo não está funcionando. Ele verifica sua versão do OpenSSH, se o backend de segredos realmente abre, se hosts.toml faz parse, hosts apontando para um site que não existe, um socket de agente ausente e uma exportação que se desviou. Ele nomeia a correção para cada um. Somente leitura, sai com 1 se algo falhar, e nunca contata um host.

Como ele se compara

Compilado em setembro de 2026 a partir do próprio README de cada projeto (e, para o Termius, seu site). Uma célula lendo "não informado" significa que a documentação do próprio projeto não diz.

O sshelf não tem dashboards, nem gerenciamento de contêineres, nem compartilhamento em equipe, nem build para Windows. Os três primeiros são escolhas, e PRIVACY.md explica o porquê: cada um significaria o sshelf guardando algo seu, ou conversando com algo por conta própria.

O que ele nunca fará

• Sem telemetria. Sem analytics, sem relatórios de crash, sem verificação de atualização.
• Sem conta, sem nuvem, sem servidor de sincronização. Não há nada para se cadastrar.
• Sem tokens guardados. O sshelf nunca armazena uma credencial de nuvem ou API.
• Sem chamadas de rede próprias. O único tráfego é a sessão SSH que você pediu.
• Nunca edita ~/.ssh/config e nunca escreve nada em ~/.ssh.
• Sem segredos em hosts.toml. Esse arquivo é seguro para commitar e compartilhar.
• Sem Electron. Um único binário, cerca de quatro megabytes.

PRIVACY.md diz o que ele lê, escreve, executa e envia. SECURITY.md é o modelo de ameaças para segredos armazenados.

Primeiros cinco minutos

Na TUI: digite para filtrar (mais tag:NAME / site:NAME) e Enter para conectar. F1 mostra todas as teclas.

Documentação

O guia do usuário cobre tudo: Quickstart · Referência da CLI · Configuração · FAQ · sshelf doctor. Há páginas por recurso para transferência de arquivos, encaminhamento de porta, sites e tags, senhas e 2FA e exportação de config SSH. Decisões de arquitetura e design vivem em docs/, e há um llms.txt para as máquinas.

Perguntas e ideias

Pergunte, sugira um recurso ou mostre o que você construiu com ele em GitHub Discussions. Contribuições são bem-vindas. Comece por CONTRIBUTING.md.

Suporte

Se o sshelf for útil para você, uma gorjeta em Bitcoin é apreciada (totalmente opcional):

Bitcoin: bc1qcdeyhpwq76u97dhymx876n49uq85z4y3ccrpje

Licença

Duplamente licenciado sob MIT ou Apache-2.0, à sua escolha (a norma do ecossistema Rust).