fish

The primary interactive shell — conf.d layout, environment, vi-mode key bindings, the cyberdream theme, completions, and every autoloaded function.

fish is the primary interactive shell. The config is split into autoloaded files: conf.d/ for startup snippets, functions/ for one function per file, completions/ for completion scripts, and themes/ for the color theme. config.fish runs last and holds the prompt and atuin setup.

None of these files are templates. chezmoi runs in symlink mode, so each target is a symlink back into the source tree and edits to ~/.config/fish/... land in the repo directly. ~/.config/fish/fish_variables (universal variables, including the selected theme) is listed in .chezmoiignore.tmpl and stays local to each machine.

Installation

fish is in .chezmoidata/packages.yaml under packages.arch.pacman and packages.darwin.brew. .chezmoiscripts/run_onchange_before_10-packages.sh.tmpl installs it with pacman on Arch and Homebrew on macOS. The tools that fish initializes (starship, zoxide, atuin, fzf, eza, gum, yazi) come from the same manifest. mise, television, hishtory, envman, and the Bun, Go, Android, and Foundry toolchains are not in the manifest; fish initializes each one only if it is present.

Plugins

fish_plugins is a fisher manifest with one entry:

jorgebucaran/nvm.fish

The plugin’s files are committed to the repo (conf.d/nvm.fish, functions/nvm.fish, functions/_nvm_*.fish, completions/nvm.fish), so fish has nvm without fisher. The plugin stores Node builds in $XDG_DATA_HOME/nvm (default ~/.local/share/nvm) and downloads from https://nodejs.org/dist. If nvm_default_version is set, it runs nvm use --silent $nvm_default_version in each interactive shell.

Startup order

fish sources conf.d/*.fish in name order and then config.fish. The numbered files load first:

00-path.fish

Runs for every shell, including non-interactive ones, so scripts get the same PATH.

~/.local/bin comes from inir-path.fish and ~/.cargo/bin from rustup.fish.

10-env.fish

GOPATH/GOBIN are not set here. The comment explains why: mise’s fish hook re-applies its [env] on every prompt, so Go paths are pinned in ~/.config/mise/config.toml, and mise provides GOROOT.

set -gx FZF_DEFAULT_OPTS "
  --height=~40%
  --layout=default
  --info=inline-right
  --border=rounded
  --prompt='  '
  --pointer='▶'
  --marker='✓'
  --color=fg:#ffffff,fg+:#ffffff,bg:-1,bg+:#3c4048
  --color=hl:#5ef1ff,hl+:#5ef1ff
  --color=info:#7b8496,header:#7b8496,border:#7b8496
  --color=prompt:#5ef1ff,pointer:#ffaecf,marker:#5eff6c,spinner:#f1ff5e
  --color=gutter:-1,query:#ffffff
"

20-aliases.fish

Editor, Bun, directory-jump, and tool aliases, followed by:

• cpy/pst: wl-copy/wl-paste if wl-copy exists, else pbcopy/pbpaste.
• q: exits the shell. If $YAZI_ID is set and ya exists, it first runs ya emit quit so the yazi that spawned the shell quits too.
• Interactive only: celar and claer → clear, and ls → eza --icons when eza is installed. clear itself is not aliased, because an alias would shadow functions/clear.fish.

The full list is on the Aliases page. This file is plain fish, not rendered from .chezmoidata/aliases.yaml, so its alias set differs from bash/zsh in a few places.

30-ssh-agent.fish

Interactive shells without SSH_AUTH_SOCK source ~/.ssh/agent.env.fish and probe with ssh-add -l. Exit code 2 means no agent is reachable. In that case it starts ssh-agent -c, rewrites its csh setenv lines into set -gx, saves them to ~/.ssh/agent.env.fish, and sources the file. An SSH_AUTH_SOCK provided from outside (systemd unit, forwarding, keyring) is left alone.

40-tools.fish

• mise activate fish runs for every shell, so scripts see mise shims too.
• Interactive only, in order:
  1. Print ~/.local/state/quickshell/user/generated/terminal/sequences.txt if present. These are escape sequences that apply wallpaper-generated Material You terminal colors from quickshell.
  2. tv init fish (television), if installed.
  3. starship init fish, zoxide init fish, and entire completion fish, each only if installed.
  4. tv init fish a second time. The comment says it runs before hishtory so hishtory keeps ctrl-r.
  5. Source ~/.hishtory/config.fish if present.
  6. Activate the unsloth studio venv (~/.unsloth/studio/unsloth_studio/bin/activate.fish) if present.

atuin is initialized later, in config.fish, and binds ctrl-r itself.

50-terminal-title.fish

Defines terminal_title, which runs on every PWD change and prints ESC k <prompt_pwd> ESC \. That sequence sets the tmux or screen window name. functions/fish_title.fish sets the regular terminal title.

pnpm-filter.fish

pnpm workspace helpers. __pnpm_pick_pkg lists workspace packages with pnpm m ls --depth -1 --json | jq, and you pick one with gum filter.

secrets.fish

Exports credentials as global variables. The values are machine-specific and are not documented here. Variable names:

PGDATABASE (local Postgres connection string), GITLAB_TOKEN, OPPER_API_KEY, OPENAI_API_KEY, GROQ_API_KEY, WEBAWESOME_NPM_TOKEN, TAVILY_API_KEY, FINANCIAL_DATASETS_API_KEY, PIMLICO_API_KEY, WAKATIME_API_KEY, LINEAR_CLI_PROFILE, LINEAR_API_KEY, LINEAR_TEAM_ID.

config.fish

The header comment says the file should stay empty, but it holds the following:

1. Starship with transient prompt. starship_transient_prompt_func renders starship module character and starship_transient_rprompt_func renders starship module time. Then starship init fish | source and enable_transience run, so past prompts collapse to ❯ with the time on the right. See Starship.
2. Bottom-pinned prompt. In interactive shells with FISH_BOTTOM_PROMPT=1, tput cup $LINES 0 moves the cursor to the last row. The comment calls 1 the default, but 10-env.fish sets 0, so the prompt stays at the top unless you export FISH_BOTTOM_PROMPT=1.
3. fish_add_path ~/.grok/bin (grok installer block).
4. Sources ~/.config/envman/load.fish if it is non-empty.
5. atuin. Interactive shells run atuin init fish | source and atuin ai init fish | source. See atuin.
6. fish_add_path ~/.cmux/bin and ~/.cache/.bun/bin.
7. Sources the first readable ~/.config/herdr/plugins/github/herdr-automatic-rename-*/shell/hook.fish. This is herdr’s automatic pane-rename hook (herdr).
8. A copy of the _atuin_ai_question_mark function that atuin ai init fish emits, followed by bind "?" _atuin_ai_question_mark.

