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

 (github.com/refactoringhq)
26P by GN⁺ | ★ favorite | 댓글 2개
  • markdown 지식 베이스를 Mac과 Linux에서 관리하는 데스크톱 앱으로, 개인용 second brain부터 회사 문서를 AI 컨텍스트로 정리하는 작업까지 겨냥함
  • Files-first와 Git-first 구조를 채택해 노트를 일반 markdown 파일과 git 저장소로 다루며, export 없이도 데이터 이식성과 전체 버전 히스토리를 유지함
  • Offline-first, zero lock-in을 전면에 두고 계정, 구독, 클라우드 의존성 없이 완전한 오프라인 동작과 사용자 중심 데이터 소유권을 유지함
  • Types as lenses, not schemas 원칙으로 필수 필드나 강제 검증 없이 탐색 보조 수단으로 타입을 쓰고, AI-first but not AI-only 방향으로 Claude Code와 Codex CLI를 지원함
  • 10,000+ 노트 워크스페이스를 실제 운영하며 부딪힌 문제를 바탕으로 기능이 추가됐고, Tauri·React·TypeScript 기반의 오픈소스 앱으로 실사용 중심 설계가 드러남

Tolaria 개요

  • markdown 지식 베이스를 Mac과 Linux에서 관리하는 데 초점을 둔 데스크톱 앱이며, 개인용 second brain, 회사 문서를 AI용 컨텍스트로 정리하는 용도, OpenClaw와 assistants의 메모리 및 절차 저장에 맞춰 설계됨
  • 대규모 10,000+ 노트 워크스페이스를 실제로 운영하는 과정에서 만들어졌고, 모든 기능도 실사용 중 부딪힌 문제를 해결하는 방향으로 추가됨
  • 짧은 사용 흐름 자료도 함께 제공됨

핵심 원칙

  • Files-first 원칙을 따르며, 노트는 일반 markdown 파일로 저장됨
    • 데이터 이식이 가능하고 어떤 편집기와도 함께 쓸 수 있음
    • 별도 export 단계가 필요 없고, 데이터 소유권도 앱이 아니라 사용자에게 남음
  • Git-first 구조를 채택해 각 vault를 git 저장소로 다룸
    • 전체 버전 히스토리를 유지할 수 있음
    • 어떤 git remote도 사용할 수 있고, Tolaria 서버에도 의존하지 않음
  • Offline-first, zero lock-in을 전면에 둠
    • 계정, 구독, 클라우드 의존성이 없음
    • vault가 완전히 오프라인으로 동작하며, 사용을 중단해도 데이터 손실이 없음
  • 오픈소스로 공개되어 있으며 무료로 제공됨
  • Standards-based 설계를 적용해 노트 형식을 markdown과 YAML frontmatter로 유지함
    • 독점 포맷을 쓰지 않음
    • Tolaria를 떠나더라도 표준 도구와 함께 계속 활용 가능함
  • 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로 구현됨
  • 로컬 실행과 기여를 위한 개발 문서는 별도로 연결되어 있음
  • 기술 문서 묶음도 함께 제공됨

사용 시작 방식

  • 최신 배포본은 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를 설치해야 함
  • 빠른 시작 명령도 포함됨
    • pnpm install
    • pnpm dev
    • 브라우저 기반 mock mode는 http://localhost:5173에서 열림
    • 네이티브 데스크톱 앱은 pnpm tauri dev로 실행 가능함

보안과 라이선스

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

함께 보면 좋은 글 β

