obsidian

obsidian is a skill for Claude Code, Codex from smallnest/goclaw. It costs 22 tokens per session (635 once invoked), scanned A, a copy of obsidian, MIT.

A command-line tool for working with Obsidian vaults, which are ordinary folders containing Markdown notes and related files. It helps locate vaults and automate note-related tasks.

In plain words
What is it for?
Use it to find the active vault, set or print a default vault, and work with Markdown notes, canvases, and attachments through scripts.
Why use it?
It avoids hardcoding the wrong note folder when a person has several Obsidian vaults, such as separate work and personal collections.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Good fit Use it to find the active vault, set or print a default vault, and work with Markdown notes, canvases, and attachments through scripts.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/smallnest/goclaw/obsidian
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.

Any agent
npx skills add smallnest/goclaw --skill obsidian
Clone the repo
git clone --depth 1 https://github.com/smallnest/goclaw

Made for: Claude Code, Codex.

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 obsidian

README.md
[![agentmods](https://agentmods.dev/badge/skills/smallnest/goclaw/obsidian.svg)](https://agentmods.dev/skills/smallnest/goclaw/obsidian)
Your own site
<a href="https://agentmods.dev/skills/smallnest/goclaw/obsidian"><img src="https://agentmods.dev/badge/skills/smallnest/goclaw/obsidian.svg" alt="Measured on agentmods" height="20"></a>
Per session 22 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 635 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin 91% copy Near-identical to another mod 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.00022 $0.00635
Opus 5 $0.00011 $0.00318
Sonnet 5 $0.00004 $0.00127
Haiku 4.5 $0.00002 $0.00064

Measured 8d ago against content hash 49e6d02bfef9, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-07, from the pricing page.

Security

Grade A, and why

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

Origin

This is a copy

91% identical to obsidian — 4 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

internal/builtin_skills/obsidian/SKILL.md · 82 lines

What it actually says

Obsidian

Obsidian vault = a normal folder on disk.

Vault structure (typical)

  • Notes: *.md (plain text Markdown; edit with any editor)
  • Config: .obsidian/ (workspace + plugin settings; usually don’t touch from scripts)
  • Canvases: *.canvas (JSON)
  • Attachments: whatever folder you chose in Obsidian settings (images/PDFs/etc.)

Find the active vault(s)

Obsidian desktop tracks vaults here (source of truth):

  • ~/Library/Application Support/obsidian/obsidian.json

obsidian-cli resolves vaults from that file; vault name is typically the folder name (path suffix).

Fast “what vault is active / where are the notes?”

  • If you’ve already set a default: obsidian-cli print-default --path-only
  • Otherwise, read ~/Library/Application Support/obsidian/obsidian.json and use the vault entry with "open": true.

Notes

  • Multiple vaults common (iCloud vs ~/Documents, work/personal, etc.). Don’t guess; read config.
  • Avoid writing hardcoded vault paths into scripts; prefer reading the config or using print-default.

obsidian-cli quick start

Pick a default vault (once):

  • obsidian-cli set-default "<vault-folder-name>"
  • obsidian-cli print-default / obsidian-cli print-default --path-only

Search

  • obsidian-cli search "query" (note names)
  • obsidian-cli search-content "query" (inside notes; shows snippets + lines)

Create

  • obsidian-cli create "Folder/New note" --content "..." --open
  • Requires Obsidian URI handler (obsidian://…) working (Obsidian installed).
  • Avoid creating notes under “hidden” dot-folders (e.g. .something/...) via URI; Obsidian may refuse.

Move/rename (safe refactor)

  • obsidian-cli move "old/path/note" "new/path/note"
  • Updates [[wikilinks]] and common Markdown links across the vault (this is the main win vs mv).

Delete

  • obsidian-cli delete "path/note"

Prefer direct edits when appropriate: open the .md file and change it; Obsidian will pick it up.

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. 8d ago First seen · 82 lines · 22 tokens per session scan A 49e6d02bfef9

Subscribe to this mod's changes

obsidian is a skill published in the GitHub repository smallnest/goclaw (603 stars, last pushed 5mo ago), licensed MIT. It adds 22 tokens to every session and 635 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. It is 91% identical to obsidian, differing in 4 lines, and is treated as a copy.