Accept GitHub Invitations

This is a basic utility that can automatically accept repo invitations for github.

Requirements

Node.js, tested on 14.x but should be fine on most modern versions

A Personal Access Token with repo:invite permissions. Get one at Github > Settings > Developer Settings > Personal Access Tokens and be sure to select repo:invite scopes before generation

Getting Started

1. Clone the repo

git clone https://github.com/hi-ashleyj/accept-github-invitations.git

2. Create a config.json file in the root directory and add a Personal Access Token with repo:invite scope

{
    "access_token": "<YOUR_TOKEN_HERE>"
}

3. Run with

node app.js
# or
npm start

or, if you want to pass in your access token instead, use

node app.js --token <YOUR_TOKEN_HERE>

Configuration

Denying users

In your config.json file, simply include an array of the users you wish to always deny

{
    ...other stuff,
    "deny": [
        "github",
        "octocat"
    ]
}

If the users that you have specified own the repository, or invite you to it, the invitation will always decline

Strict Mode

When in strict mode, only requests from allowed users will be accepted. All others will decline. To do this, add this to your config.json (without the comments)

{
    ...other stuff,
    // First, enable strict mode
    "strict": true,

    // Then, allow only a few users
    "allow": [
        "octocat",
        "hi-ashleyj"
    ]
}

If the users that you specifiy own the repository, or invite you to it, the invitation will automatically accept. This DOES NOT override denylist functionality, which will always take precendence. The allowlist makes no difference when strict: false

Using the action

1. Create your own copy of the repo (however you like to do this)
2. Add a secret (Repo Settings > Secrets) called INVITE_ACCESS_TOKEN with your access token
3. Execute the workflow run from the actions tab.

License

Feel free to use this basic script however you like, and modify it to add always-running or at-time based refreshing. I accept PRs and Issues on the base script, not on any modified versions.