# Wiki Cli

> Detecta y usa el CLI oficial de Obsidian para acceso de solo lectura al vault. Las mutaciones siempre pasan por el core de transacciones de claude-obsidian.

Fuente: https://skillsagentes.com/skills/agricidaniel/claude-obsidian/wiki-cli
Markdown: https://skillsagentes.com/skills/agricidaniel/claude-obsidian/wiki-cli.md

Repositorio: https://github.com/AgriciDaniel/claude-obsidian
Autor: AgriciDaniel
Licencia: MIT
Actualizado: el mes pasado
Coste de contexto: 79 tok instalada, 714 tok al activarse, 714 tok con todos los archivos del bundle
Bundle: 1 archivo, 3 KB
Permisos que pide: ninguno declarado

## Instalación

Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina.

```bash
# Claude Code
npx -y skills add AgriciDaniel/claude-obsidian --skill wiki-cli --agent claude-code
# Cursor
npx -y skills add AgriciDaniel/claude-obsidian --skill wiki-cli --agent cursor
# Codex
npx -y skills add AgriciDaniel/claude-obsidian --skill wiki-cli --agent codex
# Gemini CLI
npx -y skills add AgriciDaniel/claude-obsidian --skill wiki-cli --agent gemini
# Windsurf
npx -y skills add AgriciDaniel/claude-obsidian --skill wiki-cli --agent windsurf
# Cline
npx -y skills add AgriciDaniel/claude-obsidian --skill wiki-cli --agent cline
```

## Qué hace

- Detecta si el CLI oficial de Obsidian está realmente disponible y usable, no solo presente en el sistema
- Usa el CLI solo para lectura y búsqueda de un vault seleccionado: leer notas, buscar, backlinks y tags
- Recurre a lectura directa de archivos y `rg` como alternativa portátil cuando el CLI no está listo
- Prohíbe comandos de creación, escritura, renombrado o borrado por CLI; toda mutación pasa por la transacción del core

## Cuándo usarla

- Se necesita detectar qué transporte de lectura de Obsidian está disponible
- Se pide leer o buscar contenido del vault, o consultar backlinks y tags

## Qué la activa

- "Busca esta nota en el vault con el CLI de Obsidian"
- "¿Qué transporte de lectura está disponible?"
- "Muéstrame los backlinks de esta nota"

## Antes de instalar

- Necesita el ejecutable oficial `obsidian` en el sistema y la app de Obsidian en ejecución para que el CLI sea usable.
- Variables de entorno: DETECT_TRANSPORT, NOTE, PRODUCT_ROOT, QUERY, VAULT
- reads environment config

## Archivos

- SKILL.md — 3 KB

## SKILL.md

Reproducido tal cual desde AgriciDaniel/claude-obsidian bajo MIT. Esta sección es el documento original y está en inglés.

# Obsidian CLI read transport

Use this skill only to detect transport and read or search a selected vault.
The official executable is `obsidian`; binary presence alone does not prove it
is usable.

Resolve the installed product root from this skill's own location, not from the
vault or current working directory:

```bash
PRODUCT_ROOT=/absolute/path/to/installed/claude-obsidian
DETECT_TRANSPORT="$PRODUCT_ROOT/scripts/detect-transport.sh"
test -f "$DETECT_TRANSPORT"
```

## Detect safely

Probe without persisting host state:

```bash
bash "$DETECT_TRANSPORT" --peek --vault "$VAULT"
```

Trust `available.cli.usable`, not merely `present` or exit status. A supported
CLI can still be unavailable because the Obsidian app is not running, command
line access is disabled, or its response is an error. Use filesystem reads as
the portable fallback.

Persist a refreshed `.vault-meta/transport.json` only when the user or setup
workflow asks for a transport snapshot:

```bash
bash "$DETECT_TRANSPORT" --force --vault "$VAULT"
```

That file is derived runtime configuration, not knowledge content. Preserve a
valid `manual_override` recorded by the detector.

## Read and search

Run official CLI commands from the selected vault so Obsidian resolves the
correct workspace. Confirm supported syntax with the installed CLI before
relying on optional commands. Typical read-only forms are:

```bash
(cd "$VAULT" && obsidian read path="$NOTE")
(cd "$VAULT" && obsidian search query="$QUERY")
```

Use read-only commands for backlinks, tags, or Bases results only when the
detector reports the CLI ready. Otherwise read files under `$VAULT` directly
and use `rg` for search. Reject absolute note arguments, traversal, symlinks, or
resolved paths outside the selected vault.

## Mutation boundary

Do not use CLI create, write, append, property-set, daily-append, move, rename,
or delete commands. Do not replace those commands with direct filesystem
writes. Any knowledge or configuration change must be expressed as one
reviewed transaction through the portable core; see
[operation transactions](../wiki/references/operation-transactions.md).

Transport choice never changes mutation semantics. The CLI is an optional read
surface, not a lock manager, transaction engine, or Git checkpoint mechanism.

## Checkpoint

Observe actual capability, think about the least complex read transport, verify
that every resolved path stays in the vault, and accept filesystem fallback
when the CLI is not ready.

## Dónde encaja

- Categoría: [Productividad](https://skillsagentes.com/categorias/productividad.md) — Planificación, toma de notas y automatización de flujos personales.
- Creador: [AgriciDaniel](https://skillsagentes.com/creators/agricidaniel.md) — 46 skills en el directorio
- [Todas las skills](https://skillsagentes.com/skills.md)
- [Ranking de instalaciones](https://skillsagentes.com/ranking.md)

## Otras skills del mismo repositorio

- [Wiki](https://skillsagentes.com/skills/agricidaniel/claude-obsidian/wiki.md): Inicializa, adopta y enruta el trabajo hacia un vault de Obsidian separado a través del core portátil `claude-obsidian`. Para configurar el vault o elegir el sub-skill correcto.
- [Defuddle](https://skillsagentes.com/skills/agricidaniel/claude-obsidian/defuddle.md): Planifica y, con consentimiento explícito de red, usa un limpiador externo Defuddle opcional para extraer páginas HTTPS tipo artículo como Markdown.
- [Obsidian Bases](https://skillsagentes.com/skills/agricidaniel/claude-obsidian/obsidian-bases.md): Explica, redacta y valida archivos Obsidian Bases `.base` con filtros, fórmulas, propiedades, resúmenes y vistas de tabla, tarjetas o lista.
- [Obsidian Markdown](https://skillsagentes.com/skills/agricidaniel/claude-obsidian/obsidian-markdown.md): Explica, redacta o valida la sintaxis de Obsidian Flavored Markdown: propiedades, wikilinks, embeds, callouts, tags, comentarios, resaltados, referencias de bloque, matemáticas y Mermaid.
- [Canvas](https://skillsagentes.com/skills/agricidaniel/claude-obsidian/canvas.md): Crea, inspecciona y actualiza tableros Obsidian JSON Canvas con nodos de texto, archivo, enlace, grupo y arista. Para estado del canvas, mapas visuales, zonas y diseños espaciales.

---

Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)