🚀 gh-org-extras

A powerful extension for GitHub CLI that enhances your GitHub organization management capabilities

gh-org-extras extends the standard gh org command with additional features that make managing GitHub organizations, teams, and members much easier - especially at scale!

✨ Features

• 👥 Member Management - List, invite, and remove organization members with ease
• 🔄 Bulk Operations - Perform actions on multiple users or teams at once
• 👪 Team Management - Create, update, and organize your GitHub teams
• 📋 Detailed Listing - View comprehensive information about members and teams
• 🔍 Pagination Support - Efficiently handle large organizations
• 🔒 Dry-Run Mode - Preview changes before applying them

📦 Installation

Prerequisites

• GitHub CLI - Installation Guide
• Requires GitHub CLI version 2.0.0 or higher

Installing gh-org-extras

gh extension install kyuubang/gh-org-extras

Updating

gh extension upgrade kyuubang/gh-org-extras

Uninstalling

gh extension remove kyuubang/gh-org-extras

🔧 Usage

Basic Commands

gh org-extras [command]

Member Management

List organization members:

gh org-extras member list <organization-name>

Invite members:

gh org-extras member invite <organization-name> <username>

Team Management

List teams:

gh org-extras team list <organization-name>

Bulk remove members from a team

gh org-extras bulk remove <organization_name> -t <team_slug>

🔐 Authentication

This extension requires a GitHub token with appropriate permissions:

• For listing members/teams: read:org scope
• For managing members/teams: admin:org scope

If you encounter permission issues, run:

gh auth login --scopes admin:org

🤝 Contributing

Contributions are welcome! Feel free to submit issues and pull requests.

📄 License

This project is licensed under the MIT License.