Skip to content

Configuration

riomoo edited this page Apr 8, 2026 · 1 revision

Configuration

nt is intentionally minimal. Configuration is done through standard environment variables — no config file is required.


Environment Variables

EDITOR

The editor opened by nt new and nt edit.

Value Effect
(unset) Falls back to nano
vim Opens in Vim
nvim Opens in Neovim
code --wait Opens in VS Code (the --wait flag is required so nt waits for you to close the tab before committing)
hx Opens in Helix
Any editor binary on $PATH Works as long as it is a blocking call
# Set permanently in your shell profile (~/.bashrc, ~/.zshrc, etc.)
export EDITOR=nvim

VS Code tip: use export EDITOR="code --wait" so the terminal waits for the file tab to close before nt auto-commits.


Bash-Specific Variables

The Bash edition also reads:

Variable Default Description
NT_DIR ~/.config/nt Override the notes directory (edit in the script itself, not an env var by default)

Changing the Default Editor Per-Command

You can override $EDITOR inline for a single command:

EDITOR=vim nt edit meeting
EDITOR="code --wait" nt new ideas

Shell Aliases

Useful aliases to add to your shell profile:

alias n='nt'
alias nl='nt list'
alias ns='nt search'

Clone this wiki locally