llmwiki-serve 공개, Obsidian 문서를 코딩 에이전트 컨텍스트로 연결

HwangJohn이 공개한 llmwiki-serve는 기존 Markdown, Obsidian, LLMWiki 폴더를 코딩 에이전트(Codex, Claude Code 등)가 사용할 수 있는 읽기 전용 Knowledge Source로 연결하는 로컬 서버다. 위키 컴파일러가 아니라 원본 파일을 수정하지 않고 CLI, HTTP, MCP를 통해 문서 근거만 조회하는 데 초점을 맞췄다.

주요 기능 및 범위

• 원본 보존: Markdown/Obsidian의 wikilink, YAML front matter, heading, tag 등을 읽기만 하며 원본 수정이나 업로드가 없다.
• 다양한 인터페이스: CLI, HTTP, MCP Streamable HTTP를 통해 동일한 데이터 projection을 제공한다.
• 보안 필터링: draft, unpublished, confidential 표시가 된 문서는 기본 조회에서 제외된다.
• 검색 방식: 기본은 모델이나 임베딩이 필요 없는 lexical 검색이며, Vector 검색은 [vector] extra와 FastEmbed provider를 명시적으로 활성화해야 한다.

Retrieval Action Guidance (System-One/Jev)

버전 0.2.13에 추가된 선택 기능으로, 기본값은 OFF다. context pack 생성 후 다음 행동(멈춤, 추가 읽기, 재검색 등)을 제안한다. LLMWIKI_QUERY_ACTION_JUDGE_API_KEY 환경변수와 --query-action-judge system-one 인자로 활성화하며, 외부 provider에는 마스킹된 질의 정보만 전달된다.

설치 및 주의사항

• 설치: uv tool install llmwiki-serve==0.2.13 (Python 3.11 이상)
• 보안: 로컬 사용 시 127.0.0.1 바인딩을 권장하며, 외부 노출 시 인증 및 TLS 설정이 필요하다. I/O 디버깅 로그에 질의/응답이 기록될 수 있으므로 --io-log off로 비활성화하거나 안전한 경로를 설정해야 한다.