Obsidian CLI
Teaches AI agents how to interact with Obsidian vaults via command-line interface.
Steph Ango (Kepano) is credited as the original ai skill creator. Setup notes, fit assessments, and cautions below are Obsidian Mate editorial guidance. How we review resources
Overview
Official CLI skill by Steph Ango (Kepano) for interacting with Obsidian vaults via command-line interface. Use it when an agent needs the repository's focused instructions for invoking supported Obsidian command-line operations. This page treats the skill as an instruction package for an existing agent host, not as an Obsidian plugin or a grant of new permissions.
Key Features
- Terminal-based vault execution
- Plugin command invocation
- Workspace and note opening
How to Install Obsidian CLI
- 1Open the source repository and read its current installation instructions for your agent host.
- 2Install the complete skill folder, including any referenced files, into the host's documented skills location.
- 3Start a fresh agent session and confirm the skill is discoverable before granting vault write access.
- 4Run the first workflow in a disposable vault and review the resulting file diff.
How to Use Obsidian CLI
Start with a read-only command in a disposable vault, confirm the active vault and output, then test one bounded write. Keep the terminal command and resulting file diff together during review.
When to Use This Skill
Use it when an agent needs the repository's focused instructions for invoking supported Obsidian command-line operations.
End-to-End Check
Start with a read-only command in a disposable vault, confirm the active vault and output, then test one bounded write. Keep the terminal command and resulting file diff together during review.
Compatibility and Safety
- A skill cannot add CLI support to an incompatible Obsidian installation. Command availability and authorization come from the installed application and agent host.
- The host agent still controls tool access, filesystem scope, and confirmation behavior.
What does this skill do?
Teaches AI agents how to use command-line interface tools to control Obsidian, open files, trigger plugin commands, and manage workspace state. Use it when an agent needs the repository's focused instructions for invoking supported Obsidian command-line operations. The agent host remains responsible for file access, tool availability, and confirmation before writes.
Best for
- Automating vault tasks from the terminal
- Integrating AI agent workflows with local Obsidian apps
- Triggering plugin commands programmatically
How it works
- Load the complete skill in a compatible agent host.
- Start with a read-only command in a disposable vault, confirm the active vault and output, then test one bounded write. Keep the terminal command and resulting file diff together during review.
- Review the resulting vault files in Obsidian before wider use.
License & Attribution
COMMUNITY RESOURCE Author: Steph Ango (Kepano) License: MIT Repository: https://github.com/kepano/obsidian-skills
Details
- Author
- Steph Ango (Kepano)
- License
- MIT
- Type
- CLI Skill
- Compatible with
- Claude Code, Codex, ChatGPT, Gemini, Agent Skills
Frequently Asked Questions
Does this require Obsidian to be running?
Some CLI commands interact with a running Obsidian instance, while file operations work on disk.
Sources and Documentation
This guide was checked against the creator's repository and primary documentation.
Related Obsidian AI Skills
Obsidian CLI Control
Complete 130+ command CLI instruction set for agents to control Obsidian from the terminal.
Obsidian Markdown
Teaches AI agents how to use Obsidian-flavored Markdown syntax correctly.
Obsidian Bases
Allows AI agents to manage Obsidian Bases (.base files), formulas, and database views.
JSON Canvas
Allows AI agents to create and edit visual JSON Canvas (.canvas) diagrams.
Related Guides
Explore more Obsidian resources
Discover more plugins, themes, templates, and starter vaults to build your perfect Obsidian setup.