# Obsidian

> Obsidian vault: search/read/write notes, backlinks, Bases, Canvas.

- Skill: `mouadja02/obsidian` (Agent Skill)
- Install (CLI): `npx skillmds@latest add mouadja02/obsidian`
- Raw SKILL.md: https://api.skillmd.com/api/skills/mouadja02/obsidian/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: mouadja02 (https://skillmd.com/u/mouadja02)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/mouadja02/obsidian

---


# Obsidian

> **Attribution:** Sourced from [steipete/agent-scripts](https://github.com/steipete/agent-scripts) by [Peter Steinberger](https://github.com/steipete).

## When to Use

- Searching, reading, or writing notes in a local Obsidian vault
- Managing backlinks, Bases, or Canvas files
- Querying vault content while preserving frontmatter and wikilinks

Use this for local Obsidian vault work. An Obsidian vault is a normal folder of Markdown files plus `.obsidian/` config.

## Sources

- App config: `~/Library/Application Support/obsidian/obsidian.json`
- Usual local vault path: `~/obsidian` (or configured path)
- Official CLI: `obsidian` (if installed)

## Common Operations

### Search notes

```bash
# Search across all vault notes
rg "search term" ~/obsidian/ -l
rg "search term" ~/obsidian/ -n

# Search with context
rg "search term" ~/obsidian/ -C 3

# Find notes with specific tags
rg "#tag-name" ~/obsidian/ -l
```

### Read note

```bash
cat ~/obsidian/path/to/note.md
```

### Create/update note

```bash
# Create new note
cat > ~/obsidian/new-note.md <<'EOF'
---
tags: [tag1, tag2]
created: 2025-01-01
---

# Note Title

Content here.
EOF
```

### Find backlinks (notes that link to a note)

```bash
rg "\[\[Note Name\]\]" ~/obsidian/ -l
rg "\[.*\]\(path/to/note\.md\)" ~/obsidian/ -l
```

### List all notes

```bash
find ~/obsidian -name "*.md" -not -path "*/.obsidian/*"
```

## Notes

- Obsidian uses double-bracket links: `[[Note Name]]`
- Tags use `#tag` in note bodies or `tags: [tag]` in YAML frontmatter
- Never modify `.obsidian/` config files unless explicitly asked
- Preserve YAML frontmatter format when editing notes