feat: add sponge via fisher; gitignore fisher-managed files

meaningful-ooo/sponge is now the one true Fisher-managed plugin,
giving the bootstrap a concrete purpose. Its files (and functions/fisher.fish,
completions/fisher.fish) are gitignored so Fisher owns them exclusively —
no committed/managed conflict possible.

Updates docs, index, requirements, and README to distinguish
Fisher-managed plugins from bundled customized ones.
This commit is contained in:
2026-06-08 22:01:30 -04:00
parent 8e7e450a9d
commit 43123ff390
6 changed files with 35 additions and 14 deletions
+9
View File
@@ -62,6 +62,15 @@
opinionated_catalog.md opinionated_catalog.md
docs/superpowers docs/superpowers
# ──────────────── Fisher-Managed Plugin Files ───────────────
# Fisher writes these into the repo directory on install/update.
# They are owned by Fisher — do not commit them.
functions/fisher.fish
completions/fisher.fish
conf.d/sponge.fish
functions/_sponge*.fish
functions/sponge_*.fish
# ─────────────────── AI Sessions and Rules ────────────────── # ─────────────────── AI Sessions and Rules ──────────────────
# Matches CLAUDE.md, .claud*, etc. # Matches CLAUDE.md, .claud*, etc.
[Cc][Ll][Aa][Uu][Dd][Ee].[Mm][Dd] [Cc][Ll][Aa][Uu][Dd][Ee].[Mm][Dd]
+1 -1
View File
@@ -22,7 +22,7 @@ This config layers on top of the CachyOS base Fish configuration and adds:
- **Catppuccin Mocha** theming throughout (prompt, FZF, syntax highlighting) - **Catppuccin Mocha** theming throughout (prompt, FZF, syntax highlighting)
- **Starship** prompt with VI key bindings - **Starship** prompt with VI key bindings
- **Fisher** plugin manager bootstrapped automatically; plugin functionality (FZF bindings, Catppuccin theme, done notifications, autopair, puffer-fish) bundled directly with the config - **Fisher** plugin manager bootstrapped automatically; manages `sponge` (failed-command history filter); FZF bindings, Catppuccin theme, done, autopair, and puffer-fish are bundled directly with the config as customized versions
- **Smart CLI wrappers** that prefer modern tools (`eza`, `bat`, `btop`, `dust`, `prettyping`) with graceful fallbacks - **Smart CLI wrappers** that prefer modern tools (`eza`, `bat`, `btop`, `dust`, `prettyping`) with graceful fallbacks
- **Auto Python venv** activation on directory change (direnv-aware) - **Auto Python venv** activation on directory change (direnv-aware)
- **Kitty terminal** deep integration for splits, tabs, and SSH - **Kitty terminal** deep integration for splits, tabs, and SSH
+2
View File
@@ -166,6 +166,8 @@ universal=## Fish Universal Variables
# ── Section 8: Fisher Plugins ───────────────────────────────── # ── Section 8: Fisher Plugins ─────────────────────────────────
plugins=# 8. FISHER PLUGINS plugins=# 8. FISHER PLUGINS
fisher=# 8. FISHER PLUGINS fisher=# 8. FISHER PLUGINS
fisher-managed=## Fisher-Managed Plugins
sponge=## Fisher-Managed Plugins
bundled-plugins=## Bundled Plugin Functionality bundled-plugins=## Bundled Plugin Functionality
fish-plugins-manifest=## fish_plugins Manifest fish-plugins-manifest=## fish_plugins Manifest
+17 -8
View File
@@ -1417,12 +1417,21 @@ testing), run:
Then open a new shell. Then open a new shell.
## Fisher-Managed Plugins
The following plugins are fully managed by Fisher. Their files are installed
into the repo directory by Fisher and are listed in `.gitignore` — do not
commit them. Fisher installs and updates them automatically.
jorgebucaran/fisher Plugin manager itself
meaningful-ooo/sponge Remove failed commands from history
## Bundled Plugin Functionality ## Bundled Plugin Functionality
Plugin functionality is bundled directly with this config rather than managed The remaining plugin functionality is bundled directly with this config rather
through Fisher. The bundled versions include customizations for Fish 4.x than managed through Fisher. The bundled versions include customizations for
compatibility and improved behavior that differ from their upstream releases. Fish 4.x compatibility and improved behavior that differ from their upstream
Installing them through Fisher would overwrite these customizations. releases. Installing them through Fisher would overwrite these customizations.
Bundled components and their upstream origins: Bundled components and their upstream origins:
@@ -1437,13 +1446,13 @@ versions. To update their behavior, edit the relevant bundled files directly.
## fish_plugins Manifest ## fish_plugins Manifest
The `fish_plugins` file at the config root contains only the Fisher manager The `fish_plugins` file at the config root:
entry itself:
jorgebucaran/fisher Plugin manager itself jorgebucaran/fisher Plugin manager itself
meaningful-ooo/sponge Remove failed commands from history
To update Fisher, run `fisher update` or `fish-deps update` which calls it To update all Fisher-managed plugins, run `fisher update` or `fish-deps
as its first step. update` which calls it as its first step.
--- ---
+1
View File
@@ -1 +1,2 @@
jorgebucaran/fisher jorgebucaran/fisher
meaningful-ooo/sponge
+5 -5
View File
@@ -116,9 +116,9 @@ Non-standard applications required by this fish shell configuration.
| Tool | Description | Notes | | Tool | Description | Notes |
|------|-------------|-------| |------|-------------|-------|
| `fisher` | Fish plugin manager | Bootstrapped automatically on first run; only entry in `fish_plugins` | | `fisher` | Fish plugin manager | Bootstrapped automatically on first run; manages `sponge` via `fish_plugins` |
| `meaningful-ooo/sponge` | Remove failed commands from history | Fisher-managed; files are gitignored |
Plugin functionality (Catppuccin theme, FZF bindings, done notifications, autopair, puffer-fish Other plugin functionality (Catppuccin theme, FZF bindings, done notifications, autopair, puffer-fish
expansions) is bundled directly with this config in `functions/`, `conf.d/`, and `themes/`. These are expansions) is bundled directly with this config in `functions/`, `conf.d/`, and `themes/` as
customized versions — do not install them via `fisher install`, as doing so would overwrite the customized versions — do not install them via `fisher install`.
bundled modifications.