Install

Arch Linux

Install the stable binary package with an AUR helper:

yay -S repo-notes-bin

Install repo-notes-git instead to track relevant changes on main:

yay -S repo-notes-git

Both packages install Git, the notes binary, and Bash, Fish, and Zsh completions.

Runtime requirements

The compiled notes binary includes its JavaScript dependencies and does not need Bun or Node.js at runtime. It uses these external applications for specific features:

Application	Used by
Git	Repository detection and vault versioning
Bash	Launching an editor from the interactive TUI
Neovim	Default editor when EDITOR is unset
OpenCode	The TUI’s o and O actions
notify-send	Optional MCP write and delete notifications
GitHub CLI	The optional capture daemon

Git is installed by the Linux packages. Set EDITOR and VISUAL to use other editors instead of Neovim. Missing notify-send only disables desktop notifications. The capture daemon also needs a running OpenCode server.

Stable releases use a manually chosen YYYYMMDD.N version. Create a blank GitHub draft, optionally generate its release notes, then publish it to build Linux archives, deb and RPM packages and update repo-notes-bin.

Build Locally

Use the mise tasks to install dependencies and build the binary. The repo pins Node and Bun through mise.

mise run install
mise run build

The compiled binary is written to dist/notes:

./dist/notes --help

Build an Arch Package

Create a local Arch package from the compiled binary:

mise run package:arch

This task is Arch-specific and needs makepkg from base-devel. The package is written to dist/ and includes shell completions.