¿Qué hace obsidian?
Úsalo para trabajar con una bóveda local de Obsidian. Una bóveda de Obsidian es una carpeta normal con archivos Markdown más la configuración de .obsidian/.
Fuentes
- Configuración de la app:
~/Library/Application Support/obsidian/obsidian.json - Nombre de bóveda por defecto:
obsidian - Ruta local habitual de la bóveda:
~/obsidian - CLI oficial:
obsidian - Los comandos de bóveda resuelven la bóveda desde el directorio de trabajo actual; ejecútalos desde
~/obsidian.
Primeras comprobaciones
command -v obsidian
obsidian version
obsidian vaults
cd ~/obsidian
obsidian commands filter=search:
Los comandos globales como version y vaults funcionan fuera de una bóveda. Los comandos de contenido de bóveda pueden imprimir Vault not found. fuera de ~/obsidian. Usa obsidian commands, no obsidian help, para descubrir la CLI.
Si obsidian indica que la CLI está deshabilitada:
- Prefiere pedir al usuario que la habilite en Configuración -> General -> Avanzado -> Interfaz de línea de comandos.
- Si ya confirmaste la forma del archivo de configuración de la app,
~/Library/Application Support/obsidian/obsidian.jsonusa"cli": true. - Reinicia Obsidian después de cambiar la configuración de CLI a nivel de app.
Flujo de lectura
Prefiere el CLI oficial para búsquedas conscientes de 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
Usa lecturas directas del sistema de archivos cuando ya conozcas la ruta y necesites los bytes exactos:
sed -n '1,220p' "$HOME/obsidian/Folder/Note.md"
rg -n "term" "$HOME/obsidian"
Informa qué fuente usaste cuando la frescura o la elección de la bóveda sea relevante.
Flujo de escritura
Elige la ruta de escritura más específica:
- Nueva nota:
obsidian create path="Folder/Note.md" content="...". - Añadir/preponer a notas diarias:
obsidian daily:append content="...". - Ediciones simples de notas: usa
apply_patchsobre el archivo Markdown. - Renombrar/mover notas: prefiere
obsidian move path="Old.md" to="Folder/New.md"para que los enlaces puedan actualizarse. - Abrir la UI después de una escritura: añade
opensolo cuando sea útil o se solicite.
Comandos comunes:
cd ~/obsidian
obsidian create path="Notes/New.md" content="# New\n\nBody"
obsidian append path="Notes/New.md" content="More text"
obsidian move path="Notes/New.md" to="Archive/New.md"
obsidian daily:path
obsidian daily:read
obsidian daily:append content="- Follow-up item"
Para contenido multilínea, prefiere editar el archivo .md con apply_patch una vez que se conozca la ruta. Evita el quoting frágil del shell para texto largo.
Bases, Canvas, Plugins
Usa primero el descubrimiento por 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:
Para archivos .canvas, .base y .json, lee/edita como datos estructurados cuando sea posible. Mantén el formato estable y valida JSON después de las ediciones.
Seguridad
- No reescribas la bóveda en bloque. Usa rutas específicas y revisa las diferencias.
- No edites
.obsidian/a menos que el usuario lo pida o la tarea sea explícitamente de configuración/plugins. - No elimines notas a menos que se pida explícitamente; prefiere la papelera antes que la eliminación permanente.
- No crees notas en carpetas ocultas (con punto) a través de la ruta URI/CLI de Obsidian.
- Conserva el frontmatter y los wikilinks a menos que la tarea sea refactorizarlos.
- Si existen múltiples bóvedas, no adivines; usa
obsidian vaultsyobsidian.json.