Agent skill

Obsidian CLI

by pablo-mano in pablo-mano/Obsidian-CLI-skill

Lets the agent read, write, search and tidy an Obsidian vault directly through the official Obsidian command-line interface.

No licenceAuto-check passedKnowledge Management

Install Obsidian CLI

skills CLI
$ npx skills add pablo-mano/Obsidian-CLI-skill --skill obsidian-cli -a claude-code

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

GitHub CLI
$ gh skill install pablo-mano/Obsidian-CLI-skill obsidian-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/pablo-mano/Obsidian-CLI-skill.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/obsidian-cli/skills/obsidian-cli .claude/skills/obsidian-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
obsidian-cli
GitHub stars
451
Token cost
~3.2k tokens
SKILL.md length
971 words
Files
2 (incl. references)
Skills in repo
1
Repo updated
First seen
Licence
None found

At a glance

Lets the agent read, write, search and tidy an Obsidian vault directly through the official Obsidian command-line interface.

  • Works in 12 steps: Paths are vault-relative — use… → create paths omit .md — the extension is… → move requires full target path including… → …
  • Reading or appending to a daily note in an Obsidian vault
  • SKILL.md covers Prerequisites, Syntax, Command Overview and Quick Reference — Most Common…, plus 4 more sections
  • Calls jq

What it does

The skill drives the official Obsidian CLI, which talks to a running Obsidian desktop app over IPC. It handles requests such as reading a note or daily note, writing or appending content, searching, listing or counting notes, managing tasks, moving or renaming files, and finding orphaned notes or broken links. It is meant for hands-on vault operations and automation, not for conceptual questions about Obsidian's interface, settings or plugins.

Prerequisites are Obsidian Desktop 1.12.0 or newer with the command line interface switched on in settings, and the app must be running. Platform notes cover the binary landing in PATH on macOS and Linux, the Obsidian.com redirector and non-admin terminals needed on Windows (with a Git Bash wrapper workaround), and the .deb package under xvfb for headless Linux.

Parameters use key=value syntax, and naming a vault as the first argument targets it, otherwise the most recently active vault is used. The CLI has more than 130 commands in groups such as files and daily notes, and references/command-reference.md lists the flags and output formats for each.

When your agent uses it

  • Reading or appending to a daily note in an Obsidian vault
  • Searching vault contents from the terminal
  • Finding orphaned notes or broken links
  • Scripting vault operations or cron-based Obsidian workflows

Example prompts

  • “Append today's meeting summary to my daily note.”
  • “Search my Work Notes vault for meeting and list the matching notes.”
  • “Find orphaned notes and broken links in my vault.”

Requirements

  • Obsidian Desktop 1.12.0 or newer, running
  • The command line interface enabled in Obsidian settings
  • On Windows, Obsidian.com next to Obsidian.exe and a non-admin terminal

Workflow steps

12 steps, taken from the first numbered list in SKILL.md.

  1. Paths are vault-relative — use folder/note.md, not absolute filesystem paths.
  2. create paths omit .md — the extension is added automatically.
  3. move requires full target path including .md extension.
  4. Pipe-friendly — plain text output works with grep, awk, sed, jq.
  5. JSON output — use format=json on search for a JSON array of file paths. The files command does not support JSON output.
  6. Stderr noise — GPU/Electron warnings on headless are harmless; filter with 2>/dev/null.
  7. daily:prepend inserts content after frontmatter, not at byte 0.
  8. Use eval to run arbitrary JavaScript against the Obsidian API (app.*).
  9. template:insert inserts into the currently active file in the Obsidian UI — it does not accept a path= parameter. If no file is open, it…
  10. property:set stores list values as strings — value="tag1, tag2" writes a literal comma-separated string, not a YAML array. For proper…
  11. eval requires single-line JavaScript — multiline JS passed inline fails with a token error. Write the script to a temp file instead
  12. Multi-vault targeting may not work in all environments — obsidian "My Vault" command can return Error: Command "My Vault" not found on…

What it can do on your machine

Read from SKILL.md and the folder at commit d778231. 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:

    • jq

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

  • Network

    Links to these hosts (documentation or services it may open):

    • obsidian.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 loads about 3.2k tokens when it runs, and up to ~8.6k if it reads all its reference files. Until then it costs about 217 tokens; SKILL.md has 971 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~217
When it runs · the whole SKILL.md, loaded when a task matches
~3.2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~8.6k

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

Without a licence we can't republish the file, so here is its outline and opening line. It has 971 words (~3,169 tokens).

“The official Obsidian CLI (released in v1.12, February 2026) lets you control every aspect of Obsidian from the terminal. It communicates with a running Obsidian desktop instance via IPC.”

— opening of SKILL.md by pablo-mano
name
obsidian-cli

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file (references) in plugins/obsidian-cli/skills/obsidian-cli of pablo-mano/Obsidian-CLI-skill.

  • SKILL.md
  • references/command-reference.md

Open the folder on GitHubat commit d778231

Compare with similar skills