GN⁺   [-]
Hacker News 의견들

  • 이거 정말 마음에 듦. Obsidian에서 원하던 것들에 플러그인까지 합친 느낌인데, 하나의 잘 설계된 앱으로 정리돼 있어서 훌륭함
    피드백도 있음. 오픈 소스는 유지하되 수익화할 방법을 찾아서 이걸 풀타임으로 개발했으면 좋겠음. 공식 앱 버전을 따로 두는 식이면 기꺼이 돈 낼 의향이 있음
    그리고 기능 과잉은 꼭 피했으면 함. Bear App의 단순한 디자인을 정말 좋아하지만 markdown 파일을 직접 다루지 못해서 결국 떠났음. Obsidian, Notion, Craft 같은 앱들은 계속 기능을 덧붙이는데, 여기서는 이미 핵심 기능은 다 갖춘 듯함. Bear처럼 핵심만 아주 잘하는 쪽에 집중해 줬으면 좋겠음

    • Bear를 정말 좋아함. Tolaria에 큰 영향을 준 앱이라서, 아마 그래서 더 마음에 들었을 것 같음
      좋은 피드백 고마움

  • 하루 차이로 내가 먼저 만들 기회를 놓쳤네. 그래도 Luca, 정말 잘했음. 툴이 아주 좋아 보여서 지금 바로 써보는 중임
    나는 https://github.com/adamjramirez/sig-releases의 Sig를 만들고 있는데, 구조적으로 겹치는 부분이 분명함. macOS, 순수 markdown, git 버전 관리, 그리고 AI 에이전트의 컨텍스트용으로 설계됐다는 점이 같음
    차이는 워크플로의 시작 지점임. Tolaria는 이미 존재하는 지식을 정리하는 데 강해 보이고, Sig는 그 이전 단계, 즉 머릿속 지식을 어떻게 파일로 꺼내 적을지 해결하려고 함. 실제로 AI 출력 품질을 좌우하는 건 대개 문서화되지 않은 것들임. 방금 회의 5분 전에 내려진 결정, 후속 조치 없는 구두 약속, 대화의 표면적 내용이 아니라 내가 실제로 읽어낸 의미 같은 것들임
    Sig의 캡처는 두 겹임. 1) 먼저 사실 기록, 2) 그 위에 개인 해석을 얹음. 둘 다 내 머신의 markdown으로 저장됨. 팀 지식베이스나 open brain에 공유할 준비가 되면 그때 명시적으로 선택해서 공개함. 기본은 비공개고, 내가 원할 때만 팀이 읽을 수 있게 됨

    • git versioned가 .md 파일 자체를 뜻한다면 바로 관심 생김. 나도 Claude에게 무엇을 보라고 할지 알려주려고 git 기반 워크플로로 파일을 처리하고 있음
      꼭 써보겠음
    • 이 구분은 정말 맞다고 봄. Tolaria는 도서관 같고 Sig는 현장 녹음기 같음
      둘 다 필요하지만 워크플로에서 맡는 순간이 다름

  • 요즘은 다들 자기만의 llm-wiki 시스템을 만드는 듯함. 나도 하나 만들었고, 그 안에 다른 agent memory system들을 크게 모아둔 목록도 있음: https://zby.github.io/commonplace/agent-memory-systems/
    당신 것도 바로 추가하겠음
    오늘은 모아둔 자료를 바탕으로 이런 시스템에 대한 wish list도 정리했음: https://zby.github.io/commonplace/notes/designing-agent-memory-systems/
    같이 협업할 수 있으면 좋겠음

    • 이런 걸 모으는 중이라면 Hjarni도 Fintool, Supermemory와 함께 source-only tier에 들어갈 만함
      hosted SaaS에 MCP가 기본 내장돼 있고, global/team/container/note 계층형 LLM instruction도 있으며, Claude/ChatGPT 멀티에이전트 워크플로용 공유 노트 프로토콜도 제공함. 원하는 형식에 맞춰 소개 페이지도 써줄 수 있음
      링크한 wishlist 문서도 좋았고, 그것도 함께 작업해보고 싶음
    • 목록에 이것도 추가할 만함 https://github.com/Signet-AI/signetai
      관계자는 아니고 그냥 테스트 중임
    • 그 목록에 neovim용 도구도 있었으면 좋겠음

  • 모바일 캡처 공백은 실제로 크고, 이런 도구들이 일상적인 기본 앱이 되지 못하는 가장 큰 이유이기도 함
    내가 잘 쓰는 흐름은 iOS의 Drafts에 액션을 설정해서 git repo 안의 날짜별 inbox.md에 append하고, 그걸 Working Copy로 동기화하는 방식임. Markdown 파일이 단일 진실 공급원이고, macOS의 어떤 도구든 Tolaria든 Obsidian이든 같은 repo를 그대로 읽어서 변환 단계가 없음
    초기에 손볼 요소는 좀 있지만, 보상은 큼. 모바일 캡처와 데스크톱 정리가 서로 다른 앱 사이 복붙이나 sync 단계가 아니라 같은 파일 위에서 이뤄짐

    • 내 선호 방식은 Bebop임. 바로 열어서 한 번 탭으로 아이디어나 노트를 잡아둘 수 있고, share sheet로 링크도 저장 가능함
      Obsidian의 Daily Note를 iCloud vault에 append하도록 설정할 수 있어서 아주 잘 맞음
      서드파티 서비스 없이 가는 점도 좋음
      ⁽¹⁾ https://apps.apple.com/us/app/bebop-quick-notes/id6477824795
    • 나도 최근에 any device 철학으로 비슷한 걸 직접 만들었음. Telegram bot 접근이고, 이 앱 제작자처럼 private Github repo를 단일 진실 공급원으로 씀
      웹에서 흥미로운 걸 발견하면 일단 수집하는 용도로 쓰고 있음
      https://github.com/momentmaker/to
    • 나는 OpenClaw로 이 문제를 거의 해결했음. Telegram으로 보내면 Tolaria 안에 괜찮은 노트를 만들어 주고, 기존 내용과 관련 항목까지 연결해 줌
      저장해둘 웹 링크나 도구 링크, 글로 바꿀 음성 메모 같은 걸 보내고 있음
      그래도 모바일 버전은 분명 만들 예정임

  • 결국 Apple Notes로 자주 돌아가게 됨. 엄밀히는 지식베이스도 아니고 markdown도 아니지만, 기기 간 sync가 잘 되고 폰에서 쓰기 편함
    본인도 이런 필요가 있는지, 아니면 모바일에서는 노트를 어떻게 보고 있는지 궁금함

    • 나는 Apple Notes를 빠른 캡처용으로 쓰고, 보관할 가치가 있는 건 맥에서 Obsidian의 daily note나 특정 노트로 복붙해서 옮김
      운동이나 식사 추적처럼 오래 이어가는 노트도 날짜 헤더를 붙여 계속 유지함
      Obsidian 모바일 같은 것보다 이게 더 잘 맞고, 복붙 과정 자체가 자연스러운 필터 역할도 해줌

  • MacBook Pro에서 markdown 미리보기 관련 질문이 있음. Finder의 quick preview, 아마 Quick Look이라고 부르는 기능에서 markdown을 렌더링하게 하려면 어떻게 해야 하는지 궁금함
    .md 파일은 항상 IDE로 열리게 연결해뒀지만 미리보기에서는 렌더링이 안 돼서 조금 불편함. IDE 안에서는 확장으로 md 렌더링을 쓰고 있어서 그 영향일 수도 있겠다고 봄. 재귀 호출 같은 게 preview extension 레벨에 노출되지 않을 수도 있겠고, 아무튼 추천할 방법이 있는지 궁금함

  • 여기서 markdown을 활용한 방식이 정말 마음에 듦
    우리도 https://voiden.md/에서 거의 같은 철학으로 가고 있음. offline-first, 파일 기반, git 지원임
    이런 형식이야말로 에이전트들이 꽤 잘 활용하게 될 형태라고 봄
    우리는 이걸 API용으로 만들었고, 오픈 소스이기도 함. 여기서 볼 수 있음: https://github.com/VoidenHQ/voiden

  • 최근엔 octarine을 쓰고 있었음. 그전엔 Obsidian을 꽤 오래 썼는데, 이것도 분명 사용해볼 생각임
    [1]: https://octarine.app

  • 멋진 작업임. 피드백 두 가지가 있음
    에디터에서 code fence literal을 지원하지 않는 듯함. ```를 입력해서 코드 블록을 만들 수가 없었음
    그리고 markdown 파일 크기가 아주 커지면 성능이 좋지 않음
    나는 내 AI 지식베이스 제품용으로 Obsidian 스타일 markdown editor를 만들고 있음: https://github.com/kenforthewin/atomic-editor

    • Atomic이 꽤 흥미로워 보이고, 특히 wiki synthesis가 눈에 띔
      나도 quick brain dump에서 "atoms"를 쉽게 뽑아내는 데 초점을 둔 skill 모음과 작은 MCP를 작업 중임. 이것도 SQLite + SQLite-vec 기반임
      chunking 문제는 각 섹션을 chunk로 선언하는 방식으로 우회하고, 초안은 LLM이 chunk가 잘 되도록 섹션 구조로 다시 쓰게 함. 그래서 중복은 많아지고 "위에서 설명했듯이" 같은 표현은 없어짐
      예상 독자는 사람이 아니라, 대상 독자별로 더 읽기 쉬운 글을 생성하는 에이전트들임. 독자를 expert로 가정하면, 검토된 atoms를 대량 생산하는 비용이 훨씬 낮아진다고 봄
      그 워크플로를 Atomic이나 Tolaria와 함께 꼭 시험해보고 싶음

  • 순수하게 뷰어 용도이고 다른 에디터를 추가하려는 게 아니라면, https://mdview.io를 만들었음
    Markdown 파일을 깔끔하게 렌더링해서 열어볼 수 있고, 테이블과 Mermaid도 지원함. 동료와 공유하거나 나중에 저장해두기에도 유용함

답변달기