Obsidian CLI로 터미널에서 노트 자동화하기

 

Obsidian CLI(Command Line Interface)는 옵시디언을 터미널에서 제어하는 명령어 인터페이스입니다.

옵시디언에서 가능한 거의 모든 작업을 커맨드라인에서 스크립트화하고 자동화할 수 있습니다.

일일 노트 열기, 검색, 태스크 관리 등 일상 작업을 스크립트로 처리할 수 있으며, 플러그인이나 테마 개발 시 디버깅과 로그 확인도 가능합니다. 일반 앱의 GUI 대신 자동화 워크플로와 연동하여 AI, Git, 태스크 자동화 도구 등과 함께 사용할 수 있습니다.

Obsidian CLI는 Obsidian 1.12 이상 버전과 Catalyst 라이선스가 필요한 얼리 액세스 기능입니다.

명령어와 문법이 향후 변경될 수 있으니 참고하시기 바랍니다.

 

설치 및 기본 설정

Obsidian CLI를 사용하려면 먼저 최신 버전을 설치해야 합니다. 옵시디언 설치 파일을 최신 버전(1.11.7 이상)으로 업데이트한 후, Early access 버전(Obsidian 1.12.x)으로 업데이트하여 CLI를 활성화할 준비를 합니다.

CLI 활성화는 옵시디언 앱에서 설정을 통해 진행합니다.

메뉴에서 설정 → General로 이동한 후, Command line interface(Obsidian CLI) 항목을 활성화합니다.

화면의 안내에 따라 CLI 등록을 완료하면 터미널에서 obsidian 명령을 사용할 수 있습니다.

 

터미널에서 사용하는 방법

Obsidian CLI는 두 가지 방법으로 사용할 수 있습니다.

한 줄 명령을 직접 실행하거나, obsidian 명령으로 터미널 인터페이스(TUI)를 열어 여러 명령과 자동완성을 활용하는 방식입니다.

TUI에서는 Tab과 Shift+Tab으로 자동 완성을 사용할 수 있으며, 위아래 화살표와 Ctrl+R로 명령어 기록을 검색할 수 있습니다. CLI가 제대로 동작하는지 확인하려면 obsidian help 명령으로 사용 가능한 모든 명령 리스트를 확인하거나, obsidian version 명령으로 현재 버전을 확인하면 됩니다.

 

주요 명령어와 활용법

일일 작업에서 자주 사용하는 명령어는 다음과 같습니다.

obsidian daily 명령은 오늘 날짜의 일일 노트를 열어줍니다.

obsidian daily:append content="메모 내용" 명령을 사용하면 일일 노트 맨 뒤에 내용을 추가할 수 있습니다.

검색 기능도 제공됩니다.

obsidian search query="회의" 명령으로 보관함 전체에서 특정 문구를 검색할 수 있으며, obsidian tasks daily 명령으로 오늘 일일 노트의 태스크 목록을 확인할 수 있습니다.

새 파일을 생성할 때는 obsidian create name="프로젝트 계획서" template=Project 명령을 사용합니다. 템플릿을 지정하여 새 파일을 만들 수 있어 반복 작업을 줄일 수 있습니다. 여러 라인을 작성하려면 \n을, 탭은 \t를 사용하면 됩니다.

파일과 폴더를 관리하는 명령어도 있습니다. obsidian files folder=projects 명령으로 특정 폴더 내 모든 파일 리스트를 확인할 수 있으며, obsidian folders 명령으로 폴더 목록을 볼 수 있습니다. 기존 파일을 덮어쓰려면 overwrite 옵션을 추가하면 됩니다.

 

버전 관리와 백업

옵시디언의 파일 복원과 Sync 기능은 CLI에서도 제어할 수 있습니다.

obsidian diff file=Recipe 명령으로 특정 파일의 모든 버전 목록을 확인할 수 있으며, obsidian diff file=Recipe from=2 to=1 명령으로 두 버전을 비교할 수 있습니다.

Sync 버전 내역은 obsidian sync:history file=Recipe 명령으로 확인하고, obsidian sync:restore file=Recipe version=1 명령으로 특정 버전으로 복원할 수 있습니다.

자동화 스크립트나 백업 시스템에서 변경 이전 상태로 되돌리는 용도로 활용하면 유용합니다.

 

플러그인과 테마 관리

플러그인과 테마를 CLI로 관리하면 자동화된 테스트와 백업 환경을 구축할 수 있습니다.

obsidian plugins 명령으로 설치된 모든 플러그인을 확인할 수 있으며, obsidian plugin:enable id=my-plugin 명령으로 특정 플러그인을 활성화하거나 비활성화할 수 있습니다.

테마 변경도 가능합니다.

obsidian themes 명령으로 설치된 테마 목록을 확인하고, obsidian theme:set name=Dark++ 명령으로 테마를 변경할 수 있습니다. 블로그나 개인 사이트를 옵시디언으로 운영할 때 자동으로 원고를 게시하도록 설정할 수 있어 편리합니다.