HelixNotes/README.md

HelixNotes

A local markdown note-taking app built with Tauri, SvelteKit, and Rust.

Your notes are stored as standard Markdown files on your local filesystem. No cloud, no lock-in.

Download (v1.2.9)

Linux

Arch / Manjaro (AUR)

yay -S helixnotes-appimage-bin

Debian / Ubuntu / Mint (APT)

curl -fsSL https://repo.arkhost.com/gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/arkhost.gpg && echo "deb [signed-by=/usr/share/keyrings/arkhost.gpg arch=amd64] https://repo.arkhost.com stable main" | sudo tee /etc/apt/sources.list.d/helixnotes.list && sudo apt update && sudo apt install helix-notes

AppImage (Arch, Fedora 43+, openSUSE Tumbleweed)

Download AppImage

.deb (manual)

Download .deb (Ubuntu 22.04+)

Windows

Download Installer (Windows 10/11)

macOS

Download .dmg (Intel, runs on Apple Silicon via Rosetta)

Android

Download APK

---

All releases: codeberg.org/ArkHost/HelixNotes/releases

Features

• Markdown editor with toolbar, slash commands, source mode, code highlighting
• [[Wiki-links]] and graph view
• Full-text search (Tantivy)
• Outline panel, daily notes with calendar view, tags, drag-and-drop
• Live KaTeX math editor (/math, /imath) with modal preview, double-click to edit
• Mermaid diagrams (opt-in render, copy as PNG, save as PNG/SVG)
• Manual notebook sorting (drag to reorder above, into, or below)
• External .md viewer mode with import-to-vault flow
• PDF preview, Obsidian import, "Show in File Manager"
• AI writing tools (Ollama / Anthropic / OpenAI)
• Version history with diffs, automatic backups
• Multi-window, file associations, focus mode, view mode
• Themes, accent colors, fonts
• Local files, no cloud

Full documentation: helixnotes.com/docs

Tech Stack

• Frontend: SvelteKit (Svelte 5) + TailwindCSS v4 + TipTap v3
• Backend: Rust (Tauri 2.0) + Tantivy (search) + Notify (file watcher)
• Platforms: Linux (AppImage), Windows, macOS, Android

Building from Source

Prerequisites

• Rust (1.77+)
• Node.js (18+)
• pnpm
• System dependencies for Tauri: see Tauri prerequisites

Development

pnpm install
pnpm tauri dev

Production Build

pnpm tauri build

Screenshots

License

AGPL-3.0