Obsidian Sync prend désormais en charge les clients headless

 (help.obsidian.md)
2 points par GN⁺ 2026-03-01 | 1 commentaires | Partager sur WhatsApp
  • Obsidian Sync propose désormais un client headless permettant la synchronisation en ligne de commande sans application de bureau
  • Il permet d’effectuer la synchronisation de vaults dans des environnements non interactifs comme les pipelines CI, les serveurs et les scripts d’automatisation
  • La commande ob sync permet d’exécuter une synchronisation ponctuelle ou continue, avec prise en charge de l’authentification automatisée via la variable d’environnement OBSIDIAN_AUTH_TOKEN
  • Il inclut un ensemble de commandes détaillées pour créer un vault distant, configurer une liaison locale, vérifier l’état ou modifier les paramètres
  • Sous Windows et macOS, un module natif conserve la date de création des fichiers (birthtime) afin de renforcer l’intégrité des données

Aperçu

  • Le Headless Client d’Obsidian Sync est un outil qui permet de synchroniser des vaults sans application de bureau
    • Utile dans les environnements CI, les agents d’automatisation et les serveurs
    • Il permet de récupérer les dernières modifications ou de maintenir les fichiers continuellement à jour
  • Sur un même appareil, il ne faut pas utiliser simultanément Sync de bureau et Headless Sync, car il existe un risque de conflit de données
  • L’installation s’effectue avec la commande npm install -g obsidian-headless

Utilisation de base

  • Connexion : ob login
  • Afficher la liste des vaults distants : ob sync-list-remote
  • Configurer un vault local : ob sync-setup --vault "My Vault"
  • Synchronisation ponctuelle : ob sync
  • Synchronisation continue : ob sync --continuous
  • Dans un environnement non interactif, il est possible d’automatiser l’authentification en définissant la variable d’environnement OBSIDIAN_AUTH_TOKEN

Commandes principales

  • ob sync-list-remote : affiche la liste de tous les vaults distants du compte, y compris les vaults partagés
  • ob sync-list-local : affiche les vaults configurés en local et leurs chemins
  • ob sync-create-remote : crée un nouveau vault distant
    • Options : --name, --encryption (standard ou e2ee), --password, --region
  • ob sync-setup : configure la liaison entre un vault local et un vault distant
    • Options : --vault, --path, --password, --device-name, --config-dir
  • ob sync : lance la synchronisation du vault configuré
    • L’option --continuous permet de surveiller les modifications et d’assurer une synchronisation continue
  • ob sync-config : affiche ou modifie les paramètres de synchronisation du vault
    • Permet de définir la stratégie de conflit (merge/conflict), les types de fichiers, les catégories de paramètres à synchroniser, les dossiers exclus, etc.
  • ob sync-status : affiche l’état de synchronisation et les paramètres du vault
  • ob sync-unlink : dissocie le vault de la synchronisation et supprime les identifiants enregistrés

Module natif

  • Inclut un addon natif pour Windows et macOS qui définit la date de création des fichiers (birthtime)
    • Lorsque des fichiers sont téléchargés depuis le serveur, leur date de création d’origine est conservée
    • Il cible la version 3 de N-API et maintient la compatibilité ABI entre les versions de Node.js
  • Sous Linux, birthtime n’est pas pris en charge, donc l’addon n’est pas inclus, mais la synchronisation fonctionne normalement
  • Cibles pour les binaires précompilés :
    • win32-x64, win32-arm64, win32-ia32, darwin-x64, darwin-arm64

À lire aussi

