winget install --id=packetThrower.Zorite -e Zorite is a cross-platform (macOS + Windows + Linux) local-first daily-journal and outliner note app. Logseq-style: an infinite-scroll journal of daily pages plus linked [[wiki-link]] pages, written in Markdown and stored in a local SQLite database. Embed and annotate PDFs, drop in images, and search across everything โ no cloud, no account; your notes stay on your machine.
macOS (Apple Silicon and Intel)
Windows (x64 and ARM64)
Linux (amd64 and arm64)
Linux additionally needs a Vulkan-capable GPU with current Mesa drivers.
Zorite is a daily-journal note app for the desktop, organized like Logseq but
edited like an ordinary document rather than an outliner. Notes are Markdown in
a local SQLite database. Pages link to each other with [[wiki-links]], and
the app also handles PDFs (viewing, annotating, form filling), images,
whiteboards, and LaTeX math. There is no cloud and no account; everything stays
on your machine. Written in Rust with gpui (Zed's UI
framework) and
gpui-component.
Developed in close collaboration with Claude (Anthropic).
<img src="docs/public/screenshots/zorite-macos-dark.png" width="820" />
๐ Changelog ยท ๐บ๏ธ Roadmap
> [!NOTE]- form), headings can be
collapsed, code blocks are syntax-highlighted, and Mermaid diagrams render in
the current theme's colors./ menu inserts Markdown constructs, the current date or time, a table via
a size picker, a property row, and your own templates (see below).[[ completes page names, # completes tags, and {{ completes template
placeholders. Brackets auto-pair, and an optional auto-linker turns existing
page titles into links as you type.$โฆ$ and display $$โฆ$$ LaTeX render as typeset math. Clicking into
a formula opens a structural editor in the style of MathQuill: fractions,
roots, matrices, delimiters, and accents (\hat, \bar, \vec, โฆ) are
live slots you arrow through; type \ for an autocomplete of commands, or
select part of a formula with the mouse and wrap it. Formulas can be copied
as LaTeX or exported as PNG/SVG.Details: Journal & pages ยท Math
Projects::Tasks
titles form a namespace tree, and renaming a namespace renames its children. ^id anchor and linked with [[Note#^id]], or
type (( and pick any block from a searchable list, Logseq-style; headings
can be linked directly. ![[Note]] embeds another note (or one of its
sections or blocks) and updates live when the source changes. A page's
alias:: names complete in [[ too. Both the reading view and the editor
render all of this.key:: value lines render as a properties panel with per-key icons; tags and
links in values are clickable. Panels are edited in place, and a Properties
page indexes every key and value across the database.Details: Journal & pages ยท All pages & the graph
โP exports the current note as a styled PDF, including tables, images,
math, and diagrams. No browser involved. (One quirk: the export writes
glyphs directly, so font ligatures render in the app but not in the PDF.)Details: PDF & images ยท Whiteboards
โF finds within the open page or across the journal feed, while you edit.Details: Search
http, https, and mailto;
imports and exports can't read or write outside their folders; the database
and data folder are created private to your user.Details: Password & encryption ยท Import your notes ยท Themes ยท Cursors ยท Shortcuts
Create a page named Templates and define snippets with !name headers โ every
line under a !name (until the next !name) is that template's body:
!meeting
## Meeting {{date}}
- Attendees:
- Notes: {{cursor}}
!standup
- Yesterday:
- Today:
- Blockers:
Then type /meeting in any day or page to insert it. Placeholders expand on
insert: {{date}}, {{time}}, {{title}} (the current page/day), and
{{cursor}} (where the caret lands). Built-in Markdown commands live in
zorite-markdown as SNIPPETS.
Zorite ships several built-in themes (Zorite, Nord, Solarized, Dracula, Tokyo Night, Foundry, Cyberpunk, CRT, E-Ink), each with a light and dark variant (Cyberpunk and CRT are dark-only). Open Settings (the โ in the title bar) to pick a theme and choose Light / Dark / Auto (Auto follows your system appearance). A quick light/dark toggle also lives in the title bar.
Settings โ Appearance also picks the app font (any installed family, or
import a .ttf/.otf) and the note text size; a custom theme can name its
own font and override every palette token โ see the
themes docs.
Drop a .json file in your themes folder (Settings โ Reveal themes folder)
and click Reload. Any color you omit falls back to the base palette, so a
theme can be just a few colors:
{
"id": "midnight",
"name": "Midnight",
"dark": {
"bg_window": "#0d1117",
"bg_sidebar": "#161b22",
"bg_content": "#0d1117",
"fg": "#e6edf3",
"accent": "#ff7b72",
"tag": "#d2a8ff",
"code": "#79c0ff"
},
"light": { "accent": "#0969da" }
}
Tokens (each #RRGGBB): bg_window, bg_sidebar, bg_content, fg (text),
accent, tag, code. Provide a dark and/or light block. Add
"dark_only": true for an always-dark theme.
Every release attaches .dmg, .exe/.msi, .deb, .AppImage, .rpm, and
.pkg.tar.zst artifacts plus SHA256SUMS on the
Releases page. On macOS and
Windows, the package managers track the latest stable tag and get you past the
first-launch Gatekeeper / SmartScreen warnings.
# macOS โ Homebrew (6.0.0+ requires trusting the tap before installing)
brew tap packetThrower/tap
brew trust packetThrower/tap
brew install --cask zorite # stable
brew install --cask zorite@alpha # pre-release
# Windows โ winget (Microsoft's package manager, preinstalled)
winget install packetThrower.Zorite # or: winget install zorite
# Windows โ Scoop
scoop bucket add packetThrower https://github.com/packetThrower/scoop-bucket
scoop install zorite # stable
scoop install zorite-prerelease # pre-release
# NixOS / Nix (Linux) โ builds from source via the repo flake
nix run github:packetThrower/zorite
winget carries stable only; for pre-release builds on Windows use Scoop or
the Releases page directly.
Linux users grab the matching .deb / .rpm / .AppImage / .pkg.tar.zst
from Releases (pacman -U for the Arch package). The AppImage carries update
information and ships a .zsync, so AppImageUpdate, AppImageLauncher, and
friends can delta-update it (from 0.11.0 onward).
To install by hand, download from Releases and drag Zorite.app to
/Applications on macOS, or run the installer on Windows. The macOS builds are
ad-hoc signed, so the first launch needs a right-click โ Open (or
xattr -cr Zorite.app); the Windows installer is unsigned, so SmartScreen needs
More info โ Run anyway. Notarized macOS and signed Windows builds are planned
โ see TODO.md.
The repo is a Rust workspace: the app plus six reusable crates.
git clone git@github.com:packetThrower/zorite.git
cd zorite
cargo run # debug build + launch
cargo build --release # optimized binary at target/release/zorite
cargo test --workspace # run the tests
The first cargo build compiles gpui's full dependency graph and takes a few
minutes; incremental builds are fast. Toolchain: a recent stable Rust (via
rustup). Platform libraries:
xcode-select --install).sudo apt install libxkbcommon-dev libxkbcommon-x11-dev libwayland-dev libx11-dev libxcb1-dev libxcb-randr0-dev libxcb-xkb-dev libxcb-cursor-dev libxcb-shape0-dev libxcb-xfixes0-dev libxcb-render0-dev libfontconfig1-dev libfreetype-dev pkg-configYour data lives at:
| OS | Path |
|---|---|
| macOS | ~/Library/Application Support/zorite/zorite.db |
| Linux | $XDG_DATA_HOME/zorite/ (or ~/.local/share/zorite/) |
| Windows | %APPDATA%\zorite\ |
ZORITE_DATA overrides the whole data directory (and ZORITE_DB just the
database file), so you can run against a throwaway data set without touching your
real notes.
zorite/
โโโ src/ the app โ journal feed, pages, search, slash menu, import, SQLite
โโโ crates/
โโโ zorite-editor/ a from-scratch WYSIWYG Markdown editor (live preview, tables, math hosting)
โโโ zorite-markdown/ a reusable Markdown renderer for gpui (clickable links, Mermaid, math)
โโโ gpui-bidi/ bidirectional text for gpui (RTL caret/selection/row layout)
โโโ gpui-pdf/ a page-virtualized PDF viewer (pure-Rust hayro) with highlight markup
โโโ gpui-whiteboard/ a host-agnostic infinite-canvas whiteboard
โโโ os-cursors/ custom mouse cursors without forking the toolkit
โโโ os-spellcheck/ native OS spell-checking (NSSpellChecker / ISpellChecker)
โโโ ratex-gpui/ a structural (MathQuill-style) math editor + LaTeX renderer (RaTeX)
Each crate is host-agnostic, MIT-licensed, and published on crates.io:
| Crate | ||
|---|---|---|
zorite-editor | crates.io | docs.rs |
zorite-markdown | crates.io | docs.rs |
gpui-bidi | crates.io | docs.rs |
gpui-pdf | crates.io | docs.rs |
gpui-whiteboard | crates.io | docs.rs |
os-cursors | crates.io | docs.rs |
os-spellcheck | crates.io | docs.rs |
ratex-gpui | crates.io | docs.rs |
Each carries its own README and a complete API.md.
The numbers below come from
synthetic databases built by scripts/gen_perf_db.py
โ a 3-level Area::Topic::Note namespace tree with [[wiki-links]], inline
images, and a couple weeks of journal days. ZORITE_DB points the app at a
throwaway database, so your real notes are never touched:
python3 scripts/gen_perf_db.py 10000 /tmp/zorite-perf.db
ZORITE_DB=/tmp/zorite-perf.db cargo run
Hot-path query timings (SQLite, best of several runs on a development Mac):
| Operation | 1,000 | 10,000 | 50,000 |
|---|---|---|---|
Load the page list (list_pages) | 0.3 ms | 4.4 ms | 26 ms |
| Search per keystroke (FTS5 trigram) | 0.07 ms | 0.11 ms | 0.09 ms |
| Backlinks for a page (indexed) | 0.005 ms | 0.005 ms | 0.005 ms |
| Seed the recent list (first launch only) | 0.1 ms | 2.3 ms | 12 ms |
list_pages loads only id/title, not page content, which keeps it fast and
memory flat. Search is a trigram FTS5 index, so it stays around 0.1 ms whether
the database holds a thousand pages or fifty thousand. Memory (resident set
size):
| Metric | Empty DB | 10,000 pages | 50,000 pages |
|---|---|---|---|
| RAM (RSS) | ~86 MB | ~135 MB | ~138 MB |
| Database file (incl. index) | 60 KB | 48 MB | 229 MB |
RAM barely moves from 10k to 50k pages: the page list holds only id/title
(about 2 MB at 50k), not the note bodies, which load one page at a time as you
open them. The database file grows mostly with the FTS trigram index. At 50,000
pages, launch, navigation, search, and scrolling remain fast, and the sidebar's
cost is independent of the total (it's capped to recently-viewed pages).
GNU General Public License v3.0 or later. Forks are welcome; derivative works must stay open under the same license. Commercial use is permitted but can't close the source.
The reusable crates under crates/ are licensed MIT so any
gpui application can use them.
Third-party dependencies keep their own licenses (see
THIRD-PARTY-LICENSES.html); HEIC/AVIF decoding
bundles an AGPL-3.0 component (heic_decoder).