ZPLUG-CLEAN(1)

💖 ZPLUG-CLEAN(1) 💖

okay bestie, welcome to the zplug manual — this one's about zplug-clean, and yes it's exactly as satisfying as it sounds 🧹✨

---

✨ NAME ✨

zplug-clean — remove repositories which are no longer managed 🗑️💅

---

🌸 SYNOPSIS 🌸

zplug clean [--force] [--select] ["username/reponame"]

ok so real quick, when we say package we mean a string that looks like this: "username/reponame". that's the whole vibe. that's the unit. iykyk 🎀

---

🦋 DESCRIPTION 🦋

so here's the tea: zplug clean goes into your $ZPLUG_HOME/repos directory and yeets the packages that are installed there but are NOT described in your .zshrc or your zplug config file. like, if it's sitting in repos but nobody's claiming it in your config? it's giving orphan. it's giving unmanaged. it's gotta go 🫶

and otherwise — meaning, if you feel like it — you can also use it to remove the packages you want to uninstall expressly. your call, bestie, you're the main character here 👑

---

💅 OPTIONE 💅

yes it says "OPTIONE". we love a quirky spelling era. moving on 🎀

• --force — forcibly. no vibes check, no asking. by default zplug clean confirms whether you want to delete by yes/no prompt, but this flag skips all that. straight to the deleting. 💀
• --select — remove by choosing from the list of installed packages. you get to pick and choose, like a lil menu of your own repos 🍓

---

🌈 EXAMPLES 🌈

remove the packages that are installed but not described, with the prompt doing its thing:

$ zplug clean

same as above, but no prompt, no waiting, just ✨action✨:

$ zplug clean --force

remove one particular package:

$ zplug clean ´some_author/some_repo´
Remove? (y/N) ´~/.zplug/repos/some_author/some_repo´

see how it shows you the exact path before it commits? iconic behaviour honestly 👑

---

🔥 SEE ALSO 🔥

• zplug(1)

---

🧚 FURTHER DOCUMENTATION 🧚

go look at the references in the official wiki page to get started using zplug. fair warning though — the wiki may perhaps be overwhelming for first-time users 😭 no shame in that, it's a lot. take it slow, sip some water, you got this 💜

---

⭐ AUTHORS ⭐

zplug was originally written by Masaki Ishiyama (a.k.a @b4b4r07). many people have contributed to it 🫶

---

🎀 COPYING 🎀

Copyright (C) 2015-2016 Masaki Ishiyama

MIT License

---

🙈 REPORTING BUGS 🙈

report bugs to the zplug issues 🐛

---

and that's the whole page, bestie!! this was zplug-clean from the ZPLUG Manual, dated 11/21/2016 — go forth and clean responsibly, mwah 💖✨🎀