NeverWrite

무엇인가

NeverWrite는 로컬 우선, 다중 패널 데스크톱 애플리케이션으로, Markdown 스타일 문서를 작성하면서 다양한 AI 에이전트(Claude, Grok 등)와 채팅할 수 있습니다. 개인 지식 기반(vault)과 그 주변의 AI 기반 워크플로우(작성, 연구 중심 탐색, 코드 생성/검토 등)를 위한 단일 장소로 설계되었습니다.

왜 중요한가

개인정보 우선 – 모든 데이터는 사용자의 컴퓨터에 유지됩니다. 앱이 vault 내용을 원격 서버로 전송하지 않습니다.
통합 워크플로우 – 다양한 파일 유형(Markdown, Mermaid 다이어그램 등)을 편집하고 동시에 AI 채팅을 실행할 수 있으며, 모델이 제안한 변경 사항을 적용하기 전에 검토할 수 있습니다.
에이전트 무관 – 증가하는 LLM 백엔드(OpenAI 호환, Anthropic, Mistral, Pi 등)와 함께 작동하며 설정에서 공급자를 전환할 수 있습니다.
지식 그래프 탐색 – 위키링크, 백링크, 태그 및 2D/3D 그래프 보기를 통해 vault 내부의 연결을 탐색할 수 있습니다. 이는 연구나 장문 작성에 유용한 기능입니다.
웹 클리핑 – 동반 브라우저 확장 프로그램이 페이지나 선택 영역을 vault로 직접 캡처하여 전체 연구 파이프라인을 로컬로 유지할 수 있습니다.

대상 사용자

Obsidian 스타일의 vault와 같은 개인 지식 기반을 유지하고, 데이터 제어권을 포기하지 않고 AI 지원을 활용하려는 작가, 연구자, 개발자.
AI 지원 문서화, 코드 검토, 브레인스토밍을 위해 자체 호스팅 또는 오프라인 우선 솔루션을 선호하는 팀.
여러 LLM 공급자를 실험하고 비교하기 위한 단일 UI를 원하는 모든 사람.

시작 방법

리포지토리를 클론하고 데스크톱 앱의 종속성을 설치합니다:

git clone https://github.com/jsgrrchg/NeverWrite.git
cd NeverWrite/apps/desktop
npm install
npm run dev   # 개발 버전 실행

AI 런타임 설정 – 앱 설정에서 공급자(Claude, Grok 등)를 선택합니다. 일부 공급자는 CLI 로그인 또는 API 키가 필요합니다. README는 Pi용 별도 AI 런타임 설정 문서를 안내합니다.
vault 생성 또는 열기 – vault는 Markdown, 이미지, PDF, Excalidraw 파일 등을 보관하는 디스크의 폴더입니다.
세션 시작 – 에이전트 채팅을 열고 파일이나 스니펫을 첨부하여 모델이 편집을 제안하도록 합니다.
변경 사항 검토 – 내장 검토 창을 사용하여 파일 전체 또는 개별 청크가 디스크에 기록되기 전에 수락하거나 거부합니다.

기술적 하이라이트

프론트엔드 – 최신 웹 기술(TypeScript, React)로 구축되었으며 Electron(또는 유사한)을 통해 네이티브 데스크톱 앱으로 패키징됩니다.
백엔드 – Rust 기반 네이티브 레이어가 파일 I/O, 그래프 인덱싱, AI 런타임과의 브리지를 처리합니다.
크로스 플랫폼 – macOS 13+, Windows, Linux(x64 및 ARM64)에서 실행됩니다.
확장 가능한 에이전트 – CLI 또는 OpenAI 호환 API를 통해 액세스할 수 있는 모든 모델을 지원합니다. Pi 통합에는 ACP 어댑터가 포함되어 있습니다.
테스트 – 데스크톱 앱용 npm 기반 단위 테스트, 웹 클리퍼용 pnpm 검사, Rust 코드용 cargo 테스트가 포함됩니다.

라이선스

Apache-2.0 – 이 허용적 라이선스 조건에 따라 소프트웨어를 사용, 수정, 재배포할 수 있습니다.

위의 모든 정보는 리포지토리의 README에서 직접 가져온 것입니다.

jsgrrchg/NeverWrite