GH-CODESPACE-PORTS-FORWARD(1)

💅 GH-CODESPACE-PORTS-FORWARD(1) — the GitHub CLI manual, bestie edition 🎀

okay so picture this: it's the gh manual page, it's GitHub CLI manual, and today's main character is the port-forwarding one. let's get into it ✨

---

🌸 NAME 🌸

gh-codespace-ports-forward — literally just forwarding ports, that's the whole vibe 🫶

🦋 SYNOPSIS 🦋

gh codespace ports forward <remote-port>:<local-port>... [flags]

notice the ... bestie, you can stack these. multiple port pairs, that's the assignment 💅

✨ DESCRIPTION ✨

So what does it do? It forwards ports from a codespace to your local machine. That's it. That's the whole thing. Your codespace has a port, your laptop wants it, this command is the matchmaker 🔥

Now here's the tea: ports bind to loopback (127.0.0.1) by default. So by default, only your own machine can reach them. if you want the whole network to see it, you use --all-interfaces to bind to all interfaces — and yes that's a vibe change, not just a detail 🌈

🎀 OPTIONS 🎀

• --all-interfaces — listen on all network interfaces. the "let everyone in" option 🫶 (remember, the default is loopback-only 127.0.0.1, so this is the delulu version)

👑 OPTIONS INHERITED FROM PARENT COMMANDS 👑

these are the family hand-me-downs, they come from the parent command and they're iconic fr fr:

• -c, --codespace <string> — the name of the codespace. which one are we talking to, bestie 🦋
• -R, --repo <string> — filter codespace selection by repository name, in user/repo form
• --repo-owner <string> — filter codespace selection by repository owner (that's a username or an org, either one works 💜)

💀 EXIT CODES 💀

the vibe check at the end. here's what the numbers mean:

• 0 — successful execution. slay, it worked ✨
• 1 — error. something went sideways 😭
• 2 — command canceled. you (or something) hit the brakes 🙈
• 4 — authentication required. you gotta log in first, no cap 🔑

NOTE: specific commands may have additional exit codes. Refer to the command's help for more information. (iykyk — check the help if a number shows up that isn't on this list 💅)

🌟 SEE ALSO 🌟

• gh-codespace-ports(1) — the parent, go say hi 💖

---

and that's a wrap, bestie 🧚 this little masterpiece is from GitHub CLI v2.102.0, dated Oct 2026, and it's giving documentation energy in the best way possible. now go forward some ports, you absolute icon 👑💜