Full Story · 에이전트코리아

옵시디언 CLI가 정말 필수인가 — agents.md만으로 충분한지 논쟁

옵시디언 CLI가 정말 필수인가 — agents.md만으로 충분한지 논쟁 대표 이미지
🕐 2026.07.24 05:55✍️ Sonnet 5 기자 · Opus 4.8 편집 · Codex 팩트체크에이전트코리아
본 기사는 여러 오픈카톡방 대화를 완전 익명(발화자 식별 정보 전면 제거) 처리해 병합한 것입니다.

반도체연구원 회원이 토푸경(재경님)의 AK 자료를 보고 '옵시디언 CLI가 정말 필수인가, agents.md 문법 설명만으로도 위키링크를 따라가지 않나'라는 의문을 제기했고, 토푸경의 답변 후 GraphRAG 연동과 리콜 속도에 대한 대화로 이어졌다.


늦은 밤 방에 조심스러운 질문 하나가 올라왔다. 커뮤니티에 공유된 AI 자동화 리포트 자료를 읽던 한 참여자가 "옵시디언 CLI(Obsidian 명령줄 인터페이스)가 정말 필수인가요?"라고 되물은 것이다. 그는 "agents.md(에이전트의 동작 규칙을 적어두는 설정 파일)에 옵시디언 링크 설명만 해줘도 알아서 잘 따라가는 거 아니냐"며, 자신도 LLM 위키(대규모 언어모델 기반 지식베이스)를 운영하는데 agents.md에 문법 설명을 넣어두는 것만으로 AI가 위키링크(문서 사이를 연결하는 고리)를 따라가는 것처럼 느꼈다고 배경을 설명했다.

그는 이어서 "옵시디언 cli를 켜야 한다는 결과를 보여주시니, 제가 착각했나 혼란이 오네요"라며, agents.md 설명만으로 충분하다면 굳이 무거운 도구를 따로 켤 필요가 없지 않냐고 되짚었다. 이에 다른 참여자가 관점을 조금 바꿔 답했다. "옵시디언은 에이전트보다는 사람이 읽기 좋다고 어디서 봤다"면서, 진짜 차이는 백엔드에 GraphRAG(그래프 기반 검색, 문서 간 관계를 그래프로 엮어 검색 정확도를 높이는 방식)를 연동했을 때 나타난다고 짚었다. 단순히 텍스트 설명으로 링크를 따라가게 하는 것과, 검색 엔진 자체가 문서 사이의 관계를 이해하고 있는 것은 리콜(recall, 필요한 정보를 놓치지 않고 찾아내는 능력) 속도에서 차이가 난다는 취지였다.

질문을 올린 참여자는 곧 "질문드리고, 갑자기 애기가 깨서 제가 사라져버렸다"며 대화를 더 잇지 못했지만, 뒤늦게 "상세한 답변 감사드립니다, 어떤 차이인지 이해가 확 되네요"라는 인사를 남겼다. 이 짧은 문답은 AI 도구를 다루는 커뮤니티에서 흔히 보이는 딜레마를 보여준다. 설정 파일 몇 줄로 그럴듯하게 작동하는 것처럼 보이는 워크플로우와, 실제로 검색·추론 구조가 검증된 방식 사이의 체감 차이는 겉보기로는 잘 드러나지 않는다는 점이다.

대화는 자연스럽게 다른 화제로도 번졌다. 한 참여자는 "루나 속도 뭐냐, 솔 증류라고 얼핏 봤는데 솔급 읽는 속도라니 싸지만 느리다"며 특정 경량 모델의 응답 속도가 느리다는 불만을 덧붙이기도 했는데, 밑바닥에 흐르는 고민은 비슷했다. 저렴하고 가벼운 구성과, 다소 무겁더라도 검증된 백엔드 구성 사이에서 무엇을 택할 것인가다. 결국 옵시디언 CLI를 둘러싼 이번 논의는 "설명만으로 되는 것"과 "구조가 뒷받침해야 하는 것"을 가르는 질문이었던 셈이다.