wiki-cli

Read, write, and search Obsidian vault notes via Obsidian CLI with filesystem fallback.

10.6k|1.2k|Updated Apr 7, 2026
One-click install
npx skills add https://github.com/AgriciDaniel/claude-obsidian --skill wiki-cli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wiki-cli
Source: https://github.com/AgriciDaniel/claude-obsidian/tree/main/skills/wiki-cli
Command: npx skills add https://github.com/AgriciDaniel/claude-obsidian --skill wiki-cli

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill solves reliable, low-friction reading and writing of an Obsidian vault from Claude Code without setting up MCP servers, REST plugins, or TLS workarounds.

Core Features & Use Cases

  • Obsidian CLI as the default transport: read, write, append, search, and modify notes through the Obsidian 1.12+ command-line interface.
  • Deterministic fallback behavior: automatically falls back to filesystem Read/Write/Edit when the CLI is unavailable.
  • Environment-aware orchestration: detects the preferred transport and records it in .vault-meta/transport.json so downstream skills choose correctly for the current machine and vault state.

Quick Start

Ask an AI to detect the available vault transport by running bash scripts/detect-transport.sh, then use Obsidian CLI commands (like obsidian-cli read "$VAULT" "$NOTE") to read or update the target note.

Frequently Asked Questions about wiki-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I read and write Obsidian vault notes from Claude Code without setting up MCP servers?

You can mutate your Obsidian vault safely via CLI using the Obsidian CLI transport to read, write, append, and modify notes. It requires no MCP servers, REST plugins, or TLS workarounds, enabling direct Claude-driven vault operations.

What happens to my Obsidian vault mutations if the Obsidian CLI is unavailable?

When the Obsidian CLI is unavailable, the Skill uses deterministic fallback behavior to automatically switch to filesystem Read, Write, and Edit operations. This ensures your vault mutation tasks continue functioning safely without interruption.

How do I update frontmatter properties and create daily notes in an Obsidian vault via CLI?

You can update frontmatter properties and create daily notes by executing obsidian-cli subcommands for the requested vault operation. Ask the AI to run the detection script first, then use commands like obsidian-cli read to modify target notes.

Does this approach require the Obsidian REST plugin or TLS configuration to search notes?

No, searching notes and executing backlink, tag, or bookmark queries relies on the Obsidian CLI with automatic filesystem fallback. It completely bypasses the need for REST plugins, MCP servers, or complex TLS workarounds for vault access.

How does transport detection work for Obsidian CLI vault operations?

Transport detection runs via scripts/detect-transport.sh and records the preferred transport in .vault-meta/transport.json. This environment-aware orchestration ensures downstream skills choose the correct vault access method for the current machine state.