Agent skill

Obsidian CLI Read Transport

by AgriciDaniel in AgriciDaniel/claude-obsidian

Detects and uses the official Obsidian command-line interface for read-only vault access, falling back to direct file reads, while all mutations stay on a separate transaction core.

MITAuto-check passedKnowledge Management

Install Obsidian CLI Read Transport

skills CLI
$ npx skills add AgriciDaniel/claude-obsidian --skill wiki-cli -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install AgriciDaniel/claude-obsidian wiki-cli --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/AgriciDaniel/claude-obsidian.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/wiki-cli .claude/skills/wiki-cli && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
wiki-cli
GitHub stars
15k
Token cost
~762 tokens
SKILL.md length
327 words
Files
1
Skills in repo
15
Repo updated
First seen
Licence
MIT

At a glance

Detects and uses the official Obsidian command-line interface for read-only vault access, falling back to direct file reads, while all mutations stay on a separate transaction core.

  • Reading or searching an Obsidian vault without risking a write
  • SKILL.md covers Detect safely, Read and search, Mutation boundary and Checkpoint
  • Calls bash
  • Checking whether the Obsidian CLI is actually usable before relying on it

What it does

The skill resolves its own installed product root rather than the vault or current working directory, so every reference it links stays anchored correctly regardless of which vault is open. Detection runs a peek probe against the selected vault and trusts only the available.cli.usable field, not mere presence or a plain exit status, because a supported CLI can still be unusable if the Obsidian app is not running or command-line access is disabled; filesystem reads are the portable fallback whenever that is the case.

Reads run the official CLI's own commands from inside the selected vault so Obsidian resolves the right workspace, covering note reads, searches, and, once the detector reports the CLI ready, backlinks, tags or Bases results. Absolute note paths, traversal and symlinks resolving outside the selected vault are rejected outright, and when the CLI is not ready the skill reads files under the vault directly and searches with rg instead.

Mutations are explicitly out of scope here: create, write, append, move, rename and delete commands are never run through this CLI and never replaced with direct filesystem writes, because any real knowledge or configuration change must go through one reviewed transaction in a separate, portable core instead. A refreshed transport snapshot is only persisted to .vault-meta/transport.json when the user or a setup workflow specifically asks for one.

When your agent uses it

  • Reading or searching an Obsidian vault without risking a write
  • Checking whether the Obsidian CLI is actually usable before relying on it
  • Looking up backlinks or tags for a note through the official CLI

Example prompts

  • “Search my vault for notes mentioning quarterly planning.”
  • “Read the note at Projects/Roadmap.md.”
  • “Check whether the Obsidian CLI is ready before we look up backlinks.”

Requirements

  • The official Obsidian CLI, for the fast path
  • Filesystem access to the vault, as a fallback

What it can do on your machine

Read from SKILL.md and the folder at commit 32ac5a0. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • bash

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Obsidian CLI Read Transport loads about 762 tokens when it runs. Until then it costs about 81 tokens; SKILL.md has 327 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~81
When it runs · the whole SKILL.md, loaded when a task matches
~762

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from AgriciDaniel/claude-obsidian at commit 32ac5a0, republished under its MIT licence (© AgriciDaniel). 327 words, ~762 tokens.

