Obsidian CLI

보관함을 지휘하세요.

Obsidian에서 할 수 있는 모든 일을 명령줄에서도 할 수 있습니다.

터미널
# 오늘의 일일 노트 열기
obsidian daily

# 보관함 검색
obsidian search query="회의 메모"

# 일일 노트에 작업 추가
obsidian daily:append content="- [ ] 장보기"

사용 사례

Obsidian CLI는 일반 텍스트를 위한 프로그래밍 방식의 놀이터입니다.

개발.
플러그인과 테마를 더 빠르게 만드세요. 터미널을 벗어나지 않고 코드를 편집하고, 다시 불러오고, 테스트하고, 디버그하세요.
협업.
문서를 배포하고, 공유 보관함을 서버에 동기화하며, Obsidian을 팀의 툴체인에 통합하세요.
자동화.
cron 작업, 셸 스크립트, 맞춤형 통합으로 작업 흐름을 오케스트레이션하세요. 스크립트로 만들 수 있다면, 해낼 수 있습니다.
실험하기.
프로그래밍 방식으로 보관함을 읽고, 검색하고, 작성하세요. 에이전트형 도구가 보관함과 상호작용할 수 있게 하세요.

시작하기

Obsidian CLI 설치

01

Obsidian 업데이트

최신 Obsidian 설치 프로그램을 다운로드하세요. 다운로드 →

02

CLI 활성화

설정일반에서 명령줄 인터페이스를 활성화하세요.

03

CLI 등록

화면의 안내에 따라 CLI를 시스템 PATH에 추가하세요. 변경 사항을 적용하려면 터미널을 다시 시작하세요.

등록하면 ~/.zprofile을 통해 Obsidian 바이너리가 PATH에 추가됩니다. bash 또는 fish를 사용하는 경우 셸 설정에 경로를 수동으로 추가하세요.

~/.zprofile
export PATH="$PATH:/Applications/Obsidian.app/Contents/MacOS"

설치 프로그램은 Obsidian.exe와 함께 Obsidian.com 터미널 리디렉터를 추가합니다. 이는 Obsidian이 GUI 앱으로 실행되기 때문에 필요합니다.

AppImage: 심볼릭 링크가 /usr/local/bin/obsidian에 생성됩니다(sudo 필요). sudo가 실패하면 ~/.local/bin으로 대체됩니다.

Flatpak: 심볼릭 링크가 자동으로 생성됩니다. 실패하면 Flatpak export를 가리키도록 수동으로 생성하세요.

첫 명령 실행하기

설치가 완료되면 바로 사용할 수 있습니다. Obsidian 앱이 실행 중이어야 합니다.

명령 실행

터미널
# 도움말 표시
obsidian help

TUI 모드 사용

터미널
# TUI 열기 (자동 완성 포함)
obsidian

예시

실제로 보기

일상적인 노트 작성부터 개발자 자동화까지, 실용적인 예제를 확인해 보세요.

터미널
# 오늘의 일일 노트 열기
obsidian daily

# 일일 노트에 작업 추가
obsidian daily:append content="- [ ] 장보기"

# 보관함 검색
obsidian search query="회의 메모"

# 현재 파일 읽기
obsidian read

# 일일 노트의 모든 작업 나열
obsidian tasks daily

# 템플릿으로 새 노트 만들기
obsidian create name="파리 여행" template=여행

# 빈도와 함께 모든 태그 보기
obsidian tags counts

# 파일의 두 버전 비교
obsidian diff file=README from=1 to=3
터미널
# DevTools 열기
obsidian devtools

# 개발 중인 플러그인 다시 불러오기
obsidian plugin:reload my-plugin

# 앱 스크린샷 캡처
obsidian dev:screenshot file=shot.png

# JavaScript 실행
obsidian eval "app.vault.getFiles().length"

# JS 오류 검토
obsidian dev:errors

# CSS 속성 검사
obsidian dev:css selector=".workspace"

# DOM 요소 쿼리
obsidian dev:dom selector=".nav"
터미널
#!/bin/bash
# 아침 루틴 자동화

# 오늘의 일일 노트 열기
obsidian daily

# 반복 작업 추가
obsidian daily:append content="- [ ] 받은 편지함 검토"
obsidian daily:append content="- [ ] 일정 확인"

# 최근 파일을 클립보드에 복사
obsidian files sort=modified limit=5 --copy

# 해결되지 않은 링크 확인
obsidian unresolved

# 특정 보관함을 검색하고 JSON으로 내보내기
obsidian search query="status::active" vault="노트" format=json

단축키

키보드 단축키

TUI에 내장된 편리한 단축키와 자동 완성.

탐색

왼쪽으로 이동 / Ctrl+B
오른쪽으로 이동 / Ctrl+F
줄 시작 Ctrl+A
줄 끝 Ctrl+E
이전 단어 Alt+B
다음 단어 Alt+F

편집

줄 시작까지 삭제 Ctrl+U
줄 끝까지 삭제 Ctrl+K
이전 단어 삭제 Ctrl+W / Alt+⌫
제안 수락 Tab
제안 닫기 Shift+Tab
첫 번째 제안 수락

일반

이전 명령 / Ctrl+P
다음 명령 / Ctrl+N
기록 검색 Ctrl+R
취소 Escape
화면 지우기 Ctrl+L
종료 Ctrl+C / Ctrl+D

동기화

Headless Sync

GUI 없이 Obsidian Sync를 실행하세요. 어떤 서버나 자동화 환경에서도 Obsidian Sync의 속도, 개인정보 보호, 종단 간 암호화를 그대로 누릴 수 있습니다.

  • 원격 백업을 자동화하세요.
  • 웹사이트 게시를 자동화하세요.
  • 에이전트형 도구가 전체 컴퓨터에 접근하지 않고도 보관함에 접근할 수 있게 하세요.
  • 공유 팀 보관함을 다른 도구에 데이터를 제공하는 서버와 동기화하세요.
  • 예약된 자동화를 실행하세요 — 일일 노트를 주간 요약으로 모으고, 태그를 자동으로 추가하는 등 더 많은 작업을 할 수 있습니다.

시작하기

Obsidian CLI를 설치하고 사용하는 방법을 알아보세요.