otty / dotfiles

All tools/fish

fish

A command line shell that favours discoverability: autosuggestions and highlighting out of the box.

Detected by fish | macOS, Linux |fishshell.com

Sync it fish.toml

Sync rules

What travels, what stays, what never leaves

fish in your home directory Every rule on this page, by file

set -gx PATHfish_add_path

Each machine keeps its own copy of these.

set -gx JAVA_HOME

Each machine keeps its own copy of these.

· conf.d/ Sync

· functions/ Sync

· completions/ Sync

· fish_plugins Sync

· themes/ Sync

· fish_variables Exclude

· fish_history Exclude

· ~/.local/share/fish/ Exclude

Only what the catalog names. A directory that syncs brings everything inside it except what is listed as excluded here.

apps/fish.tomlThe file this page is generated from

id = "fish"

name = "fish"

homepage = "https://fishshell.com"

description = "A command line shell that favours discoverability: autosuggestions and highlighting out of the box."

icon = "SimpleIcons:fishshell"

detect = ["fish"]

platforms = ["macos", "linux"]

# fish reads $XDG_CONFIG_HOME/fish, defaulting to ~/.config/fish on macOS as

# well as Linux — the [configHome] base directory

# (https://fishshell.com/docs/current/language.html#configuration-files).

paths = [

"[configHome]/fish/config.fish",

"[configHome]/fish/conf.d/",

"[configHome]/fish/functions/",

"[configHome]/fish/completions/",

"[configHome]/fish/fish_plugins",

"[configHome]/fish/themes/",

]

# fish_variables holds universal variables, which fish rewrites at runtime;

# it is machine state, not configuration.

# fish's data directory is $XDG_DATA_HOME, else ~/.local/share, on macOS as well

# as Linux, so it is [xdgData]; [dataHome] would be

# ~/Library/Application Support, which fish never writes. fish reads the

# variable rather than hard-coding the default — `fish -c 'echo

# $__fish_user_data_dir'` on macOS answers $XDG_DATA_HOME/fish when it is set

# and ~/.local/share/fish when it is not.

exclude = [

"[configHome]/fish/fish_variables",

"[configHome]/fish/fish_history",

"[xdgData]/fish/",

]

secret = []

# Both lines are built out of this user's own home directory, so no second

# machine can take them as they stand — but they are also this user's shell,

# the thing they would rebuild first, so they are kept: backup.

[[machine_lines]]

file = "[configHome]/fish/config.fish"

match = { prefix = ["set -gx PATH", "fish_add_path"] }

scope = "backup"

# JAVA_HOME is split out of the rule above because it is a different kind of

# value: /opt/homebrew/opt/openjdk on Apple Silicon, /usr/local on Intel,

# /usr/lib/jvm on a distro — the same on every machine of that class whoever is

# logged in. Decided by the platform, so it travels to one of the same kind.

[[machine_lines]]

file = "[configHome]/fish/config.fish"

match = { prefix = ["set -gx JAVA_HOME"] }

scope = "platform"

Use it with your dotfile manager

Same data, in the shape your tool already reads

Opens Otty and adds this tool to what it syncs

Opens otty://sync/add/fish. Otty ships with this catalog, so the link only has to name the tool — nothing is downloaded.

Every one of these is generated from the same rules as this page. None of them splits set -gx PATH and fish_add_path for you — that part is Otty’s own sync, or a template you write by hand.