{"id":18521765,"url":"https://github.com/gjbae1212/findgs","last_synced_at":"2025-04-09T09:33:24.005Z","repository":{"id":57514135,"uuid":"240153531","full_name":"gjbae1212/findgs","owner":"gjbae1212","description":"FindGS is an interactive CLI that searches from README, NAME, TOPICS for wanted starred repositories quickly.🔥","archived":false,"fork":false,"pushed_at":"2022-09-13T02:50:55.000Z","size":84,"stargazers_count":80,"open_issues_count":0,"forks_count":5,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-03-24T04:43:24.913Z","etag":null,"topics":["cli","findgs","github","gitstar","go","golang","search"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gjbae1212.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-02-13T01:40:17.000Z","updated_at":"2025-03-18T19:55:54.000Z","dependencies_parsed_at":"2022-08-31T22:01:40.307Z","dependency_job_id":null,"html_url":"https://github.com/gjbae1212/findgs","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gjbae1212%2Ffindgs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gjbae1212%2Ffindgs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gjbae1212%2Ffindgs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gjbae1212%2Ffindgs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gjbae1212","download_url":"https://codeload.github.com/gjbae1212/findgs/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248012864,"owners_count":21033254,"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","findgs","github","gitstar","go","golang","search"],"created_at":"2024-11-06T17:27:32.293Z","updated_at":"2025-04-09T09:33:23.314Z","avatar_url":"https://github.com/gjbae1212.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# FindGS\n\n\u003cp align=\"left\"\u003e\n\u003ca href=\"https://hits.seeyoufarm.com\"/\u003e\u003cimg src=\"https://hits.seeyoufarm.com/api/count/incr/badge.svg?url=https%3A%2F%2Fgithub.com%2Fgjbae1212%2Ffindgs\"/\u003e\u003c/a\u003e\n\u003ca href=\"https://img.shields.io/badge/language-golang-blue\"\u003e\u003cimg src=\"https://img.shields.io/badge/language-golang-blue\" alt=\"language\" /\u003e\u003c/a\u003e\n\u003ca href=\"/LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/license-MIT-GREEN.svg\" alt=\"license\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n**FindGS** searches for **your starred repositories** in Github that are matched your input text to README, Name, Topic, Description.\n\n**Motivation**  \nMaybe you have many starred repositories in github for using it in someday.   \nWith stacking more and more your starred repositories, you can **difficult** to find **wanted repositories** in starred repositories.   \nBecause github site doesn't officially support to search for it in README.          \n\n**FindGS** is an interactive CLI using your github token for searching repositories.\n\u003e Notice that **FindGS** makes internally caching db and indexing in local.\n\u003e Because Github API is limited 5000 per hourly, so it's required something for caching and for searching with higher performance.  \n\u003e So It would slow it boots somewhat for caching and indexing if the first run it.  \n\u003e And **FindGS** updates cached data an interval of 1 hour when running it.  \n\u003e **If you have had starred repositories more than 5000**, you should run findgs an interval of 1 hour for caching rest repositories.(Github API is limited 5000 per hourly)  \n\u003e As a result, All of starred repositories can store caching db and indexing in local.\n\nIt's implemented using **Golang**.\n\u003cbr/\u003e \u003cbr/\u003e\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://storage.googleapis.com/gjbae1212-asset/findgs/findgs_hello.gif\"/\u003e\n\u003c/p\u003e\n\u003cbr/\u003e\n\n## Getting Started\n\n### Prerequisite\nIt's required [**github personal access token**](https://github.com/settings/tokens).\n(But scopes of token aren't required.)\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://storage.googleapis.com/gjbae1212-asset/findgs/findgs_token2.png\"/\u003e\n\u003c/p\u003e\n\u003cbr/\u003e\n\n  \n**This token should set global environment or pass to **findgs**.**\n```bash\n# ex 1)\n$ export GITHUB_TOKEN=your-github-token # .zshrc or .bash_profile \n$ findgs run \n# ex 2)\n$ findgs run -t your-github-token \n```\n\n### Install\nUse to **Homebrew** if you want to install mac, but also you can download from [**releases**](https://github.com/gjbae1212/findgs/releases).\n```bash\n# mac \n$ brew tap gjbae1212/findgs\n$ brew install findgs\n\n# linux\n$ wget https://github.com/gjbae1212/findgs/releases/download/v1.0.5/findgs_1.0.5_Linux_x86_64.tar.gz\n\n# window\n$ wget https://github.com/gjbae1212/findgs/releases/download/v1.0.5/findgs_1.0.5_Windows_x86_64.tar.gz\n```\n\u003cbr/\u003e  \n\n## Features\n**FindGS** is currently to support the following features:\n- ```findgs run```\n- ```findgs clear```\n\n------\n### findgs run\nRun an interactive CLI for searching your starred repositories in Github.\n```bash\n# 1)\n$ findgs run # need to `export GITHUB_TOKEN=your-token`\n# 2)\n$ findgs run -t your-github-token \n```\n \n**An interactive CLI** is currently to support the following commands: \n \n**1. search**  \nThis command searches your starred repositories using input text. Also it's to support wildcard searching.  \n```bash  \n\u003e\u003e search [searhing text(ex cli tool, hello* ...)] \n```  \n\n**2. open**  \nThis command show your selected repository to browser.  \n```bash\n\u003e\u003e open name [searched repositories name]\n\u003e\u003e open num [searched column num]\n```\n\n**3. list**  \nThis command show recently searched result.\n```bash\n\u003e\u003e list\n```\n\n**4. score**  \nThis command sets a score that can search repositories equal to or higher than the score.( 0 \u003c= score)\n```bash\n# default score 0.1\n\u003e\u003e score 0.5 # change score to 0.5 \n```\n\n**5. exit**  \nThis  program.\n```bash\n\u003e\u003e exit \n```    \n------\n\n### findgs clear\nDelete cached db and indexed data in local.\n```bash\n$ findgs clear\n```\n\n## License\nThis project is following The MIT.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgjbae1212%2Ffindgs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgjbae1212%2Ffindgs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgjbae1212%2Ffindgs/lists"}