glint

A modeless terminal markdown editor with live styling — a Bubble Tea TUI built for a notes vault. Type in a centered iA-Writer-style writing canvas with soft-wrapping and live markdown coloring, flip to a Glamour read preview, fuzzy-find notes with a live preview pane, and theme it to match your terminal (Flexoki light/dark + charm). Open any file, jump to today's daily note, or start a fresh document from anywhere.

Install

brew tap humdrum/tap https://codex.humdrum.me/git/homebrew-tap.git
brew trust humdrum/tap   # Homebrew gates third-party taps
brew install glint

Upgrade later:

brew update && brew upgrade glint

Usage

glint                 # fuzzy picker over the current directory
glint notes.md        # open a file
glint -n [name]       # new note in the current dir (-n -i → inbox, -n -v → vault)
glint -t              # today's daily note
glint -d              # browse the daily-notes folder
glint -v              # fuzzy picker over your vault, from anywhere
glint -i              # fuzzy picker over your inbox
glint -c              # interactive config walkthrough
glint --version       # print version

Every command flag accepts a short letter or the full word, with one or two dashes: -n / --n / -new / --new, -t / --today, -v / --vault, etc.

Keys

Key	Action
type / arrows / `Enter` / `Backspace` / `Del`	edit and move (Up/Down move by visual line)
mouse wheel	scroll the view (hold `Option`/`Shift` to select text while mouse mode is on)
mouse click	move the cursor
`Alt+←` / `Alt+→`	move by word (also `Alt+b` / `Alt+f`)
`Alt+Backspace` / `Ctrl+W`	delete the word before the cursor (`Alt+d` deletes the word after)
`Ctrl+U` / `Ctrl+K`	delete to start / end of line (map `Cmd+Delete`→`Ctrl+U` in your terminal)
`Ctrl+S`	save (an unnamed buffer prompts for a name → inbox)
`Ctrl+P`	toggle the Glamour read preview
`Ctrl+F`	fuzzy file picker (with live preview)
`Ctrl+D`	today's daily note
`Ctrl+N`	new note in the current directory (a typed picker query becomes its name)
`Ctrl+T`	cycle theme (flexoki-light → flexoki-dark → charm)
`Ctrl+Q`	quit (press twice if there are unsaved changes)
`Esc`	back to the editor

Configuration

Run glint config for an interactive walkthrough that writes the file for you (no hand-editing, daily-format presets instead of raw Go layouts). The settings live in ~/.config/glint/config.toml (all keys optional):

vault_dir     = ""           # the vault `glint vault` opens from anywhere (e.g. "~/Notes"); unset = current dir
inbox_dir     = ""           # where `glint new` / save-as land; "" = working dir, relative = under it
daily_subdir  = "Daily"      # daily notes live in <vault>/<daily_subdir>/ (absolute path used as-is)
daily_format  = "2006-01-02" # Go time layout for daily-note filenames
theme         = "auto"       # auto | flexoki-light | flexoki-dark | charm  (auto detects macOS appearance)
glamour_style = ""           # override the preview style; "" follows the theme

Two roots. Bare glint, glint new, and --daily operate on the working directory — the folder you launched from (or $GLINT_VAULT if set), so glint works in whatever repo you're in. glint vault opens the picker on your configured vault_dir from anywhere — set it to your notes vault to reach it without cd-ing there.

Themes

Three palettes, every span explicitly colored so text stays readable on light and dark terminals: flexoki-light, flexoki-dark, and charm. auto picks light or dark from the macOS system appearance; Ctrl+T cycles live. The read preview and the whole canvas background follow the active theme.

License

Free software under the GNU Affero General Public License v3.0 (or, at your option, any later version). You may use, study, share, and modify it; any distributed derivative — or modified version offered to users over a network — must also be AGPL-licensed with source available. It comes with no warranty. See LICENSE for the full terms.