Feature Flags Reference¶

Feature flags let you turn parts of the dotfiles on or off. All flags live in .chezmoidata.toml under [features]. Set a flag to true to enable it, or false to disable it. Changes take effect after you run dot apply.

Shell and Terminal¶

These flags control shell behavior and terminal tools.

Flag	Default	Description
`alias_wrapper`	`false`	Enable alias governance wrapper (confirms destructive aliases)
`dms`	`true`	Dank Material Shell theming for GNOME
`zellij`	`false`	Enable Zellij terminal multiplexer config

Linux Desktop¶

These flags enable Wayland desktop components. Turn them on if you run a Linux desktop with Niri or another tiling compositor.

Flag	Default	Description
`linux_desktop`	`false`	Enable full Linux desktop environment configs
`niri`	`false`	Niri Wayland compositor config
`waybar`	`false`	Waybar status bar config
`fuzzel`	`false`	Fuzzel application launcher config
`mako`	`false`	Mako notification daemon config
`foot`	`false`	Foot terminal emulator config
`kanshi`	`false`	Kanshi display manager config

Hardware¶

Flag	Default	Description
`touch`	`false`	Enable touchscreen support (gestures, on-screen keyboard)
`t2`	`false`	Apple T2 security chip handling
`surface`	`false`	Microsoft Surface hardware support

Tool Selection¶

Setting	Default	Options
`node_manager`	`mise`	`mise`, `fnm`, `nvm`

Alias Policy¶

Setting	Default	Description
`aliases.buckets.system`	`true`	Enable system utility aliases
`aliases.buckets.svn`	`true`	Enable SVN aliases
`aliases.policy.strict_mode`	`false`	Require confirmation for destructive aliases (rm, mv)

How to Toggle Features¶

You can edit flags in two places. Change .chezmoidata.toml in the repo to set defaults for all machines. Or override on a single machine in ~/.config/chezmoi/chezmoi.toml:

# In ~/.config/chezmoi/chezmoi.toml
[data.features]
zellij = true
linux_desktop = true

Then apply: dot apply