Download SKILL.mdSave it as .claude/skills/wiki-cli/SKILL.md (or your agent's skills folder).
name
wiki-cli
description
Detect and use the official Obsidian command-line interface for read-only vault access; use for wiki-cli, Obsidian CLI, Obsidian read, Obsidian search, vault transport, which transport, transport detection, backlinks, tags, or Obsidian command line. Mutations always go through the claude-obsidian transaction core.

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"

Every ../wiki/references/ link in this file resolves the same way, relative to this skill's own directory under $PRODUCT_ROOT, never relative to the selected vault's wiki/ directory.

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.

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.

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.

© AgriciDaniel, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/wiki-cli of AgriciDaniel/claude-obsidian.

Open the folder on GitHubat commit 32ac5a0

Compare with similar skills

Obsidian CLI Read Transport next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Obsidian CLI Read Transport compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Obsidian CLI Read Transport this skillAgriciDaniel/claude-obsidian15k—~762Automated safety check: PassMIT
Karpathy WikiSherwinQ/karpathy-wiki113—~967Automated safety check: PassMIT
My LLM WikiMartinLwx/dotfiles140—~2.7kAutomated safety check: PassNone
Obsidian Knowledge BuilderMichael-OvO/obsidian-knowledge-agent205—~917Automated safety check: PassMIT
AI Second Braincharlie947/ai-second-brain184—~3.5kAutomated safety check: PassMIT
LLM Wikiinfranodus/skills119—~8.6kAutomated safety check: NotesNone

Similar skills

  • Karpathy Wiki

    SherwinQ/karpathy-wiki

    A skill your agent uses when building or maintaining a personal knowledge base with LLM assistance.

    113 GitHub stars~967 tokensUpdated 5 mo ago
    Knowledge ManagementAuto-check passed
  • My LLM Wiki

    MartinLwx/dotfiles

    Provides access to the user's personal wiki, including notes, research, project documentation, decisions, and archived knowledge.

    140 GitHub stars~2.7k tokensUpdated 17 days ago
    Knowledge ManagementAuto-check passed
  • Obsidian Knowledge Builder

    Michael-OvO/obsidian-knowledge-agent

    Turns PDFs, slides, syllabi, papers and transcripts into structured, teaching-quality Obsidian notes, matching how much structure is built to how much the material needs.

    205 GitHub stars~917 tokensUpdated 3 mo ago
    Knowledge ManagementAuto-check passed
  • AI Second Brain

    charlie947/ai-second-brain

    Walks the user through Charlie Hills's AI Second Brain + Karpathy Wiki setup from the MarTech AI newsletter.

    184 GitHub stars~3.5k tokensUpdated 5 mo ago
    Knowledge ManagementAuto-check passed
  • LLM Wiki

    infranodus/skills

    Guide users through setting up a personal LLM-maintained wiki — a persistent, compounding knowledge base where the LLM incrementally builds and maintains interlinked markdown pages from raw sources.

    119 GitHub stars~8.6k tokensUpdated 16 days ago
    Knowledge ManagementAuto-check: notes
  • Second Brain

    coreyhaines31/makerskills

    When you want to capture into, compile, query, lint, or connect your personal Second Brain.

    844 GitHub stars~2.9k tokensUpdated 1 mo ago
    Knowledge ManagementAuto-check passed

More from AgriciDaniel/claude-obsidian

All 15 skills in this repo
  • Bounded Autoresearch

    AgriciDaniel/claude-obsidian

    Runs a bounded, source-grounded research loop that drafts a cited dossier and can propose a separately reviewed merge into an Obsidian vault.

    15k GitHub stars~1.6k tokensUpdated 26 days ago
    Auto-check passed
  • Obsidian Canvas Boards

    AgriciDaniel/claude-obsidian

    Creates, inspects and updates Obsidian JSON Canvas boards in a vault, with text, file, link, group and edge nodes, using safe recoverable edits.

    15k GitHub stars~1.4k tokensUpdated 26 days ago
    Auto-check passed
  • Obsidian Wiki Vault Setup

    AgriciDaniel/claude-obsidian

    Sets up or adopts a separate Obsidian knowledge vault through the claude-obsidian core script and routes follow-up work to the right wiki sub-skill.

    15k GitHub stars~1.3k tokensUpdated 26 days ago
    Auto-check passed
  • Obsidian Wiki Log Fold

    AgriciDaniel/claude-obsidian

    Creates a bounded, extractive rollup of recent Obsidian wiki log entries, previewed by default, with one optional apply step and no changes to child pages.

    15k GitHub stars~1.2k tokensUpdated 26 days ago
    Auto-check passed
  • Defuddle Web Page Cleaner

    AgriciDaniel/claude-obsidian

    Plans, and with explicit network consent runs, an external Defuddle extractor that turns an article-like HTTPS page into clean Markdown for later wiki ingestion.

    15k GitHub stars~1.1k tokensUpdated 26 days ago
    Auto-check passed
  • Obsidian Bases Editor

    AgriciDaniel/claude-obsidian

    Explains, drafts and validates Obsidian Bases .base files, building filters, formulas and table, card or list views, and applying edits only through one inspected transaction.

    15k GitHub stars~1.2k tokensUpdated 26 days ago
    Auto-check passed

Works with

Questions about Obsidian CLI Read Transport

What does Obsidian CLI Read Transport do?

Detects and uses the official Obsidian command-line interface for read-only vault access, falling back to direct file reads, while all mutations stay on a separate transaction core. The skill resolves its own installed product root rather than the vault or current working directory, so every reference it links stays anchored correctly regardless of which vault is open.usable field, not mere presence or a plain exit status, because a supported CLI can still be unusable if the Obsidian app is not running or command-line access is disabled; filesystem reads are the portable fallback whenever that is the case.

When should I use Obsidian CLI Read Transport?

Obsidian CLI Read Transport fits situations like: reading or searching an Obsidian vault without risking a write; checking whether the Obsidian CLI is actually usable before relying on it; looking up backlinks or tags for a note through the official CLI.

How do I install Obsidian CLI Read Transport in Claude Code?

Run `npx skills add AgriciDaniel/claude-obsidian --skill wiki-cli -a claude-code`. Or copy the skill folder (skills/wiki-cli in AgriciDaniel/claude-obsidian) into .claude/skills/wiki-cli in your project. Claude Code loads it when a task matches its description.

How do I install Obsidian CLI Read Transport in Codex?

Run `npx skills add AgriciDaniel/claude-obsidian --skill wiki-cli -a codex`. Or copy the skill folder (skills/wiki-cli in AgriciDaniel/claude-obsidian) into .agents/skills/wiki-cli in your project. Codex loads it when a task matches its description.

Can I use Obsidian CLI Read Transport in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add AgriciDaniel/claude-obsidian --skill wiki-cli -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/wiki-cli, .gemini/skills/wiki-cli, .github/skills/wiki-cli and .opencode/skills/wiki-cli in your project.

What does Obsidian CLI Read Transport need to run?

Going by SKILL.md and its folder, Obsidian CLI Read Transport needs the command-line tools its instructions call (bash). Our summary lists: The official Obsidian CLI, for the fast path; Filesystem access to the vault, as a fallback.

Does Obsidian CLI Read Transport access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Obsidian CLI Read Transport safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Obsidian CLI Read Transport use?

Obsidian CLI Read Transport is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Obsidian CLI Read Transport use?

About 762 tokens (SKILL.md is roughly 3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Obsidian CLI Read Transport?

Skills that share tags, products or a category with Obsidian CLI Read Transport: Karpathy Wiki (SherwinQ/karpathy-wiki, 113 stars), My LLM Wiki (MartinLwx/dotfiles, 140 stars), Obsidian Knowledge Builder (Michael-OvO/obsidian-knowledge-agent, 205 stars) and AI Second Brain (charlie947/ai-second-brain, 184 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Obsidian CLI Read Transport?

AgriciDaniel (a GitHub user) maintains it in AgriciDaniel/claude-obsidian, which has 15,379 GitHub stars. The repository holds 15 skills in this directory. The repository was last updated on September 10, 2026.

Source: AgriciDaniel/claude-obsidian on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.