옵시디언 CLI 사용법, 개발 노하우를 AI 지식 자산으로 만들기

개발 테크

4시간 전

조회수

AI 에이전트 활용이 늘어날수록 작업 지시를 얼마나 정교하게 작성하느냐가 결과물의 품질을 결정합니다. 이 때문에 개발 과정에서 얻은 노하우를 꾸준히 기록하고 체계적으로 쌓아두는 것이 중요해지고 있는데요.

이를 개발자 친화적으로 구현한 도구가 출시되었습니다. 바로 '옵시디언 CLI'입니다. 옵시디언의 지식 축적 기능을 터미널에서 직접 구현할 수 있게 만들어 코딩 흐름을 끊지 않고 기록하고, 검색하고, AI 에이전트와 연동하는 것까지 터미널 안에서 처리할 수 있습니다.

이번 글에서는 옵시디언 CLI가 무엇인지, 개발 현장에서 어떻게 활용할 수 있는지 구체적인 예시와 함께 정리합니다.

옵시디언 CLI 핵심 요약

옵시디언 CLI는 터미널에서 옵시디언을 제어하는 공식 명령줄 인터페이스입니다. 데일리 노트 열기, 문서 검색, 특정 노트에 내용 추가 같은 작업을 앱 전환 없이 터미널에서 바로 실행할 수 있습니다.
AI 에이전트 시대에 개인 지식 자산을 연결하는 도구로 활용할 수 있습니다.
명령어 스니펫, 설정 메모, 트러블슈팅 기록을 옵시디언 볼트에 쌓아두고, Claude Code·Codex·Cursor 같은 AI 에이전트 작업 지식으로 확장할 수 있습니다.
실제 개발에서는 기록, 저장, 검색, 불러오기 흐름에 유용합니다.
코딩 중 떠오른 아이디어는 데일리 노트에 저장하고, Git 변경 이력은 개발 로그에 누적하며, 오류 해결 기록은 검색 후 read 명령어로 다시 불러올 수 있습니다.
사용할 때는 노트 존재 여부와 이름, 입력 형식에 주의해야 합니다. 기존 노트에 내용을 추가하려면 해당 노트가 먼저 있어야 하며, 긴 코드나 여러 줄 내용을 저장할 때는 따옴표·줄바꿈 때문에 명령어가 깨지지 않도록 확인해야 합니다

옵시디언 CLI(Obsidian CLI)란?

옵시디언 CLI는 사용자가 터미널에서 명령어를 입력해 옵시디언을 제어할 수 있도록 만든 공식 명령줄 인터페이스입니다.

옵시디언의 마크다운 노트 환경을 CLI와 연동해, 작업 목록과 태그, 데일리 노트를 터미널 중심의 워크플로우에 연결하고 지식과 작업 흐름을 자동화하는 개인 지식 관리 도구로 확장합니다.

데일리 노트 열기, 볼트 내 문서 검색, 특정 노트에 내용 추가 같은 작업을 터미널에서 명령어 한 줄로 바로 실행가능합니다.

옵시디언 CLI가 주목받는 이유

- AI 에이전트와 연결되는 지식 저장소

옵시디언 CLI는 옵시디언의 노트 기능을 터미널에서 그대로 사용할 수 있습니다. 코딩 중에 옵시디언 앱으로 화면을 전환하거나 폴더를 찾아 들어갈 필요 없이, 단순 명령어 한 줄로 떠오르는 아이디어와 작업 메모를 바로 저장할 수 있습니다.

볼트 안에 쌓인 명령어 스니펫, 설정 파일 메모, 트러블슈팅 기록은 필요할 때 바로 활용할 수 있는 지식 자산이 됩니다. 명령어 한 줄로 즉시 검색해 현재 작업에 꺼내 쓸 수 있어 개발 생산성을 높일 수 있습니다.

기록으로 쌓은 노하우를 AI 에이전트의 작업 지식으로 확장

나아가 클로드 코드(Claude Code), 코덱스(Codex), 커서(Cursor) 같은 AI 에이전트와 연동하면, 터미널에서 쌓아온 노하우를 AI 에이전트가 참고할 수 있는 작업 지식으로 확장할 수 있습니다.

특히 하네스 엔지니어링처럼 AI 에이전트의 작업을 세밀하게 관리하는 프롬프트를 작성할 때, 볼트에 축적해둔 개발 노하우와 작업 기록을 그대로 참고 자료로 활용할 수 있어 AI 에이전트의 작업 정확도를 높일 수 있습니다.

