obsidian-mechanics

What problem does it solve?

It helps you operate your Obsidian vault via the Obsidian CLI reliably by providing practical mechanics for searching, creating, editing, moving, renaming, managing properties, and maintaining vault hygiene without breaking wikilinks or losing recovery options.

Core Features & Use Cases

• Vault-aware CLI workflows: Perform vault-wide operations like search, file listing, backlinks, unresolved links, orphans, deadends, outlines, and tag queries.
• Safe editing and recovery patterns: Prefer direct file tools (Read/Edit/Write) for existing files and use version history and trash/permanent delete appropriately to reduce accidental loss in a non-git, synced vault.
• File creation and wikilink-safe navigation: Use Write by default to avoid shell escaping issues, and use rename/move commands where wikilink auto-updating matters.
• Fallback when the CLI fails: Resolve vault paths via the CLI with caching, then fall back to a vault path environment variable for contexts where Obsidian GUI/CLI integration is unreliable.

Quick Start

Ask your agent to create and update a note in your vault by using this skill’s vault path resolution and writing conventions.