obsidian-vault-manager

# Obsidian Vault Manager

## Prerequisites

Before performing vault operations:

1. **Verify obsidian-cli is installed:**
   ```bash
   obsidian-cli --version
   ```

2. **If obsidian-cli is unavailable:**
   - Install via: `npm install -g @johnlindquist/obsidian-cli`
   - Fallback: Standard file operations can be used but will NOT preserve wiki-links
   - Warning: Without obsidian-cli, moving notes will break all internal `[[wiki-links]]`

3. **Verify vault is accessible:**
   ```bash
   obsidian-cli print-default
   ```

## Overview

**Use `obsidian-cli` for all Obsidian vault operations.** Standard file tools (mv, Write, Edit) break internal links and ignore vault structure. The `obsidian-cli` tool automatically preserves `[[wiki-links]]` and maintains vault integrity.

## When to Use

This skill activates when:
- Working with Obsidian vaults (`.md` files with `[[wiki-links]]`)
- Moving/renaming notes (links must stay valid)
- Creating notes with Obsidian-specific syntax (wiki-links, checkboxes, tags)
- Searching vault content or note names
- Organizing multiple notes across folders

**Don't use for:**
- General markdown editing outside Obsidian vaults
- Static documentation (no internal links)
- Single-file markdown operations

## Quick Reference

| Task | Command | Notes |
|------|---------|-------|
| Check vault | `obsidian-cli print-default` | Always run first |
| Read note | `obsidian-cli print "Note Name"` | Reads by name or path |
| Create note | `obsidian-cli create "Name" --content "text"` | Add `--open` to launch Obsidian |
| Update note | `obsidian-cli create "Name" --content "text" --append` | Use `--overwrite` to replace |
| Move note | `obsidian-cli move "old/path" "new/path"` | **Auto-updates all links** |
| Search content | `obsidian-cli search-content "term"` | Searches note contents |
| Search names | `obsidian-cli search` | Fuzzy search (interactive) |
| Daily note | `obsidian-cli daily` | Create/open today's note |

**See also:**
- [Complete o