Key bindings

functions/fish_user_key_bindings.fish turns on vi mode (fish_vi_key_bindings) first, then adds custom binds in both insert and default (normal) modes, so they work in either mode.

Bindings added by tool init scripts:

_pj_bind_down hands the key to down-or-search when the buffer is non-empty, the completion pager is open, or history search is active. Otherwise it runs PJ_QUIET=1 pj, so pressing down outside a project does nothing and prints no error.

The prompt shows ❮ in green in vi normal mode (starship’s vimcmd_symbol).

Theme

themes/cyberdream.theme is a fish theme file with colors from cyberdream.nvim and preferred background #16181a. The repo ships the file but does not select it. The active theme is stored in fish_variables, which chezmoi ignores, so pick it once per machine with fish_config theme save cyberdream.

FZF_DEFAULT_OPTS in 10-env.fish uses the same palette.

Completions

Functions

Every file in functions/ is autoloaded by name. Several also exist as POSIX scripts in ~/.local/bin for bash and zsh. In fish the function shadows the script. See Scripts for why the cd-style helpers must stay shell functions.

Functions defined inside conf.d/ and config.fish rather than functions/: q (20-aliases), terminal_title (50-terminal-title), the pnpmf* helpers and __pnpm_pick_pkg (pnpm-filter), the _nvm_install/_nvm_update/_nvm_uninstall event handlers (nvm), and starship_transient_prompt_func, starship_transient_rprompt_func, and _atuin_ai_question_mark (config.fish).

auto-Niri.fish

# Auto start Niri on tty1
if test -z "$DISPLAY" ;and test "$XDG_VTNR" -eq 1
    mkdir -p ~/.cache
    exec niri-session > ~/.cache/niri.log 2>&1
end

This file is applied only on Linux with role desktop or laptop. It is not in conf.d/, so fish does not load it automatically, and nothing in the repo sources it. To start niri on login to tty1, source it from a login-shell snippet. See niri.