즉, 옵시디언 CLI는 옵시디언에 쌓아둔 개인 지식 자산을 AI 에이전트의 작업 흐름으로 확장해주는 도구입니다.

옵시디언 CLI 사용법

옵시디언 내 명령줄 인터페이스 활성화

옵시디언 공식 문서에 따르면 옵시디언 CLI를 실행하기위해 Obsidian installer 버전으로 업데이트하고, 설정에서 Command line interface를 켜야 한다고 안내하고 있습니다.

이를 위해 먼저 Obsidian 1.12.7 이상 설치 프로그램으로 업데이트한 뒤, 앱 설정에서 CLI를 활성화합니다.

옵시디언 CLI를 사용하기 위해 옵시디언 앱 화면에서 업데이트 하는 방법을 설명했습니다.

옵시디언을 실행한 뒤 설정 버튼을 클릭하고, 일반 옵션에서 업데이트 확인 버튼을 눌러 현재 설치된 버전을 확인합니다. 설치된 버전이 Obsidian 1.12.7보다 낮다면 최신 버전으로 업데이트를 진행합니다.

옵시디언 CLI를 사용하기 위해 옵시디언 앱 화면에서 명령줄 인터페이스를 활성화 하는 방법을 설명했습니다.

Obsidian 1.12.7 이상 버전이 설치되어 있다면, 설정 > 일반 > 고급 설정에서 ‘명령줄 인터페이스’를 활성화합니다.

이후 안내 창이 표시되면 터미널에서 obsidian 명령어를 사용할 수 있도록 등록을 진행합니다.

터미널에서 옵시디언 실행하기

obsidian help

옵시디언 내 명렬줄 인터페이스가 활성화 되었다면, 터미널에서 옵시디언 CLI가 정상적으로 실행되는지 확인하기 위해 위 명령어를 입력합니다.

옵시디언 CLI가 터미널에서 작동되는지 확인하기 위한 테스트 화면입니다.

위의 이미지와 같이 입력하면 옵시디언 CLI에서 사용할 수 있는 명령어 목록이 표시된 화면이 나오면 CLI가 정상적으로 등록된 상태입니다.

터미널에서 obsidian 명령어를 입력하면 Obsidian CLI의 TUI 화면으로 접속이 됩니다. 이제 데일리 노트 실행, 검색, 개발자 도구 실행 등 다양한 작업을 터미널에서 사용할 수 있습니다.

옵시디언 CLI를 실제 개발에 활용는 방법

옵시디언 CLI를 활성화하면 CLI 전용 화면인 TUI에서 사용하거나, 터미널에서 명령어를 직접 입력해 사용하는 두 가지 방식으로 활용할 수 있습니다.

터미널에서 사용할 때는 옵시디언 명령어 앞에 obsidian을 붙여 실행하면 됩니다.지금부터 보여드리는 예시는 개발자 환경에 맞게 터미널 기반 예시로 정리했습니다.

1. 코딩 중 떠오른 아이디어를 데일리 노트에 바로 저장하기

obsidian daily:append content="저장할 내용"

개발을 하다 보면 코드 수정 중 갑자기 아이디어가 떠오르거나 나중에 수정해야 할 작업이 생깁니다. 이럴 때 메모해두지 않으면 잊어버리게 되는데요

터미널에 위의 명령어를 입력하면 바로 오늘의 데일리 노트에 기록할 수 있습니다.

데일리 노트 저장 예시 프롬프트

obsidian daily:append content="## 로그인 실패 횟수 제한 로직

