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
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 ──────────────────
# Matches CLAUDE.md, .claud*, etc.
[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)
- **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
- **Auto Python venv** activation on directory change (direnv-aware)
- **Kitty terminal** deep integration for splits, tabs, and SSH
+2
View File
@@ -166,6 +166,8 @@ universal=## Fish Universal Variables
# ── Section 8: Fisher Plugins ─────────────────────────────────
plugins=# 8. FISHER PLUGINS
fisher=# 8. FISHER PLUGINS
fisher-managed=## Fisher-Managed Plugins
sponge=## Fisher-Managed Plugins
bundled-plugins=## Bundled Plugin Functionality
fish-plugins-manifest=## fish_plugins Manifest
+17 -8
View File
@@ -1417,12 +1417,21 @@ testing), run:
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
Plugin functionality is bundled directly with this config rather than managed
through Fisher. The bundled versions include customizations for Fish 4.x
compatibility and improved behavior that differ from their upstream releases.
Installing them through Fisher would overwrite these customizations.
The remaining plugin functionality is bundled directly with this config rather
than managed through Fisher. The bundled versions include customizations for
Fish 4.x compatibility and improved behavior that differ from their upstream
releases. Installing them through Fisher would overwrite these customizations.
Bundled components and their upstream origins:
@@ -1437,13 +1446,13 @@ versions. To update their behavior, edit the relevant bundled files directly.
## fish_plugins Manifest
The `fish_plugins` file at the config root contains only the Fisher manager
entry itself:
The `fish_plugins` file at the config root:
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
as its first step.
To update all Fisher-managed plugins, run `fisher update` or `fish-deps
update` which calls it as its first step.
---
+1
View File
@@ -1 +1,2 @@
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 |
|------|-------------|-------|
| `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
expansions) is bundled directly with this config in `functions/`, `conf.d/`, and `themes/`. These are
customized versions — do not install them via `fisher install`, as doing so would overwrite the
bundled modifications.
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/` as
customized versions — do not install them via `fisher install`.