🖼️ 인포그래픽

🖼️ 4컷 인포그래픽

💡 한 줄 요약

OpenWiki Brains는 이메일·문서·저장소·소셜 웹 등 여러 정보원에서 관심 맥락을 능동적으로 수집하고, 이를 자동 갱신되는 로컬 위키로 만들어 AI 에이전트의 지속적인 기억으로 제공하는 오픈소스 프레임워크다.

📌 핵심 요약

• 기존 내장 메모리가 사용자가 직접 알려 준 사실이나 대화에서 추론한 정보를 주로 반응적으로 기억한다면, OpenWiki Brains는 연결된 정보원에서 필요한 맥락을 먼저 찾아 보존하는 능동적 기억을 지향한다.
• OpenWiki 0.1.0의 Personal Brain은 Gmail, Notion, Git 저장소, Twitter/X, Hacker News, 웹 검색을 연결해 프로젝트·연구·고객·인물·저장 링크 등의 정보를 로컬 위키로 구성한다.
• 사용자는 초기 설정에서 기억이 집중할 주제를 지정하며, OpenWiki는 이 지침을 기준으로 새로 수집한 정보 가운데 무엇을 위키에 남길지 결정한다.
• 기억은 로컬의 마크다운 파일로 저장되고, 별도 서버나 상시 실행 프로세스 없이 사용자가 정한 주기의 예약 작업을 통해 자동으로 갱신된다.
• 기존 코드 문서화 기능은 Code Brain으로 유지되며, 앞으로 연결 정보원 확대, 전문·의미 기반 검색과 에이전트형 검색, 상호 연결성이 강화된 지식 표현 형식이 추가될 예정이다.

🧩 주요 포인트

1. 기존 내장 메모리가 사용자가 직접 알려 준 사실이나 대화에서 추론한 정보를 주로 반응적으로 기억한다면, OpenWiki Brains는 연결된 정보원에서 필요한 맥락을 먼저 찾아 보존하는 능동적 기억을 지향한다.
2. OpenWiki 0.1.0의 Personal Brain은 Gmail, Notion, Git 저장소, Twitter/X, Hacker News, 웹 검색을 연결해 프로젝트·연구·고객·인물·저장 링크 등의 정보를 로컬 위키로 구성한다.
3. 사용자는 초기 설정에서 기억이 집중할 주제를 지정하며, OpenWiki는 이 지침을 기준으로 새로 수집한 정보 가운데 무엇을 위키에 남길지 결정한다.
4. 기억은 로컬의 마크다운 파일로 저장되고, 별도 서버나 상시 실행 프로세스 없이 사용자가 정한 주기의 예약 작업을 통해 자동으로 갱신된다.
5. 기존 코드 문서화 기능은 Code Brain으로 유지되며, 앞으로 연결 정보원 확대, 전문·의미 기반 검색과 에이전트형 검색, 상호 연결성이 강화된 지식 표현 형식이 추가될 예정이다.

🧠 상세 정리

1. 코드 문서화 도구에서 범용 기억 체계로

OpenWiki는 원래 Git 저장소를 분석해 코드베이스 위키를 만들고, 코드 변경에 맞춰 문서를 계속 갱신하는 오픈소스 명령줄 도구로 출발했다. OpenWiki 0.1.0은 이 구조를 코드 에이전트 밖의 연구, 계획, 글쓰기, 고객 업무, 개인 작업 흐름까지 확장한다. 새롭게 소개된 OpenWiki Brains는 에이전트가 접근할 수 있는 도구·채널·파일에서 관련 정보를 가져와 범용적인 로컬 위키를 구축한다. 사용자가 매 세션마다 업무 배경과 관심사, 프로젝트 현황을 직접 복사하거나 기억 파일을 관리하지 않아도 필요한 맥락을 제공하는 것이 목표다. 즉, 한 저장소의 구조를 설명하던 자동 문서화 방식을 여러 업무 정보원을 포괄하는 지속적 기억 체계로 발전시킨 것이다.

2. 분산된 맥락과 기존 내장 메모리의 한계

에이전트의 성능은 적절한 맥락에 크게 좌우되지만, 코드 밖의 업무 정보는 Gmail, Notion, 저장한 게시물, Hacker News 토론, Git 저장소, 반복적인 웹 검색 등 여러 장소에 흩어져 있다. 작업할 때마다 에이전트에게 각 정보원을 다시 검색하게 하면 느리고 결과도 일관되지 않을 수 있으며, 사람이 직접 정리하면 지속적으로 최신 상태를 유지해야 한다. Claude, ChatGPT, LangSmith Fleet 등의 내장 메모리는 사용자가 알려 준 사실과 대화에서 파악한 선호를 기억하는 데 유용하지만, 매일 외부 도구에서 달라지는 맥락을 능동적으로 반영하는 데에는 한계가 있다. 중요한 업데이트나 회의 기록, 이메일의 유용한 대화, 소셜 서비스에 저장한 글은 채팅에 붙여 넣지 않으면 기억에 들어오지 않을 수 있다. OpenWiki Brains는 이를 대체하기보다 보완하며, 연결된 업무 공간에서 관련 정보를 찾아 장기간 조회할 수 있는 구조화된 위키에 기록한다.

3. Personal Brain의 구성과 선별 기준

