essh

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

Un terminal. Sessioni SSH multiple. Insight live sugli host. Zero cambio di contesto.

ESSH è un client SSH puro Rust con una TUI nitida e ispirata a Netwatch, pensata per operatori che vogliono più di una semplice shell.
Connettiti velocemente, monitora lo stato dell'host in tempo reale, trasferisci file, gestisci inoltri e mantieni una traccia di audit pulita senza lasciare il terminale.

Perché ESSH

La maggior parte degli strumenti SSH si ferma a "sei connesso". ESSH è costruito per ciò che accade dopo.

• Lavora su più host senza dover gestire finestre di terminale separate.
• Visualizza CPU, memoria, dischi, rete e pressione dei processi mentre sei sulla macchina.
• Tieni diagnostica di connessione, registrazioni, trasferimento file e port forwarding nello stesso flusso di lavoro.
• Rimani in un'interfaccia terminal-first che sembra veloce, densa e operativa.

ESSH è per chi gestisce sistemi reali e vuole che il proprio client SSH si comporti come uno strumento operativo, non solo come un mezzo di trasporto.

Cosa Lo Rende Efficace

Demo

_{Dashboard, terminale multi-sessione, monitor host, pannello diviso, palette comandi, file browser e port forwarding in un unico flusso.}

Installa Velocemente

Al momento ESSH supporta solo build per macOS e Linux.

crates.io

cargo install essh

dal sorgente

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

Windows non è un target di build locale supportato al momento.

Primi 60 Secondi

# Avvia la dashboard
essh

# Connessione diretta
essh connect user@host

# Usa una chiave specifica
essh connect user@host -i ~/.ssh/id_ed25519

# Usa una chiave crittografata (ESSH chiederà la passphrase)
essh connect user@host -i ~/.ssh/id_ed25519_encrypted

# Importa host dalla tua configurazione SSH esistente
essh hosts import

# Esegui un comando su un gruppo taggato
essh run web-servers -- uptime

Al primo avvio, ESSH crea ~/.essh/ e ti fornisce una configurazione funzionante, una cache SQLite degli host, una directory per la diagnostica e un percorso per i log di audit.

Il Prodotto in una Schermata

┌─ 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               │
└───────────────────────────────────────────────────────────────────┘

L'idea è semplice: fedeltà del terminale quando hai bisogno di una shell, segnale operativo quando hai bisogno di contesto.

Punti Salienti delle Funzionalità

Multi-Sessione Senza Caos

• Fino a 9 sessioni SSH simultanee.
• Cambio istantaneo con Alt+1-9, Alt+←/→ e Alt+Tab.
• Terminale a pannello diviso con monitor host tramite Alt+s.
• Cronologia di scrollback preservata anche dopo le riconnessioni.

Insight Remoto Senza Agente

• CPU, memoria, carico, disco, rete, uptime e processi principali.
• Cronologia sparkline e indicatori a barre ottimizzati per una scansione rapida.
• Raccolti tramite canali exec SSH, quindi non è necessario installare nulla in remoto.

Funzionalità Fleet Che Contano Davvero

• Importa host da ~/.ssh/config.
• Assegna tag agli host e definisci gruppi.
• Esegui comandi su un gruppo con fan-out parallelo.
• Sondaggi fleet in background con cronologia della latenza e stato colorato.

Costruito per il Vero Lavoro SSH

• Autenticazione con chiave pubblica, password e agente SSH.
• Chiavi private OpenSSH crittografate con richieste interattive di passphrase.
• Verifica delle chiavi host TOFU con modalità strict, prompt e auto.
• Cinque temi integrati con cambio istantaneo e preferenze persistenti.
• Supporto per jump host / ProxyJump.
• Inoltri di porte locali, aggiunta e rimozione in tempo reale.
• File browser a due pannelli per upload e download.

Reti di Sicurezza Integrate

