rootiest/fish-config
1
1
Fork 0
Code Issues Pull Requests Actions Wiki Activity

docs: revamp minimal mode troubleshooting section

Browse Source 
Replaced the minimal mode troubleshooting section with a new 'What's with the C1-C6 stuff?' heading. Included a quick-reference table for the six opinionated categories with links to their detailed customization sections, and updated the documentation index.
This commit is contained in:
rootiest
2026-07-27 16:33:00 -04:00
parent 6b484599ae
commit 8dba8a31fe
4 changed files with 1362 additions and 1773 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/fish-config.md
+20 -16
View File
@@ -3322,24 +3322,31 @@ overrides):
See C3 — Key and Environment Overrides for the full list of
what C3 controls.
## Minimal Mode / Disabling Opinionated Features
## What's with the C1-C6 stuff?
Disable all opinionated features at once:
This configuration groups its opinionated behaviors into six categories (C1–C6), allowing you to selectively disable features that conflict with your workflow. Disabling all of them leaves you with a "Minimal Mode" shell that only manages PATH, XDG variables, and your `local.fish` overrides.
Category Description
──────────────────────────────────────────────────────────────────────────
C1 Command Shadows (aliases that replace default tools)
C2 Auto-Exec (background tasks and startup side-effects)
C3 Key & Env Overrides (Vi mode, PAGER)
C4 Terminal Integrations (Kitty, WezTerm)
C5 Logging and Capture (session logs, command duration)
C6 Greeting & First-Run UI (custom startup banner)
Disable all opinionated features at once (Minimal Mode):
set -U __fish_config_opinionated 0
This turns off all six categories (aliases, auto-exec, overrides,
integrations, logging, greeting) — leaving a clean shell with only PATH,
XDG variables, and local.fish sourcing.
Disable a single category:
set -U __fish_config_op_aliases off # C1 — command shadows
set -U __fish_config_op_autoexec off # C2 — startup side-effects
set -U __fish_config_op_overrides off # C3 — key/env overrides
set -U __fish_config_op_integrations off # C4 — terminal integrations
set -U __fish_config_op_logging off # C5 — logging and capture
set -U __fish_config_op_greeting off # C6 — greeting
set -U __fish_config_op_aliases off # C1
set -U __fish_config_op_autoexec off # C2
set -U __fish_config_op_overrides off # C3
set -U __fish_config_op_integrations off # C4
set -U __fish_config_op_logging off # C5
set -U __fish_config_op_greeting off # C6
Keep one category active under a master disable:
@@ -3350,10 +3357,7 @@ Re-enable everything:
set -Ue __fish_config_opinionated
Or use the interactive TUI: `config-settings`.
See Opinionated Components (Minimal Mode) for the full
component reference tables.
For an interactive alternative to setting these variables by hand, run `config-settings`.
---