Il y a une semaine, j’ai officiellement branché Hermes Agent dans mon vault Obsidian en me lançant un défi : le laisser gérer tout le travail de notes automatiquement pendant sept jours. Le résultat m’a surpris — non pas parce qu’il m’a fait gagner du temps, mais parce que mon vault m’a paru vivant pour la première fois. Le briefing du matin était prêt à mon réveil, la boîte de réception se vidait toute seule chaque soir, et le plus frappant était un graphe sémantique dessiné automatiquement qui mettait sous mes yeux des connexions que je n’avais jamais rendues explicites. Voici le journal complet de la semaine, avec les deux façons officielles de connecter les choses — et un avertissement : la commande hermes memory setup --provider obsidian qui circule dans les communautés chinoises n’existe pas dans le code officiel. Ne la copiez pas.

Les deux chemins officiels

Chemin A : le skill obsidian officiel intégré (lecture/écriture des notes)

Hermes est livré avec un skill obsidian (catégorie note-taking, par Teknium). Il traite votre vault comme un espace de travail orienté système de fichiers : lire des notes, les lister, effectuer une recherche en texte intégral, créer des notes, ajouter du contenu, faire des modifications ciblées et ajouter des wikilinks — le tout via les outils fichiers officiels, sans détour par MCP.

• Le chemin du vault se configure via la variable d’environnement OBSIDIAN_VAULT_PATH (par défaut ~/Documents/Obsidian Vault si elle n’est pas définie) ;
• Les chemins avec des espaces ne posent aucun problème (les outils fichiers les gèrent nativement) ;
• Les nouvelles notes se relient entre elles avec la syntaxe [[Note Name]] — l’âme d’Obsidian, que le skill érige en règle.

L’utilisation en une ligne : définissez OBSIDIAN_VAULT_PATH dans votre .env, puis dites simplement à Hermes « lis la note quotidienne d’aujourd’hui » ou « enregistre ceci comme note et relie-la aux sujets connexes ».

Chemin B : le plugin communautaire Obsidian (vault comme répertoire de travail)

Un cran au-delà du skill, il y a le plugin communautaire Hermes Agent (jsun2020/hermes-agent-obsidian-plugin, MIT). Il transforme Obsidian en interface pour Hermes :

• Chat latéral multi-onglets : un panneau de conversation intégré à Obsidian, qui utilise le Runs transport du gateway (flux d’événements d’outils et de raisonnement), avec Chat Completions en solution de repli ;
• Envoi du contexte en un clic : envoyer la note courante ou une sélection directement à Hermes — sans copier-coller ;
• Vault comme répertoire de travail : définissez un dossier de travail et l’agent peut réellement lire, écrire, rechercher et exécuter des workflows multi-étapes sur vos notes — c’est ce qui a rendu possible « une semaine d’automatisation » ;
• Smart Graph : Hermes lit les résumés des notes et fait remonter des connexions semantic (sujets partagés, une note qui développe une autre, prérequis/dépendances, contradictions), rendues sous forme de graphe interactif force-directed — la vue Graph native d’Obsidian ne connaît que les [[wikilinks]] explicites ; Smart Graph, lui, trouve ceux que vous ressentiez sans jamais les écrire. Les résultats sont mis en cache, le graphe survit donc à la réouverture.

L’authentification utilise la API_SERVER_KEY du gateway (générée automatiquement par Hermes Desktop, dans ~/.hermes/.env). L’installation se fait via le plugin communautaire BRAT, ou manuellement avec le trio main.js / manifest.json / styles.css.

La semaine, jour après jour

