iwe-org/iwe

해결하는 문제

IWE는 로컬의 Markdown 파일 디렉터리를 쿼리 가능한 지식 그래프로 변환할 수 있는 방법을 제공합니다. 사용자는 일반 텍스트로 노트를 완전히 소유하면서도, 편집기에서 인간이 탐색할 수 있는 기능과 CLI 또는 API를 통해 AI 에이전트가 질의할 수 있는 구조화된, 데이터베이스와 유사한 검색 기능을 모두 제공합니다.

작동 방식

IWE는 두 가지 유형의 링크를 사용하여 Markdown 파일을 연결된 구조로 간주합니다: "포함 링크"는 중첩(계층/트리 생성)에 사용되며, 크로스레퍼런스는 관계의 웹을 형성합니다. 하나의 노트가 여러 부모를 가질 수 있어, 파일을 중복하지 않고 여러 주제에 속할 수 있습니다.

AI 에이전트를 위해 CLI와 MCP(Model Context Protocol) 서버를 제공하여 에이전트가 노트를 검색, 가져오고, 재구성할 수 있도록 합니다. 변경 사항의 영향 범위를 검증하는 "expect" 가드와 프론트마터 및 구조를 검증하는 문서 스키마를 통해 안전성을 보장합니다. 고성능을 위해 Rust로 구현되어 20,000개의 파일을 1초 미만으로 처리할 수 있습니다.

대상 사용자

• 지식 작업자: Markdown 기반 노트 시스템을 사용하며, VS Code, Neovim, Zed, Helix 등의 편집기에서 IDE와 유사한 기능(검색, 리팩터링, 자동 완성)을 원하는 사용자.
• AI 에이전트 개발자: Git으로 버전 관리되며, 벡터 데이터베이스의 "유사성 추측"을 피할 수 있는 장기적이고 인간이 읽을 수 있는 기억 시스템을 제공하고 싶은 개발자.
• AI 코딩 에이전트 사용자 (예: Claude Code): 프로젝트 컨텍스트용 구조화된 기억을 원하는 사용자.

주요 특징

• 일반 Markdown 소유권: 독점적인 데이터베이스나 클라우드 종속성 없음; 모든 내용은 .md 파일로 저장됩니다.
• Model Context Protocol (MCP) 지원: Claude Desktop, Cursor, Windsurf 등의 AI 도구와의 네이티브 통합.
• 그래프 기반 검색: 단일 호출로 노트와 그 부모 컨텍스트, 자식 노트를 모두 가져오며, 단순한 유사성 검색에 의존하지 않습니다.
• LSP 통합: Language Server Protocol을 통해 여러 편집기에서 IDE와 유사한 기능 제공.
• 가드된 변경 사항: AI 에이전트의 쓰기 작업은 스키마와 범위 가드에 따라 검증되어 지식 그래프의 실수적 손상 방지.