gh search commits

gh search commits [<query>] [flags]

Search for commits on GitHub.

The command supports constructing queries using the GitHub search syntax, using the parameter and qualifier flags, or a combination of the two.

GitHub search syntax is documented at:


--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> (default 30)
Maximum number of commits to fetch
Filter on merge commits
--order <string> (default "desc")
Order of commits returned, ignored unless '--sort' flag is specified: {asc|desc}
--owner <strings>
Filter on repository owner
--parent <string>
Filter by parent hash
-R, --repo <strings>
Filter on repository
--sort <string> (default "best-match")
Sort fetched commits: {author-date|committer-date}
-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

JSON Fields

author, commit, committer, id, parents, repository, sha, url


# search commits matching set of keywords "readme" and "typo"
$ gh search commits readme typo

# search commits matching phrase "bug fix"
$ gh search commits "bug fix"

# search commits committed by user "monalisa"
$ gh search commits --committer=monalisa

# search commits authored by users with name "Jane Doe"
$ gh search commits --author-name="Jane Doe"

# search commits matching hash "8dd03144ffdc6c0d486d6b705f9c7fba871ee7c3"
$ gh search commits --hash=8dd03144ffdc6c0d486d6b705f9c7fba871ee7c3

# search commits authored before February 1st, 2022
$ gh search commits --author-date="<2022-02-01"

See also