Basalt – Vos coffres Obsidian direct dans le terminal
Un TUI en Rust pour gérer vos coffres Obsidian sans quitter le terminal c’est ce que propose Basalt qui détecte automatiquement vos vaults, affiche le markdown avec un rendu visuel, et depuis la v0.12.3, y’a même un mode vim intégré. Le tout sans avoir besoin que la vraie app tourne en arrière-plan !
Et c’est là toute la différence avec
le CLI officiel d’Obsidian
dont je vous parlais il y a quelques jours. Car le CLI a besoin de l’app qui tourne via un socket local. Basalt, lui, lit en fait vos fichiers .md directement sur le disque. Du coup, ça marche en SSH, sur un serveur headless, ou sur n’importe quelle machine où vous avez juste vos fichiers markdown. C’est carrément pratique !
L’installation se fait en une commande :
cargo install basalt-tui
Au premier lancement, l’outil va alors chercher automatiquement vos coffres en lisant le fichier de config (sous macOS c’est dans ~/Library/Application Support/obsidian/obsidian.json). Comme ça, hop hop, vos vaults apparaissent, vous naviguez au clavier et vous passez d’un coffre à l’autre avec Ctrl+G. Vous pouvez aussi passer par
aqua
ou télécharger un binaire pré-compilé sur la page releases si vous préférez.
Basalt en action, navigation dans un vault Obsidian
Vous ouvrez alors une note et le markdown s’affiche avec un rendu visuel : les # disparaissent au profit d’indicateurs plus colorés, les blocs de code ont un fond distinct, les callouts > [!NOTE] sont reconnus, et les wiki-links [[Ma Note]] sont également parsés. D’ailleurs, quand vous renommez une note avec r, tous les wiki-links qui pointent vers elle sont mis à jour automatiquement dans tout le vault. Pas de search-replace à la main, ça fait toujours du bien !
Après faut pas s’attendre à un clone complet non plus. Y’a pas de rendu pour le gras, l’italique ou les tableaux. Pas de recherche dans les notes. Pas de graph view. L’éditeur intégré est expérimental (pas d’undo, pas de copier-coller, pas de sélection). C’est assumé de ce que j’ai pu voir, car le projet se présente comme un compagnon minimaliste.
Et c’est justement pour ça que le mode vim est le bienvenu, à vrai dire. Vous pouvez activer ça dans votre config TOML comme ceci :
vim_mode = true
Le mode vim en action dans Basalt
Et là vous avez hjkl pour naviguer, gg / G pour sauter en haut et en bas, w / b pour les mots, i pour l’insertion. C’est pas forcément aussi complet qu’un vrai vim, mais franchement, pour parcourir vos notes c’est agréable.
Le vrai kiff, c’est la config TOML qui permet de lancer un éditeur externe sur la note en cours :
[global]
key_bindings = [
{ key = "ctrl+alt+e", command = "exec:vi %note_path" },
]
Du coup, le workflow devient : Basalt pour naviguer et lire et un raccourci clavier pour ouvrir dans vim (ou n’importe quel éditeur) quand vous voulez éditer sérieusement. C’est le genre de combo qui fonctionne bien quand vous bossez en
full terminal
.
Le projet est sous licence MIT, écrit en Rust avec ratatui, et tourne sur Linux, macOS et Windows. Tiens, la v0.12.3 ajoute aussi la création de notes et dossiers directement depuis l’explorateur avec n et N… Ça avance plutôt vite comme projet !!
Voilà, si vos notes vivent dans des coffres et que le terminal c’est votre habitat naturel,
Basalt
fera bien le boulot.
Leave a Comment