GH-REPO-VIEW(1) GitHub CLI manual GH-REPO-VIEW(1)

# [NAME](#NAME)

gh-repo-view - View a repository

# [SYNOPSIS](#SYNOPSIS)

**gh repo view \[<repository>] \[flags]**

# [DESCRIPTION](#DESCRIPTION)

Display the description and the README of a GitHub repository.

With no argument, the repository for the current directory is displayed.

With **--web**, open the repository in a web browser instead.

With **--branch**, view a specific branch of the repository.

# [OPTIONS](#OPTIONS)

[**-b**, **--branch** **<string>**](#b)

View a specific branch of the repository

[**-q**, **--jq** **<expression>**](#q)

Filter JSON output using a jq expression

[**--json** **<fields>**](#json)

Output JSON with the specified fields

[**-t**, **--template** **<string>**](#t)

Format JSON output using a Go template; see "gh help formatting"

[**-w**, **--web**](#w)

Open a repository in the browser

# [JSON FIELDS](#JSON_FIELDS)

**archivedAt**, **assignableUsers**, **codeOfConduct**, **contactLinks**, **createdAt**, **defaultBranchRef**, **deleteBranchOnMerge**, **description**, **diskUsage**, **forkCount**, **fundingLinks**, **hasDiscussionsEnabled**, **hasIssuesEnabled**, **hasProjectsEnabled**, **hasWikiEnabled**, **homepageUrl**, **id**, **isArchived**, **isBlankIssuesEnabled**, **isEmpty**, **isFork**, **isInOrganization**, **isMirror**, **isPrivate**, **isSecurityPolicyEnabled**, **isTemplate**, **isUserConfigurationRepository**, **issueTemplates**, **issues**, **labels**, **languages**, **latestRelease**, **licenseInfo**, **mentionableUsers**, **mergeCommitAllowed**, **milestones**, **mirrorUrl**, **name**, **nameWithOwner**, **openGraphImageUrl**, **owner**, **parent**, **primaryLanguage**, **projects**, **projectsV2**, **pullRequestTemplates**, **pullRequests**, **pushedAt**, **rebaseMergeAllowed**, **repositoryTopics**, **securityPolicyUrl**, **squashMergeAllowed**, **sshUrl**, **stargazerCount**, **templateRepository**, **updatedAt**, **url**, **usesCustomOpenGraphImage**, **viewerCanAdminister**, **viewerDefaultCommitEmail**, **viewerDefaultMergeMethod**, **viewerHasStarred**, **viewerPermission**, **viewerPossibleCommitEmails**, **viewerSubscription**, **visibility**, **watchers**

# [EXIT CODES](#EXIT_CODES)

0: Successful execution

1: Error

2: Command canceled

4: Authentication required

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

# [SEE ALSO](#SEE_ALSO)

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

Sep 2026

---

Document: gh-repo-view(1) from gh 2.101.0-r1 (Chainguard OS)
Source: https://github.com/cli/cli