GH-REPO-SET-DEFAULT(1)

💅 GH-REPO-SET-DEFAULT(1) — the GitHub CLI manual, bestie edition 🎀

okay so you're reading the manual page for gh-repo-set-default from the GitHub CLI manual, and honestly? it's a glow-up moment for your local clone. let's get into it ✨

---

🌸 NAME 🌸

gh-repo-set-default — configure the default repository for this directory 🫶

---

✨ SYNOPSIS ✨

gh repo set-default [<repository>] [flags]

---

💖 DESCRIPTION 💖

so basically this command sets the default remote repository that gets used when you're querying the GitHub API for the repo you've got cloned locally. it's the "who am I talking to" of your directory, and it ate. 👑

gh uses that default repository for things like:

• viewing and creating pull requests
• viewing and creating issues
• viewing and creating releases
• working with GitHub Actions

NOTE: gh does not use the default repository for managing repository and environment secrets. not me being the one thing this command doesn't do 😭 keep that in mind, fr fr.

---

🦋 OPTIONS 🦋

• -u, --unset — unset the current default repository, bye bestie 👋
• -v, --view — view the current default repository, just a lil peek 👀

---

⭐ EXIT CODES ⭐

• 0: successful execution — slay, it worked 💅
• 1: error — something went sideways 😭
• 2: command canceled — you changed your mind, valid 🌸
• 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 📖

---

🌈 EXAMPLE 🌈

# Interactively select a default repository
$ gh repo set-default

# Set a repository explicitly
$ gh repo set-default owner/repo

# Set a repository using a git remote name
$ gh repo set-default origin

# View the current default repository
$ gh repo set-default --view

# Show more repository options in the interactive picker
$ git remote add newrepo https://github.com/owner/repo
$ gh repo set-default

like, the last one is such a hack bestie — add a remote first and the interactive picker has more options to offer you. main character energy. 🧚

---

👑 SEE ALSO 👑

• gh-repo(1)

---

and that's the whole vibe check 💜 this was the GitHub CLI v2.102.0 manual page, dated Oct 2026 — go set that default repo, you absolute icon. periodt. 🔥🍓