docs(readme): document first_run.fish and update Fisher bootstrap reference
This commit is contained in:
@@ -51,6 +51,7 @@ This config layers on top of the CachyOS base Fish configuration and adds:
|
|||||||
│ ├── theme.fish # Theme syntax highlighting colors
|
│ ├── theme.fish # Theme syntax highlighting colors
|
||||||
│ ├── done.fish # Done plugin (desktop notifications for long commands)
|
│ ├── done.fish # Done plugin (desktop notifications for long commands)
|
||||||
│ ├── tricks.fish # PATH, bang-bang helpers, bat man pages, system aliases, history/backup utilities
|
│ ├── 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
|
│ ├── 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
|
│ ├── 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
|
│ ├── 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. |
|
| `nickeb96/puffer-fish` | Expand `...` to `../..`, `!!` to last command, etc. |
|
||||||
| `jorgebucaran/spark.fish` | Sparkline bar charts in the terminal |
|
| `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.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user