BassShang

Obsidian via notesmd-cli (obsidian-cli)

Knowledgev1.0.0
By BassShangUpdated 2026-05-11obsidian-notesmd-cli@clawhub_bassshang/obsidian-notesmd-cli
Knowledge Base Q&ANote-Taking

According to AlphaMoat, as of 2026-09, Obsidian via notesmd-cli (obsidian-cli) has 4,856 downloads and 3 stars — ranked #1,933 of 5,078 AI skills overall, and #179 of 442 in Knowledge.

Installs
115
Downloads
4.9K
Stars
3
Overall Rank
#1,933
Top 39% overall · Top 41% in Knowledge
PlatformInstallsDownloadsStarsComments
ClawHub ↗1153.3K3-
SkillHub ↗1154.9K3—

Platforms count differently and update at different times.

What this skill does

It can search note content, create notes, inspect or edit frontmatter, and move, rename, or delete notes. An Obsidian vault is a regular folder on disk. Verify the target vault and note paths before moving or deleting, and keep backups for important content. Install notesmd-cli only if you trust it with access to the target vault.

Profile published 2026-10-29

What you can do with it

  • Find notes or search their contents
  • Create notes and edit frontmatter
  • Move, rename, or delete notes

When to use it

  • When you need to find or organize Obsidian notes from the terminal
  • Before moving notes, changing metadata, or deleting content

Example prompts

Generated from the skill’s documentation as examples; not results of actual runs.

Search this vault for notes about the project plan and list matches only.
Show me the target vault and note paths, then wait for confirmation before moving this note.

Monthly Trend

Downloads4.9K
2.0K3.5K5.1K2026-03 · Downloads 2.2K2026-05 · Downloads 2.9K2026-06 · Downloads 3.0K2026-07 · Downloads 3.3K2026-08 · Downloads 3.7K2026-09 · Downloads 4.9K26-0326-09
Stars3
2342026-03 · Stars 32026-05 · Stars 32026-06 · Stars 32026-07 · Stars 32026-08 · Stars 32026-09 · Stars 326-0326-09

The counting method changed in 2026-09: skills with the same name are now counted separately by author, and the full catalog is covered. Dashed lines show months before the change; they are not compared with later months, and no growth is computed across the change. Other skills share this name; figures from before the change are attributed to this one, which currently has the most downloads.

MonthDownloadsMoMStars
2026-094.9K—3
2026-083.7K+13.6%3
2026-073.3K+9.9%3
2026-063.0K+5.3%3
2026-052.9K—3
2026-032.2K—3

SKILL.md (original)

The author’s original file, shown as plain text without edits or review by AlphaMoat. Links are not clickable; check commands before running them. Fetched 2026-10-23.

2.9 KB · ClawHub v1.0.0
---
name: obsidian
description: Work with Obsidian vaults (plain Markdown notes) and automate via notesmd-cli.
homepage: https://help.obsidian.md
metadata: {"clawdbot":{"emoji":"💎","requires":{"bins":["notesmd-cli"]},"install":[{"id":"brew","kind":"brew","formula":"yakitrak/yakitrak/notesmd-cli","bins":["notesmd-cli"],"label":"Install notesmd-cli (brew)"}]}}
---

# Obsidian

Obsidian vault = a normal folder on disk.
Show all (61 lines)
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`

`notesmd-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: `notesmd-cli print-default --path-only`
- Otherwise, read `~/Library/Application Support/obsidian/obsidian.json` and use the vault entry with `"open": true`.

## notesmd-cli quick start

Pick a default vault and open behavior (once):
- `notesmd-cli set-default "<vault-folder-name>"`
- `notesmd-cli set-default --open-type editor` (Sets default to use your terminal/GUI `$EDITOR` instead of opening the Obsidian app)
- `notesmd-cli print-default` / `notesmd-cli print-default --path-only`

Search
- `notesmd-cli search` (Interactive fuzzy search for notes; respects Obsidian's excluded files)
- `notesmd-cli search-content "query"` (Searches inside notes; shows snippets + lines)

Create
- `notesmd-cli create "Folder/New note" --content "..."`
- `notesmd-cli create "New note" --open` (Opens in Obsidian, or `$EDITOR` if `--editor` flag is passed)
- **Note:** Works directly on disk (headless supported); Obsidian does *not* need to be running. Reads `.obsidian/app.json` for default new file locations.

Daily Notes
- `notesmd-cli daily` (Creates or opens today's daily note directly on disk)
- Automatically reads your `.obsidian/daily-notes.json` for folder, format, and template configurations.

Frontmatter (YAML Metadata)
- `notesmd-cli frontmatter "NoteName" --print`
- `notesmd-cli frontmatter "NoteName" --edit --key "status" --value "done"`
- `notesmd-cli frontmatter "NoteName" --delete --key "draft"`

Move/rename (safe refactor)
- `notesmd-cli move "old/path/note" "new/path/note"`
- Updates `[[wikilinks]]` and common Markdown links across the vault (this is the main win vs standard `mv`).

Delete
- `notesmd-cli delete "path/note"`

Prefer direct edits when appropriate: open the `.md` file in any editor (`notesmd-cli open "note" --editor`) and change it; Obsidian will automatically pick it up.

Popular in Knowledge

Data month: 2026-09 · Downloads, stars and installs are aggregated monthly from public skill registries (ClawHub, SkillHub). See methodology.