정정(2026-09-21): 공식 Obsidian CLI와 커뮤니티 도구의 설치·명령 체계를 혼용한 설명을 수정했습니다. 아래는 공식 문서 기반 안내이며, 이 글을 위해 세 운영체제에서 직접 실행한 시험 결과는 아닙니다. 기존 생산성 수치는 측정 기록이 확인되지 않아 제외했습니다.
공식 CLI 설치 경로
Obsidian 공식 CLI 문서는 최신 설치 프로그램(1.12.7 이상)으로 업데이트한 뒤 설정 → 일반 → Command line interface에서 기능을 활성화하고 등록 안내를 따르도록 설명합니다.
npm install -g obsidian-cli나 brew install obsidian-cli를 공식 설치 절차로 안내했던 부분은 잘못됐습니다. 이름이 비슷한 커뮤니티 패키지와 공식 기능은 구분해야 합니다.
공식 CLI의 명령 이름은 obsidian입니다. Obsidian 앱이 필요하며, 앱이 실행 중이 아니면 첫 명령 실행 시 앱을 시작합니다. 데스크톱 앱 없이 동작하는 다른 도구와 혼동하지 마세요.
먼저 읽기 작업으로 연결을 확인하세요
아래는 공식 문서에 나온 명령 형식입니다. 사용자 환경에서의 성공을 보장하는 실행 기록은 아닙니다.
obsidian help
obsidian version
obsidian vault="Notes" search query="meeting"
Notes는 자신의 볼트 이름으로 바꾸세요. 여러 볼트를 사용한다면 대상을 명시해야 엉뚱한 볼트를 조회하거나 수정하는 실수를 줄일 수 있습니다.
쓰기 작업은 테스트 볼트에서 확인하세요
공식 명령 형식을 이용한 예시입니다. Notes-Test라는 별도 테스트 볼트를 준비하고 실행하세요. 실제 볼트의 기존 문서를 덮어쓰는 옵션은 넣지 않았습니다.
obsidian vault="Notes-Test" create name="CLI-check" content="CLI test note"
obsidian vault="Notes-Test" read file="CLI-check"
생성 후 앱에서도 파일 위치와 내용을 확인하세요. 자동화에 연결하기 전 다음 기록을 남기면 실패 원인을 비교하기 쉽습니다.
| 기록 항목 | 적을 내용 |
|---|---|
| 환경 | 운영체제·설치 프로그램·앱 버전 |
| 대상 | 볼트 이름과 테스트 노트 경로 |
| 입력 | 실제 실행한 명령에서 비밀정보를 제거한 내용 |
| 결과 | 출력·오류 메시지·앱에 반영된 내용 |
명령을 찾지 못하면 공식 문서의 운영체제별 문제 해결 항목과 등록 상태를 확인하세요. 비슷한 이름의 패키지를 추가 설치하는 것으로 해결하려 하지 마세요.
