Skip to content

Dependency Catalog

fish-deps manages these tools. Run fish-deps to check status, fish-deps install to install missing Required/Recommended ones, or add --optional, --terminals, or --all to also include the Optional and/or Terminal Emulators tiers. Name tools to install only those, from any tier: fish-deps install gh gt. Add --yes to take every default without being asked, for scripts.

Tool Description
fish Fish shell >= 4.0
fzf Fuzzy finder; >= 0.48 for its key bindings (fzf-update installs the latest)
Tool Description
cargo Rust toolchain (via rustup); used by fish-deps to install Rust-based tools and to build fish from source. All paths are gated on type -q cargo and degrade gracefully. Building needs a C compiler to link; fish-deps offers to install one (build-essential, base-devel or gcc) the first time it is needed.
starship Cross-shell prompt; loaded via type -q starship guard. Without it the Catppuccin nim-style fallback prompt activates.
uv Python package and project manager (Astral); used by the fish-from-source build path in fish-deps, which has it run the build with Sphinx so fish’s man pages are rendered. Any system Python 3 works; uv downloads one itself only when the system has none. All consumers degrade gracefully without it.
direnv Per-directory environment loading; integration is fully guarded with type -q direnv. Without it the direnv hook is simply not loaded and auto-venv activates normally.
paru AUR helper (Arch only; preferred); guarded throughout — non-Arch systems silently skip AUR-specific paths. fish-deps neither offers it nor reports it as missing unless os-release identifies an Arch-based system.
yay AUR helper (Arch only; fallback to paru); same guards apply.
eza Modern ls replacement
zoxide Smart cd with frecency
lsd ls replacement (fallback to eza)
bat Syntax-highlighted cat
ov Modern pager (replaces less); also backs the logs viewer. Not a Rust crate, despite the name collision with an unrelated ov crate on crates.io. Prefers go install github.com/noborus/ov@latest when go is available (always gets the latest release, and covers distros like Debian/Ubuntu that don’t package ov in their base repos); falls back to the system PM (AUR on Arch) otherwise. When the system PM has no ov and Go is missing, fish-deps offers to install Go first and then runs go install; a system package method the PM’s index does not carry is left out rather than offered only to fail.
ripgrep Fast line search
trash Safe delete (trash-cli); backs the rm and scrub wrappers.
python3 Standalone interpreter — used by the paru/yay log cleaner. Note: uv does not provide python3 on PATH, and Arch’s base does not include it, so it is listed separately. All consumers degrade gracefully without it.

Single-purpose tools that back one wrapper function (or less) and only matter if you already use that specific tool. Skipped by fish-deps install/sync unless you pass --optional.

Tool Description
btop Modern resource monitor; backs the top wrapper (falls back to system top).
dust Disk usage tree (Rust); one of two backends for the du wrapper (falls back to system du).
duf Disk usage/free overview; the other backend for the du wrapper (falls back to system du).
prettyping Colorized ping wrapper; backs the ping wrapper (falls back to system ping).
go Go toolchain; only used to install ov via go install (see below), which gets the latest release and doesn’t depend on your distro packaging ov. fish-deps maps the package name per distro (go on Arch/Homebrew, golang-go on Debian/Ubuntu, golang on Fedora) and offers to install Go itself when ov needs it, even though this entry is in the Optional tier. A distro’s Go may be older than ov asks for; from Go 1.21 on, it then fetches the newer toolchain it needs by itself.
lazygit Terminal git UI; only referenced by the lg abbreviation.
lazydocker Terminal docker UI; backs the ld wrapper.
docker Container runtime; gates the Docker context indicator in the right prompt and backs the ld wrapper. Both consumers are guarded with type -q docker and degrade gracefully without it. Installing the daemon package does not enable/start the service — do that yourself if you want it running.
yt-dlp Video/media downloader; backs the yt-dlp wrapper function. The wrapper falls back to the system yt-dlp and the rest of the config works without it.
screen GNU screen; fallback backend for jobrunner when tmux is unavailable.
marktext Markdown editor; backs the md wrapper, which is the only thing that references it. No distro packages it under a common name, so fish-deps offers the AUR package (marktext-bin) on Arch and otherwise installs upstream’s AppImage to ~/.local/bin/marktext.
firejail Sandbox; needed only by md --read-only, which uses it to make MarkText unable to save over the file it opened. Every other md invocation works without it.
win32yank.exe Clipboard bridge for WSL2; backs the y/p/hist clipboard fallback chain when neither wl-copy/wl-paste nor xclip are present. fish-deps only offers to install it when WSL2 is detected (microsoft in /proc/sys/kernel/osrelease), downloading the pinned, checksum-verified x86_64 release from GitHub to ~/.local/bin.

