[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-74757":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":23,"hasPages":25,"topics":26,"createdAt":10,"pushedAt":10,"updatedAt":27,"readmeContent":28,"aiSummary":29,"trendingCount":16,"starSnapshotCount":16,"syncStatus":30,"lastSyncTime":31,"discoverSource":32},74757,"tolaria","refactoringhq\u002Ftolaria","refactoringhq","Desktop app to manage markdown knowledge bases","https:\u002F\u002Ftolaria.md",null,"TypeScript",15304,1054,39,9,0,531,3619,3946,3894,119.07,"GNU Affero General Public License v3.0",false,"main",true,[],"2026-06-12 04:01:15","![Latest stable](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fv\u002Frelease\u002Frefactoringhq\u002Ftolaria?display_name=tag) [![CI](https:\u002F\u002Fgithub.com\u002Frefactoringhq\u002Ftolaria\u002Factions\u002Fworkflows\u002Fci.yml\u002Fbadge.svg?branch=main)](https:\u002F\u002Fgithub.com\u002Frefactoringhq\u002Ftolaria\u002Factions\u002Fworkflows\u002Fci.yml) [![Codecov](https:\u002F\u002Fcodecov.io\u002Fgh\u002Frefactoringhq\u002Ftolaria\u002Fgraph\u002Fbadge.svg?branch=main)](https:\u002F\u002Fcodecov.io\u002Fgh\u002Frefactoringhq\u002Ftolaria) [![CodeScene Hotspot Code Health](https:\u002F\u002Fcodescene.io\u002Fprojects\u002F76865\u002Fstatus-badges\u002Fhotspot-code-health)](https:\u002F\u002Fcodescene.io\u002Fprojects\u002F76865)\n\n# 💧 Tolaria\n\nTolaria is a desktop app for macOS, Windows, and Linux for managing **markdown knowledge bases**. People use it for a variety of use cases:\n\n* Operate second brains and personal knowledge\n* Organize company docs as context for AI\n* Store OpenClaw\u002Fassistants memory and procedures\n\nPersonally, I use it to **run my life** (hey 👋 [Luca here](http:\u002F\u002Fx.com\u002Flucaronin)). I have a massive workspace of 10,000+ notes, which are the result of my [Refactoring](https:\u002F\u002Frefactoring.fm\u002F) work + a ton of personal journaling and *second braining*.\n\n\u003Cimg width=\"1000\" height=\"656\" alt=\"1776506856823-CleanShot_2026-04-18_at_12 06 57_2x\" src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F8aeafb0a-b236-43c2-a083-ec111f903c38\" \u002F>\n\n## Walkthroughs\n\nYou can find some Loom walkthroughs below — they are short and to the point:\n- [How I Organize My Own Tolaria Workspace](https:\u002F\u002Fwww.loom.com\u002Fshare\u002Fbb3aaffa238b4be0bd62e4464bca2528)\n- [My Inbox Workflow](https:\u002F\u002Fwww.loom.com\u002Fshare\u002Fdffda263317b4fa8b47b59cdf9330571)\n- [How I Save Web Resources to Tolaria](https:\u002F\u002Fwww.loom.com\u002Fshare\u002F8a3c1776f801402ebbf4d7b0f31e9882)\n\n## Principles\n\n- 📑 **Files-first** — Your notes are plain markdown files. They're portable, work with any editor, and require no export step. Your data belongs to you, not to any app.\n- 🔌 **Git-first** — Every vault is a git repository. You get full version history, the ability to use any git remote, and zero dependency on Tolaria servers.\n- 🛜 **Offline-first, zero lock-in** — No accounts, no subscriptions, no cloud dependencies. Your vault works completely offline and always will. If you stop using Tolaria, you lose nothing.\n- 🔬 **Open source** — Tolaria is free and open source. I built this for [myself](https:\u002F\u002Fx.com\u002Flucaronin) and for sharing it with others.\n- 📋 **Standards-based** — Notes are markdown files with YAML frontmatter. No proprietary formats, no locked-in data. Everything works with standard tools if you decide to move away from Tolaria.\n- 🔍 **Types as lenses, not schemas** — Types in Tolaria are navigation aids, not enforcement mechanisms. There's no required fields, no validation, just helpful categories for finding notes.\n- 🪄**AI-first but not AI-only** — A vault of files works very well with AI agents, but you are free to use whatever you want. We support Claude Code, Codex CLI, and Gemini CLI setup paths, but you can edit the vault with any AI you want. We provide an AGENTS file for your agents to figure out.\n- ⌨️ **Keyboard-first** — Tolaria is designed for power-users who want to use keyboard as much as possible. A lot of how we designed the Editor and the Command Palette is based on this.\n- 💪 **Built from real use** — Tolaria was created for manage my personal vault of 10,000+ notes, and I use it every day. Every feature exists because it solved a real problem.\n\n## Installation\n\n### Homebrew\n\nInstall via Homebrew on macOS:\n\n```batch\nbrew install --cask tolaria\n```\n\n### Download from releases\n\nDownload the [latest release here](https:\u002F\u002Frefactoringhq.github.io\u002Ftolaria\u002Fdownload\u002F) for macOS, Windows, or Linux.\n\n## Getting started\n\nWhen you open Tolaria for the first time you get the chance of cloning the [getting started vault](https:\u002F\u002Fgithub.com\u002Frefactoringhq\u002Ftolaria-getting-started) — which gives you a walkthrough of the whole app.\n\nThe public user docs live in [`site\u002F`](site\u002F) and are published to GitHub Pages. Start with [Install Tolaria](site\u002Fstart\u002Finstall.md), then [First Launch](site\u002Fstart\u002Ffirst-launch.md).\n\n## Open source and local setup\n\nTolaria is open source and built with Tauri, React, and TypeScript. If you want to run or contribute to the app locally, here is [how to get started](https:\u002F\u002Fgithub.com\u002Frefactoringhq\u002Ftolaria\u002Fblob\u002Fmain\u002Fdocs\u002FGETTING-STARTED.md). You can also find the gist below 👇\n\n### Prerequisites\n\n- Node.js 20+\n- pnpm 8+\n- Rust stable\n- macOS or Linux for development\n\n#### Linux system dependencies\n\nTauri 2 on Linux requires WebKit2GTK 4.1 and GTK 3:\n\n- Arch \u002F Manjaro:\n  ```bash\n  sudo pacman -S --needed webkit2gtk-4.1 base-devel curl wget file openssl \\\n    appmenu-gtk-module libappindicator-gtk3 librsvg\n  ```\n- Debian \u002F Ubuntu (22.04+):\n  ```bash\n  sudo apt install libwebkit2gtk-4.1-dev build-essential curl wget file \\\n    libxdo-dev libssl-dev libayatana-appindicator3-dev librsvg2-dev \\\n    libsoup-3.0-dev patchelf\n  ```\n- Fedora 38+:\n  ```bash\n  sudo dnf install webkit2gtk4.1-devel openssl-devel curl wget file \\\n    libappindicator-gtk3-devel librsvg2-devel\n  ```\n\nThe bundled MCP server still spawns the system `node` binary at runtime on Linux, so install Node from your distro package manager if you want the external AI tooling flow.\n\n### Quick start\n\n```bash\npnpm install\npnpm dev\n```\n\nOpen `http:\u002F\u002Flocalhost:5173` for the browser-based mock mode, or run the native desktop app with:\n\n```bash\npnpm tauri dev\n```\n\n## Tech Docs\n\n- 📐 [ARCHITECTURE.md](docs\u002FARCHITECTURE.md) — System design, tech stack, data flow\n- 🧩 [ABSTRACTIONS.md](docs\u002FABSTRACTIONS.md) — Core abstractions and models\n- 🚀 [GETTING-STARTED.md](docs\u002FGETTING-STARTED.md) — How to navigate the codebase\n- 📚 [ADRs](docs\u002Fadr) — Architecture Decision Records\n\n## Security\n\nIf you believe you have found a security issue, please report it privately as described in [SECURITY.md](.\u002FSECURITY.md).\n\n## License\n\nTolaria is licensed under AGPL-3.0-or-later. The Tolaria name and logo remain covered by the project’s trademark policy.\n","Tolaria 是一款用于管理 Markdown 知识库的桌面应用程序，支持 macOS、Windows 和 Linux 平台。其核心功能包括基于文件和 Git 的知识管理方式，强调数据的可移植性和用户所有权，同时提供离线优先的设计理念以确保零锁定。技术特点上，Tolaria 采用 TypeScript 开发，遵循开放标准（如 YAML frontmatter），并通过类型作为导航辅助而非强制性架构来增强用户体验。此外，该应用还支持与 AI 工具集成，但不依赖于特定的 AI 服务。Tolaria 适用于个人知识管理、企业文档组织以及为 AI 提供上下文信息等多种场景，尤其适合那些重视数据自主权和灵活性的用户。",2,"2026-06-11 03:50:42","high_star"]