NEXTD(1)

✨ NEXTD(1) — the fish-shell glow-up page ✨

okay so bestie, welcome to nextd, a lil fish-shell icon from section 1 of the manual 💅 she's the forward button on your directory time machine, and honestly? she ate.

---

🦋 NAME 🦋

nextd — move forward through directory history. yeah. that's her whole thing. main character energy only 💖

---

🌸 SYNOPSIS 🌸

nextd [-l | --list] [POS]

---

🎀 DESCRIPTION 🎀

so here's the vibe: nextd moves forwards POS positions in the history of visited directories (that's the <#directory-history> situation, iykyk) 🧚 and if you've hit the end of the history? a warning gets printed. not her being dramatic, she's just telling you there's nowhere left to go 😭

if you pass the -l or --list option, the current directory history gets displayed too — like a little peek behind the curtain ✨

the -h or --help option displays help about using this command, because even icons need a help menu 🫶

heads up bestie: the cd command limits directory history to the 25 most recently visited directories — that's the cap, no cap. the history is stored in the dirprev and dirnext variables, which this command manipulates. so yeah, she's in there moving your variables around and she's slaying while doing it 💀

---

🔥 EXAMPLE 🔥

like, literally just watch:

cd /usr/src
# Working directory is now /usr/src

cd /usr/src/fish-shell
# Working directory is now /usr/src/fish-shell

prevd
# Working directory is now /usr/src

nextd
# Working directory is now /usr/src/fish-shell

see how she just… went back? obsessed 🌈 that's the whole trick. prevd goes back, nextd goes forward, and everyone lives happily ever after 🎀

---

👑 SEE ALSO 👑

• the cdh command to display a prompt to quickly navigate the history 🍓
• the dirh command to print the directory history 🌸
• the prevd command to move backward 💜

---

💖 Copyright 💖

fish-shell developers — iconic of them, honestly.

---

and that's the page, bestie! this was NEXTD(1) from the fish-shell manual, version 4.9, dated Sep 08, 2026 — so go forth, move forward through your directory history, and remember: if the warning prints, you've reached the end, and that's simply the universe telling you to cd somewhere new 💅✨🦋