¿Qué hace obsidian-vault?
Buscar, crear y gestionar notas en la bóveda de Obsidian con wikilinks y notas índice. Utilizar cuando el usuario quiera encontrar, crear u organizar notas en Obsidian.
Descripción
Esta habilidad permite a un agente de IA interactuar con una bóveda de Obsidian, realizando operaciones como:
- Buscar notas existentes por título o contenido
- Crear nuevas notas con contenido y metadatos
- Agregar o eliminar etiquetas de notas
- Mantener una nota índice que lista todas las notas y las organiza por etiquetas
- Utilizar wikilinks (
[[enlaces]]) para conectar notas
Configuración
La habilidad asume que la bóveda de Obsidian se encuentra en el directorio especificado en la variable de entorno OBSIDIAN_VAULT_PATH. Si no está configurada, se usa el directorio por defecto ~/obsidian-vault.
La nota índice se almacena en INDEX.md dentro de la raíz de la bóveda. Se puede cambiar configurando la variable de entorno OBSIDIAN_INDEX_NOTE (sin extensión .md).
Comandos
search - Buscar notas
# Buscar notas que contengan "machine learning" en el título o contenido
grep -ri "machine learning" "$OBSIDIAN_VAULT_PATH" --include="*.md" -l
create - Crear una nueva nota
# Crear una nota con título y contenido
cat > "$OBSIDIAN_VAULT_PATH/nueva-nota.md" << 'EOF'
---
title: Nueva Nota
tags:
- ejemplo
- guía
---
# Nueva Nota
Contenido de la nota con [[wikilinks]] a otras notas.
EOF
add-tag - Agregar una etiqueta a una nota
# Agregar etiqueta "pendiente" a una nota
touch "$OBSIDIAN_VAULT_PATH/nota.md"
sed -i 's/tags:.*/&\n - pendiente/' "$OBSIDIAN_VAULT_PATH/nota.md"
update-index - Actualizar la nota índice
# Actualizar la nota índice con todas las notas y sus etiquetas
# Este comando es más complejo; ver documentación interna
Ejemplos de uso
-
Buscar notas sobre un tema
- Usuario: "Encuentra notas sobre TypeScript"
- Agente: Ejecuta
search typeScripty muestra resultados
-
Crear una nota y linkearla
- Usuario: "Crea una nota sobre React y enlázala desde la nota de JavaScript"
- Agente: Crea la nota y agrega
[[React]]a la nota de JavaScript
-
Organizar notas por etiquetas
- Usuario: "Agrega la etiqueta 'documentación' a todas las notas de API"
- Agente: Busca notas que contengan "API" en el título y agrega la etiqueta
Notas importantes
- Las rutas de archivos son relativas al directorio de la bóveda
- Los wikilinks se escriben como
[[Título de la nota]] - La nota índice se actualiza automáticamente después de ciertas operaciones
- Se recomienda tener una copia de seguridad de la bóveda antes de usar esta habilidad extensivamente