1 commentaires

 
GN⁺ 2026-03-01
Avis sur Hacker News
  • Obsidian a ajouté de nouvelles fonctionnalités CLI
    Voir la documentation officielle
    Ces derniers temps, c’est vraiment amusant d’utiliser Obsidian avec une CLI d’IA. Même sans plugin, comme il s’agit simplement d’une structure de répertoires Markdown, on peut l’exploiter immédiatement
    • J’ai synchronisé Obsidian avec iCloud, mais l’accès au conteneur de fichiers iCloud demande l’autorisation d’accès complet au disque, ce qui était gênant
      Je me demande si tout le monde utilise Obsidian Sync payant, ou bien des alternatives comme SyncThing
    • Je suis content de voir la CLI revenir sur le devant de la scène
    • On ne peut pas encore voir directement les notes depuis la CLI, mais on peut déjà déclencher certaines actions comme la recherche
    • Cette fonctionnalité a l’air vraiment très utile, merci
  • J’ai participé directement à ce projet. Si vous avez des questions, je peux essayer d’y répondre
    • En remerciant l’équipe d’avoir créé Obsidian, quelqu’un demande s’il est prévu de packager le client de synchronisation headless pour pouvoir l’utiliser avec Docker ou Podman
      Il demande aussi si l’installation de obsidian-headless fournit également la CLI, ou si c’est uniquement dédié à la synchronisation
    • On disait justement au travail qu’il n’existait pas de synchronisation basée sur la CLI, donc je suis ravi de voir arriver une fonctionnalité officielle
      Je vais maintenant envisager Obsidian Sync officiel
    • Je me demande comment sont gérés les conflits de synchronisation sur le système de fichiers
      Par exemple, si deux modifications ont lieu en même temps et que l’une écrase l’autre, j’aimerais savoir ce qu’il advient de mes changements
    • Quelqu’un demande s’il est prévu de prendre en charge des autorisations par scoped token donnant accès uniquement à certains dossiers ou notes
      Il aimerait mettre à jour automatiquement certaines notes en fonction de changements d’état ou de tâches cron, tout en évitant l’accès à l’ensemble du vault
      Le produit lui plaît tellement qu’il a aussi acheté VIP Catalyst
    • Il cherche un guide ou un point de départ pour une configuration de collaboration en équipe où plusieurs personnes modifient et synchronisent les fichiers ensemble
  • Ce serait bien de pouvoir modifier un seul fichier Markdown
    Par exemple, s’il n’y a qu’un readme.md dans un projet, je n’ai pas envie de créer un vault séparé et un fichier de configuration juste pour l’ouvrir
    • Cette fonctionnalité devrait être ajoutée un jour
      Mais ce n’est pas simple, car beaucoup de fonctionnalités d’Obsidian dépendent de paramètres au niveau du vault
      Par exemple : quel thème utiliser, quels plugins activer, comment gérer l’autocomplétion des liens [[...]], etc.
  • C’était la fonctionnalité Obsidian que j’attendais le plus
    Cela semble vraiment utile pour l’automatisation côté serveur ou les tâches basées sur le RAG
  • J’ai trouvé et signalé un bug hier en testant le client headless, et aujourd’hui je vois qu’il a déjà été corrigé
    À ce sujet, j’ai écrit un billet de blog expérimental → utf9k.net/blog/obsidian-headless
    Ce workflow n’est pas parfait, mais j’ai l’impression qu’il réduit les frictions entre l’écriture et la publication immédiate
    Avant, j’utilisais Git ou une combinaison de plusieurs plugins Obsidian, mais c’était toujours complexe
  • Je pensais qu’il suffisait d’utiliser Nextcloud comme un dossier Markdown local, mais en fait non
    J’ai l’impression de l’avoir complètement mal utilisé
  • Je me demande si quelqu’un peut recommander un plugin Obsidian prenant en charge l’édition par IA sur mobile
    J’aimerais modifier un document en conversant avec lui, comme avec ChatGPT, mais je n’ai encore rien trouvé de vraiment adapté
    Je me demande aussi s’il est possible de faire du tool calling pour modifier seulement certaines parties, sans réécrire tout le document
    • J’ai essayé plusieurs plugins, mais au final, utiliser Claude Code en contrôle à distance a été ce qui marchait le mieux
  • Je n’utilise pas Obsidian sur desktop, mais je l’utilise sur téléphone
    Avec cette fonctionnalité, je pourrais synchroniser depuis le téléphone et ouvrir les documents sur desktop avec Neovim
  • Cela fait plus d’un an que je cherche “Obsidian CLI” tous les mois, donc je suis vraiment ravi que ce soit enfin là
    • Moi aussi, j’utilise Obsidian avec Claude ou Codex, mais je ne vois pas très bien quelle valeur ajoutée apporte la CLI
      Si ce sont juste des fichiers Markdown, pourquoi une CLI est-elle nécessaire, et comment une IA manipule-t-elle un vault via la CLI ?
  • J’utilise Obsidian avec un agent Claude pour synchroniser des documents de recherche ou des journaux quotidiens
    Cela fonctionne déjà plutôt bien avec des compétences personnalisées, mais cette fonctionnalité devrait rendre le workflow plus fluide
    J’ai aussi créé un outil CLI appelé obsidian-semantic-search pour faire de l’indexation d’embeddings LanceDB et de la recherche sémantique
    Cela permet de mieux créer des liens internes entre les notes
    • Je me demande si vous pourriez partager un peu plus de détails sur votre configuration avec Claude Code
    • J’aimerais aussi savoir quel impact cette approche a sur la consommation de tokens ou les quotas