```js

function checkLoginAttempt(user) {

const MAX_ATTEMPTS = 5;

if (user.loginFailCount >= MAX_ATTEMPTS) {

return {

allowed: false,

message: '로그인 실패 횟수를 초과했습니다. 잠시 후 다시 시도해주세요.'

};

}

return {

allowed: true,

message: '로그인 시도가 가능합니다.'

};

}

목적: 로그인 실패 횟수가 5회를 넘으면 추가 로그인을 제한하기 위함
활용 상황: 로그인 보안 강화, 비정상 접근 방지, 반복 로그인 시도 차단에 활용 가능
추후 개선: 제한 시간 설정, IP 기준 차단, 관리자 알림 기능 추가"

옵시디언 CLI의 데일리 노트 명령어를 사용해 로그인 실패 횟수 제한 로직에 대한 내용을 기록했습니다.

위 화면처럼 터미널에서 입력한 코드와 설명이 옵시디언 데일리 노트에 그대로 저장된 것을 확인할 수 있습니다.

2. Git 상태와 변경 이력을 개발 로그로 저장하기

obsidian append file="노트 이름" content="저장할 내용"

두 번째 방법은 터미널에서 확인한 작업 상태를 기존에 있던 옵시디언 볼트 안의 개발 로그 노트에 누적해 저장하는 방식입니다.

Git 변경 파일, 브랜치 상태, 커밋 전 점검 내용을 하나의 노트에 계속 쌓아두면 나중에 어떤 작업을 했는지 흐름을 한눈에 파악할 수 있습니다. 작업 변경 이력을 체계적으로 기록하고 관리하는 용도로 활용하기 좋습니다.

개발 로그 저장 예시 프롬프트

obsidian append file="개발 로그" content="## Git 작업 로그”

브랜치:

$(git branch --show-current)

변경 파일:

$(git status --short)

- 기록 목적: 현재 프로젝트의 브랜치와 변경된 파일 상태를 남기기

- 활용 상황: 코드 수정 내역 확인, 커밋 전 변경 사항 점검

- 추후 활용: 작업 회고, 오류 발생 시 변경 이력 확인"

옵시디언 CLI의 명령어를 사용해 개발 로그에 대한 내용을 기록했습니다.

위 화면처럼 옵시디언 볼트 안에 있는 ‘개발 로그’ 노트에 Git 작업 로그가 저장된 것을 확인할 수 있습니다.

이처럼 Git 브랜치, 변경 파일, 커밋 전 점검 내용을 한곳에 기록해두면 나중에 어떤 작업을 진행했는지 흐름을 파악하기 쉽고, 프로젝트 변경 이력도 체계적으로 관리할 수 있습니다.

3. 저장해둔 오류 해결 기록을 검색해 다시 활용하기

obsidian search query="찾을 내용"

obsidian read file="노트 이름"

세 번째는 옵시디언에 저장해둔 오류 해결 기록을 터미널에서 다시 검색해 활용하는 방식입니다.

개발 중 같은 오류가 다시 발생했을 때 매번 웹에서 검색하지 않아도, 이전에 정리해둔 트러블슈팅 기록을 빠르게 찾아 참고할 수 있습니다.

먼저 오류 해결 기록을 검색하기 위해 search 명령어를 사용합니다.

검색 예시 프롬프트

obsidian search query="MODULE_NOT_FOUND"

위 화면처럼 search query 명령어를 사용하면 옵시디언 볼트 안에서 특정 키워드가 포함된 노트를 터미널에서 바로 검색할 수 있습니다. 검색 결과를 통해 MODULE_NOT_FOUND 오류 기록이 어떤 노트에 저장되어 있는지 확인할 수 있습니다.

이제 검색 결과에서 확인한 노트의 실제 내용을 불러오기 위해 read 명령어를 사용합니다.

기록 불러오기 예시 프롬프트

obsidian read file="MODULE_NOT_FOUND 오류 해결 기록"

명령어를 실행하면 노트 안에 저장해둔 오류 메시지, 오류 코드, 발생 상황, 원인, 해결 방법, 확인 방법이 터미널에 그대로 출력됩니다.

옵시디언 앱을 열지 않아도 이전에 정리해둔 트러블슈팅 기록을 터미널에서 바로 확인할 수 있습니다.

옵시디언 CLI 주요 명령어

한 눈에 보기 좋게 정리했습니다!

명령어	역할	활용 상황
obsidian help	CLI 명령어 목록 확인	CLI 설치 후 정상 작동 확인
obsidian create name="" content=""	새 노트 생성	트러블슈팅 기록, 개발 로그 노트 생성
obsidian append file="" content=""	기존 노트에 내용 추가	개발 로그, 오류 해결 기록 누적
obsidian daily	오늘 데일리 노트 열기	일일 작업 기록 확인
obsidian daily:append content=""	데일리 노트에 내용 추가	코딩 중 아이디어 즉시 기록
obsidian search query=""	키워드로 노트 검색	오류 기록, 명령어 스니펫 검색
obsidian read file=""	노트 내용 불러오기	저장된 해결 방법 확인
obsidian devtools	개발자 도구 실행	플러그인·테마 개발 점검

* 옵시디언 CLI의 주요 명령어는 생성, 추가, 검색, 불러오기, 실행으로 나눌 수 있습니다. create는 새 노트를 만들 때, append는 기존 노트에 내용을 추가할 때, search는 저장된 기록을 찾을 때, read는 노트 내용을 터미널에서 확인할 때 사용합니다.