DESCRIPTION

A production-grade Fish shell configuration targeting Fish 4.x. It provides:

• Drop-in replacements for common Unix tools (ls, cat, rm, du, ping, less)
• Deep Kitty and WezTerm terminal integration: tab/window/pane management from the command line
• Scrollback history snapshots saved to ~/.terminal_history on session exit
• Automatic Python virtualenv activation on directory change
• Cross-platform package management via pkg and fish-deps
• AI session helpers for Claude Code and Antigravity
• Catppuccin Mocha color theme throughout

The configuration is split across:

config.fish               Main entry point; sets env vars and PATH
conf.d/
  abbr.fish               All abbreviations
  cheat.fish              cheat.sh completions
  done.fish               Desktop notifications for long commands
  first_run.fish          One-time init: Fisher bootstrap, theme, welcome
  key_bindings.fish       Custom key bindings and Vi mode
  paru-wrapper.fish       Auto-generates ~/.local/bin/paru logging wrapper
  starship.fish           fish_prompt with OSC 133 shell-integration markers
  tailscale.fish          Tailscale CLI tab completions
  theme.fish              Catppuccin syntax highlight colors
  sponge_privacy.fish     Sponge privacy patterns; filters credentials from history
  tricks.fish             PATH, bang-bang helpers, bat man pages, aliases
  wakatime.fish           WakaTime shell hook
  yay-wrapper.fish        Auto-generates ~/.local/bin/yay logging wrapper
  zoxide.fish             Zoxide z/zi integration; overrides cd
functions/                Custom functions, one per file, autoloaded
completions/              Tab completion scripts
integrations/
  fzf.fish                FZF Catppuccin theme and key binding config
scripts/
  clean_progress_log.py   Strips paru/yay typescript animations to clean static logs
docs/                     Offline documentation and compiled man page
  fish-config.md          Primary source manual (terminal-readable)
  fish-config.1           Compiled man page (auto-generated by CI)
  fish-config.index       Section index for help config navigation
  html/                   Chunked HTML docs (auto-generated by CI)
  wiki/                   Markdown wiki (auto-generated by CI)