dpt-invite-github(1)

💖 NAME 💖

dpt-invite-github — the little helper that slides into someone's DMs and invites them to join a GitHub organization 🫶

---

✨ SYNOPSIS ✨

dpt invite-github [option...] {github-username}

---

🦋 DESCRIPTION 🦋

okay so bestie, dpt invite-github is literally the move for inviting people to become members of a GitHub organization. no cap. 💅

you get to pick which organization, and here's the thing: you set the org name through the DPT_GITHUB_ORGNAME environment variable. and if you don't set it? it just defaults to pkg-perl-tools. comfy.

this script needs the DPT_GITHUB_OAUTH environment variable though — like, it will not function without it. you can set it in ~/.dpt.conf or ~/.config/dpt.conf. cf. dpt-github-oauth(1) and dpt-config(5) for the deets. 📎

and now for the part that actually matters: you need write access to the admin:org scope to be able to manage organization memberships. like, that's not optional, that's the whole vibe check. please please please make sure the token you're using has that scope, over at <https://github.com/settings/tokens>. 🙈

not me forgetting the scope and then wondering why nothing works... it's giving "read the docs bestie" 😭

---

👑 OPTIONS 👑

• --role name — this one sets the role for the user. valid roles are admin or member, and member is the default. ✨
• --force — use this if the GitHub user is already a member of the organization and you wanna change their role anyway. basically "i said what i said" energy. 🔥

---

🎀 LICENSE AND COPYRIGHT 🎀

Copyright 2016 Alex Muntada.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See <http://dev.perl.org/licenses/> for more information.

---

and that's a wrap, babe 🧚 this was dpt-invite-github(1), shipped as part of pkg-perl-tools 0.88, dated 2026-04-01. go forth and invite people, main character 💜