Personal Brain은 OpenWiki 0.1.0에서 추가된 핵심 모드로, 사용자가 연결한 정보원을 바탕으로 개인용 로컬 위키를 만든다. 위키에는 진행 중인 프로젝트, 조사하는 주제, 함께 일하는 사람과 회사, 저장한 링크, 관련 이메일, 메모처럼 이후 에이전트 작업에 필요할 수 있는 맥락이 포함될 수 있다. 초기 설정 과정에서 OpenWiki는 이 기억이 무엇에 집중해야 하는지 묻고, 일반적인 개인 비서를 위한 기본 지침도 제공한다. 사용자는 활성 프로젝트, AI 연구 주제, 고객 맥락, 저장 링크, 최근 Notion 메모 등 자신의 목적에 맞게 지침을 수정할 수 있다. 이 지침은 단순한 검색어가 아니라 새로운 정보를 수집할 때 무엇을 보존할지 판단하는 선별 기준으로 사용된다.

4. 연결 정보원과 두 가지 수집 방식

Personal Brain의 정보 수집은 커넥터를 통해 이루어지며, 첫 지원 대상은 Gmail, Notion, Git 저장소, Twitter/X, Hacker News, 웹 검색이다. Slack 지원은 향후 추가될 예정이다. 커넥터의 동작은 정보원의 특성에 따라 달라지는데, Gmail의 최근 이메일, Twitter/X의 최근 타임라인이나 북마크, Hacker News의 최근 게시물, Git 저장소의 최근 커밋처럼 정해진 방식으로 가져올 수 있는 정보가 있다. 반면 Notion과 웹 검색에는 관련된 모든 내용을 곧바로 제공하는 단일 피드가 없으므로 더 에이전트 중심적인 접근이 필요하다. 이 경우 OpenWiki는 수집 시점에 에이전트에게 검색 도구와 사용자가 지정한 목표를 제공하고, 에이전트가 그 목적에 맞는 정보를 직접 탐색하도록 한다.

5. 로컬 실행과 자동 갱신, 두 Brain의 역할

OpenWiki의 기억은 사용자 컴퓨터에 존재하므로, 일반적인 로컬 도구처럼 예약 작업을 실행해 연결 정보원에서 새 내용을 가져오고 디스크의 위키를 갱신할 수 있다. 별도의 서버를 마련하거나 상시 실행 프로세스를 유지할 필요가 없으며, 사용자가 선택한 주기에 따라 동작한다. 예정된 실행이 시작되면 OpenWiki는 설정된 커넥터를 순회하면서 새 정보를 위키에 반영하므로, 정보원을 한 번 구성한 뒤에는 백그라운드 유지 관리에 맡기는 흐름을 지향한다. 기존 코드베이스 기능은 Code Brain이라는 이름으로 계속 제공되며, 저장소 구조·Git 이력·파일 관계·코딩 관례를 중심으로 문서를 생성하고 에이전트 지침 파일에 위키 참조를 추가한다. Personal Brain은 더 넓은 업무 맥락을 다루기 때문에 두 모드는 지침과 커넥터, 갱신 절차가 다르지만, 생성되고 관리되는 맥락을 필요할 때 에이전트가 활용하게 한다는 원리는 같다.

6. 마크다운 우선 설계와 향후 계획

현재 OpenWiki Brains는 기억을 일반 마크다운 파일로 저장한다. 마크다운은 사람이 직접 읽고 검사하기 쉽고, 에이전트가 탐색하기에도 적합하며, 기억을 특정 인터페이스 뒤에 숨기지 않고 파일 시스템에 드러낸다는 장점이 있다. 제작진은 앞으로 페이지 간 연결, 더 풍부한 지식 형식, Google Open Knowledge Format과 같은 표현 방식도 검토할 계획이지만, 기존 에이전트 작업 흐름과 바로 호환되는 단순한 출발점으로 마크다운을 선택했다. 검색 측면에서는 현재의 파일 기반 위키를 넘어 전문 검색, MCP, 의미 검색, 에이전트형 검색을 탐색하고 있다. 또한 Slack을 시작으로 LangSmith 추적 정보, Claude 및 Codex의 로컬 세션 등 더 많은 정보원을 연결하려 하며, OpenWiki는 현재 GitHub 저장소와 NPM 패키지를 통해 사용할 수 있다.

🧾 핵심 주장 / 시사점

• OpenWiki Brains의 핵심 차별점은 대화에서 우연히 축적되는 기억이 아니라, 사용자가 지정한 관심 기준에 따라 외부 정보원을 주기적으로 탐색하고 보존하는 능동적 수집 구조에 있다.
• 정보원마다 동일한 수집 방식을 강제하지 않고, 최근 이메일·커밋처럼 규칙적으로 가져올 수 있는 자료와 Notion·웹 검색처럼 목표 지향적 탐색이 필요한 자료를 구분한다.
• 로컬 마크다운과 예약 실행을 채택함으로써 기억의 내용과 갱신 과정을 사용자가 직접 확인할 수 있게 했으며, 향후 검색 및 지식 연결 기능을 확장할 수 있는 단순한 기반을 마련했다.

✅ 액션 아이템

• 기존 메모리 운용 방식과 OpenWiki Brains형 능동 기억 모델을 동일 지표로 비교해 전환 기준을 정한다.
• Gmail·Notion·Git·트위터/X·HN·웹검색을 개인 브레인 연결원으로 설정하고, 로컬 위키 범위와 갱신 주기를 사전에 정의한다.
• 수집 대상 필터링 규칙을 주제 기준으로 고정한 뒤 마크다운 로컬 위키와 예약 갱신으로 반영 일관성과 누락 여부를 점검한다.

❓ 열린 질문

• 어떤 업무 영역에서 OpenWiki의 능동 수집이 기존 반응형 메모리보다 기억 품질을 더 높일 수 있는가?
• 초기 주제 설정이 바뀔 때 갱신 주기와 수집 범위는 어떻게 조정해 맥락 정합성을 유지할 수 있는가?
• 연결 정보원 확장과 에이전트형 검색 도입 시 오탐수집을 억제할 실무 기준은 무엇인가?