약간 좀 늦은 감이 있지만, 옵시디언이 업데이트되면서 CLI가 추가되었다. 직접 사용해본 후기를 남겨본다.
CLI 이전에는
CLI 이전에도 옵시디언 노트들을 에이전트로 관리하는 데 큰 이슈는 없었다. 어차피 옵시디언은 내부 노트를 각각의 마크다운 파일로 관리하고 있어서, 에이전트가 CLI 없이도 노트를 읽거나 쓰는 게 가능했기 때문이다.
물론 대규모 처리 수준에서는 좀 문제가 있었다. 예를 들어 특정 태그가 달린 노트들만 리스트업해서 에이전트가 확인해야 하는 경우, 스크립트를 직접 만들어 쓰거나 노트 파일을 하나하나 열어보며 태그 유무를 확인해야 했다. 에이전트 입장에서는 꽤나 비효율적인 작업이다.
옵시디언 CLI는 바로 이런 부분을 해결해준다. 에이전트가 직접 해석할 필요 없이 CLI 명령 한 줄로 처리할 수 있으니 토큰 비용도 크게 줄고, 속도도 훨씬 빠르다.
플러그인 충돌 방지
거기에 추가로, 플러그인과의 충돌을 막아준다는 점이 크다. 나는 self-hosted-livesync 플러그인을 사용해서 옵시디언 볼트를 동기화하고 있는데, 에이전트가 외부에서 노트 파일을 직접 수정하면 잠재적인 이슈들이 발생했다.
플러그인이 외부 파일 수정을 감지하지 못해 동기화가 제대로 이루어지지 않고, 이 때문에 여러 이슈가 터졌다. 단순 내용 컨플릭트 정도면 상관없는데, 동기화 상태 자체가 꼬여서 원격 데이터베이스를 초기화해야 하는 일이 잦았다. 클로드 코드를 사용해서 수정할 땐 그나마 덜했는데, 유독 코덱스로 수정하면 이런 문제가 자주 터졌다.
옵시디언 CLI를 통해 노트를 수정하면 플러그인들이 변경 사항을 정상적으로 감지해서 올바르게 동작한다. 더 이상 동기화 꼬임 따위에 시달리지 않아도 된다.
설정 방법
에이전트가 옵시디언 노트를 수정할 때 CLI를 사용하도록 명시해줘야 한다. 이건 스킬로 간단하게 처리할 수 있다. https://github.com/kepano/obsidian-skills 에 옵시디언 스킬을 정리해주신 분이 있는데, 여기에 옵시디언 CLI 관련 스킬도 포함되어 있어 바로 가져다 쓸 수 있다.
스킬 추가 자체도 에이전트에게 해달라고 하면 어려움 없이 바로 적용된다.
결론
스킬까지 추가하고 나서 에이전트를 통해 이런저런 노트 수정을 해보니 너무 만족스럽다. 내가 요청한 사항들을 옵시디언 CLI로 읽고 쓰니 처리도 빠르고, 수정 사항도 올바르게 반영된다. 플러그인 충돌은 말할 것도 없고.
옵시디언 CLI 덕분에 에이전트가 좀 더 똑똑해진 느낌도 있다. 이전엔 태그를 일괄 변경할 때 스크립트로 Replace시키는 방식이었다면, 이젠 Tag Wrangler 플러그인을 이용해 태그를 일괄 변경한다. 이런 방식 덕분에 토큰 절약은 물론이고 속도와 정확성 모두 크게 좋아졌다.
Base와 더불어 정말 잘 만든 옵시디언의 신규 기능이다. 계속해서 좋은 기능을 추가해주는 옵시디언 개발팀에게 압도적인 감사를 보낸다.