GH-CODESPACE-REBUILD(1)

💅 GH-CODESPACE-REBUILD — bestie's guide to the rebuild button but make it terminal

okay so you're in the gh manual, specifically the gh-codespace-rebuild page, part of the GitHub CLI manual. yes this is the one that rebuilds your codespace. no we are not panicking. let's go 🎀

---

✨ NAME ✨

gh-codespace-rebuild — rebuild a codespace, fr fr it literally rebuilds it 🦋

---

✨ SYNOPSIS ✨

gh codespace rebuild [flags]

that's it. that's the whole vibe. flags go after, periodt 💅

---

✨ DESCRIPTION ✨

so rebuilding means your codespace gets recreated from scratch — like a glow-up but for your container ✨

the important part, and do not skip this: your code and any current changes will be preserved 🫶 ngl that's the whole reason this command is safe to run. your codespace gets rebuilt using your working directory's dev container, so it matches whatever config you're actually sitting in.

also, a full rebuild (that's the --full flag, more on her below) also removes cached Docker images. yes, all of them. it's giving "clean slate main character energy" 😭

---

✨ OPTIONS ✨

• -c, --codespace <string> — the name of the codespace. tell her which one you mean 💖
• --full — perform a full rebuild 🔥 (and remember from up there: full rebuild = cached Docker images get yeeted too)
• -R, --repo <string> — filter codespace selection by repository name, formatted user/repo 🍓
• --repo-owner <string> — filter codespace selection by repository owner — that's a username or an org, so you can narrow it down before you pick 🌸

---

✨ EXIT CODES ✨

like, she'll tell you exactly how it went:

• 0 — successful execution 👑 slay
• 1 — error 💀
• 2 — command canceled 🙈 (you hit the brakes)
• 4 — authentication required 🔐 go log in bestie

NOTE: specific commands may have additional exit codes. refer to the command's help for more information. iykyk, always check the help 🌈

---

✨ SEE ALSO ✨

• gh-codespace(1) — the whole codespace fam, go say hi 🧚

---

and that's the page!! you understood the assignment 💜 this was written for GitHub CLI v2.102.0, dated Oct 2026 — so if you're reading this in some other timeline, check your version, ok bye love u 🫶⭐