Preview: Open Lazygit, Neovim, or a Shell over Your Tab
This preview of Nash 0.13.7 introduces modal panes: terminal tools that appear over your current tab without making you rearrange splits or dedicate another tab to a quick Git check.
One Key to Show, the Same Key to Hide
The bundled shortcuts will open tools in the active pane's working directory:
SUPER+Backslashopens lazygit.SUPER+Shift+Backslashopens Neovim.SUPER+Alt+Ctrl+Backslashopens a shell, without starting another program.
On macOS, SUPER means CMD and Alt means Option. Lazygit and Neovim must
be installed on the machine where they run. The command palette and View
menu also list Lazygit, Neovim, and Modal Terminal.
Press the same shortcut again, even inside the tool, to hide it without stopping its program. A left-click outside the overlay in the pane area does the same. That entire click is consumed: it does not select text, activate a pane, or reach the application underneath. A click used only to focus the window does not hide it when focus-click swallowing is enabled.
While shown, the modal pane receives typing and paste. Search, copy mode, and QuickSelect work there too. Each tab shows at most one modal pane; switching tabs leaves the overlay with its tab.
Reuse Tools by Folder
Instances are associated with an action and a starting folder, not a window. Open lazygit from a repository, hide it, then toggle it from a subdirectory: Nash reuses the nearest existing ancestor-folder instance. From another tab, the shortcut moves that instance into view there instead of starting a copy.
A hidden instance stays alive while a pane remains in its folder or below it. When the last such pane closes or leaves that folder tree, Nash ends the hidden instance without confirmation. Working-directory reporting affects when Nash notices a shell's directory change.
Save editor changes before leaving the project. Modal panes are not preserved by session saves or Reopen Closed Tab, and all instances end when Nash quits. A modal shell is not the place for a build that must outlive those boundaries.
Run beside Remote Work, Not beyond Its Connection
For a remote mux pane, the tool runs on the mux server's host, in the folder reported there. Its title includes the host and path. A local folder with the same path has a separate instance.
Remote modal panes require Nash 0.13.7 or later on a macOS or Linux mux host. Their programs use that host's environment. Non-multiplexing SSH is unsupported: Nash shows a card and starts nothing.
Unlike ordinary durable mux-session work, a remote modal pane belongs to this GUI's connection. Quitting Nash, detaching the domain, or losing the connection ends it; reconnecting does not restore the old program. Other attached GUIs do not share the modal pane.
Make the Shortcut Yours
To move lazygit to another key, override its entry in your own commands.toml:
[[command]]
id = "modal_lazygit"
keys = [{ key = "g", mods = "SUPER|SHIFT" }]The [modal] section of nash.toml controls padding, opacity, border, and
backdrop dimming. The
configuration guide explains
Nash's configuration files;
Multiplexer Sessions covers the
persistent workspaces whose lifetime should not be confused with these temporary
tools.