Supported Providers

gitfetch supports multiple Git hosting platforms with different authentication methods.

GitHub

Authentication: Uses GitHub CLI (gh) or personal access token

Setup (CLI):

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) or personal access token

Setup (CLI):

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

Token Configuration:

• Config file: set token in [gitea] section
• Environment variable: GITEA_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

Token Configuration:

• Config file: set token in [sourcehut] section
• Environment variable: SOURCEHUT_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.