PUSHD(1)

💅 pushd — push directory to directory stack

okay so bestie, this one is a fish-shell function (yep, we're in fish-shell land, not bash 👀) and it's about to become your new fave thing. It's the little directory-stack bestie that lets you hop around folders and then rewind like nothing happened. 🎀

---

✨ SYNOPSIS ✨

pushd DIRECTORY

---

🦋 DESCRIPTION 🦋

The pushd function adds DIRECTORY to the top of the directory stack and makes it the current working directory. That's it, that's the whole vibe. 💖

Then when you're done, popd will pop it off and return you to the original directory. It's giving "teleport there, teleport back" energy and honestly? Iconic. ✨

Without arguments, it exchanges the top two directories in the stack. Lowkey a little shuffle, no cap. 🔄

• pushd +NUMBER — rotates the stack counter-clockwise, i.e. from bottom to top 💫
• pushd -NUMBER — rotates clockwise, i.e. top to bottom 🔃

Also, the -h or --help option displays help about using this command. Because even main characters need a little help sometimes 🫶

---

🌸 EXAMPLE 🌸

cd ~/dir1
pushd ~/dir2
pushd ~/dir3
# Working directory is now ~/dir3
# Directory stack contains ~/dir2 ~/dir1

pushd /tmp
# Working directory is now /tmp
# Directory stack contains ~/dir3 ~/dir2 ~/dir1

pushd +1
# Working directory is now ~/dir3
# Directory stack contains ~/dir2 ~/dir1 /tmp

popd
# Working directory is now ~/dir2
# Directory stack contains ~/dir1 /tmp

see how it just stacks up your whole life and then unwinds it?? literally the most satisfying thing ever 😭🔥

---

👑 SEE ALSO 👑

• the dirs command to print the directory stack 🖨️
• the cdh command which provides a more intuitive way to navigate to recently visited directories 🌈

---

✨ ngl bestie, if you're forever lost in your own filesystem, cdh might be your actual soulmate. iykyk 💅

---

Copyright — fish-shell developers 🧚

sending you off with love from version 4.9, dated Sep 08, 2026 — stay stacked, stay slaying 💜🐚✨