A fast, native note app for macOS. Your notes stay plain markdown files in a folder (a vault); Inkra reads and writes them in place.
Written in Rust on GPUI, the GPU-rendered UI framework of the Zed editor. No Electron, no web view: one 17 MB binary, one process.
Status: early. Inkra is usable day to day but young. macOS only, built from source, no
.appbundle yet. Formats may change between commits.
- Markdown live preview: styled as you type, markup hidden until the caret or the selection touches it. Quotes, lists and code blocks.
- Links:
[[wikilinks]]to notes and files, a backlinks panel,⌘Enterto follow a link. - Search:
⌘Pquick open by word start on names and text, text matches ranked by BM25;⌘⇧Fvault search, hits grouped by note;⌘⇧Pcommand palette. - Tabs and splits: tabs with per-tab back and forward,
⌘⇧Tto reopen a closed tab, split groups in any direction, tabs dragged between them. - Docks: the file tree and the backlinks panel move between the left and
the right dock,
⌘\and⌘|hide them. - Themes: built-in themes and your own JSON themes in
<vault>/.inkra/, reloaded on save. - Files: images open in a tab; other files show in the tree.
- Safe with your files: autosave, conflict detection, and a file watcher that follows edits made outside the app.
- Instant reopen: the index is cached on disk, the last tabs come back.
Not yet: task boxes, syntax highlighting in code blocks, plugins, sync, Windows and Linux.
Real time, 50,000 notes: launch, ⌘P "ada lo", ⌘⇧F "enigma turing".
Content: Simple English Wikipedia, CC BY-SA 4.0.
Inkra against Obsidian on the same generated vaults, measured from outside both apps by the same script. Warm open, median of 5 runs, Apple M5 Pro, macOS 26.5, 2026-11-08. Inkra 0.1.0, Obsidian 1.14.5 with no plugins.
Window on screen, warm (lower is better)
█ Inkra ▒ Obsidian
Inkra 500 ┤███████████ 112 · · · ·
Obsidian 500 ┤▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 296 · ·
Inkra 5k ┤███████████ 112 · · · ·
Obsidian 5k ┤▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 295 · ·
Inkra 50k ┤███████████ 114 · · · ·
Obsidian 50k ┤▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 294 · ·
└┬─────────┬─────────┬─────────┬─────────┬─────────┬
0 100 200 300 400 500 ms
Memory at idle, warm (lower is better)
█ Inkra ▒ Obsidian
Inkra 500 ┤███ 52 · · · · ·
Obsidian 500 ┤▒▒▒▒▒▒▒▒▒▒▒ 228 · · · ·
Inkra 5k ┤████ 82 · · · · ·
Obsidian 5k ┤▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 372 · · ·
Inkra 50k ┤█████████████ 261 · · · ·
Obsidian 50k ┤▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 924
└┬─────────┬─────────┬─────────┬─────────┬─────────┬
0 200 400 600 800 1000 MiB
CPU until idle, first open (lower is better)
█ Inkra ▒ Obsidian
Inkra 500 ┤█ 0.17 · · · · ·
Obsidian 500 ┤▒ 1.84 · · · · ·
Inkra 5k ┤█ 0.78 · · · · ·
Obsidian 5k ┤▒▒▒▒ 9.92 · · · · ·
Inkra 50k ┤█████ 11.52 · · · ·
Obsidian 50k ┤▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 105.77 ·
└┬─────────┬─────────┬─────────┬─────────┬─────────┬
0 25 50 75 100 125 s
CPU until idle, warm (lower is better)
█ Inkra ▒ Obsidian
Inkra 500 ┤█ 0.11 · · · · ·
Obsidian 500 ┤▒▒▒▒ 0.75 · · · · ·
Inkra 5k ┤█ 0.17 · · · · ·
Obsidian 5k ┤▒▒▒▒▒ 1.07 · · · ·
Inkra 50k ┤████ 0.75 · · · · ·
Obsidian 50k ┤▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 5.42 · ·
└┬─────────┬─────────┬─────────┬─────────┬─────────┬
0 2 4 6 8 10 s
| Notes | Window on screen | CPU until idle | Memory at idle | |
|---|---|---|---|---|
| 500 | Inkra | 112 ms | 0.11 s | 52 MiB |
| Obsidian | 296 ms | 0.75 s | 228 MiB | |
| 5,000 | Inkra | 112 ms | 0.17 s | 82 MiB |
| Obsidian | 295 ms | 1.07 s | 372 MiB | |
| 50,000 | Inkra | 114 ms | 0.75 s | 261 MiB |
| Obsidian | 294 ms | 5.42 s | 924 MiB |
First open of a 50,000-note vault: 11.5 s of CPU for Inkra, 105.8 s for Obsidian. Install size: 17 MB against 530 MB.
Read these figures with their limits: one machine, default settings, and
"window on screen" is not "note readable" for either app. At idle Obsidian
uses less CPU (0.04 % against 0.3 %). Method, cold-cache runs and the full
tables: docs/benchmarks.md. Reproduce with
./scripts/bench-compare.sh (quit Obsidian first).
Requires macOS and Rust 1.98; rustup installs the pinned toolchain from rust-toolchain.toml.
cargo run --release -p inkra-app -- ~/path/to/vaultThe first build fetches gpui from Zed's repository, at a pinned commit.
Screen readers cannot read note text yet: GPUI's accessibility bridge exposes no text properties. This is a known gap, tracked in docs/gpui-accessibility.md.
./scripts/check.sh checks formatting, spelling (typos), the crate graph, the
ast-grep rules, line ceilings, clippy, cargo deny, the tests and a release
build; green is the definition of done. It needs typos, ast-grep,
cargo-deny and jq installed, and prints the install command for a missing one. The workspace is split into crates with one role
each (text, editor, markdown, index, vault, tabs, layout, app);
only app depends on GPUI. Architecture and conventions are in
CLAUDE.md, design specs in docs/superpowers/specs/, deferred
work in docs/roadmap.md.
GPL-3.0-or-later. You may use, change and share Inkra, including commercially, as long as what you distribute stays open under the same license.