An open API service indexing awesome lists of open source software.

https://github.com/msaaddev/github-interact-cli

🎩 Interact with GItHub right inside your terminal
https://github.com/msaaddev/github-interact-cli

cli github github-api github-cli github-issues github-stars issues javascript node-cli repo repository

Last synced: 7 months ago
JSON representation

🎩 Interact with GItHub right inside your terminal

Awesome Lists containing this project

README

          

![github-interact-cli](https://i.imgur.com/m46Grpf.jpg)


⚑️ github-interact-cli





`github-interact-cli` lets you use GitHub right inside your terminal.

## πŸ‘‰ FEATURES

- πŸ“¦ Create a new repo
- ♻️ Delete your existing repo
- πŸš€ Get all public repos of any GitHub User
- ⚠️ Open issue in any repo.
- βœ‰οΈ Get public email of any GitHub user
- ⭐️ Get stargazers of any GitHub repo

## 🎩 INSTALLATION

Install the CLI globally. If you are windows user, run your command prompt/terminal as administrator. If you are macOS user, add `sudo` before the following command.

```
npm i -g github-interact-cli
```


installation

## πŸ— SETUP

Type the following in the terminal to run the CLI.

```
github
```

CLI will start running. It will ask you to add a **Personal Access Token** & your **GitHub Username**. If you don't know what Personal Access Token is & how to create one, check this [awesome guide](https://help.github.com/en/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line) by GitHub.

`!Note:` Be sure to give the token _repo_, _admin:repo_hook_ & _delete repo_ scopes .

personal access token configurations

Once you are done, exit the CLI so that configurations can be saved & used again.

done

`! Note:` This is one time thing. You will not have to do it again every time you run the CLI.

### πŸ‘Œ Shortcuts

You can now use shortcuts to interact with the CLI. Just type any of the following in the terminal & hit Enter

- New Repo

```
github-new
```

- Delete Repo

```
github-delete
```

- Get All Public Repo

```
github-get
```

- Open Issue

```
github-issue
```

- Get Email

```
github-email
```

- Get Stars

```
github-stars
```

### πŸ“¦ Create New Repo

Write the following in the terminal to run the CLI again.

```
github
```

You will get this menu. πŸ”₯

menu

Enter 1 to Create a GitHub Repo. Then answer the next questions.

done

Taa daa! The repo has been created. You can [check](https://github.com/msaaddev/git-test-repo) it! πŸ₯‚

### ♻️ Delete your Existing Repo

Type the following in the terminal to run the CLI.

```
github
```

You will get this menu. πŸ”₯

menu

Enter 2 to Create a GitHub Repo. Then enter the name of the repo you want to delete.

done

Taa daa! The repo has been deleted. πŸ™ŒπŸ»

`! Note:` Be sure to give your personal access token _delete repo_ scope. If you don't know how to edit your current token, follow these steps.

- Open your GitHub account settings
- Select **Developer settings** from the left sidebar
- Click on **Personal access tokens**
- You will see a list of personal access tokens. Select the token you created earlier for github-interact-cli.
- Scroll down the scope list and select **delete_repo**
- Then scroll at the bottom & select **Update token**

steps of editing personal access token

### πŸš€ Get All Repos

Type the following in the terminal to run the CLI.

```
github
```

You will get this menu. πŸ”₯

menu

Enter 3 to get all GitHub Public Repos of the any GitHub user. Next enter the username of the GitHub user you want to see the repos of.

enter username

Press Enter. And there you have it, folks! πŸ”₯

done

### ⚠️ Open Issue

Type the following in the terminal to run the CLI.

```
github
```

You will get this menu. πŸ”₯

menu

Enter 4 to Create a GitHub Issue. Then answer the next questions.

done

[Click here](https://github.com/msaaddev/vidly/issues/9) to check the issue I just created in the screenshot.

### βœ‰οΈ Get Public Email

Type the following in the terminal to run the CLI.

```
github
```

You will get this menu. πŸ”₯

menu

Enter 5 to get public email of the GitHub user. Then enter the username of the GitHub user.

done

### ⭐️Get Stargazers

Type the following in the terminal to run the CLI.

```
github
```

You will get this menu. πŸ”₯

menu

Enter 6 to get total number of stargazers of any GitHub repos. Then answer the next questions.

done

## πŸš€ FEATURE REQUEST

Use the [Issues](https://github.com/msaaddev/github-interact-cli/issues) section if you want to request any feature or report an issue.

## πŸ™ŒπŸ» PROPS

- Header Image by [Iqra Fatima](https://github.com/iqrafatimame)

## πŸ‘¨πŸ»β€πŸ’» AUTHOR

πŸ™‹πŸ»β€β™‚οΈ Hola! I am Saad, an undergrad Computer Science student. I developed this CLI to automate the repetitive ridiculous amount of things we have to do in GitHub. You can follow me at

- [Twitter](https://twitter.com/msaaddev)
- [Facebook](https://www.facebook.com/msaaddev)
- [Blog](https://msaad.dev)

## ⚑️ Other Projects

I have curated a [detailed list](https://github.com/msaaddev/open-source) of all the open-source projects I have authored. Do take out a moment and take a look.

## πŸ”‘ LICENSE

- MIT