docs: section export/import/synchronisation dans le README
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
1 files changed
+34 −0
M
README.md
+34 −0
README.md
@@ -59,6 +59,40 @@ sssh export > hosts.toml # sauvegarde / partage
sssh import hosts.toml # fusionne (--force pour écraser)
```
+## Export, import et synchronisation
+
+`sssh export` sort l'intégralité de tes hosts au format `hosts.toml` — le même format que le fichier de config, donc un export est directement réutilisable :
+
+```sh
+sssh export # affiche le TOML sur la sortie standard
+sssh export sauvegarde.toml # écrit dans un fichier
+```
+
+Seuls les hosts gérés par sssh sont exportés ; ceux de `~/.ssh/config` (lecture seule) n'en font pas partie.
+
+`sssh import` **fusionne** un fichier exporté avec tes hosts existants :
+
+- un nom qui n'existe pas encore est ajouté ;
+- un nom déjà présent est ignoré (ta version locale est conservée) ;
+- avec `--force`, les noms déjà présents sont écrasés par la version du fichier.
+
+```sh
+sssh import sauvegarde.toml # ajoute les nouveaux, garde le reste
+sssh import sauvegarde.toml --force # le fichier fait foi
+```
+
+### Synchroniser deux machines
+
+Le plus direct, de machine à machine (sssh sait déjà s'y connecter) :
+
+```sh
+sssh export | ssh autre-pc "sssh import /dev/stdin"
+# ou en deux temps :
+sssh export /tmp/hosts.toml && scp /tmp/hosts.toml autre-pc:
+```
+
+Pour une synchro permanente, pointe `$SSSH_CONFIG` vers un fichier partagé (dossier Syncthing, iCloud, Dropbox…) sur les deux machines, ou versionne `~/.config/sssh/` dans un repo git.
+
### Raccourcis du TUI
| Touche | Action |