FISH_TAB_TITLE(1)

✨ FISH_TAB_TITLE ✨ (section 1 of the fish-shell manuals, bestie 💅)

okay so this page is literally about fish_tab_title — it's from fish-shell, and it's the whole entire vibe of "how do I make my terminal tab say something cute instead of the default boring-ness". let's get into it 🎀

---

💖 NAME 💖

fish_tab_title — define the terminal tab's title. that's it, that's the whole job, and honestly? iconic.

---

🌸 SYNOPSIS 🌸

fish_title
fish_tab_title

function fish_title
    ...
end

function fish_tab_title
    ...
end

---

🦋 DESCRIPTION 🦋

so here's the tea ☕ — fish_title is a function, and fish runs it before and after a new command gets executed or put into the foreground, and whatever it prints becomes your titlebar message. like, it's giving "your terminal is a whole aesthetic now" ✨

the first argument to fish_title contains the most recently executed foreground command as a string, if there is one. yup, argv[1] is literally the receipts of what you just ran 📝

⚠️ heads up bestie — this requires that your terminal supports [programmable titles](<#term-compat-osc-0>) and that the feature is turned on. no support, no title. them's the rules 😭

want to disable setting the title entirely? just use an empty function, it's like, the simplest slay ever (see the examples below, i gotchu 🫶).

and if you want the terminal tab title to be something other than the terminal window title — yes those are two different things, keep up 💀 — then you define the fish_tab_title function. it works exactly like fish_title but it overrides that one. main character energy, literally 👑

---

🎀 EXAMPLE 🎀

a simple title, ngl this one ate:

function fish_title
    set -q argv[1]; or set argv fish
    # Looks like ~/d/fish: git log
    # or /e/apt: fish
    echo (fish_prompt_pwd_dir_length=1 prompt_pwd): $argv;
end

do not change the title — for when you simply cannot be bothered 🙈:

function fish_title
end

change the tab title only, baby steps 💜:

function fish_tab_title
    echo fish $fish_pid
end

---

🌈 Copyright 🌈

fish-shell developers — credit where credit is due, we stan 💖

---

and that's the whole page, no cap 🧚✨ this was fish-shell manuals, version 4.9, dated Sep 08, 2026 — go forth and make your tabs cute, bestie, i believe in you 🫶💅🍓