최근 코딩 에이전트(coding agent) 활용이 늘면서, 개발자들이 쌓아둔 로컬 문서들을 에이전트가 제대로 활용하지 못하는 문제가 대두되었습니다. 프로젝트 README, 설계 문서(ADR), 사양(spec), 회의 노트, 개인 옵시디언(Obsidian) 문서 등 방대한 자료를 에이전트가 매번 찾아 읽도록 지시하거나 직접 붙여넣는 것은 매우 번거로운 일입니다. 이러한 비효율성을 해결하기 위해, 로컬 마크다운(Markdown) 문서를 코딩 에이전트가 쉽게 접근하고 활용할 수 있도록 돕는 'llmwiki-serve'가 프리뷰 버전으로 공개되었습니다.
llmwiki-serve는 사용자가 지정한 로컬 마크다운 폴더를 '읽기 전용 컨텍스트 서버(context server)'로 열어줍니다. 이를 통해 코딩 에이전트는 이 서버에 연결하여 필요한 문서를 검색하고 읽으며, 어떤 문서를 근거로 작업했는지까지 파악할 수 있습니다. 예를 들어, "이번 릴리스에서 빠진 체크가 뭐야?", "이 설계 변경과 관련된 ADR을 찾아줘"와 같은 질문에 에이전트가 스스로 관련 문서를 찾아 답변할 수 있게 됩니다. 이 도구는 마크다운 폴더, 옵시디언 스타일 위키링크(wikilink), YAML 프론트매터(front matter), 헤딩(heading), 태그(tag) 등을 지원하며, CLI, HTTP, MCP(Message Channel Protocol)를 통해 에이전트와 연결됩니다. 특히 코덱스(Codex)나 클로드 코드(Claude Code) 사용자를 위해 마켓플레이스 플러그인(marketplace plugin)을 제공하여 설치 및 연결 과정을 간소화했습니다.
llmwiki-serve의 가장 큰 장점은 복잡한 임베딩 인덱스나 RAG(검색 증강 생성) 앱을 별도로 구축할 필요 없이, 기존 로컬 문서들을 에이전트가 활용할 수 있도록 해준다는 점입니다. 기본적으로는 로컬 마크다운 문서 내의 어휘/문자열 검색을 지원하며, 필요에 따라 FastEmbed 기반의 벡터(vector) 또는 하이브리드(hybrid) 검색 기능도 추가할 수 있습니다. 이를 통해 개발 팀은 에이전트의 정보 접근성을 높여 개발 생산성을 향상시키고, 에이전트가 더 정확하고 맥락에 맞는 작업을 수행하도록 유도할 수 있습니다. 또한, 원본 마크다운 파일을 수정하지 않고 조회 인터페이스만 제공하므로 기존 문서 관리 워크플로우를 방해하지 않는다는 점도 큰 이점입니다.