Que fait obsidian ?
Utilisez cette compétence pour travailler avec un coffre Obsidian local. Un coffre Obsidian est un dossier normal contenant des fichiers Markdown et une configuration .obsidian/.
Sources
- Configuration de l'application :
~/Library/Application Support/obsidian/obsidian.json - Nom de coffre par défaut :
obsidian - Chemin de coffre local habituel :
~/obsidian - CLI officielle :
obsidian - Les commandes du coffre résolvent le coffre depuis le répertoire courant ; exécutez-les depuis
~/obsidian.
Premières vérifications
command -v obsidian
obsidian version
obsidian vaults
cd ~/obsidian
obsidian commands filter=search:
Les commandes globales comme version et vaults fonctionnent en dehors d'un coffre. Les commandes liées au contenu d'un coffre peuvent afficher Vault not found. en dehors de ~/obsidian. Utilisez obsidian commands, pas obsidian help, pour découvrir la CLI.
Si obsidian indique que la CLI est désactivée :
- Demandez d'abord à l'utilisateur d'activer Paramètres -> Général -> Avancé -> Interface en ligne de commande.
- Si vous avez déjà confirmé la forme de la configuration de l'application,
~/Library/Application Support/obsidian/obsidian.jsonutilise"cli": true. - Redémarrez Obsidian après avoir modifié la configuration CLI au niveau de l'application.
Workflow de lecture
Privilégiez la CLI officielle pour les recherches tenant compte d'Obsidian :
cd ~/obsidian
obsidian search query="OpenClaw" format=json
obsidian search:context query="OpenClaw" limit=20 format=json
obsidian read path="Folder/Note.md"
obsidian file path="Folder/Note.md"
obsidian outline path="Folder/Note.md" format=json
obsidian backlinks path="Folder/Note.md" format=json
obsidian links path="Folder/Note.md"
obsidian properties path="Folder/Note.md" format=json
Utilisez les lectures directes du système de fichiers lorsque vous connaissez déjà le chemin et avez besoin des octets exacts :
sed -n '1,220p' "$HOME/obsidian/Folder/Note.md"
rg -n "terme" "$HOME/obsidian"
Indiquez la source utilisée lorsque la fraîcheur ou le choix du coffre est important.
Workflow d'écriture
Choisissez le chemin d'écriture le plus précis :
- Nouvelle note :
obsidian create path="Folder/Note.md" content="...". - Ajouter au début/à la fin des notes quotidiennes :
obsidian daily:append content="...". - Modifications simples de notes : utilisez
apply_patchsur le fichier Markdown. - Renommer/déplacer des notes : privilégiez
obsidian move path="Old.md" to="Folder/New.md"pour que les liens puissent être mis à jour. - Ouvrir l'interface après une écriture : ajoutez
openseulement si cela est utile ou demandé.
Commandes courantes :
cd ~/obsidian
obsidian create path="Notes/New.md" content="# Nouveau\n\nCorps"
obsidian append path="Notes/New.md" content="Texte supplémentaire"
obsidian move path="Notes/New.md" to="Archive/New.md"
obsidian daily:path
obsidian daily:read
obsidian daily:append content="- Élément de suivi"
Pour du contenu multiligne, privilégiez la modification du fichier .md avec apply_patch une fois le chemin connu. Évitez les guillemets fragiles du shell pour les longs textes.
Bases, Canvas, Plugins
Utilisez d'abord la découverte par CLI :
cd ~/obsidian
obsidian bases
obsidian base:views path="Projects.base"
obsidian base:query path="Projects.base" view="Active" format=json
obsidian plugins format=json
obsidian plugins:enabled format=json
obsidian commands filter=workspace:
Pour les fichiers .canvas, .base et .json, lisez/modifiez-les en tant que données structurées lorsque c'est possible. Maintenez un formatage stable et validez le JSON après les modifications.
Sécurité
- Ne réécrivez pas le coffre en masse. Utilisez des chemins ciblés et examinez les différences.
- Ne modifiez pas
.obsidian/sauf si l'utilisateur le demande ou si la tâche concerne explicitement la configuration ou les plugins. - Ne supprimez pas de notes sauf demande explicite ; privilégiez la corbeille à la suppression définitive.
- Ne créez pas de notes dans des dossiers cachés (commençant par un point) via le chemin URI/CLI d'Obsidian.
- Préservez le frontmatter et les wikilinks sauf si la tâche consiste à les refactoriser.
- Si plusieurs coffres existent, ne devinez pas ; utilisez
obsidian vaultsetobsidian.json.