FUNCED(1)

💅 funced — like, the fish-shell manual, section 1, bestie 💅

okay so real talk, this page is from the fish-shell manual, section 1, and it's all about a little command called funced. sit down, grab a strawberry 🍓, we're gonna edit some functions together.

---

✨ NAME ✨

funced — edit a function interactively. that's it, that's the vibe. 🎀

✨ SYNOPSIS ✨

funced [OPTIONS] NAME

✨ DESCRIPTION ✨

okay so funced is literally your little doorway into editing the definition of the function NAME. it gives you an interface to do that, no cap. 💅

here's the tea on which editor it picks — listen up:

• if the $VISUAL environment variable is set, that is the program it uses to edit the function.
• if $VISUAL is unset but $EDITOR is set, then $EDITOR gets the job.
• otherwise? a built-in editor is used. iconic, self-sufficient, main character energy. 👑

⚠️ tiny but crucial thing about the built-in editor: to enter a literal newline you press alt+enter. pressing enter signals that you're done editing the function. this does not apply to an external editor like emacs or vim — those do their own thing, bestie.

and here's something lowkey important: funced will try to edit the original file that a function is defined in — which might include variable definitions or helper functions as well. if changes can't be saved to the original file, a copy gets created in the user's function directory. so it's flexible like that. 🦋

if there's no function called NAME? no worries, a brand new function will be created with the specified name. new function, new you. ✨

---

🎀 OPTIONS 🎀

• -e command, --editor command — opens the function body inside the text editor given by command (for example, -e vi). the special command fish uses the built-in editor — same as specifying -i. 🧚
• -i, --interactive — forces opening the function body in the built-in editor even if $VISUAL or $EDITOR is defined. built-in editor said not today to your env vars. 💀
• -s, --save — automatically saves the function after successfully editing it. no extra step, we love efficiency. 🫶
• -h, --help — displays help about using this command. classic. 🌸

---

🌈 EXAMPLE 🌈

say you want to modify your prompt. (yes, your prompt. the thing you stare at all day. give it a glow-up.)

run:

>_ funced fish_prompt

this will open up your editor, allowing you to modify the function. when you're done, save and quit. fish will reload the function, so you should see the changes right away. obsessed. 🔥

when you're done, use:

>_ funcsave fish_prompt

for more, see funcsave <>. to view a function's current definition, use functions <> or type <>. iykyk. ⭐

---

📜 Copyright 📜

fish-shell developers — they made it, we're just vibing in it. 💖

---

sign-off szn 🌸 this page came to you courtesy of the fish-shell developers, version 4.9, dated Sep 08, 2026. go edit a function, bestie, you got this. 🦋✨💅