{"id":646,"url":"https://github.com/umutphp/awesome-cli","last_synced_at":"2025-09-28T01:30:20.720Z","repository":{"id":45037335,"uuid":"238624420","full_name":"umutphp/awesome-cli","owner":"umutphp","description":"A simple command line tool to give you a fancy command line interface to dive into Awesome lists.","archived":false,"fork":false,"pushed_at":"2025-09-17T21:14:31.000Z","size":486,"stargazers_count":622,"open_issues_count":2,"forks_count":29,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-09-18T14:23:39.434Z","etag":null,"topics":["awesome","awesome-go","awesome-list","hacktoberfest"],"latest_commit_sha":null,"homepage":"","language":"Go","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/umutphp.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT","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,"zenodo":null},"funding":{"patreon":"umutphp"}},"created_at":"2020-02-06T06:40:13.000Z","updated_at":"2025-09-18T02:49:48.000Z","dependencies_parsed_at":"2025-04-24T06:01:26.132Z","dependency_job_id":null,"html_url":"https://github.com/umutphp/awesome-cli","commit_stats":null,"previous_names":[],"tags_count":28,"template":false,"template_full_name":null,"purl":"pkg:github/umutphp/awesome-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/umutphp%2Fawesome-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/umutphp%2Fawesome-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/umutphp%2Fawesome-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/umutphp%2Fawesome-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/umutphp","download_url":"https://codeload.github.com/umutphp/awesome-cli/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/umutphp%2Fawesome-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":276106042,"owners_count":25586191,"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","status":"online","status_checked_at":"2025-09-20T02:00:10.207Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["awesome","awesome-go","awesome-list","hacktoberfest"],"created_at":"2024-01-05T20:13:01.097Z","updated_at":"2025-09-28T01:30:20.714Z","avatar_url":"https://github.com/umutphp.png","language":"Go","readme":"# Awesome CLI\n\nAwesome CLI is a simple command line tool to give you a fancy command line interface to dive into [Awesome](https://github.com/sindresorhus/awesome) lists.\n\n![AWESOME CLI](./assets/images/awesome-cli-banner.png)\n\n![Build](https://github.com/umutphp/awesome-cli/workflows/Test%20\u0026%20Build/badge.svg) ![WOSPM Checker](https://github.com/umutphp/awesome-cli/workflows/WOSPM%20Checker/badge.svg)\n\n---\n\u003c!-- START doctoc generated TOC please keep comment here to allow auto update --\u003e\n\u003c!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE --\u003e\n\n\n- [Introduction](#introduction)\n- [How To Use](#how-to-use)\n  - [Interactive Mode](#interactive-mode)\n  - [Random Mode](#random-mode)\n  - [Surprise Mode](#surprise-mode)\n- [How To Install](#how-to-install)\n  - [Basic](#basic)\n  - [Build as binary](#build-as-binary)\n  - [Download and use official binary](#download-and-use-official-binary)\n  - [CLI Options](#cli-options)\n  - [Sample Execution](#sample-execution)\n- [How To Contribute](#how-to-contribute)\n\n\u003c!-- END doctoc generated TOC please keep comment here to allow auto update --\u003e\n---\n\n## Introduction\n\nThe CLI starts with the root repository [sindresorhus/awesome](https://github.com/sindresorhus/awesome) and guides to to the final repo according to your choices. It fetches Readme files of the repositories and parses them to create the select lists. So, the CLI needs a working network :). It also uses file caches to cache the Readme file contents. You can find the cache folder with name \".awesomecache\" under your home folder.\n\n![Avesome-cli Sample](./assets/images/awesome-cli.gif)\n\n## How To Use\n\n### Interactive Mode\n\nIn order to use awesome-cli interactively, just execute it without giving any option. You will walk through the categories and repositories by using \"↓ ↑ → ←\" buttons. Your choices will be saved to use them in [surprise mode](#surprise-mode).\n\n```bash\n\u003e $ awesome-cli\nUse the arrow keys to navigate: ↓ ↑ → ← \n? Select from 'Awesome' list: \n  ▸ Platforms\n    Programming Languages\n    Front-End Development\n    Back-End Development\n    Computer Science\n    Big Data\n    Theory\n    Books\n    Editors\n↓   Gaming\n```\n\n### Random Mode\n\nYou can use \"random\" option to go a random awesome repository under a random category.\n\n```bash\n\u003e $ awesome-cli random\nawesome-cli Version 0.3.0\n✔ Programming Languages\n✔ Eta\n✔ Community\n✔ IRC\nhttps://kiwiirc.com/client/irc.freenode.net/#eta-lang\n```\n\n### Surprise Mode\n\nWhen you use \"surprise\" option, awesome-cli will use your previous selections in [interactive mode](#interactive-mode) to find a random repository for you.\n\n```bash\n\u003e $ awesome-cli surprise\nawesome-cli Version 0.3.0\n✔ Back-End Development\n✔ Docker\n✔ Videos\n✔ From Local Docker Development to Production Deployments\nhttps://www.youtube.com/watch?v=7CZFpHUPqXw\n```\n\n## How To Install\n\n### Basic\n\nFollow the steps;\n\n```bash\n\u003e $ git clone git@github.com:umutphp/awesome-cli.git\n\u003e $ cd awesome-cli\n\u003e $ go run main.go\n```\n\n### Build as binary\n\nFollow the steps;\n\n```bash\n\u003e $ git clone git@github.com:umutphp/awesome-cli.git\n\u003e $ cd awesome-cli\n\u003e $ sudo go build -o /usr/local/bin/awesome-cli .\n\u003e $ awesome-cli\n```\n\n### Download and use official binary\n\nVisit the [latest release](https://github.com/umutphp/awesome-cli/releases/latest) page, download the zip correspondingly and extract the zip. You can used the binary in the zip file. \n\n```bash\n\u003e $ cp /path/to/zip/extract/awesome-cli /usr/local/bin/awesome-cli\n\u003e $ awesome-cli\n```\n\n### CLI Options\n\nThe CLI works in interactive mode without any given option. But, It can be also called some options described below;\n\n```bash\n\u003e $ awesome-cli help\nawesome-cli Version 0.6.0\n\nOptions of awesome-cli:\n  help      To print this screen.\n  random    To go to a random awesome content.\n  surprise  To go to a surprise awesome content according to your previos choices.\n  profile   To see your previous choices.\n  reset     To clean your choices to start from the beginning.\n  update    Update awesome-cli to the latest version.\n```\n\n### Sample Execution\n\n```bash\n\u003e $ awesome-cli random\nawesome-cli Version 0.2.0\n✔ Platforms\n✔ Linux\n✔ Applications\n✔ Gedit\nhttps://wiki.gnome.org/Apps/Gedit\n```\n\n## How To Contribute\nPlease follow the instructions in [CONTRIBUTING](CONTRIBUTING.md) file and beware of [CODE_OF_CONDUCT](CODE_OF_CONDUCT).\n","funding_links":["https://patreon.com/umutphp"],"categories":["Meta","Related","\u003ca name=\"online\"\u003e\u003c/a\u003eOnline search and resources","Uncategorized","HarmonyOS","Live Site:   [searchAwesome](https://search-awesome.vercel.app/)","Go","🪄 Software Development","awesome-list","Vim (text editor)","Themed Directories"],"sub_categories":["Uncategorized","Windows Manager","Other","Offline usage \u003ca href=\"https://github.com/chubin/cheat.sh#installation\"\u003einstall\u003c/a\u003e cheat script manually\u003cbr\u003e"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fumutphp%2Fawesome-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fumutphp%2Fawesome-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fumutphp%2Fawesome-cli/lists"}