Supported Providers

gitfetch supports multiple Git hosting platforms with different authentication methods.

GitHub

Authentication: Uses GitHub CLI (gh)

Setup:

1. Install GitHub CLI: brew install gh (macOS) or follow official instructions
2. Run gh auth login to authenticate
3. gitfetch will detect and use your GitHub credentials

Token Configuration:

You can also set a token via:

• Config file: set token in [github] section of ~/.config/gitfetch/gitfetch.conf
• Environment variable: GH_TOKEN

Rate Limits:

• No token: 60 requests/hour (limited, may hit limits)
• With token: 5,000 requests/hour (recommended)

GitLab

Authentication: Uses GitLab CLI (glab)

Setup:

1. Install GitLab CLI: brew install glab (macOS) or follow official instructions
2. Run glab auth login to authenticate
3. gitfetch will detect and use your GitLab credentials

Token Configuration:

You can also set a token via:

• Config file: set token in [gitlab] section of ~/.config/gitfetch/gitfetch.conf
• Environment variable: GITLAB_TOKEN

Gitea/Forgejo/Codeberg

Authentication: Personal access tokens

Setup:

1. Generate a personal access token in your account settings
2. During gitfetch setup, select Gitea/Forgejo/Codeberg
3. Enter your instance URL and personal access token

Supported Instances:

• Gitea (any instance)
• Forgejo (any instance)
• Codeberg (codeberg.org)

Sourcehut

Authentication: Personal access tokens

Setup:

1. Generate an OAuth2 personal access token in your account settings
2. During gitfetch setup, select Sourcehut
3. Enter your personal access token

Provider Configuration

You can change your configured provider at any time:

gitfetch --change-provider

The provider setting is stored in your configuration file at ~/.config/gitfetch/gitfetch.conf.