GH-SECRET(1) GitHub CLI manual GH-SECRET(1)

# [NAME](#NAME)

gh-secret - Manage GitHub secrets

# [SYNOPSIS](#SYNOPSIS)

**gh secret <command> \[flags]**

# [DESCRIPTION](#DESCRIPTION)

Secrets can be set at the repository, or organization level for use in GitHub Actions, Agents, or Dependabot. User, organization, and repository secrets can be set for use in GitHub Codespaces. Environment secrets can be set for use in GitHub Actions. Run **gh help secret set** to learn how to get started.

# [AVAILABLE COMMANDS](#AVAILABLE_COMMANDS)

[**gh-secret-delete(1)**](#gh_secret_delete%281%29)

Delete secrets

[**gh-secret-list(1)**](#gh_secret_list%281%29)

List secrets

[**gh-secret-set(1)**](#gh_secret_set%281%29)

Create or update secrets

# [OPTIONS](#OPTIONS)

[**-R**, **--repo** **<\[HOST/\]OWNER/REPO>**](#R)

Select another repository using the \[HOST/]OWNER/REPO format

# [EXIT CODES](#EXIT_CODES)

0: Successful execution

1: Error

2: Command canceled

4: Authentication required

NOTE: Specific commands may have additional exit codes. Refer to the command's help for more information.

# [SEE ALSO](#SEE_ALSO)

[**gh(1)**](/man/os/gh/gh.1)

Oct 2026

---

Document: gh-secret(1) from gh 2.103.3-r0 (Chainguard OS)
Source: https://github.com/cli/cli