Skip to main content

Search git from the command line

Project description

Git Search

Simple command line to search github.


git-search is a simple command line tool that allows you to search for users and repositories in GitHub.


To install git search you can use pip with the following command;

pip3 install gitsearch-cli


By default the search will be scoped to look in repositories, however you can change the scope to look specifically for users.

Searching for Users

git-search --scope users owen rumney


git-search --scope users owenrumney

This will yield the following results;

username url

Searching for repositories

When searching for repositories you can create a general search by keyword or focus the search by including the language and/or user.

git-search -l scala -u apache spark

This will give the following result;

name owner url
fluo-muchos apache
predictionio apache
spark apache
spark-website apache

If you want to only return results where the keyword is in the name, you can use the --nameonly flag

git-search -l scala -u apache spark --nameonly

This will give the following result;

name owner url
spark apache
spark-website apache

Date based criteria

You can search for repositories based on created or updated dates using natural date periods, all of the below examples are acceptable (not limited to this). If you use a date period that isn't acceptable, the search will use the beginning of time (1979-30-10)

git-search -l=scala --updated="last week" # return 30 scala projects updated in the last week

git-search -l=python --created="yesterday" # return 30 scala projects created yesterday

git-search gitsearch -l=python --created "3 days ago"  # return 30 scala projects created yesterday


  • Add date based options for search criteria
  • Add tests
  • Refactor the code to be more pythonic

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

gitsearch-cli-1.0.0.tar.gz (3.3 kB view hashes)

Uploaded source

Built Distribution

gitsearch_cli-1.0.0-py3-none-any.whl (4.5 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page