Skip to content

fish.md

Latest commit

 

History

History
191 lines (142 loc) · 5.46 KB

fish.md

File metadata and controls

191 lines (142 loc) · 5.46 KB

Fish Shell

Fish is the default shell. The configuration lives in ~/.config/fish/.

Prompt

The prompt is Tide (v6), configured in ~/.config/fish/conf.d/tide.fish with Rose Pine colors. Transience is enabled — previous prompt lines collapse after execution.

The prompt layout:

<os icon> <directory> [python env] [status]          <vcs>
❯

VCS info is provided by a custom _tide_item_vcs.fish that tries jj first and falls back to Tide's built-in git item. Inside a jj repository, _tide_item_jj.fish shows:

  • File counts (+added ~modified -deleted)
  • Short commit ID and change ID
  • Current bookmark, or closest ancestor bookmark prefixed with ↑
  • State flags: 💥 conflict, 🚧 divergent, 👻 hidden, 🔒 immutable
  • Diff metrics (+insertions -deletions)

Plugins

Plugins are managed with fisher. The plugin list is tracked in ~/.config/fish/fish_plugins.

Plugin Purpose
IlanCosman/tide@v6 Tide prompt
jorgebucaran/autopair.fish Automatic bracket, quote, and parenthesis pairing
nickeb96/puffer-fish Type ... to expand to ../.., .... to ../../.., etc.
0rax/fish-bd bd <name> — jump back to a named parent directory
PatrickF1/fzf.fish Fzf integration: Ctrl+Alt+F files, Ctrl+R history, Ctrl+Alt+P processes
icezyclon/zoxide.fish Zoxide integration — replaces cd with frecency-aware navigation
rose-pine/fish Rosé Pine color theme
johnstegeman/fish-take take <dir> — create a directory and cd into it

To update all plugins:

fisher update

Tool integrations

The following tools are initialized in config.fish when present, using if using <tool> guards so the config works gracefully on machines where a tool is not installed:

Tool Integration
Tide Prompt initialization + transience (initialized automatically via fish_prompt)
Zoxide Replaces cd
Fzf Shell keybindings
Atuin Shell history (ctrl-r not overridden)
Carapace Enhanced completions for many CLI tools
Leadr Terminal command session panel
uv Shell completions
Helix Set as $EDITOR

Abbreviations

Abbreviation Expands to
- cd -

Custom functions

Command replacements

These wrap modern CLI tools with graceful fallbacks to standard commands:

Function Standard Tool Notes
ls ls eza
ll ls -l eza -l
la ls -a eza -a
lla ls -la eza -la
lt — eza --tree No fallback
cat cat bat Syntax highlighting
du du dua Interactive disk usage
df df duf Disk free display
rm rm trash-cli Moves to trash instead of deleting
dig dig doggo DNS lookup
cd cd zoxide Smart frecency-based navigation

hv — haven wrapper

hv ap    # haven apply (apply dotfiles)
hv ed    # open haven source directory in Zed
hv cd    # cd to haven source directory (~/.local/share/haven)
hv ...   # pass-through to haven for any other subcommand

br — Homebrew wrapper (macOS)

br up     # brew update && brew upgrade --greedy-auto-updates && brew cleanup && brew doctor
br in     # brew bundle install --file ~/config/Brewfile
br clean  # brew bundle cleanup --zap --file ~/config/Brewfile
br ...    # pass-through to brew

jmr — Jujutsu multi-remote setup

Sets up a jj repository with upstream and origin remotes, typically used when working on a fork:

jmr

This configures:

  • Fetch from both upstream and origin
  • Push to origin only
  • Tracks main@upstream and main@origin bookmarks
  • Sets trunk() to main@upstream

mkvenv — create a Python virtual environment

mkvenv          # create .venv using the latest installed Python
mkvenv 3.12     # create .venv using Python 3.12

uvu — upgrade and sync uv project

uvu    # uv lock --upgrade && uv sync

plo — list outdated Python packages

plo    # uv pip list --outdated (falls back to pip if uv unavailable)

inf — GCP SSH helper

SSH shortcut for GCP instances via gcloud:

inf gs    # ssh to inf-graph
inf p1    # ssh to inf-prop1
inf p2    # ssh to inf-prop2
inf p3    # ssh to inf-prop3
inf p4    # ssh to inf-prop4
inf p5    # ssh to inf-prop5

dock — macOS Dock backup/restore

dock backup     # copy com.apple.dock.plist into the haven source directory
dock restore    # restore the saved Dock plist and restart the Dock

Git aliases

Short wrappers for common git operations:

Alias Command
g git
ga git add
gb git branch
gc git commit
gl git log
gp git push
gst git status

using — utility helper

Internal helper used by all wrapper functions. Returns true if the given command exists:

if using eza
    eza $argv
end

Path management

Paths are added conditionally — only if the directory exists:

test -d /opt/homebrew/bin; and fish_add_path /opt/homebrew/bin
test -d ~/.cargo/bin; and fish_add_path ~/.cargo/bin
test -d ~/bin; and fish_add_path ~/bin
# etc.

This means the config works on machines where certain tools aren't installed without producing errors.