wiki-cli

wiki-cli is a skill for Claude Code, Codex from AgriciDaniel/claude-obsidian. It costs 74 tokens per session (623 once invoked), scanned A, original, MIT.

A read-only bridge to Obsidian's official command-line interface, which lets programs search and read a vault from a terminal. It checks whether that interface is actually usable and falls back to reading files when needed.

In plain words
What is it for?
Use it to detect the available vault-reading method, search notes, inspect backlinks and tags, and read Obsidian content.
Why use it?
It avoids treating a merely installed command as working when Obsidian is closed or command-line access is disabled. It keeps changes out of this tool; vault edits go through a separate transaction process.

Skill for Claude CodeCodex

Part of the claude-obsidian plugin — 16 skills, 3 agents, 2 hooks shipped together

About the project

claude-obsidian is a local knowledge system that turns source material into linked, source-cited Markdown notes in an Obsidian vault for use with Claude Code and compatible agent hosts. People use it to capture research, retrieve evidence-grounded answers, maintain knowledge, and map connections while retaining ownership of their files. The catalogue entries provide workflows and extensions for operating this knowledge system.

AgriciDaniel/claude-obsidian · 14,630 stars · on GitHub

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/agricidaniel/claude-obsidian/wiki-cli
Any agent
npx skills add AgriciDaniel/claude-obsidian --skill wiki-cli
Clone the repo
git clone --depth 1 https://github.com/AgriciDaniel/claude-obsidian

Made for: Claude Code, Codex.

Or install claude-obsidian, the plugin that ships this one along with the rest of its 16 skills, 3 agents, 2 hooks.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for wiki-cli

README.md
[![agentmods](https://agentmods.dev/badge/skills/agricidaniel/claude-obsidian/wiki-cli.svg)](https://agentmods.dev/skills/agricidaniel/claude-obsidian/wiki-cli)
Your own site
<a href="https://agentmods.dev/skills/agricidaniel/claude-obsidian/wiki-cli"><img src="https://agentmods.dev/badge/skills/agricidaniel/claude-obsidian/wiki-cli.svg" alt="Measured on agentmods" height="20"></a>
Per session 74 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 623 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00074 $0.00623
Opus 5 $0.00037 $0.00311
Sonnet 5 $0.00015 $0.00125
Haiku 4.5 $0.00007 $0.00062

Measured 6d ago against content hash 2885621fc55c, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-05, from the pricing page.

Security

Grade A, and why

wiki-cli scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 6d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/wiki-cli/SKILL.md · 76 lines

How it starts

The opening of the file, as written. The whole thing — 76 lines — stays where its author put it; the contents beside it link to each section on GitHub.

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:

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 "$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 "$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:

(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.

Read the full file on GitHub · 76 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 6d ago First seen · 76 lines · 74 tokens per session scan A 2885621fc55c

Subscribe to this mod's changes

wiki-cli is a skill published in the GitHub repository AgriciDaniel/claude-obsidian (14,630 stars, last pushed 10d ago), licensed MIT. It adds 74 tokens to every session and 623 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

follower-onboard

Onboard a NEW family/team machine as a FOLLOWER-CONSUMER joining the multi-machine Claude+vault network. A follower READS the shared vault + canon + skills + memory as RECEIVE- ONLY data, runs nothing heavy locally (no RAG/reindex/GPU), and the hub never pushes executable hooks to it. Trigger on "/follower-onboard "…

tonydzi/second-brain-starter-kit · 99 tokens

claudeai-sync

One-command incremental sync of a claude.ai WEB account into the Obsidian vault — pull only new/changed chats, fold them in as notes (idempotent, never overwrites curated ones), extract artifacts as first-class notes, concept-link the new artifacts, refresh the RAG index + dashboard. Trigger on "/claudeai-sync", "pull…

tonydzi/second-brain-starter-kit · 89 tokens

chat-search

Search INSIDE past Claude Code sessions (the episodic "book of chats" index) — find which previous session discussed a topic, and continue it with one command. Uses a SEPARATE session index, NOT the curated-knowledge RAG, so raw chat noise never pollutes the distilled brain. Trigger on "/chat-search", "which chat…

tonydzi/second-brain-starter-kit · 88 tokens

five-hard

Five Hard Questions — monthly (or on demand) the second brain ITSELF asks the owner 5 hard questions about their own long-held beliefs and codex entries that haven't been revisited in a while. Prevents assumptions from fossilizing. Trigger on "/five-hard", "challenge my beliefs", "pressure-test my views". Part of the…

tonydzi/second-brain-starter-kit · 77 tokens

canvas-generate

AI-orchestrated full canvas generation. Given a description, detects the best archetype, generates content and visuals, instantiates a template, applies layout, and produces a complete canvas. The flagship command. Dispatches canvas-media and canvas-composer agents for parallel asset generation. Triggers on: canvas…

AgriciDaniel/claude-canvas · 97 tokens

canvas

AI-orchestrated visual production for Obsidian Canvas. Create presentations, flowcharts, mood boards, knowledge graphs, galleries, storyboards, timelines, dashboards, and more with intelligent layout and AI-generated content. Claude acts as Creative Director — dispatching sub-agents for image generation, SVG diagrams…

AgriciDaniel/claude-canvas · 153 tokens