Manage watched vs unwatched GitHub repositories.
When working in a GitHub organization with many repositories it can be tough to discover:
- what new repos exist that could be useful?
- what repos are getting a lot of activity, that I need to know about?
- what repos am I watching that I do not care about anymore?
GitHub's notifications web app is great, but
as far as I can tell it does not provide these answers. repo_watch
is a command-line tool for discovering this info!
- Clone the source
git clone https://github.com/guidorice/repo_watch.git cd repo_watch/
- Get Rust for building this app. https://rustup.rs/ is a good source if you do not have Rust.
- Build and install using Rust's
cargo
command:cargo install --path . # now a repo_watch binary should be on your PATH repo_watch --help
repo_watch
uses the GitHub API, so get a GitHub token if you do not have one already, see https://github.com/settings/tokens . Set your token inGITHUB_TOKEN
environment variable. Alternatively, you set add the GITHUB_TOKEN in a.env
file.export GITHUB_TOKEN=******
$ repo_watch --help
Repo π Watch 0.1.2
Alex G Rice <alex@ricegeo.dev>
Manage watched vs unwatched github repositories.
USAGE:
repo_watch [OPTIONS] <scope> [sort]
FLAGS:
-h, --help Prints help information
-V, --version Prints version information
OPTIONS:
-n, --name <name> github user name or organization name (defaults to current authenticated user)
ARGS:
<scope> scope of search: github organization, github user, or all visible to user (all organizations)
[possible values: Org, User, All]
<sort> sort by recent activity, or creation date (defaults to alpha (alphabetical) [default: alpha]
[possible values: Alpha, Active, Newest]
EXAMPLES:
# repos belonging to authenticated user
repo_watch user
# public repos belonging to another github username
repo_watch user --name {username}
# repos belonging to an organization name
repo_watch org --name {orgname}
# all repos * all orgs, which the authenticated user has visibility into
repo_watch all
# optionally specify sort order: alpha, active, or newest
repo_watch all active
I am not currently a member of the georust organization, but I can still see all it's public repos!
Note: repo_watch
works with private repositories as well, since it authenticates you to the Github API.
$ repo_watch org --name georust
fetching github user info...
hello, guidorice!
fetching list of repos you are watching...
found 69 watching repos
fetching repos owned by organization georust...
scope: georust github organization
watching repos (9)
π https://github.com/georust/docker-images
π https://github.com/georust/gdal (β¨ 89 stars) (π΄ 28 forks)
π https://github.com/georust/geo (β¨ 577 stars) (π΄ 71 forks)
π https://github.com/georust/geocoding (β¨ 35 stars) (π΄ 9 forks)
π https://github.com/georust/geohash (β¨ 41 stars) (π΄ 11 forks)
π https://github.com/georust/geojson (β¨ 105 stars) (π΄ 22 forks)
π https://github.com/georust/georust.org (π΄ 1 fork)
π https://github.com/georust/geotiff (β¨ 7 stars) (π΄ 5 forks)
π https://github.com/georust/osm (β¨ 12 stars) (π΄ 3 forks)
not-watching repos (17)
π΄ https://github.com/georust/assets
π΄ https://github.com/georust/geographiclib-rs (β¨ 3 stars)
π΄ https://github.com/georust/geos (β¨ 37 stars) (π΄ 17 forks)
π΄ https://github.com/georust/geos-sys (β¨ 1 star)
π΄ https://github.com/georust/gpx (β¨ 31 stars) (π΄ 15 forks)
π΄ https://github.com/georust/meta (β¨ 1 star)
π΄ https://github.com/georust/netcdf (β¨ 25 stars) (π΄ 11 forks)
π΄ https://github.com/georust/polyline (β¨ 10 stars) (π΄ 4 forks)
π΄ https://github.com/georust/proj (β¨ 37 stars) (π΄ 10 forks)
π΄ https://github.com/georust/proj-sys (π΄ 5 forks)
π΄ https://github.com/georust/robust (β¨ 5 stars) (π΄ 3 forks)
π΄ https://github.com/georust/shapefile (β¨ 4 stars) (π΄ 2 forks)
π΄ https://github.com/georust/tilejson (β¨ 1 star)(π΄ 2 forks)
π΄ https://github.com/georust/topojson (β¨ 5 stars) (π΄ 2 forks)
π΄ https://github.com/georust/transitfeed (β¨ 7 stars) (π΄ 3 forks)
π΄ https://github.com/georust/wkt (β¨ 25 stars) (π΄ 11 forks)
π΄ https://github.com/georust/world-file (β¨ 4 stars)
In Terminal.app you can click through the github.com URLs to see additional info and of course, to watch or un-watch.