Obsidian

• You want an AI agent to search your notes by name or content and surface relevant snippets.
• You need to create new notes in a specific folder, optionally with pre-filled content, via Obsidian's URI handler.
• You need to rename or move notes safely — obsidian-cli move updates all [[wikilinks]] across the vault, which a plain mv command would break.
• You want to automate vault maintenance (deleting stale notes, bulk creating entries) without manually touching Obsidian.

• You are not using the Obsidian desktop app — obsidian-cli depends on Obsidian being installed and its vault registry (obsidian.json) being present.
• You need to work with canvas files (.canvas) or plugin configuration (.obsidian/) — those formats are not covered by this skill.
• You are on Linux or Windows — obsidian-cli is installed via Homebrew and the vault registry path referenced is macOS-specific (~/Library/Application Support/obsidian/).

Use obsidian-cli search to find notes by filename, or obsidian-cli search-content to search inside notes with matching snippets and line numbers returned.

obsidian-cli move renames or relocates a note and automatically updates all [[wikilinks]] and common Markdown links that reference it across the vault — a critical advantage over a raw filesystem rename.

Create notes at any vault path with optional pre-filled content using obsidian-cli create, which routes through Obsidian's URI handler to ensure the new file is properly registered.

The skill reads Obsidian's own obsidian.json to locate active vaults rather than hardcoding paths, correctly handling multi-vault setups (iCloud, work/personal, etc.).

For simple reads or edits, the skill can open .md files directly — Obsidian picks up filesystem changes automatically, making direct edits a fast and valid alternative to CLI commands.

Ask your agent to find all notes related to a project or topic. It uses search-content to return relevant snippets and line references, letting you quickly locate information buried across hundreds of notes.

Pipe in meeting transcripts, web research, or task lists and have the agent create structured Markdown notes in the right vault folder, complete with frontmatter and content, using obsidian-cli create.

Rename or restructure note hierarchies without manually hunting down broken links — obsidian-cli move keeps all internal references intact across the entire vault.

Have the agent search for outdated or duplicate notes and delete them with obsidian-cli delete, keeping the vault tidy without requiring you to manually browse folders.