docs(readme): document first_run.fish and update Fisher bootstrap reference

This commit is contained in:
2026-06-06 23:12:30 -04:00
parent 945b8ddabf
commit 278ceb2c06
+10 -1
View File
@@ -51,6 +51,7 @@ This config layers on top of the CachyOS base Fish configuration and adds:
│ ├── theme.fish # Theme syntax highlighting colors
│ ├── done.fish # Done plugin (desktop notifications for long commands)
│ ├── tricks.fish # PATH, bang-bang helpers, bat man pages, system aliases, history/backup utilities
│ ├── first_run.fish # One-time initialization: Fisher bootstrap, theme, welcome message
│ ├── paru-wrapper.fish # Auto-generates ~/.local/bin/paru logging wrapper on first run
│ ├── yay-wrapper.fish # Auto-generates ~/.local/bin/yay logging wrapper on first run
│ ├── starship.fish # fish_prompt with OSC 133;A/B shell-integration markers
@@ -86,7 +87,15 @@ Managed via [Fisher](https://github.com/jorgebucaran/fisher):
| `nickeb96/puffer-fish` | Expand `...` to `../..`, `!!` to last command, etc. |
| `jorgebucaran/spark.fish` | Sparkline bar charts in the terminal |
Fisher and all listed plugins are installed automatically by the bootstrap script in `config.fish` upon launching the shell for the first time.
Fisher and all listed plugins are installed automatically by `conf.d/first_run.fish` on the first interactive session. This also applies the Catppuccin Mocha theme and prints a one-time welcome message. Subsequent launches are unaffected.
To re-trigger first-run initialization (e.g., after a fresh clone):
```fish
set -Ue __fish_config_first_run_complete
```
Then open a new shell.
---