93 lines
3.6 KiB
Markdown
93 lines
3.6 KiB
Markdown
# Shell
|
|
|
|
## Chaîne interactive
|
|
|
|
```mermaid
|
|
flowchart LR
|
|
Z[Zsh] --> S[Starship]
|
|
Z --> A[Atuin]
|
|
Z --> F[FZF]
|
|
Z --> X[Zoxide]
|
|
Z --> E[Eza]
|
|
Z --> B[Bat]
|
|
Z --> Y[Yazi]
|
|
```
|
|
|
|
| Élément | Rôle |
|
|
| --- | --- |
|
|
| Zsh | shell interactif et point d'intégration |
|
|
| Starship | prompt configuré par `starship/.config/starship.toml` |
|
|
| Atuin | recherche d'historique local ; base et clé exclues de Git |
|
|
| FZF | sélection interactive et prévisualisations |
|
|
| Zoxide | navigation par fréquence |
|
|
| Eza | affichage enrichi des répertoires |
|
|
| Bat | lecture et prévisualisation colorée |
|
|
| Yazi | gestionnaire de fichiers terminal |
|
|
|
|
`.zprofile` initialise la session graphique via UWSM lorsque son contexte le
|
|
permet. `.zshenv` publie le socket de l'agent SSH utilisateur. `.zshrc` charge
|
|
les intégrations interactives, aliases et fonctions.
|
|
|
|
## Plugins Zsh et Tmux
|
|
|
|
Les plugins ne sont pas téléchargés à chaque ouverture du shell. Git épingle
|
|
leurs commits comme sous-modules :
|
|
|
|
| Intégration | Chemin versionné |
|
|
| --- | --- |
|
|
| Fast Syntax Highlighting | `zsh/.zsh/plugins/fast-syntax-highlighting` |
|
|
| FZF Tab | `zsh/.zsh/plugins/fzf-tab` |
|
|
| Zsh Autosuggestions | `zsh/.zsh/plugins/zsh-autosuggestions` |
|
|
| Catppuccin Tmux | `tmux/.config/tmux/plugins/catppuccin/tmux` |
|
|
|
|
Initialisation et contrôle :
|
|
|
|
```bash
|
|
git submodule update --init --recursive
|
|
git submodule status --recursive
|
|
```
|
|
|
|
La configuration Zsh vérifie la lisibilité des fichiers de plugins avant de
|
|
les sourcer. Le dépôt parent, et non une commande lancée au démarrage du shell,
|
|
reste propriétaire des versions.
|
|
|
|
## Scripts utilisateur
|
|
|
|
Le package `bin` déploie des commandes dans `~/.local/bin`. Les familles
|
|
principales sont :
|
|
|
|
- maintenance Pacman/AUR (`aurinstall`, `aurremove`, `aursearch`, `aurupdate`) ;
|
|
- énergie et batterie (`batlimit`, `battery-low-notify.sh`) ;
|
|
- session et applications (`sway-close`, `thunderbird-proton`,
|
|
`vmware-on-demand`, `nextcloud-sync`) ;
|
|
- développement local (`dcnvim`, `pi-dev`) ;
|
|
- acquisition/3D (`colmap-amd`, `scan3d`, `scan3d-watch`) ;
|
|
- intégrations Trainlog (`trainlog-bt-watch`) et autres projets locaux.
|
|
|
|
Ces scripts orchestrent des outils existants ; ils ne fournissent pas les
|
|
projets externes, credentials ou binaires système qu'ils appellent. Consulter
|
|
[`external-tools.md`](../.assets/external-tools.md) avant de les réutiliser sur
|
|
une autre machine.
|
|
|
|
|
|
|
|
Le 1er novembre 2026, les anciens helpers `cliphist-daemon.sh` (remplacé
|
|
par deux unités systemd), `sway-layout-ws1.sh`, `tlp-profile.sh`,
|
|
`kitty-ssh-add.sh` et `opencode-away` ont été retirés.
|
|
Les exécutables non versionnés `goose` et `agy` ont été mis en quarantaine
|
|
sous `~/.local/share/local-bin-archive/2026-11-01/`, hors du `PATH`.
|
|
Ils restent récupérables sans téléchargement ; supprimer cette archive
|
|
ultérieurement seulement après vérification de leur inutilité.
|
|
Les liens cassés `labfy-remote-ui`, `trainlog-btd`, `trainlog-syncd`
|
|
et `trainlog-sync-once` ont été retirés de `~/.local/bin` :
|
|
les services Trainlog en cours utilisent leurs exécutables de déploiement
|
|
via les drop-ins systemd. La commande `trainlog` reste disponible.
|
|
Le lien `labfy-investigation-web` a été préservé malgré sa cible
|
|
actuellement absente, car son unité systemd référence encore ce chemin.
|
|
|
|
## Données locales
|
|
|
|
L'historique Zsh et le store Atuin sont des données utilisateur, pas de la
|
|
configuration. La clé, la base, les sessions et tout identifiant Atuin restent
|
|
hors Git. Cette installation utilise Atuin localement ; aucune procédure de
|
|
compte ou de synchronisation distante n'est requise par le dépôt.
|