/gh

A super simple Github CLI to handle Pull Request

Primary LanguageTypeScriptMIT LicenseMIT

PRs Welcome License MIT

Simple CLI to help users with Github Commands using google/zx

🏠 Getting started

This project is a helper, to guide and help begginers with tipical activities used at Liferay, to interact with Github, such as Send, List and Get a Pull Request from some fork;

The project is under development and may not be fit 100% your needs. So, if you want something more robust, I'd like to suggest using Github CLI or Node-GH

Actually, this project has some inspiration with Node-GH.

📖 Requirement

Node.js >= 14.8.0 Git >= 1.7.0

⚡ Install

npm i -g yarn # Skip if you already use it
npm i -g zx
yarn
yarn link

After run yarn link an alias you'll be added into you aliases type gitray into any git project to see if it's working.

⚙️ Configuration

After everything setup, open a terminal of your preference and type gitray step, like this;

First access configuration

You need to fill some fields;

  • What is your GitHub username: Is the user you're signed in.
  • What is your GitHub Signature: This Signature is used when you are fetching a PR from someone and a message is added there.
  • What is your GitHub Token: You need to create a GitHub Personal Access Token for this. Follow these steps:
    • Login in your Github Account
    • Go to this page: https://github.com/settings/tokens
    • Generate new token
    • Generate Token
    • Put a fancy name, on Note Input
    • Put expiration date you want, I suggest to choose a longer expiration date, or no expiration for this.
    • On Select Scopes, check all the boxes inside repo
    • On the bottom, click on Generate Token
    • After generate a token, you'll be redirect to other screen, copy the generated token inside the green box, and use as GitHub Token in this CLI.
    • Generated Token
  • What is your Branch Prefix: Whenever you fetch a PR from someone, a branch is created using this prefix and the Pull Request ID, if you are fetching the 100 from pt-liferay-solutions/liferay-portal a branch called pr-100 will be created.

And after the first access configuration, this will'be the first screen

First access configuration

🤝 Contributing

If you liked the project and want to cooperate feel free to fork this repository and send Pull Requests.

All kinds of contributions are very welcome and appreciated

  • ⭐️ Star the project
  • 🐛 Find and report issues
  • 📥 Submit PRs to help solve issues or add features

📖 License

MIT license, Copyright (c) 2021 Keven Leone.