obsidian-official-cli

What This Skill Does

The obsidian-official-cli skill provides a robust interface for interacting with your Obsidian vaults directly from your terminal. It effectively turns Obsidian into a programmable environment by wrapping the official CLI tool. Whether you are performing file management tasks like creating, moving, or deleting notes, or more complex operations like searching through vault contents, managing tags, or manipulating note properties, this skill automates the heavy lifting. It is designed to integrate seamlessly into your workflow, allowing you to bridge the gap between deep technical command-line environments and the organized, knowledge-centric world of Obsidian.

Installation

To install this skill, run the following command in your terminal: clawhub install openclaw/skills/skills/slmoloch/obsidian-official-cli Ensure you have Obsidian 1.12+ with a Catalyst license. Enable the 'Command line interface' in your Obsidian Settings under the General tab, and follow the registration prompt. Restart your terminal or source your profile to ensure the obsidian command is available in your PATH.

Use Cases

• Personal Knowledge Management (PKM): Rapidly draft notes or append findings from a terminal coding session directly into your Obsidian Inbox.
• Automation: Use shell scripts to batch-create meeting notes or daily templates based on terminal output.
• Search & Retrieval: Quickly find specific information across thousands of markdown files without leaving your IDE or shell.
• File Maintenance: Bulk-move notes to archival folders or clean up duplicate files through standard command-line pipe operations.
• Development: Use it to reload plugins or inspect vault data for debugging custom plugin development.

Example Prompts

1. "Open the note named 'Project Roadmap' in a new tab and append the current output of my build command to the bottom."
2. "Search for all notes containing the tag '#urgent' that were modified this week, and output the list as a JSON object."
3. "Move all files currently located in the 'Inbox/' folder to the 'Projects/Archive/' directory."

Tips & Limitations

• Requirement: Obsidian must remain open in the background for the CLI to communicate with the vault.
• Targeting: Always prefer the path= parameter for specific files to avoid ambiguity in vaults with similarly named files.
• TUI Mode: For interactive exploration, simply run obsidian without arguments to enter the interactive TUI, which supports autocomplete for commands.
• Safety: Be careful with the permanent flag on the delete command, as it bypasses the system trash.