Obsidian CLI 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 compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Obsidian CLI this skillpablo-mano/Obsidian-CLI-skill451—~3.2kAutomated safety check: PassNone
LLM Wikilewislulu/llm-wiki-skill655—~3.7kAutomated safety check: PassNone
Save to Obsidian VaultAgriciDaniel/claude-obsidian15k1 repos~1.3kAutomated safety check: PassMIT
Obsidian Project Knowledge BaseGalaxy-Dawn/claude-scholar5.7k—~551Automated safety check: PassMIT
LLM WikiCharlesHoskinson/sevenlayer116—~1.5kAutomated safety check: PassCustom licence
Ray Obsidian Vault Setupimraywang/rayskills160—~625Automated safety check: PassCustom licence

Similar skills

  • LLM Wiki

    lewislulu/llm-wiki-skill

    Build and maintain a Karpathy-style LLM knowledge base — a self-compiling Obsidian markdown wiki where an Agent ingests raw sources, compiles cross-linked concept/entity/summary pages, answers…

    655 GitHub stars~3.7k tokensUpdated 5 mo ago
    Knowledge ManagementAuto-check passed
  • Save to Obsidian Vault

    AgriciDaniel/claude-obsidian

    Files a specific answer, decision or insight you point to in a conversation as one reviewed note in your Obsidian vault, and only when you ask for it.

    15k GitHub starsUsed in 1 repo~1.3k tokens
    Knowledge ManagementAuto-check passed
  • Obsidian Project Knowledge Base

    Galaxy-Dawn/claude-scholar

    Maintains a project-scoped Obsidian research knowledge base: bootstrapping its folders, routing notes, updating hub, plan and index notes, and linting.

    5.7k GitHub stars~551 tokensUpdated 15 days ago
    Knowledge ManagementAuto-check passed
  • LLM Wiki

    CharlesHoskinson/sevenlayer

    Builds and maintains a persistent, interlinked Obsidian-compatible markdown knowledge wiki in a git repo via three operations — ingest a source into linked pages, answer a question from the…

    116 GitHub stars~1.5k tokensUpdated 1 mo ago
    Knowledge ManagementAuto-check passed
  • Ray Obsidian Vault Setup

    imraywang/rayskills

    Sets up, audits or incrementally upgrades a local Obsidian vault for knowledge work and content production, without overwriting or moving existing notes.

    160 GitHub stars~625 tokensUpdated 15 days ago
    Knowledge ManagementAuto-check passed
  • Wiki Vault Query

    jason-effi-lab/karpathy-llm-wiki-vault

    Answers questions from a local Obsidian-style wiki by reading its index first, then the relevant pages, and replying with wiki-link citations instead of model memory.

    716 GitHub stars~383 tokensUpdated 5 mo ago
    Knowledge ManagementAuto-check passed

Works with

Questions about Obsidian CLI

What does Obsidian CLI do?

Lets the agent read, write, search and tidy an Obsidian vault directly through the official Obsidian command-line interface. The skill drives the official Obsidian CLI, which talks to a running Obsidian desktop app over IPC. It handles requests such as reading a note or daily note, writing or appending content, searching, listing or counting notes, managing tasks, moving or renaming files, and finding orphaned notes or broken links.

When should I use Obsidian CLI?

Obsidian CLI fits situations like: reading or appending to a daily note in an Obsidian vault; searching vault contents from the terminal; finding orphaned notes or broken links; scripting vault operations or cron-based Obsidian workflows.

How do I install Obsidian CLI in Claude Code?

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

How do I install Obsidian CLI in Codex?

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

Can I use Obsidian CLI 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 pablo-mano/Obsidian-CLI-skill --skill obsidian-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/obsidian-cli, .gemini/skills/obsidian-cli, .github/skills/obsidian-cli and .opencode/skills/obsidian-cli in your project.

What does Obsidian CLI need to run?

Going by SKILL.md and its folder, Obsidian CLI needs the command-line tools its instructions call (jq). Our summary lists: Obsidian Desktop 1.12.0 or newer, running; The command line interface enabled in Obsidian settings; On Windows, Obsidian.com next to Obsidian.exe and a non-admin terminal.

Does Obsidian CLI access the network?

SKILL.md names 1 domain. As links in the text: obsidian.md. This is read from the text; nothing was executed.

Is Obsidian CLI 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 use?

No licence was found for Obsidian CLI or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Obsidian CLI use?

About 3.2k tokens (SKILL.md is roughly 13k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 5.4k tokens, read only when the agent opens those files.

What are the alternatives to Obsidian CLI?

Skills that share tags, products or a category with Obsidian CLI: LLM Wiki (lewislulu/llm-wiki-skill, 655 stars), Save to Obsidian Vault (AgriciDaniel/claude-obsidian, 15k stars), Obsidian Project Knowledge Base (Galaxy-Dawn/claude-scholar, 5.7k stars) and LLM Wiki (CharlesHoskinson/sevenlayer, 116 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Obsidian CLI?

pablo-mano (a GitHub user) maintains it in pablo-mano/Obsidian-CLI-skill, which has 451 GitHub stars. The repository was last updated on March 5, 2026.

Source: pablo-mano/Obsidian-CLI-skill on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.