obsidian-cli

A skill for managing notes, tasks, properties, plugins, and themes in an open Obsidian vault through the Obsidian command line. Obsidian is a note-taking app that stores linked notes as local files.

In plain words
What is it for?
Use it to read, create, search, append, and update notes and tasks, manage note properties, reload plugins, inspect pages, capture screenshots, and check errors.
Why use it?
It lets an agent work with an existing vault using repeatable commands instead of manually navigating the app. Obsidian must be open for the commands to interact with it.

Skill for Claude CodeCodex

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/arch3rpro/ark-space/obsidian-cli
Any agent
npx skills add arch3rPro/ark-space --skill obsidian-cli
Clone the repo
git clone --depth 1 https://github.com/arch3rPro/ark-space

Made for: Claude Code, Codex.

Per session 102 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 587 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 $0.00102 $0.00587
Opus 5 $0.00051 $0.00293
Sonnet 5 $0.00020 $0.00117
Haiku 4.5 $0.00010 $0.00059

Measured 2d ago against content hash 42c3acaae172, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

obsidian-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 2d 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.

plugins/ark-space/skills/obsidian-cli/SKILL.md · 67 lines

What it actually says

Obsidian CLI

Use the obsidian CLI to interact with a running Obsidian instance. Requires Obsidian to be open.

Command Reference

Run obsidian help to see the current command set. Full docs: https://help.obsidian.md/cli

Syntax

  • Parameters take a value with =.
  • Flags are boolean switches with no value.
  • Quote values with spaces.
  • Use \n for multiline content and \t for tabs.
obsidian create name="My Note" content="# Hello"
obsidian create name="My Note" silent overwrite

Targeting

Many commands accept file or path:

  • file=<name> resolves like a wikilink.
  • path=<path> uses an exact vault-relative path such as folder/note.md.

Commands target the most recently focused vault by default. Use vault=<name> as the first parameter to select another vault.

obsidian vault="My Vault" search query="project alpha"

Common Patterns

obsidian read file="My Note"
obsidian create name="New Note" content="# Hello" template="Template" silent
obsidian append file="My Note" content="New line"
obsidian search query="search term" limit=10
obsidian daily:read
obsidian daily:append content="- [ ] New task"
obsidian property:set name="status" value="done" file="My Note"
obsidian tasks daily todo
obsidian tags sort=count counts
obsidian backlinks file="My Note"

Use --copy to copy output to the clipboard. Use silent to prevent files from opening. Use total on list-style commands to get a count.

Development Work

When the task is plugin, theme, or UI debugging work, keep the main skill light and load the extra workflow only when needed:

Guidance

  • Prefer the narrowest command that answers the request instead of reaching for eval first.
  • For note content changes, target an exact file or path when ambiguity would be risky.
  • For development tasks, reload the plugin or theme and check for errors before claiming success.
Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

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. 2d ago First seen · 67 lines · 102 tokens per session scan A 42c3acaae172

Subscribe to this mod's changes

obsidian-cli is a skill published in the GitHub repository arch3rPro/ark-space (2 stars, last pushed 7d ago), licensed MIT. It adds 102 tokens to every session and 587 once invoked, about $0.0005 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-31.

Related

Other skills, from other repositories

skill-authoring

Author SKILL.md skills: frontmatter, validator limits, structure.

mateaix/mateclaw · 18 tokens

obsidian-wiki-system

Initialize or maintain a reusable Obsidian wiki knowledge iteration system with raw inbox, wiki pages, source/concept/synthesis/project templates, workflows, prompts, indexes, logs, and AGENTS.md rules. Use in Codex, OpenCode, or any agent that can read skill folders when the user wants to create a new Obsidian vault…

LiyuanW21/obsidian-wiki-system · 97 tokens

agent-platform-model-registry

Agent Platform Model Registry Management. Use when you need to upload, list, describe, update, or delete machine learning models (and their versions) in the Agent Platform Model Registry. Don't use for model training, model deployment to endpoints, or managing non-Agent Platform models.

google/skills · 60 tokens

bigquery-ai-ml

Leverages BigQuery's built-in machine learning and GenAI capabilities for advanced data analytics. Use when you need to write SQL queries that perform time-series forecasting, predict values, detect outliers or anomalies, find key drivers, perform semantic search or vector search, classify text, calculate similarity…

google/skills · 104 tokens

twitter-reader

Read Twitter/X for financial research using opencli (read-only). Use this skill whenever the user wants to read their Twitter feed, search for financial tweets, view bookmarks, look up user profiles, or gather market sentiment from Twitter/X. Triggers include: "check my feed", "search Twitter for", "show my…

himself65/finance-skills · 161 tokens

referral-program

When the user wants to design, launch, or optimize an in-app referral / invite / share-to-earn program — including reward structure, mechanics, fraud prevention, deep link setup, and viral coefficient measurement. Use when the user mentions "referral program", "invite a friend", "refer and earn", "share to earn"…

Eronred/aso-skills · 159 tokens