• Riconnessioni con backoff esponenziale.
• Log di audit strutturati in JSON.
• Diagnostica di sessione salvata come JSONL.
• Registrazione e riproduzione facoltativa in formato asciicast v2.
• Notifiche basate su regex per output importanti.

Facilità d'Uso, Non Cerimonia

Importa ciò che hai già

essh hosts import

Usa chiavi private crittografate

ESSH supporta chiavi private protette da passphrase sia per connessioni CLI dirette che per la TUI.

# Connessione CLI singola con chiave crittografata
essh connect user@host -i ~/.ssh/id_ed25519_encrypted

# Aggiungi una chiave crittografata alla cache locale
essh keys add ~/.ssh/id_ed25519_encrypted --name laptop-key

Cosa aspettarsi:

• Se la chiave è crittografata, ESSH chiede la passphrase e poi prosegue con la connessione.
• Gli host salvati nella TUI si comportano allo stesso modo: selezionando un host che usa una chiave crittografata, verrà richiesta la passphrase quando necessario.
• Le connessioni tramite jump host e le esecuzioni su gruppi rispettano anch'esse le chiavi crittografate.
• Se preferisci evitare richieste ripetute, caricare la chiave in ssh-agent funziona comunque.

Porta ordine in un fleet caotico

[[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"

Esegui un comando sul fleet senza uscire dal toolchain

essh run web-servers -- sudo systemctl status nginx

Riproduci ciò che è successo in seguito

essh session list
essh session replay <session-id>

Flusso da Tastiera

Globali

Operazioni di Sessione

Dashboard

Temi

ESSH include lo stesso set di temi integrati di NetWatch: dark, light, solarized, dracula e nord.

Usa t nelle viste stile dashboard o Alt+t da qualsiasi sessione per cambiare tema istantaneamente. Il tema selezionato viene salvato in ~/.essh/config.toml come:

theme = "dark"

Cheat Sheet CLI

essh                                  # avvia dashboard
essh connect user@host                # sessione SSH diretta
essh hosts list                       # elenca host in cache
essh hosts import                     # importa da ~/.ssh/config
essh keys list                        # elenca chiavi in cache
essh diag <session-id>                # ispeziona diagnostica
essh session list                     # elenca registrazioni
essh session replay <session-id>      # riproduce una registrazione
essh audit tail --lines 20            # ispeziona eventi di audit recenti
essh config show                      # stampa configurazione attiva

Configurazione

ESSH memorizza il suo stato in ~/.essh/.

~/.essh/
├── config.toml      # configurazione principale
├── cache.db         # cache host e chiavi
├── audit.log        # traccia di audit strutturata
├── sessions/        # log di diagnostica per sessione
├── recordings/      # registrazioni asciicast
└── known_cas/       # autorità di certificazione fidate

Comandi utili:

essh config init
essh config edit
essh config show

Se vuoi la configurazione completa e le specifiche dell'architettura, vedi SPEC.md.

Sicurezza

• Le chiavi host vengono verificate e memorizzate nella cache.
• La politica TOFU è configurabile: strict, prompt o auto.
• Cipher e algoritmi KEX consentiti possono essere limitati.
• Gli eventi di audit vengono scritti come JSON strutturato.
• La diagnostica e le registrazioni delle sessioni sono artefatti espliciti e ispezionabili.

ESSH è costruito per dare agli operatori maggiore visibilità senza nascondere ciò che lo strumento fa per loro conto.

Build e Validazione

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

GitHub Actions esegue gli stessi controlli principali su push e pull request verso main.

Contribuire

I contributi sono benvenuti.

1. Fai il fork del repository.
2. Crea un branch.
3. Apporta le modifiche.
4. Esegui cargo test, cargo clippy --all-targets --all-features -- -D warnings e cargo fmt --check.
5. Apri una pull request.

Licenza

MIT. Vedi LICENSE.

_{ESSH è un SSH nativo del terminale con un po' più di ambizione.}