How-to · Knowledge & Research · By Steph Ango (Kepano / Obsidian)

How to use Obsidian CLI in your AI agent

Install and use the Obsidian CLI skill in Claude Code, Cursor, Codex, Gemini CLI, OpenCode, and Windsurf — with sample prompts.

What you'll get

Obsidian CLI lets you interact with your Obsidian vault through simple commands instead of clicking around the app. Create notes, append to your daily journal, search your entire vault, manage tasks, and update note properties — all from your AI assistant. Perfect for anyone who wants to capture ideas, organize research, or manage their knowledge base without context-switching.

Step 1 — Get the skill source URL

The Obsidian CLI skill lives at:

Step 2 — Add it to your AI agent

Copy one of these prompts and paste it into your AI tool. The agent will fetch and install the skill for you.

Claude Code

Add the agent skill from https://github.com/kepano/obsidian-skills/tree/main/skills/obsidian-cli to my project.

Cursor

Install this agent skill: https://github.com/kepano/obsidian-skills/tree/main/skills/obsidian-cli

Codex

Add this skill to .codex/skills/: https://github.com/kepano/obsidian-skills/tree/main/skills/obsidian-cli

Gemini CLI

Add the skill at https://github.com/kepano/obsidian-skills/tree/main/skills/obsidian-cli to my .gemini/skills/ directory.

OpenCode

Install this agent skill from https://github.com/kepano/obsidian-skills/tree/main/skills/obsidian-cli

Windsurf

Add this skill: https://github.com/kepano/obsidian-skills/tree/main/skills/obsidian-cli

Step 3 — Try these prompts

Once the skill is installed, ask your AI things like:

  • Quickly add something to your daily note without opening Obsidian
  • Search your entire knowledge base for a specific topic
  • Organizing research and want to create multiple linked notes at once
  • Bulk-update properties or tags across notes

What this skill does

  • Creates and reads notes in your Obsidian vault
  • Searches across all your notes and finds backlinks
  • Appends content to notes including daily notes and tasks
  • Updates note properties and manages tags
  • Captures screenshots and inspects vault structure for developers
Made bySteph Ango (Kepano / Obsidian)
CategoryKnowledge & Research