Tolaria는 Mac 및 Linux용 데스크톱 앱으로, Markdown 기반 지식 베이스를 관리하는 데 사용됩니다. 이 앱은 개인의 'second brain' 구축, 지식 정리, 회사 문서 관리 (AI 컨텍스트 제공), OpenClaw/assistants의 메모리 및 절차 저장 등 다양한 용도로 활용됩니다. 개발자는 이를 10,000개 이상의 노트로 구성된 개인 워크스페이스를 관리하기 위해 사용하고 있습니다.

Tolaria의 핵심 방법론 및 설계 원칙은 다음과 같습니다:

• Files-first (파일 우선): 모든 노트는 일반 Markdown 파일로 저장되어 휴대성이 높고 어떤 에디터에서도 작동하며 데이터 소유권을 보장합니다.
• Git-first (Git 우선): 각 'vault'는 Git repository로 관리되어, 완벽한 버전 히스토리를 제공하고 모든 Git remote를 사용할 수 있으며, Tolaria 서버에 대한 의존성이 없습니다.
• Offline-first, zero lock-in (오프라인 우선, 락인 없음): 계정, 구독, 클라우드 종속성이 없어 완전히 오프라인으로 작동하며, Tolaria 사용을 중단해도 데이터를 잃지 않습니다.
• Open source (오픈 소스): 무료이며 AGPL-3.0-or-later 라이선스 하에 배포됩니다.
• Standards-based (표준 기반): YAML frontmatter를 사용하는 Markdown 파일을 사용하며, 독점 형식이 없어 다른 표준 도구와 호환됩니다.
• Types as lenses, not schemas (유형은 렌즈, 스키마가 아님): 유형은 네비게이션 보조 도구로 기능하며, 필수 필드나 유효성 검사 같은 강제 메커니즘이 아닙니다.
• AI-first but not AI-only (AI 우선, 그러나 AI 전용 아님): 파일 기반 vault는 AI agents와 매우 잘 작동하며, Claude Code, Codex CLI, Gemini CLI와 같은 AI 툴 설정 경로를 지원합니다. AGENTS.md 파일을 통해 AI agents를 위한 지침을 제공합니다.
• Keyboard-first (키보드 우선): 파워 유저를 위해 설계되었으며, Editor와 Command Palette가 키보드 사용에 최적화되어 있습니다.
• Built from real use (실제 사용 기반 구축): 개발자의 10,000개 이상의 개인 노트를 관리하는 실제 문제 해결에서 시작되었습니다.

기술적인 측면에서 Tolaria는 Tauri, React, TypeScript로 구축되었습니다. 로컬 개발을 위한 전제 조건으로는 Node.js 20+, pnpm 8+, Rust stable 버전이 필요하며, macOS 또는 Linux 환경에서 지원됩니다. Linux 시스템에서는 WebKit2GTK 4.1 및 GTK 3와 같은 특정 라이브러리가 요구됩니다. 특히, 번들된 MCP server는 런타임에 시스템 Node.js 바이너리를 사용하므로, 외부 AI 툴링 (예: Gemini CLI)을 활용하려면 Node.js를 별도로 설치해야 합니다. Tolaria는 ~/.gemini/settings.json에 MCP server를 등록하여 선택된 vault에 대한 외부 AI 툴 설정을 지원합니다. 이는 VAULT_PATH로 범위가 지정되며 Node.js 18+ 및 설치된 Gemini CLI가 필요합니다. GEMINI.md 호환성 shim을 생성하여 AGENTS.md 지침을 가리키도록 설정할 수도 있습니다. 개발 및 실행은 pnpm install 후 pnpm dev 또는 pnpm tauri dev 명령어를 통해 가능합니다. 시스템 디자인, 기술 스택, 데이터 흐름에 대한 정보는 ARCHITECTURE.md에, 핵심 추상화 및 모델은 ABSTRACTIONS.md에, 그리고 코드베이스 탐색 방법은 GETTING-STARTED.md에 문서화되어 있습니다.