essh

                         ███████╗███████╗███████╗██╗  ██╗
                         ██╔════╝██╔════╝██╔════╝██║  ██║
                         █████╗  ███████╗███████╗███████║
                         ██╔══╝  ╚════██║╚════██║██╔══██║
                         ███████╗███████║███████║██║  ██║
                         ╚══════╝╚══════╝╚══════╝╚═╝  ╚═╝
                           Enhanced SSH for people with fleets

Um terminal. Múltiplas sessões SSH. Visibilidade ao vivo do host. Zero mudança de contexto.

ESSH é um cliente SSH puro em Rust com uma TUI nítida, inspirada no Netwatch, para operadores que querem mais do que um shell simples.
Conecte-se rapidamente, monitore a saúde do host em tempo real, transfira arquivos, gerencie encaminhamentos e mantenha um rastro de auditoria limpo sem sair do terminal.

Por que ESSH

A maioria das ferramentas SSH para em "você está conectado." ESSH foi construído para o que acontece depois disso.

• Trabalhe em vários hosts sem gerenciar janelas de terminal.
• Veja CPU, memória, discos, rede e pressão de processo enquanto você está na máquina.
• Mantenha diagnósticos de conexão, gravações, transferência de arquivos e encaminhamento de porta no mesmo fluxo de trabalho.
• Fique em uma interface que prioriza o terminal, que parece rápida, densa e operacional.
• ESSH é para pessoas que gerenciam sistemas reais e querem que seu cliente SSH funcione como uma ferramenta de operações, não apenas como um meio de transporte.

O Que O Torna Impactante

Demo

_{Dashboard, terminal multi-sessão, monitor de host, painel dividido, paleta de comandos, navegador de arquivos e encaminhamento de porta em um único fluxo.}

Instalação Rápida

ESSH atualmente suporta apenas builds para macOS e Linux.

crates.io

cargo install essh

a partir do código fonte

git clone https://github.com/matthart1983/essh.git
cd essh
cargo build --release
./target/release/essh

Windows não é um alvo de build local suportado no momento.

Primeiros 60 Segundos

# Launch the dashboard
essh

# Direct connect
essh connect user@host

# Use a specific key
essh connect user@host -i ~/.ssh/id_ed25519

# Use an encrypted key (ESSH will prompt for the passphrase)
essh connect user@host -i ~/.ssh/id_ed25519_encrypted

# Pull hosts from your existing SSH config
essh hosts import

# Run a command across a tagged group
essh run web-servers -- uptime

Na primeira execução, o ESSH cria ~/.essh/ e fornece um config funcional, cache de hosts SQLite, diretório de diagnósticos e caminho de log de auditoria.

O Produto Em Uma Tela

┌─ ESSH ── [1] web-prod  [2] db-primary  [3] staging ───────────────┐
│ deploy@web-prod:~$                                                │
│                                                                   │
│   journalctl -u api -f                                            │
│                                                                   │
├───────────────────────────────────────────────────────────────────┤
│ RTT 12.3ms   ↑1.2KB/s   ↓48.5KB/s   Loss 0.0%   ● Excellent       │
├───────────────────────────────────────────────────────────────────┤
│ CPU  23%  ▁▂▃▄▅▆▅▃▂▁     MEM  40%  ████████████████░░░░░░░░░       │
│ LOAD 0.82 0.64 0.55      NET  RX 48.5KB/s   TX 1.2KB/s            │
│ DISK / 62%               Top: node, nginx, postgres               │
└───────────────────────────────────────────────────────────────────┘

A ideia é simples: fidelidade de terminal quando você precisa de um shell, sinal operacional quando você precisa de contexto.

Destaques de Funcionalidades

Multi-Sessão Sem Bagunça

• Até 9 sessões SSH simultâneas.
• Troca instantânea com Alt+1-9, Alt+←/→, e Alt+Tab.
• Terminal com painel dividido mais monitor de host com Alt+s.
• Histórico de rolagem preservado entre reconexões.

Insight Remoto Sem Agente

• CPU, memória, carga, disco, rede, tempo de atividade e principais processos.
• Histórico de sparkline e medidores de barra ajustados para varredura rápida.
• Coletados através de canais de execução SSH, portanto não há nada extra para instalar remotamente.

Funcionalidades de Frota Que Realmente Importam

• Importar hosts de ~/.ssh/config.
• Marcar hosts e definir grupos.
• Executar comandos em um grupo com distribuição paralela.
• Sondagens de frota em segundo plano com histórico de latência e estado codificado por cores.

Construído Para Trabalho SSH Real

