GCLI-ISSUES(1)

✨ GCLI-ISSUES(1) ✨

bestie you have FOUND it — this is a page from the General Commands Manual, and it's the one about gcli config, aka the lil button that changes the settings on your Git Forge Account. 🎀

---

🌸 NAME 🌸

gcli config — Git Forge Configuration. that's it, that's the vibe. configuration of the forge, the git kind. 💜

---

🦋 SYNOPSIS 🦋

no cap, here's exactly how you call it:

gcli config ssh
gcli config ssh add -t title -k keypath
gcli config ssh delete -i id

three shapes, three moods. pick your main character moment. ✨

---

👑 DESCRIPTION 👑

okay so gcli config is literally the settings panel for your Git Forge Account. you use it to change stuff — like, for example, adding or deleting the SSH public keys you use to push to forges. 🫶

it's giving "keychain management but make it fashion". 🔥

---

💅 OPTIONS 💅

here are the flags, all of them, no skips:

• -t, --title title — sets the title of the SSH key you're about to add. it's a lil short description of the key, like a name tag but for crypto. 🏷️
• -k, --key key-path — the path to the file that holds your SSH public key. yes, the actual file. the real one.
• -i, --id id — the ID of the public key you want to delete. bye bye key 💀

---

🎀 SUBCOMMANDS 🎀

• ssh — lists the SSH public keys for the current user. a whole lil show-and-tell. 🌈
• ssh add — adds an SSH public key for the current user. new key, who dis. ⭐
• ssh delete — deletes an SSH public key for the current user. it's over bestie. 🥀

---

🧚 EXAMPLES 🧚

print a list of registered SSH public keys

$ gcli config ssh

look at them. all lined up. iconic. 👑

register ~/.ssh/id_rsa.pub on the default forge

$ gcli config ssh add \
      -t "Key for $(hostname)" \
      -k ~/.ssh/id_rsa.pub

note the \ line continuation and the $(hostname) command substitution — we love a shell that does the work for us. 🍓

---

🔥 SEE ALSO 🔥

• git(1)
• gcli(1)

go read those too, you know you want to. 📚

---

💜 AUTHORS 💜

Nico Sonack aka. herrhotzenplotz <nsonack@herrhotzenplotz.de> and contributors. 🫶 thank you for your service, legend.

---

💀 BUGS 💀

okay so this is the important part, listen up bestie:

when you use this feature to manage SSH keys on GitHub, be aware that you need the "read:public_key" scope enabled on your access token. otherwise you will receive HTTP 404 errors. yes fr fr, 404. the most gaslighting error code. 😭

Please report bugs via E-Mail to https://lists.sr.ht/~herrhotzenplotz/gcli-discuss.

Alternatively you can report them on any of the forges linked at https://sr.ht/~herrhotzenplotz/gcli. However, the preferred and quickest method is to use the mailing list. 💌

---

and that's the whole page, bestie. this was gcli version 2.13.0, dated 05-Aug-2026, and it lives in the GCLI-ISSUES(1) manual page. slay, go push something. 💅✨