Tolaria - Markdown 지식 베이스를 관리하는 오픈소스 macOS 앱

2 days ago 3

(github.com/refactoringhq)

Markdown 파일 기반 지식 베이스를 관리하는 데스크톱 앱으로, 개인 지식 관리와 회사 문서를 AI 맥락에 맞게 정리하는 작업에 쓰이며 OpenClaw·assistant 메모리와 절차 저장에도 활용됨
files-first, Git-first 구조를 택해 노트를 일반 Markdown 파일로 저장하고 각 vault를 git 저장소로 다뤄, 별도 export 없이 이식성과 버전 이력을 함께 확보함
offline-first, zero lock-in 원칙을 따라 계정·구독·클라우드 의존성 없이 완전히 오프라인으로 동작하며, 사용을 멈춰도 데이터를 잃지 않음
AI-first but not AI-only 방향으로 설계되어 Claude Code와 Codex CLI를 지원하고, 다른 AI 도구도 파일 기반 vault를 직접 편집할 수 있으며 AGENTS 파일도 함께 제공함
10,000개가 넘는 노트를 담은 대형 워크스페이스의 실사용 문제를 해결하는 과정에서 기능이 추가됐고, 표준 Markdown과 YAML frontmatter를 쓰는 오픈소스 앱이라 데이터 소유권과 장기 호환성을 함께 지켜줌

시작하기

최신 앱은 latest release에서 받을 수 있음
처음 실행하면 getting started vault를 클론할 수 있음
- 이 vault 안에서 앱 전체 사용 흐름을 따라갈 수 있음

오픈소스와 로컬 개발 환경

Tauri, React, TypeScript로 만들어졌으며, 로컬 실행과 기여를 위한 안내는 GETTING-STARTED.md에 있음
사전 요구 사항
- Node.js 20+, pnpm 8+, Rust stable이 필요함
- 개발 환경은 macOS 또는 Linux를 대상으로 함
Linux 시스템 의존성
- Linux에서 Tauri 2를 쓰려면 WebKit2GTK 4.1과 GTK 3가 필요함
- Arch / Manjaro
  - webkit2gtk-4.1, base-devel, curl, wget, file, openssl, appmenu-gtk-module, libappindicator-gtk3, librsvg 설치가 필요함
- Debian / Ubuntu 22.04+
  - libwebkit2gtk-4.1-dev, build-essential, curl, wget, file, libxdo-dev, libssl-dev, libayatana-appindicator3-dev, librsvg2-dev, libsoup-3.0-dev, patchelf 설치가 필요함
- Fedora 38+
  - webkit2gtk4.1-devel, openssl-devel, curl, wget, file, libappindicator-gtk3-devel, librsvg2-devel 설치가 필요함
- 번들된 MCP server는 Linux 런타임에서 시스템 node 바이너리를 계속 spawn함
  - 외부 AI tooling 흐름을 쓰려면 배포판 패키지 매니저로 Node를 설치해야 함
빠른 시작
- pnpm install, pnpm dev로 브라우저 기반 mock 모드를 실행할 수 있음
- 브라우저 기반 mock 모드는 http://localhost:5173에서 열림
- 네이티브 데스크톱 앱은 pnpm tauri dev로 실행할 수 있음

기술 문서

ARCHITECTURE.md: 시스템 설계, 기술 스택, 데이터 흐름
ABSTRACTIONS.md: 핵심 추상화와 모델
GETTING-STARTED.md: 코드베이스 탐색 시작점
ADRs: 아키텍처 결정 기록

보안

보안 이슈를 발견한 경우 SECURITY.md에 적힌 방식으로 비공개 보고를 받음

라이선스

라이선스는 AGPL-3.0-or-later임
Tolaria 이름과 로고에는 프로젝트의 trademark policy가 계속 적용됨

Read Entire Article