GH-AUTH(1)

✨ GH-AUTH(1) ✨

okay so this is the gh-auth page from the GitHub CLI manual — literally the whole vibe of "how do I prove to GitHub that I'm me" 🫶 bestie, you're gonna be so authenticated by the end of this.

---

🌸 NAME 🌸

gh-auth — Authenticate gh and git with GitHub 💅

like, that's the whole job. get gh and git talking to GitHub as you. no cap.

---

🦋 SYNOPSIS 🦋

gh auth <command> [flags]

it's giving "go pick a subcommand" energy. the <command> is the main character here, and [flags] is whatever extra little garnish you wanna sprinkle on top ✨

---

🎀 AVAILABLE COMMANDS 🎀

okay here's the roster, the whole lineup, and yes i'm listing every single one because we don't skip 🍓

• gh-auth-login(1) — Log in to a GitHub account 🔑 like, the classic. you, GitHub, a token, a whole moment.
• gh-auth-logout(1) — Log out of a GitHub account 👋 breaking up (respectfully).
• gh-auth-refresh(1) — Refresh stored authentication credentials 🔄 your creds said "glow-up time".
• gh-auth-setup-git(1) — Setup git with GitHub CLI 🛠️ making git and GitHub actually cooperate, iconic behavior.
• gh-auth-status(1) — Display active account and authentication state on each known GitHub host 👀 the vibe check. who are you right now, and where?
• gh-auth-switch(1) — Switch active GitHub account 🔁 main character swap. multiple accounts is valid.
• gh-auth-token(1) — Print the authentication token gh uses for a hostname and account 🎟️ yes it literally just prints the token, handle with care bestie.

---

💀 EXIT CODES 💀

when the command finishes it tells you how it went, and here's the full legend:

• 0: Successful execution ✅ slay, it worked.
• 1: Error 😭 something went wrong.
• 2: Command canceled 🙈 you (or something) hit stop.
• 4: Authentication required 🔒 it needs you to log in first, bestie. it's giving locked door.

NOTE: Specific commands may have additional exit codes. Refer to the command's help for more information. 📌 so like, don't @ me if a subcommand has its own extra codes — go read its help. iykyk.

---

🌈 SEE ALSO 🌈

• gh(1) — the whole parent CLI, the mothership 👑

---

and that's the page!! 🧚💜

little sign-off moment: this is GitHub CLI v2.102.0, dated Oct 2026 — so if your version is older, go update, no cap 💖✨🎀