https://github.com/seiffert/ghrepos
Filter GitHub repositories by topic with ease
https://github.com/seiffert/ghrepos
github
Last synced: 11 months ago
JSON representation
Filter GitHub repositories by topic with ease
- Host: GitHub
- URL: https://github.com/seiffert/ghrepos
- Owner: seiffert
- License: mit
- Created: 2017-02-03T20:27:46.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2017-03-02T12:12:07.000Z (almost 9 years ago)
- Last Synced: 2025-01-29T05:14:59.302Z (about 1 year ago)
- Topics: github
- Language: Go
- Homepage:
- Size: 33.2 KB
- Stars: 3
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ghrepos
[](https://travis-ci.org/seiffert/ghrepos)
[](https://goreportcard.com/report/github.com/seiffert/ghrepos)
[](https://lima.codeclimate.com/github/seiffert/ghrepos)
**ghrepos** is a simple CLI tool that allows you to find GitHub repositories with a specific
[topic](https://help.github.com/articles/about-topics/). This is particularly useful when you automate the
configuration of build tools or the management of your GitHub repositories.
## Example Usage
```bash
$ ghrepos --owner seiffert example-topic
seiffert/example-repo-1
seiffert/example-repo-2
seiffert/example-repo-3
```
To authenticate against the GitHub API, **ghrepos** optionally takes a GitHub access token. This is required if you want
to list private repositories.
Generate a token one in [your account settings](https://github.com/settings/tokens) and pass it either as environment
variable `GITHUB_TOKEN` or via the `--token` option:
```bash
$ ghrepos --owner seiffert --token example-topic
```
## Installation
To install **ghrepos**, download a binary from the provided
[GitHub releases](https://github.com/seiffert/ghrepos/releases) and put it into a folder that is part of your
system's `$PATH`.
## Contribution
If you have ideas for improving this little tools or just a question, please don't hesitate to open an
[issue](https://github.com/seiffert/ghrepos/issues/new) or even fork this repository and create a pull-request!