Configuration

This page lists the options that control the folded strip and the maximized pane cues. Both groups live in the [pane] table of ~/.config/nash/nash.toml. Nash reloads the file when you save it.

An empty string ("") means "use the default". The bundled file leaves most colors empty for that reason.

To change keys, see Keys and Commands.

Folded strip

[pane]
folded_pane_color = ""
folded_pane_inactive_color = ""
folded_pane_text_color = ""
folded_pane_inactive_text_color = ""
folded_pane_font_size = 14
folded_pane_show_cwd = true
folded_pane_thickness = 1.0

Option	Type	Default in `nash.toml`	Effect
`folded_pane_color`	color	`""`: your accent, at 55% opacity	Fill of the strip that has focus. It draws over the pane background.
`folded_pane_inactive_color`	color	`""`: the active color, dimmed	Fill of every other strip.
`folded_pane_text_color`	color	`""`: your foreground color	Title color on the strip that has focus.
`folded_pane_inactive_text_color`	color	`""`: the active title, dimmed	Title color on every other strip.
`folded_pane_font_size`	number	`14`	Title size in points. Nash draws it in the title font, not the terminal font.
`folded_pane_show_cwd`	boolean	`true`	Adds the last part of the pane's working directory after the title.
`folded_pane_thickness`	number	`1.0`	Thickness of the colored band, in cell heights.

Notes on the defaults:

The "" for folded_pane_text_color resolves to the foreground option in your [ui] table if you set one. Otherwise it resolves to the foreground color of your theme.
If you remove folded_pane_font_size from the file, Nash falls back to 10. The bundled file sets 14.
Colors accept the usual forms, for example "#123456" or "rgba(255, 100, 48, 55%)".

The focus fill

A strip is too thin for an outline. A strip takes no active pane highlight and no pane switch animation. The fill carries the focus cue instead: the strip with focus uses folded_pane_color, and every other strip uses folded_pane_inactive_color.

If you leave the two inactive options empty, Nash derives them from the active pair. It scales the red, green, and blue channels to 60% and keeps the opacity. The strip keeps its hue, and only its brightness shows which strip has focus. Set a color to take over completely:

[pane]
folded_pane_inactive_color = "rgba(0, 0, 0, 45%)"
folded_pane_inactive_text_color = "#949494"

Thickness

A folded pane keeps whole text cells: one row in a column of stacked panes, and two columns in a row of side-by-side panes. Nash draws the band inside those cells, folded_pane_thickness cell heights thick, and centers it. The pane background shows on both sides.

At 1.0, a strip is exactly one cell high in both directions, so they look alike. A larger value fills more of the freed space. A smaller value makes a thinner band with a wider gutter. The band never grows beyond the cells the strip owns, so a very large value simply fills them.

[pane]
# A chunkier band.
folded_pane_thickness = 1.4

Title and folder

A strip shows a fold icon, the pane title, and, if folded_pane_show_cwd is on, · folder. Nash cuts text that does not fit and ends it with …. Nash does not show the folder for a remote directory, or when it equals the title. A lower folded_pane_font_size fits more of the title. In a strip down a column, the turned title is centered on the band, and a large size can overhang it a little.

Maximized pane cues

A maximized pane fills the tab. These options mark that state. See The Pane Size Ladder.

[pane]
maximized_pane_indicator = ["badge", "corner"]
maximized_pane_indicator_color = ""
maximized_pane_badge_text_color = ""
maximized_pane_badge_duration = '1.5s'
maximized_pane_indicator_size = '1.2pt'

Option	Type	Default in `nash.toml`	Effect
`maximized_pane_indicator`	name or list of names	`["badge", "corner"]`	Which cues mark a maximized pane.
`maximized_pane_indicator_color`	color	`""`: your accent color	Fill of the marker and of the badge background.
`maximized_pane_badge_text_color`	color	`""`: near-white or near-black	Badge text. Nash picks the one that reads on the fill.
`maximized_pane_badge_duration`	duration	`'1.5s'`	How long the badge stays. See below.
`maximized_pane_indicator_size`	size	`'1.2pt'`	Size of the marker. Markers draw at 10 times this size.

Cue names

maximized_pane_indicator takes "badge", a shape, or both. The badge and one shape combine.

Name	Cue
`"badge"`	The badge that fades out after the toggle.
`top`, `bottom`, `gutter`, `left`, `right`, `box`, `square`, `circle`, `corner`	A shape that stays while the pane is maximized.
`"none"` or `[]`	No cue.

These forms are equal:

maximized_pane_indicator = ["badge", "corner"]
maximized_pane_indicator = "badge, corner"
maximized_pane_indicator = "badge corner"

Prefer the list form. Nash reports a misspelled entry in a list on its own. Only one shape is drawn, so a list with two shapes is a configuration error.

Badge duration

maximized_pane_badge_duration takes a number of milliseconds or a string such as '1.5s'. The badge holds at full strength for the first half of that time and fades out over the second half.

0 turns the badge off.
A negative value keeps the badge on screen for as long as the pane is maximized.

Marker size

Shapes use the same size rules as active_pane_highlight_size. A bar or border takes the size as its thickness. The markers square, circle, and corner multiply it by 10, so the default '1.2pt' draws a 12-point corner triangle. Use points rather than pixels, so the marker looks the same on every screen density.

Fold and Unfold a Pane shows what a strip contains.
If an upgrade did not add these options to your file, see Configuration Sync.