Skip to content

Obsidian CLI Assistant

by Steph Ango (kepano)SkillGet organised

Lets your AI agent read, search and add to your Obsidian notes and daily tasks

View on GitHub

About Obsidian CLI Assistant

Obsidian CLI Assistant is a skill that teaches your AI agent to work with your Obsidian notes while the app is open: search the vault, read and create notes, add daily tasks and set properties.

For Obsidian usersPeople who keep daily notesPlugin and theme developers

Made by Steph Ango (kepano)

Steph Ango, known as kepano, is the CEO of Obsidian, the note-taking app, and earlier co-founded Lumi and Inkodye.

Stars
★ 50k
License
MIT
Cost
Free
Level
Intermediate
Contents
Instructions only

Overview

Teaches your AI agent to use the Obsidian CLI, the command line interface built into the Obsidian app. With Obsidian open, the agent can read and create notes, search your vault, add tasks to your daily note, set properties and list backlinks or tags. It also covers plugin and theme development, such as reloading a plugin and reading its errors. Made by Obsidian's CEO for Obsidian users who want an agent to work with their vault directly.

It works through Obsidian's own command line interface, so the agent uses the app's search, templates and daily notes instead of editing files blind.

Try these first

Start with the first one: it is a small task you can check easily.

  1. Search my vault for "[word]" and list the matching notes. Don't change anything.First try · read-only

  2. Read the note [Meeting 2026-10-28] and list its open tasks.

  3. Add "- [ ] [task]" to today's daily note.edits a note

  4. List the tags in my vault, sorted by how often they are used.

Example prompts written by Agent Flows Hub.

What you get

From the creator's documentation.

OutputWhat it isReads
SearchSearch vault content and list the matching notesYour vault
ReadRead notes, backlinks, tags and tasksYour vault
Create and appendCreate notes from templates and add lines to existing notesYour vault
Daily notesRead today's daily note and add tasks to itYour vault
PropertiesSet properties such as status on a noteYour vault
Developer commandsReload plugins, read errors, take screenshots and run JavaScript in the appObsidian app

Good to know

Let an agent search a vault and add a task to today's daily note through the running Obsidian app. The skill lists the CLI syntax for reading, creating, searching and editing notes, plus developer commands for plugins and themes.

Limits

  • The CLI needs the Obsidian 1.12 installer or newer, switched on in Settings, and the app running; the first command opens Obsidian if it is closed.
  • The same commands can overwrite notes and run JavaScript inside the app. Start with read-only commands such as search and read.

Notes by (original project name: obsidian-cli), written from the creator's documentation, not from running it ourselves. obsidian-cli: SKILL.md · Obsidian Help: Obsidian CLI · Obsidian: About (Steph Ango, CEO)

Stuck setting it up?

Tell us what happened. We take a look first; if it needs paid work, you get an estimate before anything starts.

Get help

Other skills

  • Obsidian Note Formatter Writes and tidies notes using Obsidian's links, callouts and properties
  • Oil UI Helps your agent design web pages and app screens, and compare directions side by side
  • Open Design Agent Kit Lets your coding agent make slide decks, posters, landing pages and app mockups as files
  • Outlier Post Finder Finds the posts that did far better than an account's usual results and explains why
  • Papermorph Turns a textbook PDF or a story into a narrated, animated web book you can host anywhere
  • PDF Toolkit Merges, splits and fills in PDFs, and pulls text and tables out of them

See all 140 skills · A skill is installed but not loading

GitHub