From 8a6b76d246ac12dcf05b816f2cc349166d56631e Mon Sep 17 00:00:00 2001 From: happysnaker <73147033+happysnaker@users.noreply.github.com> Date: Tue, 30 Jun 2026 09:19:56 +0800 Subject: [PATCH 1/3] docs(search): add examples for multiple qualifiers Signed-off-by: happysnaker <73147033+happysnaker@users.noreply.github.com> --- pkg/cmd/search/code/code.go | 3 +++ pkg/cmd/search/commits/commits.go | 3 +++ pkg/cmd/search/issues/issues.go | 3 +++ pkg/cmd/search/prs/prs.go | 3 +++ pkg/cmd/search/repos/repos.go | 3 +++ 5 files changed, 15 insertions(+) diff --git a/pkg/cmd/search/code/code.go b/pkg/cmd/search/code/code.go index 7ef2a4193f0..a844b98ec5c 100644 --- a/pkg/cmd/search/code/code.go +++ b/pkg/cmd/search/code/code.go @@ -56,6 +56,9 @@ func NewCmdCode(f *cmdutil.Factory, runF func(*CodeOptions) error) *cobra.Comman # Search code matching "error handling" $ gh search code "error handling" + # Search code using multiple search syntax qualifiers as separate arguments + $ gh search code panic path:pkg language:go + # Search code matching "deque" in Python files $ gh search code deque --language=python diff --git a/pkg/cmd/search/commits/commits.go b/pkg/cmd/search/commits/commits.go index 939109b65de..a860cc36b0c 100644 --- a/pkg/cmd/search/commits/commits.go +++ b/pkg/cmd/search/commits/commits.go @@ -55,6 +55,9 @@ func NewCmdCommits(f *cmdutil.Factory, runF func(*CommitsOptions) error) *cobra. # Search commits matching phrase "bug fix" $ gh search commits "bug fix" + # Search commits using multiple search syntax qualifiers as separate arguments + $ gh search commits fix author:monalisa merge:false + # Search commits committed by user "monalisa" $ gh search commits --committer=monalisa diff --git a/pkg/cmd/search/issues/issues.go b/pkg/cmd/search/issues/issues.go index ffddb3e2668..34239ea431a 100644 --- a/pkg/cmd/search/issues/issues.go +++ b/pkg/cmd/search/issues/issues.go @@ -50,6 +50,9 @@ func NewCmdIssues(f *cmdutil.Factory, runF func(*shared.IssuesOptions) error) *c # Search issues matching phrase "broken feature" $ gh search issues "broken feature" + # Search issues using multiple search syntax qualifiers as separate arguments + $ gh search issues label:bug author:monalisa state:open + # Search issues and pull requests in cli organization $ gh search issues --include-prs --owner=cli diff --git a/pkg/cmd/search/prs/prs.go b/pkg/cmd/search/prs/prs.go index 34f1c7f565d..3723e6c0335 100644 --- a/pkg/cmd/search/prs/prs.go +++ b/pkg/cmd/search/prs/prs.go @@ -52,6 +52,9 @@ func NewCmdPrs(f *cmdutil.Factory, runF func(*shared.IssuesOptions) error) *cobr # Search draft pull requests in cli repository $ gh search prs --repo=cli/cli --draft + # Search pull requests using multiple search syntax qualifiers as separate arguments + $ gh search prs review:required status:success base:main + # Search open pull requests requesting your review $ gh search prs --review-requested=@me --state=open diff --git a/pkg/cmd/search/repos/repos.go b/pkg/cmd/search/repos/repos.go index 0a4275a87ca..c05161cd546 100644 --- a/pkg/cmd/search/repos/repos.go +++ b/pkg/cmd/search/repos/repos.go @@ -56,6 +56,9 @@ func NewCmdRepos(f *cmdutil.Factory, runF func(*ReposOptions) error) *cobra.Comm # Search repositories matching phrase "vim plugin" $ gh search repos "vim plugin" + # Search repositories using multiple search syntax qualifiers as separate arguments + $ gh search repos topic:artificial-intelligence stars:>5000 pushed:>2026-06-01 archived:false + # Search repositories public repos in the microsoft organization $ gh search repos --owner=microsoft --visibility=public From 6ee1a913de49f09bffd043a386ba38afd2884d75 Mon Sep 17 00:00:00 2001 From: happysnaker <73147033+happysnaker@users.noreply.github.com> Date: Tue, 30 Jun 2026 20:54:00 +0800 Subject: [PATCH 2/3] docs(search): simplify raw qualifier examples --- pkg/cmd/search/code/code.go | 2 +- pkg/cmd/search/prs/prs.go | 4 ++-- pkg/cmd/search/repos/repos.go | 4 ++-- 3 files changed, 5 insertions(+), 5 deletions(-) diff --git a/pkg/cmd/search/code/code.go b/pkg/cmd/search/code/code.go index a844b98ec5c..b34691d83dc 100644 --- a/pkg/cmd/search/code/code.go +++ b/pkg/cmd/search/code/code.go @@ -56,7 +56,7 @@ func NewCmdCode(f *cmdutil.Factory, runF func(*CodeOptions) error) *cobra.Comman # Search code matching "error handling" $ gh search code "error handling" - # Search code using multiple search syntax qualifiers as separate arguments + # Search code using raw search qualifiers as separate arguments $ gh search code panic path:pkg language:go # Search code matching "deque" in Python files diff --git a/pkg/cmd/search/prs/prs.go b/pkg/cmd/search/prs/prs.go index 3723e6c0335..07ea9155312 100644 --- a/pkg/cmd/search/prs/prs.go +++ b/pkg/cmd/search/prs/prs.go @@ -52,8 +52,8 @@ func NewCmdPrs(f *cmdutil.Factory, runF func(*shared.IssuesOptions) error) *cobr # Search draft pull requests in cli repository $ gh search prs --repo=cli/cli --draft - # Search pull requests using multiple search syntax qualifiers as separate arguments - $ gh search prs review:required status:success base:main + # Search pull requests using raw search qualifiers as separate arguments + $ gh search prs is:merged author:monalisa # Search open pull requests requesting your review $ gh search prs --review-requested=@me --state=open diff --git a/pkg/cmd/search/repos/repos.go b/pkg/cmd/search/repos/repos.go index c05161cd546..254de8a12c5 100644 --- a/pkg/cmd/search/repos/repos.go +++ b/pkg/cmd/search/repos/repos.go @@ -56,8 +56,8 @@ func NewCmdRepos(f *cmdutil.Factory, runF func(*ReposOptions) error) *cobra.Comm # Search repositories matching phrase "vim plugin" $ gh search repos "vim plugin" - # Search repositories using multiple search syntax qualifiers as separate arguments - $ gh search repos topic:artificial-intelligence stars:>5000 pushed:>2026-06-01 archived:false + # Search repositories using raw search qualifiers as separate arguments + $ gh search repos topic:github 'stars:>5000' # Search repositories public repos in the microsoft organization $ gh search repos --owner=microsoft --visibility=public From 0afaf6fc8c21f42a34a9807901b5ca20627426c9 Mon Sep 17 00:00:00 2001 From: happysnaker <73147033+happysnaker@users.noreply.github.com> Date: Wed, 1 Jul 2026 09:16:37 +0800 Subject: [PATCH 3/3] docs(search): reword raw qualifier examples --- pkg/cmd/search/commits/commits.go | 2 +- pkg/cmd/search/issues/issues.go | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/pkg/cmd/search/commits/commits.go b/pkg/cmd/search/commits/commits.go index a860cc36b0c..14af7c4256f 100644 --- a/pkg/cmd/search/commits/commits.go +++ b/pkg/cmd/search/commits/commits.go @@ -55,7 +55,7 @@ func NewCmdCommits(f *cmdutil.Factory, runF func(*CommitsOptions) error) *cobra. # Search commits matching phrase "bug fix" $ gh search commits "bug fix" - # Search commits using multiple search syntax qualifiers as separate arguments + # Search commits using raw search qualifiers as separate arguments $ gh search commits fix author:monalisa merge:false # Search commits committed by user "monalisa" diff --git a/pkg/cmd/search/issues/issues.go b/pkg/cmd/search/issues/issues.go index 34239ea431a..cc4e7f78e5e 100644 --- a/pkg/cmd/search/issues/issues.go +++ b/pkg/cmd/search/issues/issues.go @@ -50,7 +50,7 @@ func NewCmdIssues(f *cmdutil.Factory, runF func(*shared.IssuesOptions) error) *c # Search issues matching phrase "broken feature" $ gh search issues "broken feature" - # Search issues using multiple search syntax qualifiers as separate arguments + # Search issues using raw search qualifiers as separate arguments $ gh search issues label:bug author:monalisa state:open # Search issues and pull requests in cli organization