Obsidian Helper

通过 Bash 脚本封装 Obsidian 笔记库的常用操作：列出、搜索、创建、读取、编辑（vim）、删除笔记及生成日报；笔记库路径可由环境变量 OBSIDIAN_VAULT 指定或自动探测（WSL/Linux）。安装脚本会把命令复制到 ~/bin 并修改 PATH，删除操作具破坏性。仅依赖本地文件系统，不涉及网络。

547895019

热度 43.00

最近更新 2026-05-11 17:43:19

分类：知识依赖：代码执行 / 读写文件应用场景：笔记整理 / 工作流 / 自动化脚本

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add obsidian-helper

Metadata

name: obsidian-helper
description: Operate Obsidian vaults from command line. Use when the user wants to list, search, create, read, edit, or delete Obsidian notes, or manage daily notes. Triggers on mentions of "obsidian笔记", "obsidian notes", "obsidian搜索", "obsidian创建", "obsidian列表", or any Obsidian vault operations.
metadata: {"obsidian-helper":{"emoji":"📝","requires":{"bins":["obsidian"],"env":["OBSIDIAN_VAULT"]},"primaryEnv":"OBSIDIAN_VAULT"}}

Obsidian Helper

A command-line tool for operating Obsidian vaults. Works with vaults stored on Windows (WSL) or Linux.

Installation

Quick Install (Recommended)

Run the install script:

cd ~/skills/obsidian-helper
bash scripts/install.sh

This will:

Copy obsidian script to ~/bin/
Make it executable
Add ~/bin to your PATH (if not already present)

Verify Installation

which obsidian
obsidian --version  # or obsidian help

Quick Start

obsidian list              # 列出所有笔记
obsidian search 关键词      # 搜索笔记内容
obsidian create 文件名      # 创建新笔记
obsidian read 文件名        # 读取笔记
obsidian edit 文件名        # 编辑笔记 (vim)
obsidian daily             # 创建/查看日报
obsidian delete 文件名      # 删除笔记

Configuration

The script auto-detects the vault path:

Environment variable (highest priority):

export OBSIDIAN_VAULT=/path/to/your/vault

WSL environment: Auto-detects Windows user directory
```
/mnt/c/Users/<WindowsUser>/Documents/Obsidian
```
Linux environment: Uses default path
```
~/obsidian
```

Set your Obsidian vault path (optional - auto-detects if not set):

# Add to ~/.bashrc
echo 'export OBSIDIAN_VAULT=/mnt/c/Users/YourName/Documents/Obsidian/Vault' >> ~/.bashrc
source ~/.bashrc

Commands Reference

Command	Aliases	Description
`list`	`ls`, `l`	List all markdown notes in vault
`search <term>`	`s`, `find`	Search content in notes
`create <name> [content]`	`c`, `new`	Create new note
`read <name>`	`r`, `cat`, `show`	Read note content
`edit <name>`	`e`, `vim`	Edit note in vim
`daily [date]`	`d`, `today`	Create/view daily note
`delete <name>`	`del`, `rm`	Delete a note
`help`	`h`	Show help

Examples

# List all notes
obsidian list

# Search for "project"
obsidian search project

# Create a note in a folder
obsidian create "Projects/MyProject"

# Create with content
obsidian create "Ideas/Quick Note" "# Quick Note\n\nThis is my idea."

# Read a note
obsidian read "Welcome"

# Create today's daily note
obsidian daily

Daily Notes

Daily notes are stored in Daily/YYYY/YYYY-MM-DD.md format.