• 6 h 30 chaque matin : un cron se déclenche ; Hermes lit la note quotidienne de la veille et l’overview.md de chaque projet, puis écrit « ce qui compte aujourd’hui + l’état du projet en une ligne + les boucles ouvertes » dans 04 - HERMES-OUTPUTS/briefings/ — cinq minutes de lecture avant la moindre notification, et c’est bien mieux que les infos.
• 20 h 00 chaque soir : le processeur de boîte de réception classe tout ce qui a été déposé dans 00 - INBOX/, l’archive, et oblige chaque nouvelle note permanente à porter au moins un wikilink — pas de connexion, pas de dossier permanent. Au bout d’une semaine, la boîte de réception n’a jamais pris de retard.
• À tout moment : sélectionnez un bon article, envoyez-le au chat latéral, « lis ceci et transforme-le en note de littérature » — il renvoie le résultat avec les sources et les liens attachés.
• La surprise du week-end : j’ai lancé Smart Graph et il a relié une note sur mon workflow d’écriture vieille de trois mois aux notes de projet de cette semaine — je n’avais aucune idée qu’elles étaient liées. Cette connexion est devenue la graine de mon prochain article.

Les pièges que j’ai rencontrés (journal honnête)

1. Le sandbox en lecture seule de Codex / gpt-5.5 : avec les modèles de la famille OpenAI-Codex, l’agent s’exécute dans un sandbox en lecture seule, et les lectures du chemin du vault sont donc rejetées (« two read-only permission requests were rejected »). Correctif : dans ~/.codex/config.toml, définissez sandbox_mode = "workspace-write" et ajoutez votre vault à [sandbox_workspace_write].writable_roots, puis redémarrez Hermes Desktop (le gateway charge la configuration au démarrage). Les environnements Windows verrouillés peuvent nécessiter danger-full-access lorsque le sandbox ne peut même pas démarrer.
2. Le TUI n’est pas le gateway : le plugin dialogue avec le gateway HTTP (par défaut 127.0.0.1:8642) ; lancer seulement le chat TUI ne suffit pas — il faut que hermes gateway ou Hermes Desktop tourne.
3. Les profils nommés déplacent le port : avec les profils nommés, le gateway écoute sur 8643–8742 ; il suffit de mettre à jour l’URL de base dans les réglages du plugin.
4. N’utilisez pas la fausse commande : hermes memory setup --provider obsidian n’existe pas dans le code officiel — Obsidian n’est pas un fournisseur de mémoire ; c’est un espace de travail pour le skill + le plugin.

Démarrage rapide (les deux chemins)

# Chemin A : le skill officiel (lecture/écriture des notes)
echo "OBSIDIAN_VAULT_PATH=$HOME/Documents/Obsidian Vault" >> ~/.hermes/.env
# Ensuite dans le chat : /skill obsidian, ou simplement « utilise le skill obsidian pour lire ma note quotidienne »

# Chemin B : le plugin (vault comme répertoire de travail)
# 1. Dans Obsidian, installez BRAT → ajoutez https://github.com/jsun2020/hermes-agent-obsidian-plugin
# 2. Dans les réglages, renseignez l'URL du gateway (par défaut http://127.0.0.1:8642) + la API_SERVER_KEY
# 3. Cliquez sur Test connection, puis ouvrez le chat latéral

Pour la planification (briefings du matin, traitement de la boîte de réception), c’est Hermes cron qui orchestre tout — voir le guide complet de l’automatisation cron. Pour isoler les vaults par profil : plusieurs instances indépendantes sur une même machine. Le précédent article sur la transformation de conversations en notes couvre le pipeline de capture à sens unique ; celui-ci est l’espace de travail bidirectionnel — ils se complètent.

Bilan

Après une semaine de « full automation », mon principal enseignement : Obsidian et Hermes forment un duo naturel — Obsidian fournit la couche de connaissances lisible par l’humain, permanente et reliée ; Hermes fournit la couche cerveau qui réfléchit, mémorise et exécute selon un calendrier. Le skill officiel gère la lecture/écriture, le plugin communautaire gère la collaboration bidirectionnelle et la découverte sémantique, et cron gère le timing. Ignorez les commandes fabriquées de toutes pièces qui circulent sur les forums chinois ; suivez les deux chemins officiels et votre vault prendra vie, lui aussi, en une semaine.