Obsidian CLI: detecta problemas en las notas sin modificar tu bóveda

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

• Dificultad: intermedio
• Proyecto: https://github.com/mvanhorn/printing-press-library/tree/main/library/productivity/obsidian
• Guía completa: https://lab.wisd.ai/hub/obsidian-cli

Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

Pasos de configuración

Paso 1: prepara el acceso

Comprueba que tienes Node.js ≥22.20.0 y npm/npx, Go ≥1.26.10 y el directorio de binarios accesible por PATH (metadatos del instalador). Habilita la CLI oficial de Obsidian ≥1.12 y confirma que obsidian está accesible desde la terminal. Abre Obsidian con la bóveda de prueba cargada y mantenlo abierto para doctor y deadends, que consulta el estado en vivo.

Paso 2: instala la CLI

El instalador compila con Go; .go-version fija 1.26.10. Node ≥22.20.0 es necesario para la CLI skills invocada tras compilar, aunque el catálogo acepte ≥20. Ejecuta el comando del README:

npx -y @mvanhorn/printing-press-library install obsidian

Quedan instalados obsidian-pp-cli y su skill. El directorio por defecto es ~/.local/bin en macOS/Linux o %LOCALAPPDATA%\Programs\PrintingPress\bin en Windows. Si no está en PATH, aplica la línea específica que imprima el instalador y abre una terminal nueva.

Paso 3: prueba el flujo documentado

Ejecuta los comandos en este orden. Los términos, dominios e identificadores de ejemplo se sustituyen por los que correspondan a tu trabajo.

obsidian-pp-cli doctor
obsidian-pp-cli deadends
obsidian-pp-cli sync
obsidian-pp-cli health
obsidian-pp-cli orphans
obsidian-pp-cli broken

La sincronización crea la copia SQLite; las tres consultas siguientes usan esa copia. Solo después de sincronizar puedes cerrar Obsidian para consultar el espejo.

Comprobación

Comprueba que cada comando termina correctamente y que la salida corresponde a la cuenta, fuente o datos que seleccionaste. Una lista vacía no demuestra que el dato no exista: comprueba primero el alcance de la consulta y, si usas una copia local, su sincronización.

Si algo falla

Si no encuentra el ejecutable oficial, revisa su instalación y acceso desde la terminal. Las consultas al espejo necesitan una sincronización previa con Obsidian abierto. Consulta el README de esta CLI para las opciones específicas de tu sistema y versión. No compartas credenciales en la salida de diagnóstico.