obsidian-vault-cli은(는) 무엇을 하나요?
명령줄에서 100개 이상의 명령어와 직접 파일 접근을 통해 Obsidian 보관함을 관리하고 자동화하여 효율적인 워크플로우를 구현합니다.
개요
rjzxui/obsidian-vault-cli는 Obsidian 사용자가 명령줄 인터페이스를 통해 보관함을 완전히 제어할 수 있도록 해주는 강력한 도구입니다. 노트 생성, 검색, 편집, 링크 관리, 템플릿 적용, 태그 분류 등 보관함 작업을 자동화하고 스크립트화할 수 있습니다.
주요 기능
- 노트 관리: 새 노트 생성, 기존 노트 편집, 노트 삭제 및 이동
- 검색 및 필터: 키워드, 태그, 생성일 등 다양한 조건으로 노트 검색
- 링크 분석: 내부 링크 확인, 끊어진 링크 찾기, 백링크 목록 보기
- 태그 관리: 태그 일괄 추가/제거, 태그 기반 노트 분류
- 템플릿 엔진: 사용자 정의 템플릿을 사용한 노트 생성
- 파일 시스템 접근: Obsidian 인터페이스 없이 직접 파일 조작
- 배치 작업: 여러 노트에 대한 일괄 작업 수행
지원 플랫폼
- Claude Code
- Cursor
- Codex
- 기타 AI 에이전트 환경
설치
npm install -g obsidian-vault-cli
또는 프로젝트별로 설치:
npm install obsidian-vault-cli --save-dev
사용 예제
# 새 노트 생성
ovc note create "아이디어 모음" --content "새로운 아이디어 목록"
# 특정 태그로 노트 검색
ovc search --tag "프로젝트"
# 끊어진 링크 확인
ovc links check --broken
# 템플릿 적용
ovc template apply daily-note.md --date "2024-01-15"
설정
~/.ovc/config.json 파일에서 설정 가능:
{
"vaultPath": "/Users/username/Obsidian/MyVault",
"defaultTemplate": "daily-note",
"editor": "code"
}
환경 변수
OBSIDIAN_VAULT_PATH: 보관함 기본 경로OBSIDIAN_CLI_TEMPLATE_DIR: 템플릿 디렉토리OBSIDIAN_CLI_EDITOR: 기본 편집기
명령어 목록
전체 명령어 목록은 GitHub 저장소에서 확인하세요.
라이선스
MIT