{"id":17442559,"url":"https://github.com/jez/stargaze","last_synced_at":"2025-04-13T08:20:42.952Z","repository":{"id":73798655,"uuid":"80898799","full_name":"jez/stargaze","owner":"jez","description":":star: Gaze at repos you've starred","archived":false,"fork":false,"pushed_at":"2017-02-05T19:45:28.000Z","size":13,"stargazers_count":20,"open_issues_count":1,"forks_count":3,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-27T00:11:06.888Z","etag":null,"topics":["bash","cli","github","github-api"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jez.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-02-04T06:25:00.000Z","updated_at":"2023-12-29T15:21:05.000Z","dependencies_parsed_at":"2023-03-25T11:18:02.139Z","dependency_job_id":null,"html_url":"https://github.com/jez/stargaze","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jez%2Fstargaze","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jez%2Fstargaze/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jez%2Fstargaze/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jez%2Fstargaze/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jez","download_url":"https://codeload.github.com/jez/stargaze/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248681598,"owners_count":21144715,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bash","cli","github","github-api"],"created_at":"2024-10-17T16:17:43.132Z","updated_at":"2025-04-13T08:20:42.918Z","avatar_url":"https://github.com/jez.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# stargaze\n\n```\nstargaze - gaze at repos you've starred\n\nusage:\n  stargaze fetch \u003cgithub-user\u003e   fetch (or refetch) your starred repos\n  stargaze random [\u003cn\u003e]          fetch \u003cn\u003e random starred repos [default: 1].\n```\n\nThis is a simple command line script to fetch random repos that you've starred\non GitHub. It's useful as inspiration for finding hack ideas, passing the\ntime, and rediscovering nifty projects I'd been meaning to revisit.\n\n## Example\n\n```console\n$ stargaze random\nhttps://github.com/carols10cents/rustlings\nSmall exercises to get you used to reading and writing Rust code\n\n$ stargaze random\nhttps://github.com/sobolevn/git-secret\n:busts_in_silhouette: A bash-tool to store your private data inside a git repository.\n```\n\n## Installation\n\nIt's just a simple bash script. Download `stargaze` and put it on your PATH.\n\nAlternatively, there's a Homebrew formula if you're on macOS:\n\n```\nbrew install jez/formulae/stargaze\n```\n\nIf you want to take it up a notch, you can even add an alias like this in your\nbashrc/zshrc:\n\n```\nalias bored='stargaze random'\n```\n\n## Dependencies\n\nThis script requires that `jq` and `shuf` or `gshuf` is on your PATH. If it's\nnot check the installation instructions for your system:\n\n- \u003chttps://stedolan.github.io/jq/\u003e\n- `brew install coreutils` (to get `shuf` on OS X)\n\n## Usage\n\nWe're using the GitHub API, which means you can run into rate limiting issues.\nFor this reason, requests to the GitHub API are cached, and only read from the\ncache.\n\nFirst: initialize the cache:\n\n```\nstargaze fetch GITHUB_USER\n```\n\nThis dumps a file to `$XDG_CACHE_HOME/stargaze/starred-repos.json`.\n\nWhenever you feel like updating the cache (i.e., you've starred a bunch of new\nrepos), just re-run `stargaze fetch GITHUB_USER`\n\nSecond: ask for a random repo:\n\n```\nstargaze random\n```\n\nAlternatively, you can ask for more than one at a time:\n\n```\nstargaze random 10\n```\n\n\n## LICENSE\n\n[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](https://jez.io/MIT-LICENSE.txt)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjez%2Fstargaze","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjez%2Fstargaze","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjez%2Fstargaze/lists"}