{"id":14155105,"url":"https://github.com/Link-/starred_search","last_synced_at":"2025-08-06T00:33:24.410Z","repository":{"id":40284820,"uuid":"271088007","full_name":"Link-/starred_search","owner":"Link-","description":"Search your starred ★ repositories on GitHub from your terminal","archived":false,"fork":false,"pushed_at":"2024-03-18T13:07:10.000Z","size":13478,"stargazers_count":137,"open_issues_count":5,"forks_count":1,"subscribers_count":5,"default_branch":"master","last_synced_at":"2024-11-29T01:49:29.259Z","etag":null,"topics":["cli","full-text-search","github","hacktoberfest","nodejs","starred-repositories","starred-search","terminal","tool"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Link-.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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":"2020-06-09T19:08:59.000Z","updated_at":"2024-08-30T17:15:58.000Z","dependencies_parsed_at":"2022-08-09T16:26:25.661Z","dependency_job_id":"cd914ad7-d57c-468e-a03d-7e7a3b53708d","html_url":"https://github.com/Link-/starred_search","commit_stats":{"total_commits":62,"total_committers":3,"mean_commits":"20.666666666666668","dds":0.467741935483871,"last_synced_commit":"625c761a7949e02e06f316fa9de4a246102986ab"},"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Link-%2Fstarred_search","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Link-%2Fstarred_search/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Link-%2Fstarred_search/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Link-%2Fstarred_search/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Link-","download_url":"https://codeload.github.com/Link-/starred_search/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":228821396,"owners_count":17977164,"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":["cli","full-text-search","github","hacktoberfest","nodejs","starred-repositories","starred-search","terminal","tool"],"created_at":"2024-08-17T08:01:56.606Z","updated_at":"2024-12-09T02:30:55.844Z","avatar_url":"https://github.com/Link-.png","language":"JavaScript","funding_links":[],"categories":["JavaScript","cli"],"sub_categories":[],"readme":"```sh\n✴    ✴   ✴              ✴       ✴              ✴                ✴\n  ✴  _      ✴      ✴   ✴        _    ✴              ✴   ✴     _   ✴  \n ___| |_ __ _ _✴__ _ __ ___  __| |    ___ ✴___  __ _ _✴__ ___| |__  \n/ __| __/ _` | '✴_| '__/ _ \\/ _` |  ✴/ __|/ _ \\/✴_` | '__/ __| '_ \\✴\n\\__ \\ || (✴| |✴|  | | |  __/ (_| | ✴ \\__ \\  __/ (_| | | | (__| |✴| |✴\n|___/\\__\\__,_|_|  |_| ✴\\___|\\__,_|___|___/\\___|\\__✴_|_| ✴\\___|_| |_|\n          ✴            ✴        |_____|      ✴       ✴               \n```\n\n\u003e Search your starred ★ repositories on GitHub from your terminal\n\n[![npm](https://img.shields.io/npm/v/starred_search?style=flat-square)](https://www.npmjs.com/package/starred_search) [![npm](https://img.shields.io/npm/dm/starred_search?style=flat-square)](https://www.npmjs.com/package/starred_search) [![GitHub](https://img.shields.io/github/license/link-/starred_search?style=flat-square)](./LICENSE)\n\nYou know those repositories you like and star into the abyss? Yes those, this cli tool will help you do a fuzzy search on them. You can search any GitHub user's starred repositories by providing their handle only.\n\nThis tool will cache the results locally so that you don't risk abusing the API requests limit.\n\n![\"Starred Search Demo\"](./_assets/starred_search.gif)\n\n**Notice:** This project is still in `alpha` and the API might change without notice. Update only after reviewing the changelog for breaking changes.\n\n## Installation\n\n### Minimum Requirements\n\n- 🐧 Linux\n- 🍎 macOS\n- 📦 Node `v12.x.x+`\n\n### Setup\n\n```sh\n# Install\nnpm install starred_search -g\n\n# Usage\nstarred_search --user 'link-' --find 'es6'\n```\n\nI recommend that you create an alias in your shell to avoid repeating the required parameters.\n\nExample alias in fish and bash:\n\n```sh\n# Create an alias (this is temporary, you might want to make it permanent)\nalias stars=\"starred_search --user 'link-'\"\n\n# Then you can use it as:\nstars -f 'es6'\n```\n\n## Usage\n\n```sh\nUsage: starred_search [OPTIONS] [ARGS]...\n\n  Search your or any other user's starred repositories on GitHub for a keyword.\n\nOptions:\n  -h, --help\n    Show this message and exit.\n\n  -u, --user \u003chandle\u003e\n    Any GitHub handle. Example: link-\n\n  -c, --cache-dir \u003cdirectory\u003e\n    Directory you want to store the cache file in. Example: /tmp/.cache\n\n  -f, --find \u003ckeyword\u003e\n    The keyword you want to search for. Example: es6\n\n  -o, --org \u003corg name\u003e  (optional)\n    GitHub organisation name. Example: GitHub\n\n  -l, --limit \u003cnumber\u003e\n    Limit the search results to the specified number. Default is 10\n\n  -V, --verbose\n    Outputs debugging log\n\n  -v, --version\n    Outputs release version\n\n  -d, --debug\n    Outputs stack trace in case an exception is thrown\n```\n\n### Non-verbose output\n\n```sh\nstarred_search --user 'link-' --find 'es6'\n```\n\n```json\n[\n  {\n    \"repo_name\": \"lukehoban/es6features\",\n    \"repo_description\": \"Overview of ECMAScript 6 features\",\n    \"repo_url\": \"https://github.com/lukehoban/es6features\",\n    \"repo_stars\": 27672\n  },\n  {\n    \"repo_name\": \"google/sa360-flightsfeed\",\n    \"repo_description\": \"Generate SA360 compatible feeds for airlines on BigQuery  :rocket:\",\n    \"repo_url\": \"https://github.com/google/sa360-flightsfeed\",\n    \"repo_stars\": 8\n  },\n  {\n    \"repo_name\": \"DrkSephy/es6-cheatsheet\",\n    \"repo_description\": \"ES2015 [ES6] cheatsheet containing tips, tricks, best practices and code snippets\",\n    \"repo_url\": \"https://github.com/DrkSephy/es6-cheatsheet\",\n    \"repo_stars\": 11410\n  }\n]\n```\n\n### Verbose output \u0026 override cache directory\n\n```sh\nstarred_search --user 'link-' --cache-dir '/tmp/.cache' --find 'es6' --verbose\n```\n\n```json\n🕵    INFO: Searching for \"es6\" in \"link-'s\" starred catalogue\n⚠️    INFO:: Serving search results from cache\n[\n  {\n    \"repo_name\": \"lukehoban/es6features\",\n    \"repo_description\": \"Overview of ECMAScript 6 features\",\n    \"repo_url\": \"https://github.com/lukehoban/es6features\",\n    \"repo_stars\": 27672\n  },\n  {\n    \"repo_name\": \"google/sa360-flightsfeed\",\n    \"repo_description\": \"Generate SA360 compatible feeds for airlines on BigQuery  :rocket:\",\n    \"repo_url\": \"https://github.com/google/sa360-flightsfeed\",\n    \"repo_stars\": 8\n  },\n  {\n    \"repo_name\": \"DrkSephy/es6-cheatsheet\",\n    \"repo_description\": \"ES2015 [ES6] cheatsheet containing tips, tricks, best practices and code snippets\",\n    \"repo_url\": \"https://github.com/DrkSephy/es6-cheatsheet\",\n    \"repo_stars\": 11410\n  }\n]\n```\n\n### Parsing the output with jq\n\nYou can pipe the standard output to be handled by tools like [jq](https://stedolan.github.io/jq/) for more magic:\n\n```sh\n# Return the first search result only\nstarred_search -u 'link-' -f 'es6' | jq '.[0]'\n```\n\n```json\n{\n  \"repo_name\": \"lukehoban/es6features\",\n  \"repo_description\": \"Overview of ECMAScript 6 features\",\n  \"repo_url\": \"https://github.com/lukehoban/es6features\",\n  \"repo_stars\": 27672\n}\n```\n\n```sh\n# Return repo_name of every result element\nstarred_search -u 'link-' -f 'es6' | jq 'map(.repo_name)'\n```\n\n```json\n[\n  \"lukehoban/es6features\",\n  \"google/sa360-flightsfeed\",\n  \"DrkSephy/es6-cheatsheet\"\n]\n```\n\n### Using a personal access token to increase the API rate limit\n\nYou can use a personal access token to increase the API rate limit from 60 requests per hour to 5000 requests per hour. Learn more about personal access tokens [here](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens).\n\n```sh\n# Assuming you're using a bash shell\nexport GITHUB_TOKEN=\"ghp_1234567890\"\nstarred_search -u 'link-' -f 'es6'\n```\n\n```json\n{\n  \"repo_name\": \"lukehoban/es6features\",\n  \"repo_description\": \"Overview of ECMAScript 6 features\",\n  \"repo_url\": \"https://github.com/lukehoban/es6features\",\n  \"repo_stars\": 27672\n}\n```\n\n## Release History\n\n- 0.1.12\n  - [x] Update packages to resolve security vulnerabilities\n- 0.1.11\n  - [x] Fix `repo_url` value to reference the Repository's GitHub URL\n  - [x] Default homepage_url to `N.A`\n- 0.1.10\n  - [x] Add release workflow\n  - [x] Add [contributing guide](./CONTRIBUTING.md)\n- 0.1.9\n  - [x] Replaced the flaky fuzzy search with an enhanced full text search\n  - [x] Updated cache invalidation logic to rely on etags\n  - [x] Add -d, --debug option\n  - [x] Automatic discovery of cache directory based on OS\n  - [x] Updates user agent for API requests\n- 0.1.8\n  - [x] **API BREAKING CHANGES**\n  - [x] Change alias for --verbose from -v to -V\n  - [x] Add -v, --version option\n- 0.1.7\n  - [x] Added -h, --help option\n  - [x] Added -l, --limit option to limit the search results\n- 0.1.6\n  - [x] Added aliases to documentation\n- 0.1.5\n  - [x] **API BREAKING CHANGES**\n  - [x] Add verbose flag\n  - [x] Fix output to return valid JSON\n  - [x] Fix output to return results in an array instead of separated objects\n- 0.1.0 - 0.1.4\n  - [x] Basic functionality\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FLink-%2Fstarred_search","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FLink-%2Fstarred_search","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FLink-%2Fstarred_search/lists"}