docs: document catppuccin fallback prompt and update component reference

This commit is contained in:
2026-06-12 00:43:42 -04:00
parent b5513ccbde
commit 0670fbbdad
2 changed files with 39 additions and 2 deletions
+9
View File
@@ -191,6 +191,15 @@ logging-sentinel=#### C5 — Logging and Capture
c6=#### C6 — Greeting and First-Run UI c6=#### C6 — Greeting and First-Run UI
greeting=#### C6 — Greeting and First-Run UI greeting=#### C6 — Greeting and First-Run UI
# ── Prompt and Theme ──────────────────────────────────────────
prompt-theme=## Prompt and Theme
starship=### Starship
fallback-prompt=### Catppuccin Fallback Prompt
catppuccin-prompt=### Catppuccin Fallback Prompt
nim-prompt=### Catppuccin Fallback Prompt
fzf-theme=### FZF
catppuccin-theme=### Catppuccin Mocha Syntax Highlighting
# ── Section 8: Fisher Plugins ───────────────────────────────── # ── Section 8: Fisher Plugins ─────────────────────────────────
plugins=# 8. FISHER PLUGINS plugins=# 8. FISHER PLUGINS
fisher=# 8. FISHER PLUGINS fisher=# 8. FISHER PLUGINS
+30 -2
View File
@@ -1362,7 +1362,7 @@ fish-deps manages these tools. Run `fish-deps` to check status, or
Rust-based tools and to build fish from source. All paths Rust-based tools and to build fish from source. All paths
are gated on type -q cargo and degrade gracefully. are gated on type -q cargo and degrade gracefully.
starship Cross-shell prompt; loaded via type -q starship guard. starship Cross-shell prompt; loaded via type -q starship guard.
Without it fish falls back to its built-in default prompt. Without it the Catppuccin nim-style fallback prompt activates.
uv Python package and project manager (Astral); used by the uv Python package and project manager (Astral); used by the
fish-from-source build path in fish-deps. All consumers fish-from-source build path in fish-deps. All consumers
degrade gracefully without it. degrade gracefully without it.
@@ -1593,7 +1593,7 @@ all of them.
Starship prompt fish_prompt replaced by Starship + OSC 133 markers Starship prompt fish_prompt replaced by Starship + OSC 133 markers
Catppuccin colors 30+ fish_color_* variables set to Mocha palette Catppuccin colors 30+ fish_color_* variables set to Mocha palette
FZF_DEFAULT_OPTS FZF themed to Catppuccin Mocha colors FZF_DEFAULT_OPTS FZF themed to Catppuccin Mocha colors
Right prompt fish_right_prompt: Docker context + timestamp Right prompt fish_right_prompt: exit code (on failure) + dim timestamp; always rendered
The bang-bang system spans key_bindings.fish, abbr.fish, puffer.fish, and The bang-bang system spans key_bindings.fish, abbr.fish, puffer.fish, and
six expand_bang_*.fish functions. All are gated together — disabling C3 six expand_bang_*.fish functions. All are gated together — disabling C3
@@ -1694,6 +1694,34 @@ markers on the prompt line itself. This allows ov to use them as sticky
section headers when browsing scrollback logs. Without Starship, fish's section headers when browsing scrollback logs. Without Starship, fish's
built-in prompt handles these markers automatically. built-in prompt handles these markers automatically.
### Catppuccin Fallback Prompt
When Starship is absent or C3 overrides are disabled, a built-in nim-style
two-line prompt activates from functions/fish_prompt.fish. No external
dependencies — fish builtins only.
Layout:
┬─[user@host:~/path] (main)
╰─>$
Elements:
user Yellow (Catppuccin Yellow); red if root
@host Blue (local) or Teal (SSH)
~/path prompt_pwd abbreviation (Catppuccin Text)
(main) Current git branch in Catppuccin Pink; omitted outside repos
─[V:name] Active Python venv basename; omitted when none
─[N/I/R/V] Vi-mode indicator when vi bindings are active
┬─ / ╰─> Connector lines: Catppuccin Green on success, Red on failure
The right prompt (fish_right_prompt.fish) always renders, regardless of C3
state. On failure it shows a red ✘ and the exit code; on success it shows
only the dim timestamp:
✘ 1 11:39:00 ← failed command
11:39:00 ← success (no ✘)
### FZF ### FZF
FZF is themed to Catppuccin Mocha via FZF_DEFAULT_OPTS set in FZF is themed to Catppuccin Mocha via FZF_DEFAULT_OPTS set in