{"id":13433833,"url":"https://github.com/devidw/ghrns","last_synced_at":"2025-03-17T13:31:02.615Z","repository":{"id":41393868,"uuid":"499530408","full_name":"devidw/ghrns","owner":"devidw","description":"GitHub Repository Naming Suggestion Service: AI powered naming suggestions for your GitHub repositories","archived":true,"fork":false,"pushed_at":"2023-01-09T02:19:56.000Z","size":1961,"stargazers_count":18,"open_issues_count":3,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-10-28T16:13:45.915Z","etag":null,"topics":["ai","ai-powered","bex","browser-extension","chrome-extension","ghrns","github","manifest-v3","naming","naming-conventions","naming-strategies","naming-suggest","naming-system","openai","quasar","quasar-framework","suggest","suggester","suggestion","suggestions"],"latest_commit_sha":null,"homepage":"https://chrome.google.com/webstore/detail/poociecpnnmbmbfbmimfnjahceocgppm","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/devidw.png","metadata":{"files":{"readme":"README.adoc","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}},"created_at":"2022-06-03T13:54:21.000Z","updated_at":"2024-07-01T05:52:59.000Z","dependencies_parsed_at":"2023-02-08T08:15:59.832Z","dependency_job_id":null,"html_url":"https://github.com/devidw/ghrns","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devidw%2Fghrns","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devidw%2Fghrns/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devidw%2Fghrns/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devidw%2Fghrns/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/devidw","download_url":"https://codeload.github.com/devidw/ghrns/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244041425,"owners_count":20388236,"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":["ai","ai-powered","bex","browser-extension","chrome-extension","ghrns","github","manifest-v3","naming","naming-conventions","naming-strategies","naming-suggest","naming-system","openai","quasar","quasar-framework","suggest","suggester","suggestion","suggestions"],"created_at":"2024-07-31T02:01:37.548Z","updated_at":"2025-03-17T13:31:02.070Z","avatar_url":"https://github.com/devidw.png","language":"JavaScript","readme":"= GitHub Repository Naming Suggestion Service\n\nLet AI suggest namings for your GitHub repositories. Open any public repo on GitHub, and use the extension as a client to prompt OpenAI for naming suggestions using the GitHub repository's description and your OpenAI API key.\n\nimage:images/cover.png[]\n\n\n== About\n\nEver wondered how to name your GitHub repository?\n\nOften we have a very good understanding of what our code does, but we don't know how to put all of that into a single repository name.\n\nThat's where _GHRNS_ (GitHub Repository Naming Suggestion Service) comes into play: It automatically suggests meaningful names for your repository based on your repository description.\n\nSuggestions are generated by artificial intelligence from https://openai.com/[OpenAI].\n\nThe browser extension automatically detects the current repository you are looking at on GitHub, then you can generate suggestions from the web browser extensions pop-up.\n\nThe extension requires credentials for the OpenAI API. Once you have your API key, you can set it up in the extension options and start generating suggestions.\n\n\n== Installation\n. Get your copy of the extension from the https://chrome.google.com/webstore/detail/poociecpnnmbmbfbmimfnjahceocgppm[Chrome Web Store]\n. Once the installation is complete, you can enter your OpenAI API key in the extension options (right-click the extension icon and select \"Options\")\n\n\n== Usage\nOnce you have finished installing the extension, you can use it to generate suggestions for your GitHub repositories by clicking the extension icon in the browser toolbar.\n\n[cols=\"2\"]\n|===\n| image:images/gh.png[]\na|\nIf you are viewing a public repository on GitHub, the extension will automatically detect it and prefills the current repository name as well as the current username in the pop-up (this info is used to query the public GitHub API to get the repo description, which is used to build your individual prompt).\n\nIn case you are not actively viewing the repository you want to have suggestions for, you can manually enter the repository name and username in the pop-up as well.\n\n| image:images/custom.png[]\na|\nBeside this GitHub flow, you can also use the extension to generate suggestions for a custom repo description. To do so, simply enter the description under the pop-up's \"Custom\" tab.\n\n| image:images/suggestions.png[]\na|\nOnce you have all your details filled in, you can click the button below the form elements to get your suggestions.\n\nAfter requesting your suggestions, you will see a loading indicator for a few seconds, during this period add data needed is fetched, prepared and suggestions are generated.\n\nWhen the suggestions are ready, you will see them in the pop-up formatted as a list.\n\nNote that you can hover over each suggestion and click it to copy it to your clipboard.\n\nIf the repo name you are generating suggestions for is included in the suggestions by the AI, it will be highlighted in the list, in this case the existing repo name is probably a good choice.\n|===\n\n\n== OpenAI App Review\nThis project falls under the _Open-source / BYOK (Bring-Your-Own-Key)_ application domain, itself is not high-stakes or disallowed, uses the end-user's API key, keeps this key at the client side and therefore https://web.archive.org/web/20220630053421/https://beta.openai.com/docs/usage-guidelines/app-review[doesn't require an OpenAI app review].\n\n\n== Privacy practices\n\n=== Single purpose\nIts purpose is to generate meaningful repository names for your GitHub repositories. It acts as a helper tool for developers to name their repositories faster and easier.\n\n=== Permission justification\n\n==== `storage` justification\nStorage is needed to save the API credentials.\n\n==== `tabs` justification\nAccess to the browser tabs is needed to detect the current repository. See if the current tab is a GitHub repository, and if so, get the repository name as well as the username, to get the repo description, which then is used to generate the suggestions.\n\n// ==== `activeTab` justification\n\n\n// ==== Host permission justification\n\n\n==== Remote code justification\nRemote code is needed to generate suggestions, since the corresponding API is not part of the extension, it invokes server-side code of a third party service: OpenAI.\n\n\n---\n\n\n+++\n\u003cp align=center\u003e\n\u003ca href=\"https://www.producthunt.com/posts/github-repository-naming-suggestions?utm_source=badge-featured\u0026utm_medium=badge\u0026utm_souce=badge-github\u0026#0045;repository\u0026#0045;naming\u0026#0045;suggestions\" target=\"_blank\"\u003e\u003cimg src=\"https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=351293\u0026theme=dark\" alt=\"GitHub\u0026#0032;Repository\u0026#0032;Naming\u0026#0032;Suggestions - AI\u0026#0032;powered\u0026#0032;naming\u0026#0032;suggestions\u0026#0032;for\u0026#0032;your\u0026#0032;GitHub\u0026#0032;repositories | Product Hunt\" style=\"width: 250px; height: 54px;\" width=\"250\" height=\"54\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n+++\n","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevidw%2Fghrns","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevidw%2Fghrns","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevidw%2Fghrns/lists"}