• Autenticação por chave pública, senha e agente SSH.
• Chaves privadas OpenSSH criptografadas com solicitações interativas de frase secreta.
• Verificação de chave de host TOFU com modos strict, prompt e auto.
• Cinco temas integrados com troca instantânea e preferências persistentes.
• Suporte a host de salto / ProxyJump.
• Encaminhamentos de porta locais, adição e remoção ao vivo.
• Navegador de arquivos de dois painéis para upload e download.

Redes de Segurança Integradas

• Reconexões com backoff exponencial.
• Log de auditoria JSON estruturado.
• Diagnósticos de sessão escritos como JSONL.
• Gravação e reprodução opcionais asciicast v2.
• Notificações em segundo plano baseadas em regex para saída importante.

Facilidade de Uso, Sem Cerimônia

Importe o que você já tem

essh hosts import

Use chaves privadas criptografadas

ESSH suporta chaves privadas protegidas por frase secreta tanto para conexões CLI diretas quanto para a TUI.

# One-off CLI connection with an encrypted key
essh connect user@host -i ~/.ssh/id_ed25519_encrypted

# Add an encrypted key to the local key cache
essh keys add ~/.ssh/id_ed25519_encrypted --name laptop-key

O que esperar:

• Se a chave estiver criptografada, o ESSH solicita a frase secreta da chave e então continua a conexão.
• Hosts salvos na TUI se comportam da mesma forma: selecionar um host que usa uma chave criptografada solicitará a frase secreta quando necessário.
• Conexões de host de salto e execuções em grupo também respeitam chaves criptografadas.
• Se você preferir evitar solicitações repetidas, carregar a chave no ssh-agent ainda funciona.

Traga estrutura para uma frota bagunçada

[[hosts]]
name = "web-prod-1"
hostname = "10.0.1.10"
user = "deploy"
key = "~/.ssh/id_ed25519"

[hosts.tags]
env = "production"
role = "web"

[[host_groups]]
name = "web-servers"

[host_groups.match_tags]
role = "web"

Execute um comando de frota sem sair da ferramenta

essh run web-servers -- sudo systemctl status nginx

Reproduza o que aconteceu depois

essh session list
essh session replay <session-id>

Fluxo de Teclado

Global

Operações de Sessão

Dashboard

Temas

ESSH vem com o mesmo conjunto de temas integrados que o NetWatch: dark, light, solarized, dracula e nord.

Use t em visualizações estilo dashboard ou Alt+t de qualquer sessão para alternar temas instantaneamente. O tema selecionado é salvo em ~/.essh/config.toml como:

theme = "dark"

Folha de Referência CLI

essh                                  # launch dashboard
essh connect user@host                # direct SSH session
essh hosts list                       # list cached hosts
essh hosts import                     # import from ~/.ssh/config
essh keys list                        # list cached keys
essh diag <session-id>                # inspect diagnostics
essh session list                     # list recordings
essh session replay <session-id>      # replay a recording
essh audit tail --lines 20            # inspect recent audit events
essh config show                      # print active config

Configuração

ESSH armazena seu estado em ~/.essh/.

~/.essh/
├── config.toml      # main configuration
├── cache.db         # host and key cache
├── audit.log        # structured audit trail
├── sessions/        # per-session diagnostics logs
├── recordings/      # asciicast recordings
└── known_cas/       # trusted certificate authorities

Comandos úteis:

essh config init
essh config edit
essh config show

Se você quiser a especificação completa de configuração e arquitetura, veja SPEC.md.

Segurança

• Chaves de host são verificadas e armazenadas em cache.
• Política TOFU é configurável: strict, prompt ou auto.
• Cifras permitidas e algoritmos KEX podem ser restritos.
• Eventos de auditoria são escritos como JSON estruturado.
• Diagnósticos e gravações de sessão são artefatos explícitos e inspecionáveis.

ESSH é construído para dar aos operadores mais visibilidade sem esconder o que a ferramenta está fazendo em nome deles.

Construir e Validar

cargo build
cargo test
cargo clippy --all-targets --all-features -- -D warnings
cargo fmt --check

GitHub Actions executa as mesmas verificações principais em pushes e pull requests para main.

Contribuindo

Contribuições são bem-vindas.

1. Faça um fork do repositório.
2. Crie uma branch.
3. Faça a alteração.
4. Execute cargo test, cargo clippy --all-targets --all-features -- -D warnings, e cargo fmt --check.
5. Abra um pull request.

Licença

MIT. Veja LICENSE.

_{ESSH é SSH nativo do terminal com um pouco mais de ambição.}