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"
See also
