Kept: AI 대화로 로컬 퍼스트 지식 베이스 구축

많은 사람들에게 AI 채팅 인터페이스는 "작업 메모리"의 주요 형태가 되었습니다. 우리는 이를 디버깅 경로를 추적하고, 연구 노트를 초안하며, 제품 결정을 다듬고, 코드 조각을 저장하는 데 사용합니다. 하지만 이러한 귀중한 지적 역사는 보통 독점적인 벤더 UI 안에 잠겨 있어, 서로 다른 플랫폼 간에 검색하거나 개인 지식 관리(PKM) 시스템에 통합하기가 어렵습니다.

Kept은 이 문제를 해결하기 위해 설계된 오픈소스, 로컬 퍼스트 에이전시 지식 관리자입니다. 여러 AI 제공업체의 대화를 추출해 로컬 머신에 일반 Markdown 파일로 저장함으로써, 일시적인 채팅 기록을 영구적이고 검색 가능하며 사용자가 직접 제어하는 아카이브로 변환합니다.

로컬 퍼스트 아카이빙 아키텍처

Kept은 데이터를 클라우드에서 로컬 디스크로 옮기기 위해 세 단계 아키텍처를 사용합니다. 이는 렌더링된 페이지를 웹 스크래핑하는 불안정한 방법에 의존하지 않습니다.

1. Chromium 확장 프로그램

DOM을 스크래핑하는 대신, 브라우저 확장 프로그램은 사용자가 로그인한 세션을 이용해 제공업체 API 엔드포인트에서 대화 데이터를 직접 가로챕니다. 여기서는 ChatGPT, Claude, Gemini, Grok, Kimi 등 다양한 제공업체의 메시지와 이미지 자산을 정규화하고, 페이로드를 로컬 서버로 전송합니다.

2. 데스크톱 애플리케이션

Tauri 2(React 프론트엔드와 Rust 백엔드)로 구축된 데스크톱 앱은 중앙 허브 역할을 합니다. 확장 프로그램으로부터 로컬 서버(http://localhost:18241)를 통해 데이터를 받고, 여러 핵심 기능을 수행합니다:

  • 볼트 관리: 대화를 YAML frontmatter가 포함된 Markdown 파일로 ~/.kept/vault/에 기록합니다.
  • 인덱싱: 고성능 전체 텍스트 검색을 위해 SQLite FTS5를 사용합니다.
  • 지식 그래프: CozoDB를 이용해 로컬 지식 그래프를 구축하고, 서로 다른 대화 간의 연결을 시각화합니다.

3. MCP 서버

아카이브를 "에이전시"하게 만들기 위해 Kept은 Model Context Protocol(MCP) 서버를 포함합니다. 이를 통해 AI 코딩 에이전트(예: Claude Code 또는 OpenClaw)가 프로그래밍 방식으로 볼트를 목록화, 읽기, 검색 및 관리할 수 있어, 에이전트가 과거 AI 상호작용을 컨텍스트 소스로 활용할 수 있습니다.

데이터베이스보다 Markdown 파일을 선택한 이유

Kept에서 가장 중요한 설계 선택 중 하나는 진실의 원천으로 Obsidian 호환 Markdown 볼트를 사용하는 것입니다. 데이터베이스가 초기 쿼리 속도에서 더 빠를 수 있지만, 파일 기반 접근 방식은 장기적으로 여러 이점을 제공합니다:

  • 상호 운용성: 볼트를 VS Code, Obsidian 또는 어떤 텍스트 편집기에서도 바로 열 수 있습니다.
  • 미래 보장: 데이터가 평문 텍스트로 저장되므로, Kept 애플리케이션이 폐기되거나 제공업체 API가 변경되더라도 아카이브를 읽을 수 있습니다.
  • 복구 가능성: 검색 및 그래프 데이터베이스는 캐시 역할을 하며, 언제든지 Markdown 파일에서 완전히 재구성할 수 있습니다.

프라이버시와 보안

모든 것을 클라우드에 동기화하는 시대에 Kept은 엄격한 로컬 퍼스트 입장을 취합니다:

  • 클라우드 동기화 없음: 호스팅 계정이나 클라우드 백업이 없습니다. 모든 데이터는 ~/.kept/에 머무릅니다.
  • 로컬 통신: 확장 프로그램은 설치당 베어러 토큰을 사용해 로컬호스트를 통해 데스크톱 앱과 통신합니다.
  • 구성 가능한 인텔리전스: 토픽 발견 및 아카이브 기반 채팅과 같은 선택적 기능은 사용자가 선택한 제공업체나 로컬 Ollama 서버를 통해 라우팅될 수 있어 완전한 프라이버시를 보장합니다.

도전 과제와 고려 사항

Kept은 AI 역사를 되찾는 강력한 방법을 제공하지만, 사설 제공업체 API에 의존한다는 고유한 도전에 직면합니다. 커뮤니티가 지적했듯이, 이러한 연결은 문서화되지 않은 엔드포인트에 의존하기 때문에 공급업체가 사전 통보 없이 변경할 수 있어 취약합니다.

하지만 기본 저장 계층으로 Markdown 볼트를 우선시함으로써 Kept은 데이터 손실 위험을 완화합니다. 제공업체 어댑터가 중단되더라도 이미 로컬 디스크에 저장된 대화는 그대로 남아 접근할 수 있습니다.

시작하기

Kept은 MIT 라이선스로 제공되며 macOS, Windows, Linux에서 사용할 수 있습니다. 설치는 일반적으로 데스크톱 앱을 설정하고 개발자 모드에서 수동으로 로드할 Chromium 확장 프로그램을 제공하는 빠른 설치 스크립트를 실행하는 방식으로 진행됩니다. 아카이브를 AI 워크플로에 통합하고자 하는 경우, MCP 서버를 한 줄 스크립트로 설치하면 에이전트가 grep_vault 또는 read_file을 통해 과거 AI 지식 베이스에 직접 접근할 수 있습니다.

Sources