obsidian-mechanics

Manage Obsidian vaults via CLI for creation, editing, linking, and hygiene.

2|Updated Jun 1, 2017
One-click install
npx skills add https://github.com/carlos-algms/dotfiles --skill obsidian-mechanics
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-mechanics
Source: https://github.com/carlos-algms/dotfiles/tree/main/AI-configs/skills/obsidian-mechanics
Command: npx skills add https://github.com/carlos-algms/dotfiles --skill obsidian-mechanics

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about obsidian-mechanics

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I safely automate Obsidian vault operations via CLI without breaking wikilinks?

To safely automate Obsidian vault operations via CLI, use rename and move commands for wikilink auto-updating, and rely on direct file editing tools like Read, Edit, or Write for existing files to avoid shell escaping issues.

How do I find orphaned notes and unresolved links in an Obsidian vault?

You can find orphaned notes and unresolved links in an Obsidian vault by running vault-wide CLI operations designed for hygiene, which query backlinks, deadends, and unresolved references to maintain note integrity.

Does the Obsidian CLI work reliably when the GUI is unavailable or integration fails?

When Obsidian GUI or CLI integration fails, you can resolve vault paths via the CLI with caching, then fall back to a vault path environment variable to ensure operations continue reliably in unstable contexts.

How do I manage Obsidian frontmatter properties and version history from the command line?

You can manage Obsidian frontmatter properties and version history from the command line by applying CLI-driven mechanics that edit metadata, append sections, and use version history with trash or permanent delete to reduce accidental loss in non-git vaults.

What is the best way to create new notes in Obsidian using CLI automation?

The best way to create new notes in Obsidian using CLI automation is to use the Write tool by default, which avoids shell escaping issues and applies vault path resolution conventions for consistent file creation.