FISH_CONFIG(1)

🌸 FISH_CONFIG(1) 🌸

okay so bestie, welcome to fish_config — it's a section 1 manual page from the fish-shell fam, and honestly? it's giving "your terminal finally has a spa day." 💅 let's get into it.

---

✨ NAME ✨

fish_config — start the web-based configuration interface 🎀

---

💖 SYNOPSIS 💖

fish_config [browse]
fish_config prompt (choose | list | save | show)
fish_config theme
fish_config theme choose THEME [ --color-theme=(dark | light) ]
fish_config theme demo
fish_config theme dump
fish_config theme list
fish_config theme show [THEME...]

---

🦋 DESCRIPTION 🦋

fish_config is literally the tool for configuring fish. no cap.

the web era 🌐

With no arguments at all, or with the browse command, it starts up the web-based configuration interface. and like — the web interface lets you view your functions, variables and history, plus make changes to your prompt and your color configuration. iconic, honestly. it spins up a local web server and opens a browser window for you.

when you're done, close the browser window and press Enter to terminate the configuration session. don't just walk away, bestie 😭

If the BROWSER environment variable is set, it gets used as the name of the web browser to open instead of the system default. very "I have preferences" of you, love that. 🫶

the prompt era 💬

With the prompt command, fish_config can be used to view and choose a prompt from fish's sample prompts, straight up inside the terminal. no browser required, we're being efficient today ✨

Available subcommands for the prompt command:

• choose — loads a sample prompt in the current session.
• list — lists the names of the available sample prompts.
• save — saves the current prompt to a file (via funcsave).
• show — shows what the given sample prompts (or all of them) would look like.

the theme era 🌈

With the theme command, fish_config can be used to view and choose a theme (meaning a color scheme — yes, queen, aesthetics) inside the terminal.

Available subcommands for the theme command:

• choose — loads a theme in the current session. if the theme has light and dark variants (see below 👀), the one matching fish_terminal_color_theme will be applied (and also whenever that variable changes). to override fish_terminal_color_theme, pass the --color-theme argument.
• demo — displays some sample text in the current theme.
• dump — prints the current theme in a loadable format.
• list — lists the names of the available themes.
• show — shows what the given themes (or all of them) would look like.
• save (not recommended 🚩) — saves the given theme to universal variables. a theme set this way will not update as fish_terminal_color_theme changes. so like, it's stuck. forever. just so you know.

The -h or --help option displays help about using this command. classic. 💜

---

🎀 THEME FILES 🎀

fish_config theme and the theme selector in the web config tool load their themes from theme files. these live in the fish configuration directory — typically ~/.config/fish/themes — with a .theme ending. so fetch. 🌸

You can add your own theme by adding a file in that directory. be the main character of your own color scheme, honestly.

To get started quickly:

fish_config theme dump > ~/.config/fish/themes/my.theme

which will save your current theme in .theme format. slay. 💅

The format looks like this:

# name: 'My Theme'

[light]
# preferred_background: ffffff
fish_color_normal 000000
fish_color_autosuggestion 7f7f7f
fish_color_command 0000ee

[dark]
# preferred_background: 000000
fish_color_normal ffffff
fish_color_autosuggestion 7f7f7f
fish_color_command 5c5cff

[unknown]
fish_color_normal --reset
fish_color_autosuggestion brblack
fish_color_cancel -r
fish_color_command --reset

The comments provide name and background color to the web config tool. very "notes app but make it aesthetic." 📝

Themes can have three variants: one for light mode, one for dark mode, and one for terminals that don't report colors (where fish_terminal_color_theme is set to unknown). triple threat behavior, we love to see it. 👑

The other lines are just like set variable value, except that no expansions are allowed. quotes are, but they aren't necessary. lowkey chill of them.

Other than that, .theme files can contain any variable with a name that matches the regular expression '^fish_(?:pager_)?color_.*$' — starts with fish_, an optional pager_, then color_ and then anything. iykyk 🧚

---

⭐ EXAMPLE ⭐

• fish_config or fish_config browse opens a new web browser window and allows you to configure certain fish settings.
• fish_config prompt show demos the available sample prompts.
• fish_config prompt choose disco makes the disco prompt the prompt for the current session. this can also be used in config.fish to set the prompt. 🕺
• fish_config prompt save saves the current prompt to an autoloaded file.
• fish_config prompt save default chooses the default prompt and saves it.

---

🌟 Copyright 🌟

fish-shell developers

---

and that's the whole page, bestie — no crumbs left behind 💖 this manual page is version 4.9, dated Sep 08, 2026, brought to you by the fish-shell girlies (fish-shell, section 1, FISH_CONFIG(1)). go forth and make your terminal gorgeous ✨🐚