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: https://docs.github.com/search-github/searching-on-github/searching-commits
Options
-
--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
-
--merge - 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
Examples
# 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"