[! 참고] 저는 Claude나 Codex 같은 AI 도구의 많은 도움을 받아 ZenNotes를 만듭니다. 이들은 훨씬 빠르게 작업을 가능하게 하지만, 여전히 배포 전에 일부 코드를 검토합니다. 아키텍처, 기술적 결정, 그리고 그 절충 관계에 대해 여전히 많은 시간을 생각하게 됩니다. AI는 코드를 더 빠르게 작성하는 데 도움을 주지만, 시스템 작동 방식을 이해하는 것을 대체하지는 않습니다.

ZenNotes는 키보드 우선 Markdown 노트 앱으로, 공유 제품 코어와 여러 런타임을 갖추고 있습니다:

• Electron으로 만든 데스크톱 앱
• Go 서버가 지원하는 자체 호스팅 웹 앱
• 동일한 웹/서버 스택 위에 구축된 미래의 호스팅 배포 모드

ZenNotes는 노트를 일반 Markdown 파일로 디스크에 보관합니다. Vim 친화적인 편집, 분할 및 미리보기 워크플로우, 작업, 태그, 아카이브/휴지통, 다이어그램, 검색, 일일 노트, CSV 데이터베이스(Notion 스타일의 테이블 + 보드 뷰, 일반 .csv 파일 위), 그리고 이미 보유한 파일 위에 MCP 통합을 추가합니다. macOS에서는 1자 zen CLI가 Raycast 확장 기능과 같은 런처 워크플로우도 구동합니다.

GitHub Releases에서 최신 빌드를 받아보세요 — 아래 설치를 참조하세요.
웹사이트: zennotes.org 개발 지원: GitHub 스폰서

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 `` 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--mac-arm64.dmg
• Intel: ZenNotes--mac-x64.dmg

Windows

Download and run the installer for your PC:

• Intel and AMD: ZenNotes--win-x64.exe
• ARM (Snapdragon and other Windows on ARM): ZenNotes--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--linux-x86_64.pacman
  

• Debian / Ubuntu:

  sudo apt install ./ZenNotes--linux-amd64.deb
  

• Nix / NixOS: Read packaging/nix/README.md for installation instructions
• Any distro — AppImage:

  chmod +x ZenNotes--linux-x86_64.AppImage
  ./ZenNotes--linux-x86_64.AppImage