How to Use GitHub Search Like a Pro

How to Use GitHub Search Like a Pro

Rajdeep Singh

GitHub is a popular code collaboration platform for developers. You can use it to share, manage, and contribute to open-source codebases, save and work on your own code, and more. And to be a more effective GitHub user, you'll need to know how to search within the platform. This involves using qualifiers to efficiently filter through millions of repositories and billions of lines of code. Precise queries help you locate specific function definitions, projects, people, issues, pull requests, code, security vulnerabilities, or contribution opportunities. In this tutorial, you'll learn how to use GitHub search, whether you're a beginner or a pro developer. To enhance your learning, I've divided this article into two sections:

Basic Search Functionality

Advanced Search Functionality

What We'll Cover:

What We’ll Cover:

Basic Search Functionality

How to Search Globally

How to Do a Scoped Search (for a Particular Repo or Organization)

Advanced Search Functionality

Search Qualifiers

How to Save Searches

How to Manage Saved Searches on GitHub

Why Do We Need GitHub Advanced Search?

Conclusion

Basic Search Functionality Basic search here refers to the most commonly used search functionalities that are fast and easy to use. To start, click the GitHub search icon, type your query, and GitHub will display your results. With basic search, you can search globally across all of GitHub or narrow your search to a specific repository or organization. How to Search Globally To search on GitHub, click the search tab or press the / key to open the search bar.

To search globally (across all of GitHub), open the search input, type your query, and select "Search all of GitHub" from the dropdown menu or press enter.

After clicking the "Search all of GitHub" button, you'll be directed to a page displaying all results related to your query.

How to Do a Scoped Search (for a Particular Repo or Organization) To search within a specific repository or organization, go to the repository or organization page, enter your query in the search field at the top, and press Enter. For instance, if you're searching for a file name starting with "pnpm" in the frontendweb repository:

In the search bar, you'll see four suggestions: the first is "Search in this repository," the second is "Search in this organization," the third is "Search all of GitHub," and the last is the code section "Display similar files." Clicking a file opens it in the GitHub web editor. Advanced Search Functionality In addition to the GitHub search bar, you can search on GitHub using the advanced search page. GitHub's advanced search allows you to find specific code, repositories, and issues. You can filter your searches by factors such as the number of stars, owners, forks, followers, programming language, and creation dates. As you complete the advanced search fields, your query is automatically generated in the top search bar, and you can click on the Search button.

For a basic example, let's search for React on GitHub, including recent pull and push requests, issues, commits, discussions, and so on, related to ReactJS. We can use GitHub's advanced search functionality for this. Type "React" in the first input field as text and add the owner, in this case, Facebook, to find everything related to ReactJS in the Facebook organization or user.

After clicking on the Search button, you should see the following results page:

As you can see, GitHub's advanced search functionality lets you find specific code, repositories and issues using a powerful set of qualifiers and options. Let's talk more about qualifiers now. Search Qualifiers You can filter your search directly using various key qualifiers. We can divide these qualifiers into different sections: Advanced Options

From these owners: type the specific user's or organization's name, such as GitHub, Atom, Electron, Octokit, and so on.

In these repositories: type the specific user's or organization's name, such as Facebook/React, Vercel/Next.js, and so on.

Created on these dates: Specify the repository creation date, for example >2016-04-29, =2016-04-29, etc., to learn more, check out the Query for dates documentation.

Written in this language: Select the specific language that matches repositories from lists: JavaScript, TypeScript, Rust, and so on, or what it’s written in.

Repository Options

With this many stars: Type the number of stars in the stars: field to filter and find repositories by star count. You can apply comparisons like >1000 (more than 1000 stars) or =1000 (exactly 1000 stars) to narrow results based on popularity.

With this many forks: Type the number of forks to filter and find repositories by fork count. You can apply comparisons like 100..1000 (find repos with 100 to 1000 forks), >1000 (more than 1000 forks), or =1000 (exactly 1000 forks) to narrow results based on popularity.

Of this size: type the repository size in KB to filter and find repositories, for example, size of 10000 KB

Pushed to: type the date to filter and find repositories, for example >2013-02-01 matches repositories with the word "react" that were pushed to after January 2013.

With this license: Select the license to filter or find repositories based on license, for example, those licensed under the Apache License 2.0.

Code Options

With this extension: type the extension, such as rb, py, or jpg, that you want to search on GitHub.

In this path: Type the path to filter on GitHub to search for files by their location within a repository. For example, you can find a header.tsx file specifically inside the ./components folder by combining filename: with path:.

With this file name: Type the file name, such as app, footer, or header, that you want to search on GitHub.

Issue Options

In the state: Select the issue state (whether the issue is open or closed), for example, libraries state:open mentions:rajdeep matches open issues that mention @rajdeep with the word "libraries," or language:JavaScript state:open matches open issues in JavaScript repositories.

With this many comments: Enter the comment number based on the comment count. You can filter the issue, for example, state:closed comments:>100 matches closed issues with more than 100 comments, or comments:500..1000 matches issues with comments ranging from 500 to 1,000.

With the labels: Enter the label to filter or narrow your results by labels. Since issues can have multiple labels, you can list and add multiple label qualifiers for each issue. For example, first, label:bug label:resolved matches issues with the labels "bug" and "resolved." Second, label:bug,resolved matches issues with the label "bug" or the label "resolved." Third, example broken in:body -label:bug label:priority matches issues with the word "broken" in the body, that lack the label "bug," but do have the label "priority."

Opened by the author: Enter the name or username to filter or find issues created by a user or integration account, or filter the issues based on the author. For example, author:rajdeep matches issues with the word "fixed" that were created by @rajdeep, or author:octocat matches issues created by the account named "octocat."

Mentioning the users: Enter the name or username to find issues that mention the user. For example, fixed mentions:rajdeep matches issues with the word "fixed" that mention @rajdeep in the issue.

Assigned to the users: Enter the name or username to find or filter issues based on the specific username assigned to the issue. For example, state:open assignee:rajdeep matches open issues that are assigned to @rajdeep.

Updated before the date: Enter the date, filter issues based on the time of creation, or when they were last updated. For example language:c# created:=2013-02-01 matches issues with the word "weird" in the body that were updated after February 2013.

User Options

With this full name: Enter a full name to filter repositories whose name includes “rajdeep singh” on GitHub.

From this location: Enter a location to find users on GitHub. For example, location:russia language:javascript returns users based in Russia whose repositories are primarily written in JavaScript.

With this many followers: Enter a follower count to filter users by popularity. For example, followers:>=1000 finds users with 1,000 or more followers, while followers:1..10 rajdeep returns users with 1–10 followers whose name includes “rajdeep” on GitHub.

With this many public repositories: Enter a repository count to filter users by the number of public repositories they have. For example, repos:>10 finds users with more than 10 repositories, while repos:10..30 returns users who have between 10 and 30 public repositories on GitHub.

Working in this language: Select the language to find users based on the primary languages of their repositories. For example, language:javascript location:russia returns users in Russia whose repositories are mostly written in JavaScript, while language:javascript fullname:rajdeep finds users with JavaScript repositories whose full name includes "rajdeep" on GitHub.

Wiki Options

Updated before the date: Enter a date to filter wiki pages containing “next.js” that were last updated after 2016-01-01 in your GitHub wiki.

The best way to use advanced search qualifiers is to combine one or multiple qualifier/search options to achieve the best result. How to Save Searches I don't often use GitHub Advanced Search, but I used it to find open-source projects to learn from and co