GPU-accelerated terminal emulators. Only one is ever relevant to a given user — the one matching $TERM — so neither is installed by default. Skipped by fish-deps install/sync unless you pass --terminals (or --all).

Tool Description
kitty GPU-accelerated terminal; unlocks kitty-specific abbreviations and --hyperlink-format=kitty in the rg wrapper when $TERM = xterm-kitty.
wezterm GPU-accelerated terminal; unlocks WezTerm-specific abbreviations when it’s the active terminal.

Opt-in third-party services that require their own account/setup.

Tool Description
wakatime Developer time tracking
tailscale Mesh VPN client
gt The official Gitea command-line client (gitea-cli, which replaced the deprecated gt). Installed from the system package where there is one (gitea-cli on Arch/CachyOS and Homebrew); otherwise, and as the alternative, fish-deps downloads the latest release from dl.gitea.com to ~/.local/bin/gt, verified against the .sha256 file published next to it.
gh GitHub command-line client. Installed from the system package (github-cli on Arch, gh elsewhere) where there is one; otherwise, and as the alternative, fish-deps downloads the latest cli/cli release tarball, verifies it against the release’s checksums.txt, and installs its bin/gh to ~/.local/bin/gh.

The release downloads are for x86_64 and aarch64 only. fish-deps update refreshes a copy in ~/.local/bin from the latest release, and upgrades a packaged copy through the package manager.

The install priority for each tool:

Method Packages
cargo Rust tools (eza, lsd, bat, dust, ripgrep, trashy, zoxide, starship) — always gets the latest crate version, built with --locked
go install ov — preferred over the system PM when go is available; always gets the latest release
system PM paru / apt / brew / dnf / etc. — for tools without a crate or go install path
release download gt, gh — the latest upstream release, checksum-verified, to ~/.local/bin; offered after the system package, and the only method where the package manager has none
git clone fzf — installed from GitHub to ~/.fzf/
curl starship installer, fisher bootstrap, uv installer

Every cargo install passes --locked, so a crate is built against the dependency versions it was published with. Without it, cargo ignores the crate’s lockfile and takes the newest compatible release of everything; that is what made eza fail to compile against a newer palette.

Build prerequisites are not catalog entries. fish-deps offers them on demand, once a method you chose needs them, and remembers the answer for the rest of the run:

Need Used for Packages
C compiler (cc) linking every cargo install build-essential (apt), base-devel (pacman), gcc (dnf, yum, zypper)
Rust toolchain cargo being a bare rustup shim rustup default stable
unzip the wakatime-cli release zip unzip
Go go install of ov golang-go (apt), golang (dnf, yum), go (others)

unzip is deliberately not a catalog tier: one integration’s download needs it, and a dependency that shows up in every fish-deps report for that is noise. _fish_deps_wakatime_binary says plainly when it is missing.

Installer scripts (rustup, uv, starship, lazydocker) are downloaded to a temporary file and run only after the download succeeds; they are never streamed into sh. The rustup installer runs with --no-modify-path: config.fish already puts $CARGO_HOME/bin on PATH, so rustup’s own conf.d/rustup.fish would only duplicate it. Downloaded binaries (wakatime-cli, gt, gh, win32yank.exe, the MarkText AppImage) are checked against a SHA-256 digest before they are made executable: the release’s published checksum file for wakatime-cli, gt and gh, the digest GitHub records for the MarkText asset, and a pinned digest for win32yank.exe, whose upstream publishes none. A failed download or checksum mismatch aborts that install and reports failure, and leaves any copy already installed in place.

fish-deps install --yes answers every fish-deps prompt with its default without reading input: each missing tool is installed, through the first method in its list, and any prerequisite that method needs is installed too. If that method fails, the next one in the list is tried, and so on; the tool is reported as failed only when every method has failed. A cancellation (q, Ctrl+C) still stops the run at once. Prompts that belong to other programs still appear, such as the sudo password, or an installer script’s own questions. Combined with tool names it installs exactly what a script needs; from a bash bootstrap script:

Terminal window
fish -c 'fish-deps install --yes gt gh'

A name that is not in the catalog, or an unknown option, is a usage error: fish-deps exits 2 before doing anything. Tool names work the same way with fish-deps update and fish-deps sync.