rootiest
beb89e406a
index.md is both the man-page LANDING section and a Starlight content page. Astro errors on any frontmatter key outside the fixed man/site/manTitle/helpKeywords schema, so folding the source fish-config.md pandoc header (title/section/header/date/author) onto index.md under a fifth "pandoc" key would break the docs-site build the moment it's scaffolded. Relocate that block to docs/manual/_pandoc.yml: a plain, fence-free YAML file that Astro content collections ignore (leading underscore). split-manual.py now extracts it as raw text (no yaml.safe_load/ safe_dump round-trip) so build-manual.py's --concat re-emits it byte-for-byte instead of merely "verbatim" in comment only. Also guard build_concat against a manual/ tree with no _pandoc.yml/index.md, removing the unconditional index.md parse that previously raised FileNotFoundError on such a tree. Regenerated docs/manual/ via split-manual.py; concat output remains byte-identical to the pre-migration docs/fish-config.md.
78 lines
3.8 KiB
Markdown
78 lines
3.8 KiB
Markdown
---
|
|
title: Fish Shell Configuration
|
|
description: Reference manual for the rootiest fish configuration.
|
|
manTitle: DESCRIPTION
|
|
sidebar:
|
|
order: 3
|
|
helpKeywords:
|
|
- description
|
|
- autopair
|
|
- puffer
|
|
- puffer-fish
|
|
- logging-events
|
|
---
|
|
|
|
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
|
|
- Automatic session logging: terminal scrollback, tmux/zellij panes, and
|
|
paru/yay output captured to ~/.terminal_history (on by default; see below)
|
|
- 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
|
|
|
|
> **CAUTION - SESSION LOGGING IS ON BY DEFAULT**
|
|
>
|
|
> This configuration silently records terminal output to `~/.terminal_history`:
|
|
> Kitty scrollback on window close, live tmux pane streams, zellij pane
|
|
> snapshots on exit, and full paru/yay output. These logs can contain command
|
|
> output, file contents, and secrets printed to the terminal. Nothing leaves
|
|
> your machine, but the files persist locally.
|
|
>
|
|
> - Disable all logging with: `set -U __fish_config_op_logging off`
|
|
> - Prefer a menu? Run the interactive picker: `config-settings`
|
|
> - See Section 7 (C5 - Logging and Capture) for the full breakdown.
|
|
|
|
The configuration is split across:
|
|
|
|
config.fish Main entry point; sets env vars and PATH
|
|
conf.d/
|
|
abbr.fish All abbreviations
|
|
autopair.fish Auto-pair brackets and quotes (bundled from jorgebucaran/autopair.fish)
|
|
cheat.fish cheat.sh tab 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
|
|
logging-events.fish C5 --on-variable event handlers; syncs logging state at startup
|
|
kitty-watcher-reminder.fish C5 per-session reminder to set up the Kitty watcher
|
|
paru-wrapper.fish Auto-generates ~/.local/bin/paru logging wrapper
|
|
puffer.fish !! / !$ / ./ expansion (bundled from nickeb96/puffer-fish)
|
|
tmux-logging.fish C5 starts tmux pipe-pane capture when fish runs inside tmux
|
|
zellij-logging.fish C5 fish_exit handler dumping zellij pane scrollback on exit
|
|
sponge_privacy.fish Sponge privacy patterns; filters credentials from history
|
|
starship.fish fish_prompt with OSC 133 shell-integration markers
|
|
tailscale.fish Tailscale CLI tab completions
|
|
theme.fish Catppuccin syntax highlight colors
|
|
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
|
|
agents-tools/ AGENTS.md version-bump script and git hooks (wired via core.hooksPath)
|
|
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)
|
|
|
|
---
|