You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
--clobber Overwrite existing aliases of the same name
gh alias list
List your aliases
gh alias set <alias> <expansion> [flags]
Create a shortcut for a gh command
--clobber Overwrite existing aliases of the same name
-s, --shell Declare an alias to be passed through a shell interpreter
gh api <endpoint> [flags]
Make an authenticated GitHub API request
--cache duration Cache the response, e.g. "3600s", "60m", "1h"
-F, --field key=value Add a typed parameter in key=value format
-H, --header key:value Add a HTTP request header in key:value format
--hostname string The GitHub hostname for the request (default "github.com")
-i, --include Include HTTP response status line and headers in the output
--input file The file to use as body for the HTTP request (use "-" to read from standard input)
-q, --jq string Query to select values from the response using jq syntax
-X, --method string The HTTP method for the request (default "GET")
--paginate Make additional HTTP requests to fetch all pages of results
-p, --preview names GitHub API preview names to request (without the "-preview" suffix)
-f, --raw-field key=value Add a string parameter in key=value format
--silent Do not print the response body
-t, --template string Format JSON output using a Go template; see "gh help formatting"
gh auth <command>
Authenticate gh and git with GitHub
gh auth login [flags]
Authenticate with a GitHub host
-p, --git-protocol string The protocol to use for git operations: {ssh|https}
-h, --hostname string The hostname of the GitHub instance to authenticate with
--insecure-storage Save authentication credentials in plain text instead of credential store
-s, --scopes strings Additional authentication scopes to request
-w, --web Open a browser to authenticate
--with-token Read token from standard input
gh auth logout [flags]
Log out of a GitHub host
-h, --hostname string The hostname of the GitHub instance to log out of
gh auth refresh [flags]
Refresh stored authentication credentials
-h, --hostname string The GitHub host to use for authentication
--insecure-storage Save authentication credentials in plain text instead of credential store
-r, --remove-scopes strings Authentication scopes to remove from gh
--reset-scopes Reset authentication scopes to the default minimum set of scopes
-s, --scopes strings Additional authentication scopes for gh to have
gh auth setup-git [flags]
Setup git with GitHub CLI
-h, --hostname string The hostname to configure git for
gh auth status [flags]
View authentication status
-h, --hostname string Check a specific hostname's auth status
-t, --show-token Display the auth token
gh auth token [flags]
Print the auth token gh is configured to use
-h, --hostname string The hostname of the GitHub instance authenticated with
-b, --branch string Select another branch by passing in the branch name
-c, --commit string[="last"] Select another commit by passing in the commit SHA, default is the last commit
-n, --no-browser Print destination URL instead of opening the browser
-p, --projects Open repository projects
-r, --releases Open repository releases
-s, --settings Open repository settings
-w, --wiki Open repository wiki
-L, --limit int Maximum number of caches to fetch (default 30)
-O, --order string Order of caches returned: {asc|desc} (default "desc")
-S, --sort string Sort fetched caches: {created_at|last_accessed_at|size_in_bytes} (default "last_accessed_at")
gh changelog
Extension changelog
gh clone-org
Extension clone-org
gh co
Alias for "pr checkout"
gh codeql
Extension codeql
gh codespace
Connect to and manage codespaces
gh codespace code [flags]
Open a codespace in Visual Studio Code
-c, --codespace string Name of the codespace
--insiders Use the insiders version of Visual Studio Code
-R, --repo string Filter codespace selection by repository name (user/repo)
--repo-owner string Filter codespace selection by repository owner (username or org)
-w, --web Use the web version of Visual Studio Code
-c, --codespace string Name of the codespace
-e, --expand Expand remote file names on remote shell
-p, --profile string Name of the SSH profile to use
-r, --recursive Recursively copy directories
-R, --repo string Filter codespace selection by repository name (user/repo)
--repo-owner string Filter codespace selection by repository owner (username or org)
gh codespace create [flags]
Create a codespace
-b, --branch string repository branch
--default-permissions do not prompt to accept additional permissions requested by the codespace
--devcontainer-path string path to the devcontainer.json file to use when creating codespace
-d, --display-name string display name for the codespace
--idle-timeout duration allowed inactivity before codespace is stopped, e.g. "10m", "1h"
-l, --location string location: {EastUs|SouthEastAsia|WestEurope|WestUs2} (determined automatically if not provided)
-m, --machine string hardware specifications for the VM
-R, --repo string repository name with owner: user/repo
--retention-period duration allowed time after shutting down before the codespace is automatically deleted (maximum 30 days), e.g. "1h", "72h"
-s, --status show status of post-create command and dotfiles
-w, --web create codespace from browser, cannot be used with --display-name, --idle-timeout, or --retention-period
gh codespace delete [flags]
Delete codespaces
--all Delete all codespaces
-c, --codespace string Name of the codespace
--days N Delete codespaces older than N days
-f, --force Skip confirmation for codespaces that contain unsaved changes
-o, --org login The login handle of the organization (admin-only)
-R, --repo string Filter codespace selection by repository name (user/repo)
--repo-owner string Filter codespace selection by repository owner (username or org)
-u, --user username The username to delete codespaces for (used with --org)
gh codespace edit [flags]
Edit a codespace
-c, --codespace string Name of the codespace
-d, --display-name string Set the display name
-m, --machine string Set hardware specifications for the VM
-R, --repo string Filter codespace selection by repository name (user/repo)
--repo-owner string Filter codespace selection by repository owner (username or org)
gh codespace jupyter [flags]
Open a codespace in JupyterLab
-c, --codespace string Name of the codespace
-R, --repo string Filter codespace selection by repository name (user/repo)
--repo-owner string Filter codespace selection by repository owner (username or org)
gh codespace list [flags]
List codespaces
-q, --jq expression Filter JSON output using a jq expression
--json fields Output JSON with the specified fields
-L, --limit int Maximum number of codespaces to list (default 30)
-o, --org login The login handle of the organization to list codespaces for (admin-only)
-R, --repo string Repository name with owner: user/repo
-t, --template string Format JSON output using a Go template; see "gh help formatting"
-u, --user username The username to list codespaces for (used with --org)
-w, --web List codespaces in the web browser, cannot be used with --user or --org
gh codespace logs [flags]
Access codespace logs
-c, --codespace string Name of the codespace
-f, --follow Tail and follow the logs
-R, --repo string Filter codespace selection by repository name (user/repo)
--repo-owner string Filter codespace selection by repository owner (username or org)
gh codespace ports [flags]
List ports in a codespace
-c, --codespace string Name of the codespace
-q, --jq expression Filter JSON output using a jq expression
--json fields Output JSON with the specified fields
-R, --repo string Filter codespace selection by repository name (user/repo)
--repo-owner string Filter codespace selection by repository owner (username or org)
-t, --template string Format JSON output using a Go template; see "gh help formatting"
-c, --codespace string Name of the codespace
--full perform a full rebuild
-R, --repo string Filter codespace selection by repository name (user/repo)
--repo-owner string Filter codespace selection by repository owner (username or org)
-c, --codespace string Name of the codespace
--config Write OpenSSH configuration to stdout
-d, --debug Log debug data to a file
--debug-file string Path of the file log to
--profile string Name of the SSH profile to use
-R, --repo string Filter codespace selection by repository name (user/repo)
--repo-owner string Filter codespace selection by repository owner (username or org)
--server-port int SSH server port number (0 => pick unused)
gh codespace stop [flags]
Stop a running codespace
-c, --codespace string Name of the codespace
-o, --org login The login handle of the organization (admin-only)
-R, --repo string Filter codespace selection by repository name (user/repo)
--repo-owner string Filter codespace selection by repository owner (username or org)
-u, --user username The username to stop codespace for (used with --org)
gh codespace view [flags]
View details about a codespace
-c, --codespace string Name of the codespace
-q, --jq expression Filter JSON output using a jq expression
--json fields Output JSON with the specified fields
-R, --repo string Filter codespace selection by repository name (user/repo)
--repo-owner string Filter codespace selection by repository owner (username or org)
-t, --template string Format JSON output using a Go template; see "gh help formatting"
Update configuration with a value for the given key
-h, --host string Set per-host setting
gh contribute
Extension contribute
gh cp
Extension cp
gh dash
Extension dash
gh eco
Extension eco
gh extension
Manage gh extensions
gh extension browse [flags]
Enter a UI for browsing, adding, and removing extensions
--debug log to /tmp/extBrowse-*
-s, --single-column Render TUI with only one column of text
gh extension create [<name>] [flags]
Create a new extension
--precompiled string Create a precompiled extension. Possible values: go, other
gh extension exec <name> [args]
Execute an installed extension
gh extension install <repository> [flags]
Install a gh extension from a repository
--force force upgrade extension, or ignore if latest already installed
--pin string pin extension to a release tag or commit ref
gh extension list
List installed extension commands
gh extension remove <name>
Remove an installed extension
gh extension search [<query>] [flags]
Search extensions to the GitHub CLI
-q, --jq expression Filter JSON output using a jq expression
--json fields Output JSON with the specified fields
--license strings Filter based on license type
-L, --limit int Maximum number of extensions to fetch (default 30)
--order string Order of repositories returned, ignored unless '--sort' flag is specified: {asc|desc} (default "desc")
--owner strings Filter on owner
--sort string Sort fetched repositories: {forks|help-wanted-issues|stars|updated} (default "best-match")
-t, --template string Format JSON output using a Go template; see "gh help formatting"
-w, --web Open the search query in the web browser
gh extension upgrade {<name> | --all} [flags]
Upgrade installed extensions
--all Upgrade all extensions
--dry-run Only display upgrades
--force Force upgrade extension
-d, --desc string A description for this gist
-f, --filename string Provide a filename to be used when reading from standard input
-p, --public List the gist publicly (default: secret)
-w, --web Open the web browser with created gist
gh gist delete {<id> | <url>}
Delete a gist
gh gist edit {<id> | <url>} [<filename>] [flags]
Edit one of your gists
-a, --add string Add a new file to the gist
-d, --desc string New description for the gist
-f, --filename string Select a file to edit
-r, --remove string Remove a file from the gist
gh gist list [flags]
List your gists
-L, --limit int Maximum number of gists to fetch (default 10)
--public Show only public gists
--secret Show only secret gists
-f, --filename string Display a single file from the gist
--files List file names from the gist
-r, --raw Print raw instead of rendered gist contents
-w, --web Open gist in the browser
gh gpg-key <command>
Manage GPG keys
gh gpg-key add [<key-file>] [flags]
Add a GPG key to your GitHub account
-t, --title string Title for the new key
gh gpg-key delete <key-id> [flags]
Delete a GPG key from your GitHub account
-y, --yes Skip the confirmation prompt
gh gpg-key list
Lists GPG keys in your GitHub account
gh grep
Extension grep
gh i
Extension i
gh install
Extension install
gh issue <command>
Manage issues
gh issue close {<number> | <url>} [flags]
Close issue
-c, --comment string Leave a closing comment
-r, --reason string Reason for closing: {completed|not planned}
gh issue comment {<number> | <url>} [flags]
Add a comment to an issue
-b, --body text The comment body text
-F, --body-file file Read body text from file (use "-" to read from standard input)
--edit-last Edit the last comment of the same author
-e, --editor Skip prompts and open the text editor to write the body in
-w, --web Open the web browser to write the comment
gh issue create [flags]
Create a new issue
-a, --assignee login Assign people by their login. Use "@me" to self-assign.
-b, --body string Supply a body. Will prompt for one otherwise.
-F, --body-file file Read body text from file (use "-" to read from standard input)
-l, --label name Add labels by name
-m, --milestone name Add the issue to a milestone by name
-p, --project name Add the issue to projects by name
--recover string Recover input from a failed run of create
-T, --template name Template name to use as starting body text
-t, --title string Supply a title. Will prompt for one otherwise.
-w, --web Open the browser to create an issue
gh issue delete {<number> | <url>} [flags]
Delete issue
--yes confirm deletion without prompting
gh issue develop {<number> | <url>} [flags]
Manage linked branches for an issue
-b, --base string Name of the base branch you want to make your new branch from
--branch-repo string Name or URL of the repository where you want to create your new branch
-c, --checkout Checkout the branch after creating it
-l, --list List linked branches for the issue
-n, --name string Name of the branch to create
gh issue edit {<numbers> | <urls>} [flags]
Edit issues
--add-assignee login Add assigned users by their login. Use "@me" to assign yourself.
--add-label name Add labels by name
--add-project name Add the issue to projects by name
-b, --body string Set the new body.
-F, --body-file file Read body text from file (use "-" to read from standard input)
-m, --milestone name Edit the milestone the issue belongs to by name
--remove-assignee login Remove assigned users by their login. Use "@me" to unassign yourself.
--remove-label name Remove labels by name
--remove-project name Remove the issue from projects by name
-t, --title string Set the new title.
gh issue list [flags]
List issues in a repository
--app string Filter by GitHub App author
-a, --assignee string Filter by assignee
-A, --author string Filter by author
-q, --jq expression Filter JSON output using a jq expression
--json fields Output JSON with the specified fields
-l, --label strings Filter by label
-L, --limit int Maximum number of issues to fetch (default 30)
--mention string Filter by mention
-m, --milestone string Filter by milestone number or title
-S, --search query Search issues with query
-s, --state string Filter by state: {open|closed|all} (default "open")
-t, --template string Format JSON output using a Go template; see "gh help formatting"
-w, --web List issues in the web browser
-q, --jq expression Filter JSON output using a jq expression
--json fields Output JSON with the specified fields
-t, --template string Format JSON output using a Go template; see "gh help formatting"
gh issue transfer {<number> | <url>} <destination-repo>
Transfer issue to another repository
gh issue unlock {<number> | <url>}
Unlock issue conversation
gh issue unpin {<number> | <url>}
Unpin a issue
gh issue view {<number> | <url>} [flags]
View an issue
-c, --comments View issue comments
-q, --jq expression Filter JSON output using a jq expression
--json fields Output JSON with the specified fields
-t, --template string Format JSON output using a Go template; see "gh help formatting"
-w, --web Open an issue in the browser
gh label <command>
Manage labels
gh label clone <source-repository> [flags]
Clones labels from one repository to another
-f, --force Overwrite labels in the destination repository
gh label create <name> [flags]
Create a new label
-c, --color string Color of the label
-d, --description string Description of the label
-f, --force Update the label color and description if label already exists
gh label delete <name> [flags]
Delete a label from a repository
--yes Confirm deletion without prompting
gh label edit <name> [flags]
Edit a label
-c, --color string Color of the label
-d, --description string Description of the label
-n, --name string New name of the label
gh label list [flags]
List labels in a repository
-q, --jq expression Filter JSON output using a jq expression
--json fields Output JSON with the specified fields
-L, --limit int Maximum number of labels to fetch (default 30)
--order string Order of labels returned: {asc|desc} (default "asc")
-S, --search string Search label names and descriptions
--sort string Sort fetched labels: {created|name} (default "created")
-t, --template string Format JSON output using a Go template; see "gh help formatting"
-w, --web List labels in the web browser
gh markdown-preview
Extension markdown-preview
gh notify
Extension notify
gh org <command>
Manage organizations
gh org list [flags]
List organizations for the authenticated user.
-L, --limit int Maximum number of organizations to list (default 30)
gh pr <command> [flags]
Manage pull requests
--help Show help for command
-R, --repo [HOST/]OWNER/REPO Select another repository using the [HOST/]OWNER/REPO format
-b, --branch string Local branch name to use (default: the name of the head branch)
--detach Checkout PR with a detached HEAD
-f, --force Reset the existing local branch to the latest state of the pull request
--recurse-submodules Update all submodules after checkout
--fail-fast Exit watch mode on first check failure
-i, --interval --watch Refresh interval in seconds when using --watch flag (default 10)
--required Only show checks that are required
--watch Watch checks until they finish
-w, --web Open the web browser to show details about checks
gh pr close {<number> | <url> | <branch>} [flags]
Close a pull request
-c, --comment string Leave a closing comment
-d, --delete-branch Delete the local and remote branch after close
-b, --body text The comment body text
-F, --body-file file Read body text from file (use "-" to read from standard input)
--edit-last Edit the last comment of the same author
-e, --editor Skip prompts and open the text editor to write the body in
-w, --web Open the web browser to write the comment
gh pr create [flags]
Create a pull request
-a, --assignee login Assign people by their login. Use "@me" to self-assign.
-B, --base branch The branch into which you want your code merged
-b, --body string Body for the pull request
-F, --body-file file Read body text from file (use "-" to read from standard input)
-d, --draft Mark pull request as a draft
-f, --fill Do not prompt for title/body and just use commit info
--fill-first Do not prompt for title/body and just use first commit info
-H, --head branch The branch that contains commits for your pull request (default: current branch)
-l, --label name Add labels by name
-m, --milestone name Add the pull request to a milestone by name
--no-maintainer-edit Disable maintainer's ability to modify pull request
-p, --project name Add the pull request to projects by name
--recover string Recover input from a failed run of create
-r, --reviewer handle Request reviews from people or teams by their handle
-T, --template file Template file to use as starting body text
-t, --title string Title for the pull request
-w, --web Open the web browser to create a pull request
gh pr diff [<number> | <url> | <branch>] [flags]
View changes in a pull request
--color string Use color in diff output: {always|never|auto} (default "auto")
--name-only Display only names of changed files
--patch Display diff in patch format
-w, --web Open the pull request diff in the browser
gh pr edit [<number> | <url> | <branch>] [flags]
Edit a pull request
--add-assignee login Add assigned users by their login. Use "@me" to assign yourself.
--add-label name Add labels by name
--add-project name Add the pull request to projects by name
--add-reviewer login Add reviewers by their login.
-B, --base branch Change the base branch for this pull request
-b, --body string Set the new body.
-F, --body-file file Read body text from file (use "-" to read from standard input)
-m, --milestone name Edit the milestone the pull request belongs to by name
--remove-assignee login Remove assigned users by their login. Use "@me" to unassign yourself.
--remove-label name Remove labels by name
--remove-project name Remove the pull request from projects by name
--remove-reviewer login Remove reviewers by their login.
-t, --title string Set the new title.
gh pr list [flags]
List pull requests in a repository
--app string Filter by GitHub App author
-a, --assignee string Filter by assignee
-A, --author string Filter by author
-B, --base string Filter by base branch
-d, --draft Filter by draft state
-H, --head string Filter by head branch
-q, --jq expression Filter JSON output using a jq expression
--json fields Output JSON with the specified fields
-l, --label strings Filter by label
-L, --limit int Maximum number of items to fetch (default 30)
-S, --search query Search pull requests with query
-s, --state string Filter by state: {open|closed|merged|all} (default "open")
-t, --template string Format JSON output using a Go template; see "gh help formatting"
-w, --web List pull requests in the web browser
--admin Use administrator privileges to merge a pull request that does not meet requirements
-A, --author-email text Email text for merge commit author
--auto Automatically merge only after necessary requirements are met
-b, --body text Body text for the merge commit
-F, --body-file file Read body text from file (use "-" to read from standard input)
-d, --delete-branch Delete the local and remote branch after merge
--disable-auto Disable auto-merge for this pull request
--match-head-commit SHA Commit SHA that the pull request head must match to allow merge
-m, --merge Merge the commits with the base branch
-r, --rebase Rebase the commits onto the base branch
-s, --squash Squash the commits into one commit and merge it into the base branch
-t, --subject text Subject text for the merge commit
-a, --approve Approve pull request
-b, --body string Specify the body of a review
-F, --body-file file Read body text from file (use "-" to read from standard input)
-c, --comment Comment on a pull request
-r, --request-changes Request changes on a pull request
gh pr status [flags]
Show status of relevant pull requests
-c, --conflict-status Display the merge conflict status of each pull request
-q, --jq expression Filter JSON output using a jq expression
--json fields Output JSON with the specified fields
-t, --template string Format JSON output using a Go template; see "gh help formatting"
gh pr unlock {<number> | <url>}
Unlock pull request conversation
gh pr view [<number> | <url> | <branch>] [flags]
View a pull request
-c, --comments View pull request comments
-q, --jq expression Filter JSON output using a jq expression
--json fields Output JSON with the specified fields
-t, --template string Format JSON output using a Go template; see "gh help formatting"
-w, --web Open a pull request in the browser
gh project <command>
Work with GitHub Projects.
gh project close [<number>] [flags]
Close a project
--format string Output format, must be 'json'
--owner string Login of the owner. Use "@me" for the current user.
--undo Reopen a closed project
gh project copy [<number>] [flags]
Copy a project
--drafts Include draft issues when copying
--format string Output format: {json}
--source-owner string Login of the source owner. Use "@me" for the current user.
--target-owner string Login of the target owner. Use "@me" for the current user.
--title string Title for the new project
gh project create [flags]
Create a project
--format string Output format: {json}
--owner string Login of the owner. Use "@me" for the current user.
--title string Title for the project
gh project delete [<number>] [flags]
Delete a project
--format string Output format: {json}
--owner string Login of the owner. Use "@me" for the current user.
gh project edit [<number>] [flags]
Edit a project
-d, --description string New description of the project
--format string Output format: {json}
--owner string Login of the owner. Use "@me" for the current user.
--readme string New readme for the project
--title string New title for the project
--visibility string Change project visibility: {PUBLIC|PRIVATE}
gh project field-create [<number>] [flags]
Create a field in a project
--data-type string DataType of the new field.: {TEXT|SINGLE_SELECT|DATE|NUMBER}
--format string Output format: {json}
--name string Name of the new field
--owner string Login of the owner. Use "@me" for the current user.
--single-select-options strings Options for SINGLE_SELECT data type
gh project field-delete [flags]
Delete a field in a project
--format string Output format: {json}
--id string ID of the field to delete
gh project field-list number [flags]
List the fields in a project
--format string Output format: {json}
-L, --limit int Maximum number of fields to fetch (default 30)
--owner string Login of the owner. Use "@me" for the current user.
gh project item-add [<number>] [flags]
Add a pull request or an issue to a project
--format string Output format: {json}
--owner string Login of the owner. Use "@me" for the current user.
--url string URL of the issue or pull request to add to the project
gh project item-archive [<number>] [flags]
Archive an item in a project
--format string Output format: {json}
--id string ID of the item to archive
--owner string Login of the owner. Use "@me" for the current user.
--undo Unarchive an item
gh project item-create [<number>] [flags]
Create a draft issue item in a project
--body string Body for the draft issue
--format string Output format: {json}
--owner string Login of the owner. Use "@me" for the current user.
--title string Title for the draft issue
gh project item-delete [<number>] [flags]
Delete an item from a project by ID
--format string Output format: {json}
--id string ID of the item to delete
--owner string Login of the owner. Use "@me" for the current user.
gh project item-edit [flags]
Edit an item in a project
--body string Body of the draft issue item
--date string Date value for the field (YYYY-MM-DD)
--field-id string ID of the field to update
--format string Output format: {json}
--id string ID of the item to edit
--iteration-id string ID of the iteration value to set on the field
--number float32 Number value for the field
--project-id string ID of the project to which the field belongs to
--single-select-option-id string ID of the single select option value to set on the field
--text string Text value for the field
--title string Title of the draft issue item
gh project item-list [<number>] [flags]
List the items in a project
--format string Output format: {json}
-L, --limit int Maximum number of items to fetch (default 30)
--owner string Login of the owner. Use "@me" for the current user.
gh project list [flags]
List the projects for an owner
--closed Include closed projects
--format string Output format: {json}
-L, --limit int Maximum number of projects to fetch (default 30)
--owner string Login of the owner
-w, --web Open projects list in the browser
gh project view [<number>] [flags]
View a project
--format string Output format: {json}
--owner string Login of the owner. Use "@me" for the current user.
-w, --web Open a project in the browser
gh quickcs
Extension quickcs
gh release <command>
Manage releases
gh release create [<tag>] [<files>...]
Create a new release
--discussion-category string Start a discussion in the specified category
-d, --draft Save the release as a draft instead of publishing it
--generate-notes Automatically generate title and notes for the release
--latest Mark this release as "Latest" (default: automatic based on date and version)
-n, --notes string Release notes
-F, --notes-file file Read release notes from file (use "-" to read from standard input)
--notes-start-tag string Tag to use as the starting point for generating release notes
-p, --prerelease Mark the release as a prerelease
--target branch Target branch or full commit SHA (default: main branch)
-t, --title string Release title
--verify-tag Abort in case the git tag doesn't already exist in the remote repository
gh release delete <tag> [flags]
Delete a release
--cleanup-tag Delete the specified tag in addition to its release
-A, --archive format Download the source code archive in the specified format (zip or tar.gz)
--clobber Overwrite existing files of the same name
-D, --dir directory The directory to download files into (default ".")
-O, --output file The file to write a single asset to (use "-" to write to standard output)
-p, --pattern stringArray Download only assets that match a glob pattern
--skip-existing Skip downloading when files of the same name exist
gh release edit <tag>
Edit a release
--discussion-category string Start a discussion in the specified category when publishing a draft
--draft Save the release as a draft instead of publishing it
--latest Explicitly mark the release as "Latest"
-n, --notes string Release notes
-F, --notes-file file Read release notes from file (use "-" to read from standard input)
--prerelease Mark the release as a prerelease
--tag string The name of the tag
--target branch Target branch or full commit SHA (default: main branch)
-t, --title string Release title
--verify-tag Abort in case the git tag doesn't already exist in the remote repository
-L, --limit int Maximum number of items to fetch (default 30)
gh release upload <tag> <files>... [flags]
Upload assets to a release
--clobber Overwrite existing assets of the same name
gh release view [<tag>] [flags]
View information about a release
-q, --jq expression Filter JSON output using a jq expression
--json fields Output JSON with the specified fields
-t, --template string Format JSON output using a Go template; see "gh help formatting"
-w, --web Open the release in the browser
-u, --upstream-remote-name string Upstream remote name when cloning a fork (default "upstream")
gh repo create [<name>] [flags]
Create a new repository
--add-readme Add a README file to the new repository
-c, --clone Clone the new repository to the current directory
-d, --description string Description of the repository
--disable-issues Disable issues in the new repository
--disable-wiki Disable wiki in the new repository
-g, --gitignore string Specify a gitignore template for the repository
-h, --homepage URL Repository home page URL
--include-all-branches Include all branches from template repository
--internal Make the new repository internal
-l, --license string Specify an Open Source License for the repository
--private Make the new repository private
--public Make the new repository public
--push Push local commits to the new repository
-r, --remote string Specify remote name for the new repository
-s, --source string Specify path to local repository to use as source
-t, --team name The name of the organization team to be granted access
-p, --template repository Make the new repository based on a template repository
gh repo delete [<repository>] [flags]
Delete a repository
--yes confirm deletion without prompting
gh repo deploy-key <command>
Manage deploy keys in a repository
gh repo deploy-key add <key-file> [flags]
Add a deploy key to a GitHub repository
-w, --allow-write Allow write access for the key
-t, --title string Title of the new key
gh repo deploy-key delete <key-id>
Delete a deploy key from a GitHub repository
gh repo deploy-key list
List deploy keys in a GitHub repository
gh repo edit [<repository>] [flags]
Edit repository settings
--add-topic strings Add repository topic
--allow-forking Allow forking of an organization repository
--allow-update-branch Allow a pull request head branch that is behind its base branch to be updated
--default-branch name Set the default branch name for the repository
--delete-branch-on-merge Delete head branch when pull requests are merged
-d, --description string Description of the repository
--enable-auto-merge Enable auto-merge functionality
--enable-discussions Enable discussions in the repository
--enable-issues Enable issues in the repository
--enable-merge-commit Enable merging pull requests via merge commit
--enable-projects Enable projects in the repository
--enable-rebase-merge Enable merging pull requests via rebase
--enable-squash-merge Enable merging pull requests via squashed commit
--enable-wiki Enable wiki in the repository
-h, --homepage URL Repository home page URL
--remove-topic strings Remove repository topic
--template Make the repository available as a template repository
--visibility string Change the visibility of the repository to {public,private,internal}
--clone Clone the fork
--default-branch-only Only include the default branch in the fork
--fork-name string Rename the forked repository
--org string Create the fork in an organization
--remote Add a git remote for the fork
--remote-name string Specify the name for the new remote (default "origin")
gh repo list [<owner>] [flags]
List repositories owned by user or organization
--archived Show only archived repositories
--fork Show only forks
-q, --jq expression Filter JSON output using a jq expression
--json fields Output JSON with the specified fields
-l, --language string Filter by primary coding language
-L, --limit int Maximum number of repositories to list (default 30)
--no-archived Omit archived repositories
--source Show only non-forks
-t, --template string Format JSON output using a Go template; see "gh help formatting"
--topic strings Filter by topic
--visibility string Filter by repository visibility: {public|private|internal}
gh repo rename [<new-name>] [flags]
Rename a repository
-y, --yes Skip the confirmation prompt
gh repo set-default [<repository>] [flags]
Configure default repository for this directory
-u, --unset unset the current default repository
-v, --view view the current default repository
gh repo sync [<destination-repository>] [flags]
Sync a repository
-b, --branch string Branch to sync (default: main branch)
--force Hard reset the branch of the destination repository to match the source repository
-s, --source string Source repository
gh repo unarchive [<repository>] [flags]
Unarchive a repository
-y, --yes Skip the confirmation prompt
gh repo view [<repository>] [flags]
View a repository
-b, --branch string View a specific branch of the repository
-q, --jq expression Filter JSON output using a jq expression
--json fields Output JSON with the specified fields
-t, --template string Format JSON output using a Go template; see "gh help formatting"
-w, --web Open a repository in the browser
gh repo-explore
Extension repo-explore
gh ruleset <command>
View info about repo rulesets
gh ruleset check [<branch>] [flags]
View rules that would apply to a given branch
--default Check rules on default branch
-w, --web Open the branch rules page in a web browser
gh ruleset list [flags]
List rulesets for a repository or organization
-L, --limit int Maximum number of rulesets to list (default 30)
-o, --org string List organization-wide rulesets for the provided organization
-p, --parents Whether to include rulesets configured at higher levels that also apply (default true)
-w, --web Open the list of rulesets in the web browser
gh ruleset view [<ruleset-id>] [flags]
View information about a ruleset
-o, --org string Organization name if the provided ID is an organization-level ruleset
-p, --parents Whether to include rulesets configured at higher levels that also apply (default true)
-w, --web Open the ruleset in the browser
gh run <command>
View details about workflow runs
gh run cancel [<run-id>]
Cancel a workflow run
gh run delete [<run-id>]
Delete a workflow run
gh run download [<run-id>] [flags]
Download artifacts generated by a workflow run
-D, --dir string The directory to download artifacts into (default ".")
-n, --name stringArray Download artifacts that match any of the given names
-p, --pattern stringArray Download artifacts that match a glob pattern
gh run list [flags]
List recent workflow runs
-b, --branch string Filter runs by branch
--created date Filter runs by the date it was created
-e, --event event Filter runs by which event triggered the run
-q, --jq expression Filter JSON output using a jq expression
--json fields Output JSON with the specified fields
-L, --limit int Maximum number of runs to fetch (default 20)
-s, --status string Filter runs by status: {queued|completed|in_progress|requested|waiting|action_required|cancelled|failure|neutral|skipped|stale|startup_failure|success|timed_out}
-t, --template string Format JSON output using a Go template; see "gh help formatting"
-u, --user string Filter runs by user who triggered the run
-w, --workflow string Filter runs by workflow
gh run rerun [<run-id>] [flags]
Rerun a run
-d, --debug Rerun with debug logging
--failed Rerun only failed jobs, including dependencies
-j, --job string Rerun a specific job from a run, including dependencies
gh run view [<run-id>] [flags]
View a summary of a workflow run
-a, --attempt uint The attempt number of the workflow run
--exit-status Exit with non-zero status if run failed
-j, --job string View a specific job ID from a run
-q, --jq expression Filter JSON output using a jq expression
--json fields Output JSON with the specified fields
--log View full log for either a run or specific job
--log-failed View the log for any failed steps in a run or specific job
-t, --template string Format JSON output using a Go template; see "gh help formatting"
-v, --verbose Show job steps
-w, --web Open run in the browser
gh run watch <run-id> [flags]
Watch a run until it completes, showing its progress
--exit-status Exit with non-zero status if run fails
-i, --interval int Refresh interval in seconds (default 3)
gh s
Extension s
gh search <command>
Search for repositories, issues, and pull requests
gh search code <query> [flags]
Search within code
--extension string Filter on file extension
--filename string Filter on filename
-q, --jq expression Filter JSON output using a jq expression
--json fields Output JSON with the specified fields
--language string Filter results by language
-L, --limit int Maximum number of code results to fetch (default 30)
--match strings Restrict search to file contents or file path: {file|path}
--owner strings Filter on owner
-R, --repo strings Filter on repository
--size string Filter on size range, in kilobytes
-t, --template string Format JSON output using a Go template; see "gh help formatting"
-w, --web Open the search query in the web browser
gh search commits [<query>] [flags]
Search for commits
--author string Filter by author
--author-date date Filter based on authored date
--author-email string Filter on author email
--author-name string Filter on author name
--committer string Filter by committer
--committer-date date Filter based on committed date
--committer-email string Filter on committer email
--committer-name string Filter on committer name
--hash string Filter by commit hash
-q, --jq expression Filter JSON output using a jq expression
--json fields Output JSON with the specified fields
-L, --limit int Maximum number of commits to fetch (default 30)
--merge Filter on merge commits
--order string Order of commits returned, ignored unless '--sort' flag is specified: {asc|desc} (default "desc")
--owner strings Filter on repository owner
--parent string Filter by parent hash
-R, --repo strings Filter on repository
--sort string Sort fetched commits: {author-date|committer-date} (default "best-match")
-t, --template string Format JSON output using a Go template; see "gh help formatting"
--tree string Filter by tree hash
--visibility strings Filter based on repository visibility: {public|private|internal}
-w, --web Open the search query in the web browser
gh search issues [<query>] [flags]
Search for issues
--app string Filter by GitHub App author
--archived Restrict search to archived repositories
--assignee string Filter by assignee
--author string Filter by author
--closed date Filter on closed at date
--commenter user Filter based on comments by user
--comments number Filter on number of comments
--created date Filter based on created at date
--include-prs Include pull requests in results
--interactions number Filter on number of reactions and comments
--involves user Filter based on involvement of user
-q, --jq expression Filter JSON output using a jq expression
--json fields Output JSON with the specified fields
--label strings Filter on label
--language string Filter based on the coding language
-L, --limit int Maximum number of results to fetch (default 30)
--locked Filter on locked conversation status
--match strings Restrict search to specific field of issue: {title|body|comments}
--mentions user Filter based on user mentions
--milestone title Filter by milestone title
--no-assignee Filter on missing assignee
--no-label Filter on missing label
--no-milestone Filter on missing milestone
--no-project Filter on missing project
--order string Order of results returned, ignored unless '--sort' flag is specified: {asc|desc} (default "desc")
--owner strings Filter on repository owner
--project number Filter on project board number
--reactions number Filter on number of reactions
-R, --repo strings Filter on repository
--sort string Sort fetched results: {comments|created|interactions|reactions|reactions-+1|reactions--1|reactions-heart|reactions-smile|reactions-tada|reactions-thinking_face|updated} (default "best-match")
--state string Filter based on state: {open|closed}
--team-mentions string Filter based on team mentions
-t, --template string Format JSON output using a Go template; see "gh help formatting"
--updated date Filter on last updated at date
--visibility strings Filter based on repository visibility: {public|private|internal}
-w, --web Open the search query in the web browser
gh search prs [<query>] [flags]
Search for pull requests
--app string Filter by GitHub App author
--archived Restrict search to archived repositories
--assignee string Filter by assignee
--author string Filter by author
-B, --base string Filter on base branch name
--checks string Filter based on status of the checks: {pending|success|failure}
--closed date Filter on closed at date
--commenter user Filter based on comments by user
--comments number Filter on number of comments
--created date Filter based on created at date
--draft Filter based on draft state
-H, --head string Filter on head branch name
--interactions number Filter on number of reactions and comments
--involves user Filter based on involvement of user
-q, --jq expression Filter JSON output using a jq expression
--json fields Output JSON with the specified fields
--label strings Filter on label
--language string Filter based on the coding language
-L, --limit int Maximum number of results to fetch (default 30)
--locked Filter on locked conversation status
--match strings Restrict search to specific field of issue: {title|body|comments}
--mentions user Filter based on user mentions
--merged Filter based on merged state
--merged-at date Filter on merged at date
--milestone title Filter by milestone title
--no-assignee Filter on missing assignee
--no-label Filter on missing label
--no-milestone Filter on missing milestone
--no-project Filter on missing project
--order string Order of results returned, ignored unless '--sort' flag is specified: {asc|desc} (default "desc")
--owner strings Filter on repository owner
--project number Filter on project board number
--reactions number Filter on number of reactions
-R, --repo strings Filter on repository
--review string Filter based on review status: {none|required|approved|changes_requested}
--review-requested user Filter on user or team requested to review
--reviewed-by user Filter on user who reviewed
--sort string Sort fetched results: {comments|reactions|reactions-+1|reactions--1|reactions-smile|reactions-thinking_face|reactions-heart|reactions-tada|interactions|created|updated} (default "best-match")
--state string Filter based on state: {open|closed}
--team-mentions string Filter based on team mentions
-t, --template string Format JSON output using a Go template; see "gh help formatting"
--updated date Filter on last updated at date
--visibility strings Filter based on repository visibility: {public|private|internal}
-w, --web Open the search query in the web browser
gh search repos [<query>] [flags]
Search for repositories
--archived Filter based on archive state
--created date Filter based on created at date
--followers number Filter based on number of followers
--forks number Filter on number of forks
--good-first-issues number Filter on number of issues with the 'good first issue' label
--help-wanted-issues number Filter on number of issues with the 'help wanted' label
--include-forks string Include forks in fetched repositories: {false|true|only}
-q, --jq expression Filter JSON output using a jq expression
--json fields Output JSON with the specified fields
--language string Filter based on the coding language
--license strings Filter based on license type
-L, --limit int Maximum number of repositories to fetch (default 30)
--match strings Restrict search to specific field of repository: {name|description|readme}
--number-topics number Filter on number of topics
--order string Order of repositories returned, ignored unless '--sort' flag is specified: {asc|desc} (default "desc")
--owner strings Filter on owner
--size string Filter on a size range, in kilobytes
--sort string Sort fetched repositories: {forks|help-wanted-issues|stars|updated} (default "best-match")
--stars number Filter on number of stars
-t, --template string Format JSON output using a Go template; see "gh help formatting"
--topic strings Filter on topic
--updated date Filter on last updated at date
--visibility strings Filter based on visibility: {public|private|internal}
-w, --web Open the search query in the web browser
gh secret <command>
Manage GitHub secrets
gh secret delete <secret-name> [flags]
Delete secrets
-a, --app string Delete a secret for a specific application: {actions|codespaces|dependabot}
-e, --env string Delete a secret for an environment
-o, --org string Delete a secret for an organization
-u, --user Delete a secret for your user
gh secret list [flags]
List secrets
-a, --app string List secrets for a specific application: {actions|codespaces|dependabot}
-e, --env string List secrets for an environment
-o, --org string List secrets for an organization
-u, --user List a secret for your user
gh secret set <secret-name> [flags]
Create or update secrets
-a, --app string Set the application for a secret: {actions|codespaces|dependabot}
-b, --body string The value for the secret (reads from standard input if not specified)
-e, --env environment Set deployment environment secret
-f, --env-file file Load secret names and values from a dotenv-formatted file
--no-store Print the encrypted, base64-encoded value instead of storing it on Github
-o, --org organization Set organization secret
-r, --repos repositories List of repositories that can access an organization or user secret
-u, --user Set a secret for your user
-v, --visibility string Set visibility for an organization secret: {all|private|selected} (default "private")
gh ssh-key <command>
Manage SSH keys
gh ssh-key add [<key-file>] [flags]
Add an SSH key to your GitHub account
-t, --title string Title for the new key
--type string Type of the ssh key: {authentication|signing} (default "authentication")
gh ssh-key delete <id> [flags]
Delete an SSH key from your GitHub account
-y, --yes Skip the confirmation prompt
gh ssh-key list
Lists SSH keys in your GitHub account
gh status [flags]
Print information about relevant issues, pull requests, and notifications across repositories
-e, --exclude strings Comma separated list of repos to exclude in owner/name format
-o, --org string Report status within an organization
gh todo
Extension todo
gh triage
Extension triage
gh user-stars
Extension user-stars
gh userfetch
Extension userfetch
gh variable <command>
Manage GitHub Actions variables
gh variable delete <variable-name> [flags]
Delete variables
-e, --env string Delete a variable for an environment
-o, --org string Delete a variable for an organization
gh variable list [flags]
List variables
-e, --env string List variables for an environment
-o, --org string List variables for an organization
gh variable set <variable-name> [flags]
Create or update variables
-b, --body string The value for the variable (reads from standard input if not specified)
-e, --env environment Set deployment environment variable
-f, --env-file file Load variable names and values from a dotenv-formatted file
-o, --org organization Set organization variable
-r, --repos repositories List of repositories that can access an organization variable
-v, --visibility string Set visibility for an organization variable: {all|private|selected} (default "private")
-a, --all Also show disabled workflows
-L, --limit int Maximum number of workflows to fetch (default 50)
gh workflow run [<workflow-id> | <workflow-name>] [flags]
Run a workflow by creating a workflow_dispatch event
-F, --field key=value Add a string parameter in key=value format, respecting @ syntax
--json Read workflow inputs as JSON via STDIN
-f, --raw-field key=value Add a string parameter in key=value format
-r, --ref string The branch or tag name which contains the version of the workflow file you'd like to run
-r, --ref string The branch or tag name which contains the version of the workflow file you'd like to view
-w, --web Open workflow in the browser
-y, --yaml View the workflow yaml file
gh xplr
Extension xplr
The text was updated successfully, but these errors were encountered:
gh reference
gh act
Extension act
gh alias <command>
Create command shortcuts
gh alias delete <alias>
Delete an alias
gh alias import [<filename> | -] [flags]
Import aliases from a YAML file
--clobber Overwrite existing aliases of the same name
gh alias list
List your aliases
gh alias set <alias> <expansion> [flags]
Create a shortcut for a gh command
-s, --shell Declare an alias to be passed through a shell interpreter
gh api <endpoint> [flags]
Make an authenticated GitHub API request
-F, --field key=value Add a typed parameter in key=value format
-H, --header key:value Add a HTTP request header in key:value format
--hostname string The GitHub hostname for the request (default "github.com")
-i, --include Include HTTP response status line and headers in the output
--input file The file to use as body for the HTTP request (use "-" to read from standard input)
-q, --jq string Query to select values from the response using jq syntax
-X, --method string The HTTP method for the request (default "GET")
--paginate Make additional HTTP requests to fetch all pages of results
-p, --preview names GitHub API preview names to request (without the "-preview" suffix)
-f, --raw-field key=value Add a string parameter in key=value format
--silent Do not print the response body
-t, --template string Format JSON output using a Go template; see "gh help formatting"
gh auth <command>
Authenticate gh and git with GitHub
gh auth login [flags]
Authenticate with a GitHub host
-p, --git-protocol string The protocol to use for git operations: {ssh|https}
-h, --hostname string The hostname of the GitHub instance to authenticate with
--insecure-storage Save authentication credentials in plain text instead of credential store
-s, --scopes strings Additional authentication scopes to request
-w, --web Open a browser to authenticate
--with-token Read token from standard input
gh auth logout [flags]
Log out of a GitHub host
-h, --hostname string The hostname of the GitHub instance to log out of
gh auth refresh [flags]
Refresh stored authentication credentials
-h, --hostname string The GitHub host to use for authentication
--insecure-storage Save authentication credentials in plain text instead of credential store
-r, --remove-scopes strings Authentication scopes to remove from gh
--reset-scopes Reset authentication scopes to the default minimum set of scopes
-s, --scopes strings Additional authentication scopes for gh to have
gh auth setup-git [flags]
Setup git with GitHub CLI
-h, --hostname string The hostname to configure git for
gh auth status [flags]
View authentication status
-h, --hostname string Check a specific hostname's auth status
-t, --show-token Display the auth token
gh auth token [flags]
Print the auth token gh is configured to use
-h, --hostname string The hostname of the GitHub instance authenticated with
gh browse [<number> | <path> | <commit-SHA>] [flags]
Open the repository in the browser
-b, --branch string Select another branch by passing in the branch name
-c, --commit string[="last"] Select another commit by passing in the commit SHA, default is the last commit
-n, --no-browser Print destination URL instead of opening the browser
-p, --projects Open repository projects
-r, --releases Open repository releases
-s, --settings Open repository settings
-w, --wiki Open repository wiki
gh cache <command>
Manage Github Actions caches
gh cache delete [<cache-id>| <cache-key> | --all] [flags]
Delete Github Actions caches
-a, --all Delete all caches
gh cache list [flags]
List Github Actions caches
-L, --limit int Maximum number of caches to fetch (default 30)
-O, --order string Order of caches returned: {asc|desc} (default "desc")
-S, --sort string Sort fetched caches: {created_at|last_accessed_at|size_in_bytes} (default "last_accessed_at")
gh changelog
Extension changelog
gh clone-org
Extension clone-org
gh co
Alias for "pr checkout"
gh codeql
Extension codeql
gh codespace
Connect to and manage codespaces
gh codespace code [flags]
Open a codespace in Visual Studio Code
-c, --codespace string Name of the codespace
--insiders Use the insiders version of Visual Studio Code
-R, --repo string Filter codespace selection by repository name (user/repo)
--repo-owner string Filter codespace selection by repository owner (username or org)
-w, --web Use the web version of Visual Studio Code
gh codespace cp [-e] [-r] [-- [<scp flags>...]] <sources>... <dest>
Copy files between local and remote file systems
-c, --codespace string Name of the codespace
-e, --expand Expand remote file names on remote shell
-p, --profile string Name of the SSH profile to use
-r, --recursive Recursively copy directories
-R, --repo string Filter codespace selection by repository name (user/repo)
--repo-owner string Filter codespace selection by repository owner (username or org)
gh codespace create [flags]
Create a codespace
-b, --branch string repository branch
--default-permissions do not prompt to accept additional permissions requested by the codespace
--devcontainer-path string path to the devcontainer.json file to use when creating codespace
-d, --display-name string display name for the codespace
--idle-timeout duration allowed inactivity before codespace is stopped, e.g. "10m", "1h"
-l, --location string location: {EastUs|SouthEastAsia|WestEurope|WestUs2} (determined automatically if not provided)
-m, --machine string hardware specifications for the VM
-R, --repo string repository name with owner: user/repo
--retention-period duration allowed time after shutting down before the codespace is automatically deleted (maximum 30 days), e.g. "1h", "72h"
-s, --status show status of post-create command and dotfiles
-w, --web create codespace from browser, cannot be used with --display-name, --idle-timeout, or --retention-period
gh codespace delete [flags]
Delete codespaces
-c, --codespace string Name of the codespace
--days N Delete codespaces older than N days
-f, --force Skip confirmation for codespaces that contain unsaved changes
-o, --org login The login handle of the organization (admin-only)
-R, --repo string Filter codespace selection by repository name (user/repo)
--repo-owner string Filter codespace selection by repository owner (username or org)
-u, --user username The username to delete codespaces for (used with --org)
gh codespace edit [flags]
Edit a codespace
-c, --codespace string Name of the codespace
-d, --display-name string Set the display name
-m, --machine string Set hardware specifications for the VM
-R, --repo string Filter codespace selection by repository name (user/repo)
--repo-owner string Filter codespace selection by repository owner (username or org)
gh codespace jupyter [flags]
Open a codespace in JupyterLab
-c, --codespace string Name of the codespace
-R, --repo string Filter codespace selection by repository name (user/repo)
--repo-owner string Filter codespace selection by repository owner (username or org)
gh codespace list [flags]
List codespaces
-q, --jq expression Filter JSON output using a jq expression
--json fields Output JSON with the specified fields
-L, --limit int Maximum number of codespaces to list (default 30)
-o, --org login The login handle of the organization to list codespaces for (admin-only)
-R, --repo string Repository name with owner: user/repo
-t, --template string Format JSON output using a Go template; see "gh help formatting"
-u, --user username The username to list codespaces for (used with --org)
-w, --web List codespaces in the web browser, cannot be used with --user or --org
gh codespace logs [flags]
Access codespace logs
-c, --codespace string Name of the codespace
-f, --follow Tail and follow the logs
-R, --repo string Filter codespace selection by repository name (user/repo)
--repo-owner string Filter codespace selection by repository owner (username or org)
gh codespace ports [flags]
List ports in a codespace
-c, --codespace string Name of the codespace
-q, --jq expression Filter JSON output using a jq expression
--json fields Output JSON with the specified fields
-R, --repo string Filter codespace selection by repository name (user/repo)
--repo-owner string Filter codespace selection by repository owner (username or org)
-t, --template string Format JSON output using a Go template; see "gh help formatting"
gh codespace ports forward <remote-port>:<local-port>...
Forward ports
gh codespace ports visibility <port>:{public|private|org}...
Change the visibility of the forwarded port
gh codespace rebuild [flags]
Rebuild a codespace
-c, --codespace string Name of the codespace
--full perform a full rebuild
-R, --repo string Filter codespace selection by repository name (user/repo)
--repo-owner string Filter codespace selection by repository owner (username or org)
gh codespace ssh [<flags>...] [-- <ssh-flags>...] [<command>]
SSH into a codespace
-c, --codespace string Name of the codespace
--config Write OpenSSH configuration to stdout
-d, --debug Log debug data to a file
--debug-file string Path of the file log to
--profile string Name of the SSH profile to use
-R, --repo string Filter codespace selection by repository name (user/repo)
--repo-owner string Filter codespace selection by repository owner (username or org)
--server-port int SSH server port number (0 => pick unused)
gh codespace stop [flags]
Stop a running codespace
-c, --codespace string Name of the codespace
-o, --org login The login handle of the organization (admin-only)
-R, --repo string Filter codespace selection by repository name (user/repo)
--repo-owner string Filter codespace selection by repository owner (username or org)
-u, --user username The username to stop codespace for (used with --org)
gh codespace view [flags]
View details about a codespace
-c, --codespace string Name of the codespace
-q, --jq expression Filter JSON output using a jq expression
--json fields Output JSON with the specified fields
-R, --repo string Filter codespace selection by repository name (user/repo)
--repo-owner string Filter codespace selection by repository owner (username or org)
-t, --template string Format JSON output using a Go template; see "gh help formatting"
gh completion -s <shell>
Generate shell completion scripts
-s, --shell string Shell type: {bash|zsh|fish|powershell}
gh config <command>
Manage configuration for gh
gh config get <key> [flags]
Print the value of a given configuration key
-h, --host string Get per-host setting
gh config list [flags]
Print a list of configuration keys and values
-h, --host string Get per-host configuration
gh config set <key> <value> [flags]
Update configuration with a value for the given key
-h, --host string Set per-host setting
gh contribute
Extension contribute
gh cp
Extension cp
gh dash
Extension dash
gh eco
Extension eco
gh extension
Manage gh extensions
gh extension browse [flags]
Enter a UI for browsing, adding, and removing extensions
-s, --single-column Render TUI with only one column of text
gh extension create [<name>] [flags]
Create a new extension
--precompiled string Create a precompiled extension. Possible values: go, other
gh extension exec <name> [args]
Execute an installed extension
gh extension install <repository> [flags]
Install a gh extension from a repository
--force force upgrade extension, or ignore if latest already installed
--pin string pin extension to a release tag or commit ref
gh extension list
List installed extension commands
gh extension remove <name>
Remove an installed extension
gh extension search [<query>] [flags]
Search extensions to the GitHub CLI
-q, --jq expression Filter JSON output using a jq expression
--json fields Output JSON with the specified fields
--license strings Filter based on license type
-L, --limit int Maximum number of extensions to fetch (default 30)
--order string Order of repositories returned, ignored unless '--sort' flag is specified: {asc|desc} (default "desc")
--owner strings Filter on owner
--sort string Sort fetched repositories: {forks|help-wanted-issues|stars|updated} (default "best-match")
-t, --template string Format JSON output using a Go template; see "gh help formatting"
-w, --web Open the search query in the web browser
gh extension upgrade {<name> | --all} [flags]
Upgrade installed extensions
--all Upgrade all extensions
--dry-run Only display upgrades
--force Force upgrade extension
gh fire
Extension fire
gh gist <command>
Manage gists
gh gist clone <gist> [<directory>] [-- <gitflags>...]
Clone a gist locally
gh gist create [<filename>... | -] [flags]
Create a new gist
-d, --desc string A description for this gist
-f, --filename string Provide a filename to be used when reading from standard input
-p, --public List the gist publicly (default: secret)
-w, --web Open the web browser with created gist
gh gist delete {<id> | <url>}
Delete a gist
gh gist edit {<id> | <url>} [<filename>] [flags]
Edit one of your gists
-a, --add string Add a new file to the gist
-d, --desc string New description for the gist
-f, --filename string Select a file to edit
-r, --remove string Remove a file from the gist
gh gist list [flags]
List your gists
-L, --limit int Maximum number of gists to fetch (default 10)
--public Show only public gists
--secret Show only secret gists
gh gist rename {<id> | <url>} <oldFilename> <newFilename>
Rename a file in a gist
gh gist view [<id> | <url>] [flags]
View a gist
-f, --filename string Display a single file from the gist
--files List file names from the gist
-r, --raw Print raw instead of rendered gist contents
-w, --web Open gist in the browser
gh gpg-key <command>
Manage GPG keys
gh gpg-key add [<key-file>] [flags]
Add a GPG key to your GitHub account
-t, --title string Title for the new key
gh gpg-key delete <key-id> [flags]
Delete a GPG key from your GitHub account
-y, --yes Skip the confirmation prompt
gh gpg-key list
Lists GPG keys in your GitHub account
gh grep
Extension grep
gh i
Extension i
gh install
Extension install
gh issue <command>
Manage issues
gh issue close {<number> | <url>} [flags]
Close issue
-c, --comment string Leave a closing comment
-r, --reason string Reason for closing: {completed|not planned}
gh issue comment {<number> | <url>} [flags]
Add a comment to an issue
-b, --body text The comment body text
-F, --body-file file Read body text from file (use "-" to read from standard input)
--edit-last Edit the last comment of the same author
-e, --editor Skip prompts and open the text editor to write the body in
-w, --web Open the web browser to write the comment
gh issue create [flags]
Create a new issue
-a, --assignee login Assign people by their login. Use "@me" to self-assign.
-b, --body string Supply a body. Will prompt for one otherwise.
-F, --body-file file Read body text from file (use "-" to read from standard input)
-l, --label name Add labels by name
-m, --milestone name Add the issue to a milestone by name
-p, --project name Add the issue to projects by name
--recover string Recover input from a failed run of create
-T, --template name Template name to use as starting body text
-t, --title string Supply a title. Will prompt for one otherwise.
-w, --web Open the browser to create an issue
gh issue delete {<number> | <url>} [flags]
Delete issue
--yes confirm deletion without prompting
gh issue develop {<number> | <url>} [flags]
Manage linked branches for an issue
-b, --base string Name of the base branch you want to make your new branch from
--branch-repo string Name or URL of the repository where you want to create your new branch
-c, --checkout Checkout the branch after creating it
-l, --list List linked branches for the issue
-n, --name string Name of the branch to create
gh issue edit {<numbers> | <urls>} [flags]
Edit issues
-b, --body string Set the new body.
-F, --body-file file Read body text from file (use "-" to read from standard input)
-m, --milestone name Edit the milestone the issue belongs to by name
--remove-assignee login Remove assigned users by their login. Use "@me" to unassign yourself.
--remove-label name Remove labels by name
--remove-project name Remove the issue from projects by name
-t, --title string Set the new title.
gh issue list [flags]
List issues in a repository
-a, --assignee string Filter by assignee
-A, --author string Filter by author
-q, --jq expression Filter JSON output using a jq expression
--json fields Output JSON with the specified fields
-l, --label strings Filter by label
-L, --limit int Maximum number of issues to fetch (default 30)
--mention string Filter by mention
-m, --milestone string Filter by milestone number or title
-S, --search query Search issues with query
-s, --state string Filter by state: {open|closed|all} (default "open")
-t, --template string Format JSON output using a Go template; see "gh help formatting"
-w, --web List issues in the web browser
gh issue lock {<number> | <url>} [flags]
Lock issue conversation
-r, --reason string Optional reason for locking conversation (off_topic, resolved, spam, too_heated).
gh issue pin {<number> | <url>}
Pin a issue
gh issue reopen {<number> | <url>} [flags]
Reopen issue
-c, --comment string Add a reopening comment
gh issue status [flags]
Show status of relevant issues
-q, --jq expression Filter JSON output using a jq expression
--json fields Output JSON with the specified fields
-t, --template string Format JSON output using a Go template; see "gh help formatting"
gh issue transfer {<number> | <url>} <destination-repo>
Transfer issue to another repository
gh issue unlock {<number> | <url>}
Unlock issue conversation
gh issue unpin {<number> | <url>}
Unpin a issue
gh issue view {<number> | <url>} [flags]
View an issue
-c, --comments View issue comments
-q, --jq expression Filter JSON output using a jq expression
--json fields Output JSON with the specified fields
-t, --template string Format JSON output using a Go template; see "gh help formatting"
-w, --web Open an issue in the browser
gh label <command>
Manage labels
gh label clone <source-repository> [flags]
Clones labels from one repository to another
-f, --force Overwrite labels in the destination repository
gh label create <name> [flags]
Create a new label
-c, --color string Color of the label
-d, --description string Description of the label
-f, --force Update the label color and description if label already exists
gh label delete <name> [flags]
Delete a label from a repository
--yes Confirm deletion without prompting
gh label edit <name> [flags]
Edit a label
-c, --color string Color of the label
-d, --description string Description of the label
-n, --name string New name of the label
gh label list [flags]
List labels in a repository
-q, --jq expression Filter JSON output using a jq expression
--json fields Output JSON with the specified fields
-L, --limit int Maximum number of labels to fetch (default 30)
--order string Order of labels returned: {asc|desc} (default "asc")
-S, --search string Search label names and descriptions
--sort string Sort fetched labels: {created|name} (default "created")
-t, --template string Format JSON output using a Go template; see "gh help formatting"
-w, --web List labels in the web browser
gh markdown-preview
Extension markdown-preview
gh notify
Extension notify
gh org <command>
Manage organizations
gh org list [flags]
List organizations for the authenticated user.
-L, --limit int Maximum number of organizations to list (default 30)
gh pr <command> [flags]
Manage pull requests
-R, --repo [HOST/]OWNER/REPO Select another repository using the [HOST/]OWNER/REPO format
gh pr checkout {<number> | <url> | <branch>} [flags]
Check out a pull request in git
-b, --branch string Local branch name to use (default: the name of the head branch)
--detach Checkout PR with a detached HEAD
-f, --force Reset the existing local branch to the latest state of the pull request
--recurse-submodules Update all submodules after checkout
gh pr checks [<number> | <url> | <branch>] [flags]
Show CI status for a single pull request
-i, --interval --watch Refresh interval in seconds when using --watch flag (default 10)
--required Only show checks that are required
--watch Watch checks until they finish
-w, --web Open the web browser to show details about checks
gh pr close {<number> | <url> | <branch>} [flags]
Close a pull request
-c, --comment string Leave a closing comment
-d, --delete-branch Delete the local and remote branch after close
gh pr comment [<number> | <url> | <branch>] [flags]
Add a comment to a pull request
-b, --body text The comment body text
-F, --body-file file Read body text from file (use "-" to read from standard input)
--edit-last Edit the last comment of the same author
-e, --editor Skip prompts and open the text editor to write the body in
-w, --web Open the web browser to write the comment
gh pr create [flags]
Create a pull request
-a, --assignee login Assign people by their login. Use "@me" to self-assign.
-B, --base branch The branch into which you want your code merged
-b, --body string Body for the pull request
-F, --body-file file Read body text from file (use "-" to read from standard input)
-d, --draft Mark pull request as a draft
-f, --fill Do not prompt for title/body and just use commit info
--fill-first Do not prompt for title/body and just use first commit info
-H, --head branch The branch that contains commits for your pull request (default: current branch)
-l, --label name Add labels by name
-m, --milestone name Add the pull request to a milestone by name
--no-maintainer-edit Disable maintainer's ability to modify pull request
-p, --project name Add the pull request to projects by name
--recover string Recover input from a failed run of create
-r, --reviewer handle Request reviews from people or teams by their handle
-T, --template file Template file to use as starting body text
-t, --title string Title for the pull request
-w, --web Open the web browser to create a pull request
gh pr diff [<number> | <url> | <branch>] [flags]
View changes in a pull request
-w, --web Open the pull request diff in the browser
gh pr edit [<number> | <url> | <branch>] [flags]
Edit a pull request
-B, --base branch Change the base branch for this pull request
-b, --body string Set the new body.
-F, --body-file file Read body text from file (use "-" to read from standard input)
-m, --milestone name Edit the milestone the pull request belongs to by name
--remove-assignee login Remove assigned users by their login. Use "@me" to unassign yourself.
--remove-label name Remove labels by name
--remove-project name Remove the pull request from projects by name
--remove-reviewer login Remove reviewers by their login.
-t, --title string Set the new title.
gh pr list [flags]
List pull requests in a repository
-a, --assignee string Filter by assignee
-A, --author string Filter by author
-B, --base string Filter by base branch
-d, --draft Filter by draft state
-H, --head string Filter by head branch
-q, --jq expression Filter JSON output using a jq expression
--json fields Output JSON with the specified fields
-l, --label strings Filter by label
-L, --limit int Maximum number of items to fetch (default 30)
-S, --search query Search pull requests with query
-s, --state string Filter by state: {open|closed|merged|all} (default "open")
-t, --template string Format JSON output using a Go template; see "gh help formatting"
-w, --web List pull requests in the web browser
gh pr lock {<number> | <url>} [flags]
Lock pull request conversation
-r, --reason string Optional reason for locking conversation (off_topic, resolved, spam, too_heated).
gh pr merge [<number> | <url> | <branch>] [flags]
Merge a pull request
-A, --author-email text Email text for merge commit author
--auto Automatically merge only after necessary requirements are met
-b, --body text Body text for the merge commit
-F, --body-file file Read body text from file (use "-" to read from standard input)
-d, --delete-branch Delete the local and remote branch after merge
--disable-auto Disable auto-merge for this pull request
--match-head-commit SHA Commit SHA that the pull request head must match to allow merge
-m, --merge Merge the commits with the base branch
-r, --rebase Rebase the commits onto the base branch
-s, --squash Squash the commits into one commit and merge it into the base branch
-t, --subject text Subject text for the merge commit
gh pr ready [<number> | <url> | <branch>] [flags]
Mark a pull request as ready for review
--undo Convert a pull request to "draft"
gh pr reopen {<number> | <url> | <branch>} [flags]
Reopen a pull request
-c, --comment string Add a reopening comment
gh pr review [<number> | <url> | <branch>] [flags]
Add a review to a pull request
-a, --approve Approve pull request
-b, --body string Specify the body of a review
-F, --body-file file Read body text from file (use "-" to read from standard input)
-c, --comment Comment on a pull request
-r, --request-changes Request changes on a pull request
gh pr status [flags]
Show status of relevant pull requests
-c, --conflict-status Display the merge conflict status of each pull request
-q, --jq expression Filter JSON output using a jq expression
--json fields Output JSON with the specified fields
-t, --template string Format JSON output using a Go template; see "gh help formatting"
gh pr unlock {<number> | <url>}
Unlock pull request conversation
gh pr view [<number> | <url> | <branch>] [flags]
View a pull request
-c, --comments View pull request comments
-q, --jq expression Filter JSON output using a jq expression
--json fields Output JSON with the specified fields
-t, --template string Format JSON output using a Go template; see "gh help formatting"
-w, --web Open a pull request in the browser
gh project <command>
Work with GitHub Projects.
gh project close [<number>] [flags]
Close a project
--format string Output format, must be 'json'
--owner string Login of the owner. Use "@me" for the current user.
--undo Reopen a closed project
gh project copy [<number>] [flags]
Copy a project
--drafts Include draft issues when copying
--format string Output format: {json}
--source-owner string Login of the source owner. Use "@me" for the current user.
--target-owner string Login of the target owner. Use "@me" for the current user.
--title string Title for the new project
gh project create [flags]
Create a project
--format string Output format: {json}
--owner string Login of the owner. Use "@me" for the current user.
--title string Title for the project
gh project delete [<number>] [flags]
Delete a project
--format string Output format: {json}
--owner string Login of the owner. Use "@me" for the current user.
gh project edit [<number>] [flags]
Edit a project
-d, --description string New description of the project
--format string Output format: {json}
--owner string Login of the owner. Use "@me" for the current user.
--readme string New readme for the project
--title string New title for the project
--visibility string Change project visibility: {PUBLIC|PRIVATE}
gh project field-create [<number>] [flags]
Create a field in a project
--data-type string DataType of the new field.: {TEXT|SINGLE_SELECT|DATE|NUMBER}
--format string Output format: {json}
--name string Name of the new field
--owner string Login of the owner. Use "@me" for the current user.
--single-select-options strings Options for SINGLE_SELECT data type
gh project field-delete [flags]
Delete a field in a project
--format string Output format: {json}
--id string ID of the field to delete
gh project field-list number [flags]
List the fields in a project
-L, --limit int Maximum number of fields to fetch (default 30)
--owner string Login of the owner. Use "@me" for the current user.
gh project item-add [<number>] [flags]
Add a pull request or an issue to a project
--format string Output format: {json}
--owner string Login of the owner. Use "@me" for the current user.
--url string URL of the issue or pull request to add to the project
gh project item-archive [<number>] [flags]
Archive an item in a project
--format string Output format: {json}
--id string ID of the item to archive
--owner string Login of the owner. Use "@me" for the current user.
--undo Unarchive an item
gh project item-create [<number>] [flags]
Create a draft issue item in a project
--body string Body for the draft issue
--format string Output format: {json}
--owner string Login of the owner. Use "@me" for the current user.
--title string Title for the draft issue
gh project item-delete [<number>] [flags]
Delete an item from a project by ID
--format string Output format: {json}
--id string ID of the item to delete
--owner string Login of the owner. Use "@me" for the current user.
gh project item-edit [flags]
Edit an item in a project
--body string Body of the draft issue item
--date string Date value for the field (YYYY-MM-DD)
--field-id string ID of the field to update
--format string Output format: {json}
--id string ID of the item to edit
--iteration-id string ID of the iteration value to set on the field
--number float32 Number value for the field
--project-id string ID of the project to which the field belongs to
--single-select-option-id string ID of the single select option value to set on the field
--text string Text value for the field
--title string Title of the draft issue item
gh project item-list [<number>] [flags]
List the items in a project
-L, --limit int Maximum number of items to fetch (default 30)
--owner string Login of the owner. Use "@me" for the current user.
gh project list [flags]
List the projects for an owner
-L, --limit int Maximum number of projects to fetch (default 30)
--owner string Login of the owner
-w, --web Open projects list in the browser
gh project view [<number>] [flags]
View a project
-w, --web Open a project in the browser
gh quickcs
Extension quickcs
gh release <command>
Manage releases
gh release create [<tag>] [<files>...]
Create a new release
-d, --draft Save the release as a draft instead of publishing it
--generate-notes Automatically generate title and notes for the release
--latest Mark this release as "Latest" (default: automatic based on date and version)
-n, --notes string Release notes
-F, --notes-file file Read release notes from file (use "-" to read from standard input)
--notes-start-tag string Tag to use as the starting point for generating release notes
-p, --prerelease Mark the release as a prerelease
--target branch Target branch or full commit SHA (default: main branch)
-t, --title string Release title
--verify-tag Abort in case the git tag doesn't already exist in the remote repository
gh release delete <tag> [flags]
Delete a release
-y, --yes Skip the confirmation prompt
gh release delete-asset <tag> <asset-name> [flags]
Delete an asset from a release
-y, --yes Skip the confirmation prompt
gh release download [<tag>] [flags]
Download release assets
-A, --archive format Download the source code archive in the specified format (zip or tar.gz)
--clobber Overwrite existing files of the same name
-D, --dir directory The directory to download files into (default ".")
-O, --output file The file to write a single asset to (use "-" to write to standard output)
-p, --pattern stringArray Download only assets that match a glob pattern
--skip-existing Skip downloading when files of the same name exist
gh release edit <tag>
Edit a release
-n, --notes string Release notes
-F, --notes-file file Read release notes from file (use "-" to read from standard input)
--prerelease Mark the release as a prerelease
--tag string The name of the tag
--target branch Target branch or full commit SHA (default: main branch)
-t, --title string Release title
--verify-tag Abort in case the git tag doesn't already exist in the remote repository
gh release list [flags]
List releases in a repository
-L, --limit int Maximum number of items to fetch (default 30)
gh release upload <tag> <files>... [flags]
Upload assets to a release
--clobber Overwrite existing assets of the same name
gh release view [<tag>] [flags]
View information about a release
-q, --jq expression Filter JSON output using a jq expression
--json fields Output JSON with the specified fields
-t, --template string Format JSON output using a Go template; see "gh help formatting"
-w, --web Open the release in the browser
gh repo <command>
Manage repositories
gh repo archive [<repository>] [flags]
Archive a repository
-y, --yes Skip the confirmation prompt
gh repo clone <repository> [<directory>] [-- <gitflags>...]
Clone a repository locally
-u, --upstream-remote-name string Upstream remote name when cloning a fork (default "upstream")
gh repo create [<name>] [flags]
Create a new repository
-c, --clone Clone the new repository to the current directory
-d, --description string Description of the repository
--disable-issues Disable issues in the new repository
--disable-wiki Disable wiki in the new repository
-g, --gitignore string Specify a gitignore template for the repository
-h, --homepage URL Repository home page URL
--include-all-branches Include all branches from template repository
--internal Make the new repository internal
-l, --license string Specify an Open Source License for the repository
--private Make the new repository private
--public Make the new repository public
--push Push local commits to the new repository
-r, --remote string Specify remote name for the new repository
-s, --source string Specify path to local repository to use as source
-t, --team name The name of the organization team to be granted access
-p, --template repository Make the new repository based on a template repository
gh repo delete [<repository>] [flags]
Delete a repository
--yes confirm deletion without prompting
gh repo deploy-key <command>
Manage deploy keys in a repository
gh repo deploy-key add <key-file> [flags]
Add a deploy key to a GitHub repository
-w, --allow-write Allow write access for the key
-t, --title string Title of the new key
gh repo deploy-key delete <key-id>
Delete a deploy key from a GitHub repository
gh repo deploy-key list
List deploy keys in a GitHub repository
gh repo edit [<repository>] [flags]
Edit repository settings
-d, --description string Description of the repository
--enable-auto-merge Enable auto-merge functionality
--enable-discussions Enable discussions in the repository
--enable-issues Enable issues in the repository
--enable-merge-commit Enable merging pull requests via merge commit
--enable-projects Enable projects in the repository
--enable-rebase-merge Enable merging pull requests via rebase
--enable-squash-merge Enable merging pull requests via squashed commit
--enable-wiki Enable wiki in the repository
-h, --homepage URL Repository home page URL
--remove-topic strings Remove repository topic
--template Make the repository available as a template repository
--visibility string Change the visibility of the repository to {public,private,internal}
gh repo fork [<repository>] [-- <gitflags>...] [flags]
Create a fork of a repository
--clone Clone the fork
--default-branch-only Only include the default branch in the fork
--fork-name string Rename the forked repository
--org string Create the fork in an organization
--remote Add a git remote for the fork
--remote-name string Specify the name for the new remote (default "origin")
gh repo list [<owner>] [flags]
List repositories owned by user or organization
-q, --jq expression Filter JSON output using a jq expression
--json fields Output JSON with the specified fields
-l, --language string Filter by primary coding language
-L, --limit int Maximum number of repositories to list (default 30)
--no-archived Omit archived repositories
--source Show only non-forks
-t, --template string Format JSON output using a Go template; see "gh help formatting"
--topic strings Filter by topic
--visibility string Filter by repository visibility: {public|private|internal}
gh repo rename [<new-name>] [flags]
Rename a repository
-y, --yes Skip the confirmation prompt
gh repo set-default [<repository>] [flags]
Configure default repository for this directory
-u, --unset unset the current default repository
-v, --view view the current default repository
gh repo sync [<destination-repository>] [flags]
Sync a repository
-b, --branch string Branch to sync (default: main branch)
--force Hard reset the branch of the destination repository to match the source repository
-s, --source string Source repository
gh repo unarchive [<repository>] [flags]
Unarchive a repository
-y, --yes Skip the confirmation prompt
gh repo view [<repository>] [flags]
View a repository
-b, --branch string View a specific branch of the repository
-q, --jq expression Filter JSON output using a jq expression
--json fields Output JSON with the specified fields
-t, --template string Format JSON output using a Go template; see "gh help formatting"
-w, --web Open a repository in the browser
gh repo-explore
Extension repo-explore
gh ruleset <command>
View info about repo rulesets
gh ruleset check [<branch>] [flags]
View rules that would apply to a given branch
-w, --web Open the branch rules page in a web browser
gh ruleset list [flags]
List rulesets for a repository or organization
-L, --limit int Maximum number of rulesets to list (default 30)
-o, --org string List organization-wide rulesets for the provided organization
-p, --parents Whether to include rulesets configured at higher levels that also apply (default true)
-w, --web Open the list of rulesets in the web browser
gh ruleset view [<ruleset-id>] [flags]
View information about a ruleset
-o, --org string Organization name if the provided ID is an organization-level ruleset
-p, --parents Whether to include rulesets configured at higher levels that also apply (default true)
-w, --web Open the ruleset in the browser
gh run <command>
View details about workflow runs
gh run cancel [<run-id>]
Cancel a workflow run
gh run delete [<run-id>]
Delete a workflow run
gh run download [<run-id>] [flags]
Download artifacts generated by a workflow run
-D, --dir string The directory to download artifacts into (default ".")
-n, --name stringArray Download artifacts that match any of the given names
-p, --pattern stringArray Download artifacts that match a glob pattern
gh run list [flags]
List recent workflow runs
-b, --branch string Filter runs by branch
--created date Filter runs by the date it was created
-e, --event event Filter runs by which event triggered the run
-q, --jq expression Filter JSON output using a jq expression
--json fields Output JSON with the specified fields
-L, --limit int Maximum number of runs to fetch (default 20)
-s, --status string Filter runs by status: {queued|completed|in_progress|requested|waiting|action_required|cancelled|failure|neutral|skipped|stale|startup_failure|success|timed_out}
-t, --template string Format JSON output using a Go template; see "gh help formatting"
-u, --user string Filter runs by user who triggered the run
-w, --workflow string Filter runs by workflow
gh run rerun [<run-id>] [flags]
Rerun a run
-d, --debug Rerun with debug logging
--failed Rerun only failed jobs, including dependencies
-j, --job string Rerun a specific job from a run, including dependencies
gh run view [<run-id>] [flags]
View a summary of a workflow run
-a, --attempt uint The attempt number of the workflow run
--exit-status Exit with non-zero status if run failed
-j, --job string View a specific job ID from a run
-q, --jq expression Filter JSON output using a jq expression
--json fields Output JSON with the specified fields
--log View full log for either a run or specific job
--log-failed View the log for any failed steps in a run or specific job
-t, --template string Format JSON output using a Go template; see "gh help formatting"
-v, --verbose Show job steps
-w, --web Open run in the browser
gh run watch <run-id> [flags]
Watch a run until it completes, showing its progress
-i, --interval int Refresh interval in seconds (default 3)
gh s
Extension s
gh search <command>
Search for repositories, issues, and pull requests
gh search code <query> [flags]
Search within code
-q, --jq expression Filter JSON output using a jq expression
--json fields Output JSON with the specified fields
--language string Filter results by language
-L, --limit int Maximum number of code results to fetch (default 30)
--match strings Restrict search to file contents or file path: {file|path}
--owner strings Filter on owner
-R, --repo strings Filter on repository
--size string Filter on size range, in kilobytes
-t, --template string Format JSON output using a Go template; see "gh help formatting"
-w, --web Open the search query in the web browser
gh search commits [<query>] [flags]
Search for commits
-q, --jq expression Filter JSON output using a jq expression
--json fields Output JSON with the specified fields
-L, --limit int Maximum number of commits to fetch (default 30)
--merge Filter on merge commits
--order string Order of commits returned, ignored unless '--sort' flag is specified: {asc|desc} (default "desc")
--owner strings Filter on repository owner
--parent string Filter by parent hash
-R, --repo strings Filter on repository
--sort string Sort fetched commits: {author-date|committer-date} (default "best-match")
-t, --template string Format JSON output using a Go template; see "gh help formatting"
--tree string Filter by tree hash
--visibility strings Filter based on repository visibility: {public|private|internal}
-w, --web Open the search query in the web browser
gh search issues [<query>] [flags]
Search for issues
-q, --jq expression Filter JSON output using a jq expression
--json fields Output JSON with the specified fields
--label strings Filter on label
--language string Filter based on the coding language
-L, --limit int Maximum number of results to fetch (default 30)
--locked Filter on locked conversation status
--match strings Restrict search to specific field of issue: {title|body|comments}
--mentions user Filter based on user mentions
--milestone title Filter by milestone title
--no-assignee Filter on missing assignee
--no-label Filter on missing label
--no-milestone Filter on missing milestone
--no-project Filter on missing project
--order string Order of results returned, ignored unless '--sort' flag is specified: {asc|desc} (default "desc")
--owner strings Filter on repository owner
--project number Filter on project board number
--reactions number Filter on number of reactions
-R, --repo strings Filter on repository
--sort string Sort fetched results: {comments|created|interactions|reactions|reactions-+1|reactions--1|reactions-heart|reactions-smile|reactions-tada|reactions-thinking_face|updated} (default "best-match")
--state string Filter based on state: {open|closed}
--team-mentions string Filter based on team mentions
-t, --template string Format JSON output using a Go template; see "gh help formatting"
--updated date Filter on last updated at date
--visibility strings Filter based on repository visibility: {public|private|internal}
-w, --web Open the search query in the web browser
gh search prs [<query>] [flags]
Search for pull requests
-B, --base string Filter on base branch name
--checks string Filter based on status of the checks: {pending|success|failure}
--closed date Filter on closed at date
--commenter user Filter based on comments by user
--comments number Filter on number of comments
--created date Filter based on created at date
--draft Filter based on draft state
-H, --head string Filter on head branch name
--interactions number Filter on number of reactions and comments
--involves user Filter based on involvement of user
-q, --jq expression Filter JSON output using a jq expression
--json fields Output JSON with the specified fields
--label strings Filter on label
--language string Filter based on the coding language
-L, --limit int Maximum number of results to fetch (default 30)
--locked Filter on locked conversation status
--match strings Restrict search to specific field of issue: {title|body|comments}
--mentions user Filter based on user mentions
--merged Filter based on merged state
--merged-at date Filter on merged at date
--milestone title Filter by milestone title
--no-assignee Filter on missing assignee
--no-label Filter on missing label
--no-milestone Filter on missing milestone
--no-project Filter on missing project
--order string Order of results returned, ignored unless '--sort' flag is specified: {asc|desc} (default "desc")
--owner strings Filter on repository owner
--project number Filter on project board number
--reactions number Filter on number of reactions
-R, --repo strings Filter on repository
--review string Filter based on review status: {none|required|approved|changes_requested}
--review-requested user Filter on user or team requested to review
--reviewed-by user Filter on user who reviewed
--sort string Sort fetched results: {comments|reactions|reactions-+1|reactions--1|reactions-smile|reactions-thinking_face|reactions-heart|reactions-tada|interactions|created|updated} (default "best-match")
--state string Filter based on state: {open|closed}
--team-mentions string Filter based on team mentions
-t, --template string Format JSON output using a Go template; see "gh help formatting"
--updated date Filter on last updated at date
--visibility strings Filter based on repository visibility: {public|private|internal}
-w, --web Open the search query in the web browser
gh search repos [<query>] [flags]
Search for repositories
-q, --jq expression Filter JSON output using a jq expression
--json fields Output JSON with the specified fields
--language string Filter based on the coding language
--license strings Filter based on license type
-L, --limit int Maximum number of repositories to fetch (default 30)
--match strings Restrict search to specific field of repository: {name|description|readme}
--number-topics number Filter on number of topics
--order string Order of repositories returned, ignored unless '--sort' flag is specified: {asc|desc} (default "desc")
--owner strings Filter on owner
--size string Filter on a size range, in kilobytes
--sort string Sort fetched repositories: {forks|help-wanted-issues|stars|updated} (default "best-match")
--stars number Filter on number of stars
-t, --template string Format JSON output using a Go template; see "gh help formatting"
--topic strings Filter on topic
--updated date Filter on last updated at date
--visibility strings Filter based on visibility: {public|private|internal}
-w, --web Open the search query in the web browser
gh secret <command>
Manage GitHub secrets
gh secret delete <secret-name> [flags]
Delete secrets
-a, --app string Delete a secret for a specific application: {actions|codespaces|dependabot}
-e, --env string Delete a secret for an environment
-o, --org string Delete a secret for an organization
-u, --user Delete a secret for your user
gh secret list [flags]
List secrets
-a, --app string List secrets for a specific application: {actions|codespaces|dependabot}
-e, --env string List secrets for an environment
-o, --org string List secrets for an organization
-u, --user List a secret for your user
gh secret set <secret-name> [flags]
Create or update secrets
-a, --app string Set the application for a secret: {actions|codespaces|dependabot}
-b, --body string The value for the secret (reads from standard input if not specified)
-e, --env environment Set deployment environment secret
-f, --env-file file Load secret names and values from a dotenv-formatted file
--no-store Print the encrypted, base64-encoded value instead of storing it on Github
-o, --org organization Set organization secret
-r, --repos repositories List of repositories that can access an organization or user secret
-u, --user Set a secret for your user
-v, --visibility string Set visibility for an organization secret: {all|private|selected} (default "private")
gh ssh-key <command>
Manage SSH keys
gh ssh-key add [<key-file>] [flags]
Add an SSH key to your GitHub account
-t, --title string Title for the new key
--type string Type of the ssh key: {authentication|signing} (default "authentication")
gh ssh-key delete <id> [flags]
Delete an SSH key from your GitHub account
-y, --yes Skip the confirmation prompt
gh ssh-key list
Lists SSH keys in your GitHub account
gh status [flags]
Print information about relevant issues, pull requests, and notifications across repositories
-e, --exclude strings Comma separated list of repos to exclude in owner/name format
-o, --org string Report status within an organization
gh todo
Extension todo
gh triage
Extension triage
gh user-stars
Extension user-stars
gh userfetch
Extension userfetch
gh variable <command>
Manage GitHub Actions variables
gh variable delete <variable-name> [flags]
Delete variables
-e, --env string Delete a variable for an environment
-o, --org string Delete a variable for an organization
gh variable list [flags]
List variables
-e, --env string List variables for an environment
-o, --org string List variables for an organization
gh variable set <variable-name> [flags]
Create or update variables
-b, --body string The value for the variable (reads from standard input if not specified)
-e, --env environment Set deployment environment variable
-f, --env-file file Load variable names and values from a dotenv-formatted file
-o, --org organization Set organization variable
-r, --repos repositories List of repositories that can access an organization variable
-v, --visibility string Set visibility for an organization variable: {all|private|selected} (default "private")
gh workflow <command>
View details about GitHub Actions workflows
gh workflow disable [<workflow-id> | <workflow-name>]
Disable a workflow
gh workflow enable [<workflow-id> | <workflow-name>]
Enable a workflow
gh workflow list [flags]
List workflows
-a, --all Also show disabled workflows
-L, --limit int Maximum number of workflows to fetch (default 50)
gh workflow run [<workflow-id> | <workflow-name>] [flags]
Run a workflow by creating a workflow_dispatch event
-F, --field key=value Add a string parameter in key=value format, respecting @ syntax
--json Read workflow inputs as JSON via STDIN
-f, --raw-field key=value Add a string parameter in key=value format
-r, --ref string The branch or tag name which contains the version of the workflow file you'd like to run
gh workflow view [<workflow-id> | <workflow-name> | <filename>] [flags]
View the summary of a workflow
-r, --ref string The branch or tag name which contains the version of the workflow file you'd like to view
-w, --web Open workflow in the browser
-y, --yaml View the workflow yaml file
gh xplr
Extension xplr
The text was updated successfully, but these errors were encountered: