gitcmmt

gitcmmt is a lightweight and user-friendly CLI tool designed to simplify and streamline your Git workflow. It automates common Git tasks like staging, committing, and pushing changes, while allowing flexibility through configurable options.

Features

• Automate Git Commands:
  • Automatically run git add . to stage changes.
  • Commit changes with customizable messages.
  • Push to the desired remote and branch.
• Customizable Flags:
  • Skip specific steps (--skip-add, --skip-push).
  • Customize the branch (--branch) and remote (--remote).
  • Specify commit messages manually (--msg) or use quick templates (--dbg for "Bugs fixed").
• Interactive Push Confirmation:
  • Ask for confirmation before pushing changes.
• Auto-Push Option:
  • Automatically push changes with the --auto-push flag.

Installation

Install the package globally via npm:

npm install -g gitcmmt

Or run directly using npx:

npx gitcmmt

Usage

Basic Usage

Run the tool to stage, commit, and optionally push changes:

npx gitcmmt

Available Options

| Option | Description | Default | |-----------------|-----------------------------------------------------------------------------|--------------| | --skip-add | Skip the git add . step. | false | | --skip-push | Skip the git push step. | false | | --branch | Specify the branch to push changes to. | main | | --remote | Specify the remote repository. | origin | | --msg | Manually set a commit message. | Auto-generated | | --dbg | Use a quick commit message: "Bugs fixed". | false | | --auto-push | Automatically push changes without asking for confirmation. | false |

Examples

1. Default

Run the tool without --auto-push to get a prompt asking whether to push changes:

npx gitcmmt

2. Commit and Push to main

npx gitcmmt --msg "Updated README" --auto-push

3. Skip Push Step

npx gitcmmt --skip-push

4. Customize Remote and Branch

npx gitcmmt --remote upstream --branch develop

5. Use Quick Commit Message

npx gitcmmt --dbg

How It Works

1. Stage Changes: Automatically stages all changes unless --skip-add is used.
2. Commit Changes: Commits with a message provided by --msg, --dbg, or an auto-generated summary of changes.
3. Push Changes: Pushes changes to the remote and branch specified, with an optional confirmation step unless --auto-push is enabled.

Contributing

We welcome contributions! If you have ideas for improvement or find bugs, feel free to open an issue or submit a pull request.

Support

If you encounter issues, please open an issue on GitHub.

Happy coding! 🚀