# NotesMD CLI
> CLI for managing Obsidian vaults from the terminal without Obsidian running

## Summary
A CLI for managing Obsidian vaults without Obsidian running — create, search, move, rename, and delete notes, manage daily notes, and edit frontmatter from the terminal.

## Capabilities
- Create, open, move, rename, and delete notes in Obsidian vaults
- Daily note creation with template support
- Fuzzy search across note titles
- Content search within notes
- YAML frontmatter viewing and editing
- Automatic link updating when renaming notes
- Open notes in configurable editor (vim, VS Code, nano, etc.)
- Works without Obsidian running

## When to Use
- You manage an Obsidian vault and want CLI access
- You need to script or automate note creation in Obsidian
- You want to create daily notes from the terminal
- You need to search Obsidian notes without opening the app
- You want to edit note frontmatter from the command line

## When NOT to Use
- You don't use Obsidian vaults
- You need graph view or plugin features that require Obsidian running
- You need rich text editing or live preview

## Key Flags
- `--vault`: Specify which Obsidian vault to use
- `--editor`: Override the default editor for opening notes

## Usage Patterns
### Create a new note
```
notesmd note create my-note
```
Creates a new note called my-note in the default vault

### Open today's daily note
```
notesmd daily
```
Creates or opens today's daily note using configured template

### Search notes by title
```
notesmd search my-query
```
Fuzzy searches note titles in the vault

### Edit frontmatter
```
notesmd frontmatter set my-note tags 'cli,automation'
```
Sets the tags field in the note's YAML frontmatter

## Input / Output
- **stdout**: Note content, search results, or frontmatter values

## Installation
- **homebrew**: `brew install yakitrak/yakitrak/notesmd-cli`

## Related Tools
- [jot](/tools/jot) (alternative): jot is a simpler Obsidian-compatible note manager
- [krafna](/tools/krafna) (complementary): krafna provides Dataview-style querying of Obsidian notes
- [nb](/tools/nb) (alternative): nb is a standalone CLI note-taking tool not tied to Obsidian

---
Source: https://littlescripts.sh/tools/notesmd-cli