Prerequisites¶

xfg requires authentication with the Git platforms you're targeting. Each platform uses its official CLI tool.

GitHub Authentication¶

Before using with GitHub repositories, authenticate with the GitHub CLI:

gh auth login

For GitHub Enterprise Server instances:

gh auth login --hostname github.mycompany.com

Required Scopes

Your token needs the repo scope to create PRs in target repositories.

Before using with Azure DevOps repositories, authenticate with the Azure CLI:

az login
az devops configure --defaults organization=https://dev.azure.com/YOUR_ORG project=YOUR_PROJECT

Required Permissions

Ensure the user/service account has "Contribute to pull requests" permission.

Before using with GitLab repositories, authenticate with the GitLab CLI:

glab auth login

For self-hosted GitLab instances:

glab auth login --hostname gitlab.example.com

Required Permissions

Ensure the user has at least "Developer" role on the project.