qit-cli

Qit 🚀

A simple CLI tool to automate your git workflow. Qit combines the three most common git commands (git add ., git commit -m, and git push) into a single command.

Installation

Global Installation(preferred)

To install the qit-cli globally so it can be used anywhere on your system:

npm install -g qit-cli

Local Installation

If you prefer to install it locally in a specific project folder:

npm install qit-cli

To run it locally, use npx in your project folder:

npx qit "Your commit message"

If installed glabally, just use qit in your project folder:

qit "Your commit message"

Usage

Basic Usage

To quickly stage, commit and push your changes, use:

qit "your commit message"

The command above will:

• Stage all changes (git add .)
• Create a commit with your message (git commit -m "your message")
• Push to your current branch (git push origin )

Examples

# Fix a bug
qit "fixed navigation menu bug"

# Add new feature

qit "added dark mode support"

# Update documentation

qit "updated installation docs"

Handling Failed Pushes

If a push fails (e.g., due to no internet connection), the changes will be committed locally but remain unpushed. When your internet connection is restored, you can try pushing again using:

qit p

This will run:

git push origin <branch>

Default Settings

• Qit automatically detects your current branch and pushes to it
• All changes are staged using git add .
• Changes are pushed to origin remote

Features

Core Features

• Single Command Operation: Execute multiple git commands with one command
• Auto Branch Detection: Automatically detects and pushes to your current branch
• Smart Defaults: Works out of the box with sensible defaults
• Clear Feedback: Colorful terminal output shows operation progress

Terminal Output

• Stage changes: Blue indicators
• Commit progress: Yellow indicators
• Push status: Magenta indicators
• Success messages: Green indicators
• Error messages: Red indicators with clear descriptions

Requirements

System Requirements

• Node.js 14 or higher
• Git installed and configured
• Active internet connection for pushing
• A git repository initialized with a remote

Repository Requirements

• Initialized git repository
• Configured remote repository
• Valid git credentials

Error Handling

Qit provides clear error messages for common issues:

Common Errors

• No Commit Message

✗ Error: Please provide a commit message
Usage: qit <commit message>

• git operation failure

ERROR
✗ Git operation failed: [error details]

Error Prevention

• Always include a commit message
• Ensure you have internet connection before pushing
• Check that your git credentials are configured
• Verify that your repository has a remote configured

Dependencies

• execa: Modern subprocess handling
• ansi-colors: Terminal styling
• fs & path: File system operations

Contributing

Getting Started

• Fork the repository
• Create a feature branch
• Make your changes
• Submit a pull request