Features

Browse and edit

Two-panel layout: file list on the left, variables on the right. Navigate with arrow keys or vim bindings (hjkl). Edit values inline, rename keys, add new variables, delete existing ones.

File management

Create, duplicate, rename, and delete .env files without leaving the TUI. Press N to create, C to duplicate, R to rename, or D to delete (with confirmation). Unsaved changes must be saved or reset before renaming or deleting.

Both duplicate (C) and template (T) preserve comments, blank lines, and file structure. Duplicate copies values as-is; template strips them, perfect for generating .env.example files.

Compare and sync

Side-by-side diff between any two .env files. Copy values in either direction, edit inline, and save — all without leaving the TUI.

Completeness matrix

Multi-file grid view showing which variables exist in which files. Spot missing entries at a glance, add them inline with a, or delete them from a specific file with d.

Change tracking

Distinct indicators show the state of each variable:

Indicators are color-coded and fully configurable.

Peek original values

Toggle inline display of the original value before your edits, so you always know what changed.

Clipboard support

Yank values or full KEY=value lines to the clipboard using OSC 52.

Secret masking

Sensitive keys (passwords, tokens, secrets) are automatically detected and masked. Toggle visibility with Ctrl+S.

Detection uses key name patterns (e.g. *_PASSWORD, *_TOKEN, *_SECRET), known value prefixes (sk-, ghp_, Bearer), and entropy-based heuristic for random-looking values.

Customize detection with the [secrets] config section — mark keys as safe, add extra patterns, or disable the value heuristic entirely.

Gitignore check

Warns when .env files are not covered by .gitignore, so you don't accidentally commit secrets.

Automatic backup

Creates a .bak copy before the first save of each session. Disable with -B or no-backup = true in config.

Round-trip fidelity

Saves preserve comments, blank lines, quoting style, and key ordering — your files stay exactly as you wrote them.

Search and sort

Filter variables by name or value with /. Toggle between original position and alphabetical sorting with o.

Variable grouping

Toggle prefix-based grouping with g. Variables sharing a non-empty prefix (everything before the first _) collapse under a header showing the prefix and group size:

▾ DB (4)
  DB_HOST     localhost
  DB_PORT     5432
  DB_USER     admin
  DB_NAME     app
▾ REDIS (2)
  REDIS_URL   redis://localhost
  REDIS_PORT  6379
▾ UNGROUPED (2)
  PORT        3000
  DEBUG       true

Press Enter or Space (or click) on any header — including UNGROUPED — to collapse it. The trailing UNGROUPED section holds variables with a unique prefix or no _; it only appears when at least one named group exists, so files where nothing groups stay in the linear view.

Groups follow file order by default. Toggling sort (o) reorders groups and variables within each group alphabetically; the UNGROUPED section stays pinned at the bottom. Search disables grouping in rendering and restores it when you clear the query. The toggle and per-group collapsed state live for the session — there's no on-disk reorder.

To start with grouping already enabled, set group = true in your config or pass -g / --group on the command line.

Read-only mode

Disable all write operations with --read-only or read-only = true in config. Editing keybindings (edit, add, delete, save, copy in diff view) are suppressed, and a [READ-ONLY] badge is shown in the status bar. Navigation, search, diff view (read-only), peek, yank, and matrix view remain fully functional.

Useful for safely inspecting production .env files without risk of accidental modifications.

Session summary

When you exit lazyenv, a recap of disk-level changes is printed to stdout. It lists only files that actually changed on disk during the session — created, deleted, renamed, duplicated, templated, or with different content from session start.

Example:

Session summary:
  .env.local                           — 2 added, 1 changed, 0 deleted
  .env.dev (renamed from .env.local)   — 0 added, 2 changed, 0 deleted
  .env.backup                          — duplicated from .env.local, 1 changed, 2 deleted
  .env.fresh                           — new file (3 variables)
  .env.schema                          — from template .env.production (8 variables)
  .env.old                             — deleted

Silent when nothing changed. Disable via session-summary = false in config or the --no-session-summary flag. --read-only disables it implicitly.

Mouse support

Click to select files, variables, diff entries, and matrix cells. Scroll wheel navigates the panel under the mouse cursor. Disable with --no-mouse or no-mouse = true in config.

Theme preview

Browse all built-in themes interactively with lazyenv --themes. The two-panel view shows every theme's full color palette — swatch, name, and hex value — updating live as you navigate. Press Enter to get the config snippet for your chosen theme.