매일 아침 10,000개가 넘는 노트 더미에서 원하는 문서를 찾는 개발자가 있다. 이번 주 깃허브 트렌드에 Tolaria라는 macOS 앱이 올라왔다. 이 앱은 그런 개발자를 위해 만들어졌다.

Tolaria, 마크다운 파일과 Git 저장소 기반 지식 베이스 관리 앱 공개

Tolaria는 Mac과 Linux에서 마크다운 지식 베이스를 관리하는 데스크톱 앱이다. 개인용 second brain(두 번째 두뇌)부터 회사 문서를 AI 컨텍스트로 정리하는 작업까지 겨냥한다. 개발자는 GitHub 저장소에서 코드를 내려받을 수 있다.

Files-first와 Git-first 구조를 채택했다. 노트는 일반 마크다운 파일로 저장되며, 각 vault(저장소 단위)를 Git 저장소로 다룬다. 별도 export 없이 데이터 이식이 가능하고 전체 버전 히스토리를 유지한다. 어떤 Git remote도 사용할 수 있고 Tolaria 서버에 의존하지 않는다.

Offline-first, zero lock-in을 전면에 뒀다. 계정, 구독, 클라우드 의존성이 없다. vault가 완전히 오프라인으로 동작하며 사용을 중단해도 데이터 손실이 없다. 오픈소스로 공개되어 있으며 무료로 제공된다.

Standards-based 설계를 적용해 노트 형식을 마크다운과 YAML frontmatter로 유지한다. 독점 포맷을 쓰지 않는다. Types as lenses, not schemas 원칙으로 타입을 강제 스키마가 아니라 탐색 보조 수단으로 사용한다. 필수 필드가 없고 검증을 강제하지 않는다.

AI-first but not AI-only 방향을 취한다. 파일 기반 vault가 AI 에이전트와 잘 맞도록 설계됐다. 현재 Claude Code와 Codex CLI를 지원한다. 다른 AI로도 vault를 수정할 수 있고 에이전트가 활용할 수 있도록 AGENTS 파일도 제공한다.

Keyboard-first 사용성을 강조한다. 키보드 중심 작업을 원하는 power-user를 겨냥한다. Editor와 Command Palette 설계에도 이 원칙이 반영됐다.

Tolaria는 Tauri, React, TypeScript로 구현됐다. 로컬 실행과 기여를 위한 개발 문서는 GETTING-STARTED.md에 연결되어 있다. 기술 문서 묶음도 함께 제공된다: ARCHITECTURE.md(시스템 설계, 기술 스택, 데이터 흐름), ABSTRACTIONS.md(핵심 추상화와 모델), GETTING-STARTED.md(코드베이스 탐색 방법), ADRs(아키텍처 결정 기록).

최신 배포본은 latest release에서 내려받을 수 있다. 첫 실행 시 getting started vault를 clone할 기회가 주어지며 앱 전체 흐름을 둘러볼 수 있다.

로컬 개발 전제 조건으로 Node.js 20+, pnpm 8+, Rust stable, macOS 또는 Linux 개발 환경이 요구된다. Linux에서는 Tauri 2 실행을 위해 WebKit2GTK 4.1과 GTK 3가 필요하다. Arch/Manjaro, Debian/Ubuntu 22.04+, Fedora 38+용 시스템 의존성 설치 예시가 포함되어 있다. 번들된 MCP server는 Linux 런타임에서 시스템 node 바이너리를 실행하므로 외부 AI 도구 흐름을 쓰려면 배포판 패키지 관리자로 Node를 설치해야 한다.

빠른 시작 명령:

bash
pnpm install
pnpm dev

브라우저 기반 mock mode는 http://localhost:5173에서 열린다. 네이티브 데스크톱 앱은 pnpm tauri dev로 실행 가능하다.

라이선스는 AGPL-3.0-or-later를 따른다. Tolaria 이름과 로고는 프로젝트의 trademark policy 적용을 받는다.

예전에는 노트 앱이 독점 포맷에 데이터를 가둬두던 방식이 지배적이었다. 이제는 Tolaria가 마크다운 파일과 Git 저장소를 직접 다루면서 데이터 이식성을 보장한다. 사용자가 앱을 떠나도 표준 도구로 노트를 계속 활용할 수 있다.

개발자가 바로 체감하는 변화는 계정과 구독이 필요 없다는 점이다. vault가 완전히 오프라인으로 동작하므로 인터넷 연결 없이도 모든 기능을 쓸 수 있다. 10,000개 이상 노트를 실제 운영하며 부딪힌 문제를 바탕으로 기능이 추가됐다.

Tolaria는 AI 에이전트와의 통합을 염두에 두고 설계됐지만, AI 없이도 완전히 동작한다. 파일 기반 구조 덕분에 Claude Code나 Codex CLI 같은 도구가 vault를 직접 수정할 수 있다. 이는 AI 워크플로우를 구축하는 팀에게 실용적인 선택지가 된다.