Tolaria: 마크다운 지식 관리용 데스크톱 앱

Tolaria 는 macOS, Windows, Linux 를 위한 마크다운 지식 관리를 위한 데스크톱 앱입니다. 사람들은 다양한 용도로 사용합니다:

• 두 번째 뇌와 개인 지식을 운영
• AI 의 컨텍스트로 회사 문서를 정리
• OpenClaw/아시스턴트의 메모와 절차를 저장

개인적으로는 제 삶을 운영하기 위해 사용합니다 (hey 👋 Luca here). 저는 10,000+ 개의 노트라는 거대한 작업 공간을 가지고 있으며, 이는 제 Refactoring 작업 + 개인 일기 작성과 두 번째 브레인의 결과입니다.

아래에는 Loom walkthroughs 를 찾을 수 있습니다 —它们是 짧고 간결합니다:

• 📑
  Files-first— 노트는 평범한 마크다운 파일입니다. 포터블하며, 어떤 편집기와도 작동하고, 내보내기 단계를 필요로 하지 않습니다. 당신의 데이터는 앱이 아닌 당신에게 속합니다.
• 🔌
  Git-first— 모든 보트는 git 저장소입니다. 완전한 버전 역사를 얻고, 어떤 git 원격과도 사용하며, Tolaria 서버에 대한 의존도가 0 입니다.
• 🛜
  Offline-first, zero lock-in— 계정이 없으며, 구독이 없으며, 클라우드 의존성이 없습니다. 당신의 보트는 완전히 오프라인으로 작동하며 항상 그렇게 할 것입니다. Tolaria 를 사용하지 않으면 아무것도 잃지 않습니다.
• 🔬
  Open source— Tolaria 는 무료이며 오픈 소스입니다. 저를 위해 그리고 다른 사람들과 공유하기 위해 만들었습니다.
• 📋
  Standards-based— 노트는 YAML 프론트매터가 있는 마크다운 파일입니다. 독점 형식이 없으며, 잠금된 데이터가 없습니다. Tolaria 를 떠나기로 결정하면 모든 것이 표준 도구와 함께 작동합니다.
• 🔍
  Types as lenses, not schemas— Tolaria 의 타입은 강제 메커니즘이 아닌 탐색 보조 수단입니다. 필수 필드가 없으며, 검증이 없으며, 노트를 찾기 위한 도움이 되는 카테고리만 있습니다.
• 🪄
  AI-first but not AI-only— 파일 보트는 AI 에이전트와 매우 잘 작동하며, 당신은 원하는 대로 사용할 수 있습니다. 우리는 Claude Code, Codex CLI, Gemini CLI 설정 경로를 지원하지만, 어떤 AI 로든 보트를 편집할 수 있습니다. 당신의 에이전트가 알아내도록 AGENTS 파일을 제공합니다.
• ⌨️
  Keyboard-first— Tolaria 는 최대한 키보드를 사용하려는 파워 유저를 위해 설계되었습니다. 우리가 Editor 와 Command Palette 를 설계한 많은 부분은 이 기반에 있습니다.
• 💪
  Built from real use— Tolaria 는 제 개인 보트 10,000+ 개의 노트를 관리하기 위해 만들어졌으며, 저는 매일 사용합니다. 모든 기능은 실제 문제를 해결하기 위해 존재합니다.

macOS 에서 Homebrew 를 통해 설치:

brew install --cask tolaria

macOS, Windows, 또는 Linux 에 대한 최신 릴리스를 여기에서 다운로드하세요.

Tolaria 를 처음 열면 클론할 기회를 얻습니다 — 이는 전체 앱의 walkthrough 을 제공합니다.

Tolaria 는 오픈 소스이며 Tauri, React, TypeScript 로 구축되었습니다. 앱을 로컬로 실행하거나 기여하고 싶다면, 여기에서 시작하는 방법을 찾을 수 있습니다. 아래에 gist 를 찾을 수도 있습니다 👇

• Node.js 20+
• pnpm 8+
• Rust stable
• macOS 또는 Linux 개발용

Linux 에서 Tauri 2 는 WebKit2GTK 4.1 과 GTK 3 를 필요로 합니다:

• Arch / Manjaro:
  sudo pacman -S --needed webkit2gtk-4.1 base-devel curl wget file openssl \ appmenu-gtk-module libappindicator-gtk3 librsvg

• Debian / Ubuntu (22.04+):
  sudo apt install 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+:
  sudo dnf install webkit2gtk4.1-devel openssl-devel curl wget file \ libappindicator-gtk3-devel librsvg2-devel

패키지된 MCP 서버는 여전히 Linux 에서 시스템 node 이너 바이너리를 런타임에 생성하므로, 외부 AI 도구 흐름을 원한다면 분포 패키지를 통해 Node 를 설치하세요.

pnpm install
pnpm dev

브라우저 기반 모크 모드를 위해 http://localhost:5173를 열거나, 다음 명령어로 네이티브 데스크톱 앱을 실행하세요:

pnpm tauri dev

• 📐 ARCHITECTURE.md — 시스템 설계, 기술 스택, 데이터 흐름
• 🧩 ABSTRACTIONS.md — 핵심 추상화와 모델
• 🚀 GETTING-STARTED.md — 코드베이스 탐색 방법
• 📚 ADRs — 아키텍처 결정 기록 (Architecture Decision Records)

보안 취약점을 발견하셨다면, SECURITY.md에 설명된 대로 사적으로 보고해 주세요.

Tolaria 는 AGPL-3.0-or-later 라이선스를 따릅니다. Tolaria 로고 및 상표는 프로젝트 상표 정책으로 보호됩니다.