Skip to content

ZenNotes CLI v0.3.0

Choose a tag to compare

@github-actions github-actions released this 17 Sep 13:39
· 196 commits to main since this release

ZenNotes CLI 0.3.0

Released on September 17, 2026 as v0.3.0, at e4c0ac2 (with d893aba). Two requests from the issue tracker, both about the terminal app matching the desktop: its color schemes (#1) and its tag completion (#3).

The same color schemes as the desktop

zn tui used one hardcoded Gruvbox pair that only knew dark and light. It now
draws with the scheme the desktop app is set to. It reads theme_family,
theme_mode and theme_id under [appearance] in the config.toml both apps
share, and takes its colors from the desktop's own tokens, so all 34 built-in
variants work: Apple, Gruvbox, Catppuccin, GitHub, Solarized, One, Nord, Tokyo
Night, Kanagawa, Black Metal and Rosé Pine. theme_mode = "auto" follows the
terminal background and keeps your variant across the flip.

Custom themes under
~/.config/zennotes/themes/ are read from the same theme.css, light and dark,
and a theme that only sets a background, a text color and an accent gets the
rest derived as the desktop derives it. The accent and syntax colors set with
Quick tweaks apply too. Fenced code uses the theme's syntax colors in the editor
and in the preview.

A palette tuned for a backlit window does not always survive thin monospace
text. Colors a terminal would draw too faint are nudged toward the text color
until they read, surfaces that sit under text give way toward the canvas, and
the rest of a palette is used as is.

Inside the app, :theme still flips dark and light. :theme nord or
:theme catppuccin-mocha switches for the session, and :themes (or
:colorscheme) opens a picker that previews the scheme under the cursor; Esc
puts the old one back. To give the terminal its own look, set theme under
[terminal] to a family, a variant or a custom theme's folder name. Left empty,
zn matches the desktop. zn still never writes config.toml.

The default look moves from classic Gruvbox to the desktop's Gruvbox Material,
which is what the shared defaults have always named.

How to test locally: pick a theme in the desktop's Settings > Appearance, then
start zn tui; the two match. Run :themes and move through the list, then
press Esc and confirm the original scheme returns. Set theme = "nord" under
[terminal], restart, and confirm only the terminal changes.

Tag completion while you type

Typing # and a letter in insert mode offers the vault's existing tags in a
small menu under the cursor, as the desktop editor does: tags that start with
what you typed, then tags that contain it, most used first. Typing narrows the
list. Ctrl+N / Ctrl+P or the arrows move, Enter, Tab or Ctrl+Y accept,
and Ctrl+E dismisses. Esc leaves insert mode and takes the menu with it, as
Vim's own popup menu does. A bare #, headings, code and links stay quiet, so
writing a heading is never interrupted.

Ctrl+X Ctrl+O opens the same menu on demand (Ctrl+X Ctrl+] and Ctrl+Space
too): every tag when nothing is typed yet, and a plain word before the cursor is
replaced by #tag. Inside a frontmatter tags: value the menu completes bare
tags. The pick undoes together with the typing, and it all works with Vim mode
off.

How to test locally: open a note in a vault that already has tags, press i,
type # and the first letters of one, and accept it with Tab. On an empty
line press Ctrl+X Ctrl+O to see every tag. Type # and confirm no menu
appears.

Also in this release

The shared task and self-hosted HTTP fixtures from the main repository are now
verified in CI on Linux, macOS and Windows.

Install

With Homebrew on macOS or Linux, run brew install zennotes/tap/zn, then
zn tui; brew update && brew upgrade zn upgrades an existing install.

Or download the archive for your platform, unpack it, and put zn on your PATH.
With Go installed, go install github.com/ZenNotes/tui/cmd/zn@latest builds the
same thing.