step-security/Setup the GitHub CLI
👨💻 Install & configure the GitHub CLI (gh) in your GitHub Actions runner
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Stale
- License
- None
Inputs
| name | description | required | default |
|---|---|---|---|
| gh-version | Which version of 'gh' to install. This can be an exact version like '2.38.0' or a semver range like '2.38' or '2.x'. You can also specify 'latest' to always use the latest version. The default is 'latest'. | — | latest |
| cli-token | The GitHub token to use when pulling versions from cli/cli. By default this should cover all cases. You shouldn't have to touch this setting. | — | ${{ github.server_url == 'https://github.com' && github.token || '' }} |
| token | Token to use when running 'gh auth login'. This can be set to an empty string to skip the login step. By default this will use the token 'github.token'. | — | ${{ github.token }} |
| github-server-url | The GitHub server URL to use when running 'gh auth login'. Defaults to the current 'github.server_url'. | — | ${{ github.server_url }} |
Outputs
| name | description |
|---|---|
| gh-version | The version of 'gh' that was installed. This will be something like '2.38.0' or similar. |
| auth | A boolean indicating whether or not the user is authenticated. This will be true if 'gh auth login' was run and false otherwise. |