Skip to content

Zennotes

Keyboard-first local Markdown notes with Vim motions, diagrams, and MCP integration.

Install

$brew install --cask zennotes/tap/zennotes

Install command taken from the project's README or registry entry. Always review code before running it.

ZenNotes

[!NOTE] I build ZenNotes with a lot of help from AI tools like Claude and Codex. They let me move much faster, but I still go through some of the code before I ship it. The architecture, the technical decisions, and the trade-offs are things I still spend a lot of time thinking about. AI helps me write code faster, but it doesn't replace understanding how the system works.

ZenNotes is a keyboard-first Markdown notes app with a shared product core and multiple runtimes:

  • a desktop app built with Electron
  • a self-hosted web app backed by a Go server
  • a future hosted deployment mode built on the same web/server stack

ZenNotes keeps your notes as ordinary Markdown files on disk. It adds Vim-friendly editing, split and preview workflows, tasks, tags, archive/trash, diagrams, search, daily notes, CSV databases (Notion-style Table + Board views over plain .csv files), and MCP integration on top of the files you already own. On macOS, the first-party zen CLI also powers launcher workflows such as the Raycast extension.

Grab the latest build from GitHub Releases — see Install below.
Website: zennotes.org Support development: GitHub Sponsors

Detailed in-repo documentation lives under docs/README.md.

Install

All desktop installers are attached to each GitHub Release. The app auto-updates, so you only download once. (Replace <version> with the current release, e.g. 2.2.0.)

macOS

Homebrew (recommended):

brew install --cask zennotes/tap/zennotes

Or download the .dmg for your chip, open it, and drag ZenNotes to Applications. Builds are signed and notarized.

  • Apple Silicon: ZenNotes-<version>-mac-arm64.dmg
  • Intel: ZenNotes-<version>-mac-x64.dmg

Windows

Download and run the installer for your PC:

  • Intel and AMD: ZenNotes-<version>-win-x64.exe
  • ARM (Snapdragon and other Windows on ARM): ZenNotes-<version>-win-arm64.exe

Linux

Pick whatever suits your distro:

  • Arch / CachyOS / Manjaro — AUR (recommended):
    yay -S zennotes-bin     # or: paru -S zennotes-bin
    
    Installs cleanly without libfuse2.
  • Arch — native package:
    sudo pacman -U ZenNotes-<version>-linux-x86_64.pacman
    
  • Debian / Ubuntu:
    sudo apt install ./ZenNotes-<version>-linux-amd64.deb
    
  • Nix / NixOS: Read packaging/nix/README.md for installation instructions
  • Any distro — AppImage:
    chmod +x ZenNotes-<version>-linux-x86_64.AppImage
    ./ZenNotes-<version>-linux-x86_64.AppImage
    
    AppImages need FUSE 2. On distros that ship only FUSE 3 (Arch, CachyOS, Fedora), either install it (sudo pacman -S fuse2, sudo dnf install fuse) or run without FUSE:
    ./ZenNotes-<version>-linux-x86_64.AppImage --appimage-extract-and-run
    
    (Or just use the AUR / .pacman / .deb package, which sidestep this entirely.)

zen CLI

The desktop app installs a zen command-line companion from Settings → CLI — list, read, search, capture, edit, archive/trash notes, plus tasks, folders, and MCP. On macOS it can also install the Raycast extension locally.

Self-hosted web app

Similar plugs

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

Java 面试 & 后端通用面试指南,覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发

Build Agentic workflows, RAG pipelines, with rich AI model and tool support on one collaborative workspace. Deploy on cloud, VPC, or self-hosted, so teams move from prototype…

Open-source web crawler and scraper for LLMs and AI agents: any website into clean, LLM-ready Markdown. Run it yourself, or use Crawl4AI Cloud with one key.