An AI agent skill for interacting with your Obsidian vault via the CLI — works with Claude Code and Cursor
<p align="center">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="./assets/banner-dark.svg">
<source media="(prefers-color-scheme: light)" srcset="./assets/banner-light.svg">
<img alt="Obsidian CLI Agent" src="./assets/banner-dark.svg" width="600">
</picture>
</p>
<p align="center">
<strong>Give your AI agent full access to your Obsidian vault.</strong>
</p>
<p align="center">
<a href="https://github.com/jcgonzalez25/obsidian-cli-agent/releases"><img src="https://img.shields.io/github/v/release/jcgonzalez25/obsidian-cli-agent" alt="Release"></a>
<a href="https://github.com/jcgonzalez25/obsidian-cli-agent/stargazers"><img src="https://img.shields.io/github/stars/jcgonzalez25/obsidian-cli-agent" alt="Stars"></a>
<a href="https://github.com/jcgonzalez25/obsidian-cli-agent/commits/main"><img src="https://img.shields.io/github/last-commit/jcgonzalez25/obsidian-cli-agent" alt="Last Commit"></a>
<a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a>
<img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg" alt="PRs Welcome">
</p>
---
> Most AI coding agents can't touch your knowledge base. This plugin bridges that gap — letting Claude Code and Cursor read, search, and write to your Obsidian vault using natural language.
<p align="center">
<img src="./assets/demo.gif" alt="Demo" width="700">
</p>
## Features
- **Daily Notes** — Append findings, decisions, and meeting notes to today's daily note
- **Note Management** — Create, read, append, move, rename, and delete notes
- **Task Tracking** — List open tasks, toggle completion, filter by daily note
- **Search** — Full-text search with context across your entire vault
- **Knowledge Graph** — Find backlinks, orphaned notes, dead ends, and broken links
- **Templates** — Create notes from your Obsidian templates
- **Properties** — Read and set frontmatterAgent that generates comprehensive documentation, API references, architecture diagrams, and developer onboarding guides from existing code.
Agent configuration for systematic bug investigation that traces issues from error logs through the codebase to root cause with suggested fixes.
Agent for integrating third-party APIs including SDK setup, type generation, error handling, retry logic, and rate limit management.
Cursor's built-in autonomous coding agent that can make multi-file edits, run terminal commands, search the codebase, and iteratively build features with minimal human intervention.
Cloud-based autonomous coding agent that runs in the background on remote sandboxed environments, handling complex multi-step tasks while you continue working.
Cursor's multi-file editing agent within Composer mode that can create, edit, and delete files across your entire project in a single conversation.