/EasyGit-CLI

Primary LanguageJavaScript

EasyGit CLI

npm install -g easygit-cli

The EasyGit CLI is a simple command line interface for Git that automates the process of initializing a new Git repository, adding files to the staging area, committing changes, and pushing them to a remote repository. It is built using Node.js and the simple-git library.

Installation

To install the EasyGit CLI, you will need to have Node.js installed on your computer. Once you have Node.js installed, you can install it by running the following command:

npm install -g easygit-cli

or update with

npm update -g easygit-cli

This will install the EasyGit CLI globally on your computer, allowing you to use it from any directory.

Enabling Scripts on Windows

If you are using Windows, you need to enable the execution of scripts in PowerShell

HOW?

  • Open PowerShell as Administrator.
  • Run the following command to allow script execution:
Set-ExecutionPolicy RemoteSigned

Usage

First Push Command

The first-push command initializes a new Git repository, stages all files, commits them with the message "Initial Commit", switches the branch to main, sets the remote origin (or uses the existing one), and pushes the changes to the remote repository.

Syntax

easygit first-push [repo]
  • repo: Optional. The URL of the remote repository to push changes to. If not provided, the user will be prompted to enter the repository URL.

Example

easygit first-push https://github.com/username/repository.git

Push Command

The push command stages changes, commits them with a provided commit message, and pushes the changes to the remote repository. You need to supply a commit message.

Syntax

easygit push [commitMessage]
  • commitMessage: Optional. If not provided, you will be prompted to enter a commit message.

Example

easygit push "refactored index file"
easygit push

Alias Command

The alias feature in easygit-cli allows you to create custom aliases for existing commands. This feature is useful when you want to create shortcuts for frequently used commands or when you want to customize the command names to fit your workflow.

Syntax

easygit add-alias [alias] [command]
  • alias & command: Optional. If not provided, you will be prompted to enter both.

Example

easygit add-alias fp first-push

Config Command

The config command returns the global Git username and email if they are set. If they are not available, it prompts the user to enter them and sets the global configuration accordingly.

Syntax

easygit config

Revert Command

The revert command reverts the local Git repository to the previous commit, and force pushes the changes to the remote repository on GitHub.This command finds the commit hash of the previous commit, resets the local repository to that commit, and force pushes the changes to the remote repository on GitHub. Be careful when using this command, as it will overwrite the remote repository with your local repository. This can cause issues if other people are also working on the repository.

Syntax

easygit revert

Contributing

Contributions are welcome! Please follow these steps to contribute:

  • Fork the repository.
  • Create a new branch with a descriptive name.
  • Make your changes and commit them with a clear message.
  • Push your changes to your fork.
  • Submit a pull request.

or

  • Create an issue

License

The Git CLI is licensed under the MIT License. See the MIT License file for more information.

Contact

If you have any questions or feedback, please feel free to contact me at okekedavid1333@gmail.com or send a dm on linkedIn: https://www.linkedin.com/in/obinna-okeke-0a7445173/.