gitx-cli

gitx-cli

A global Git helper CLI built with commander.js and chalk.

It provides:

• Commit shortcuts with gitmoji
• Amend support for editing last commits
• Git aliases for frequent commands
• Emoji and alias reference tables in colorful output

Installation

Install globally from npm (once published)

npm install -g gitx-cli

This makes the gx command available system-wide.

Usage

Commit Shortcuts

Each commit type has an associated emoji + label:

gx feature "add login form"
gx fix "resolved signup crash"
gx docs "update API documentation"
gx ui "improve dashboard UI"
gx perf "optimize query execution"

Options:

• -a, --all → Run git add . before committing
• -A, --amend → Amend last commit instead of creating a new one

Example:

gx fix -a "fixed null pointer issue"
gx feature -a -A "add OTP validation"

Amend Last Commit

Rename/relabel your last commit with a new type and message:

gx amend fix "better error handling"
gx amend docs "typo fix in README"

Emoji Reference

See all supported commit types, emojis, and meanings:

gx emoji-list

Emoji	Type	Description
🎉	INIT	Initial project setup
✨	FEATURE	New feature or enhancement
🐛	FIX	Bug fix
🚑	HOTFIX	Urgent production fix
🔥	DELETE	Remove code/files
🔨	REFACTOR	Code restructure (no behavior change)
📚	DOCS	Documentation updates
💄	STYLE	Formatting, styles, UI minor changes
🎨	UI	UI/UX improvements
✅	TEST	Add/update tests
⚡️	PERF	Performance improvements
🚀	DEPLOY	Deployment / CI changes
⬆️	UPGRADE	Upgrade dependencies
🔧	CONFIG	Config or environment changes
👷	CI	CI pipeline changes
🔒	SECURITY	Security related changes
⏪	ROLLBACK	Rollback or revert
🔖	RELEASE	Release/Version tag
🔍	SEO	Search engine optimization
♿️	ACCESSIBILITY	Accessibility improvements
🔀	MERGE	Merge branches
🗑️	CHORE	Routine chores/cleanup

Git Aliases

Run frequent Git commands via short aliases:

gx a <alias> [args...]

Show all aliases:

gx a list

Available Aliases

Alias	Command	Description
ga	git add .	Stage all changes (quickly stage everything).
gs	git status	Show working tree status.
gm	git commit	Create a commit with staged changes.
gp	git push	Push current branch to remote.
gpl	git pull	Pull latest changes from remote.
gco	git checkout	Switch branches or restore files.
gb	git branch	List, create, or delete local branches.
gcm	git checkout main	Quickly switch to main.
gps	git push origin main	Push main to remote.
gplm	git pull origin main	Pull latest changes from main.
gld	git log --oneline --graph --decorate --all	Pretty git log as a decorated graph.
reset-hard	git reset --hard HEAD~1	Rollback last commit and discard changes permanently.
reset-soft	git reset --soft HEAD~1	Undo last commit but keep changes staged.
delete-local-branch	git branch -d <branch>	Delete a local branch.
delete-remote-branch	git push origin --delete <branch>	Delete a remote branch (destructive).
stash	git stash	Save uncommitted changes temporarily.
stash-pop	git stash pop	Reapply most recent stashed changes.
cls	clear	Clear terminal screen.

Examples:

gx a ga
gx a gs
gx a gco feature-branch
gx a delete-local-branch old-branch
gx a list

Examples

gx feature "added login form"
gx fix -a "resolved crash on signup"
gx fix -a --amend "tweak message"
gx amend fix "updated commit message"
gx a ga
gx a gs
gx emoji-list
gx a list

Why Use gitx-cli?

• Faster commits with standardized messages (great for teams).
• Gitmoji support makes commit logs more visual.
• Built-in git aliases save keystrokes.
• Colorful CLI output via chalk.
• Easy to extend - just add more commit types or aliases in code.

Contributing

• Fork the repo
• Create a feature branch
• Add/update commit shortcuts or aliases
• Submit a PR

License

MIT License 2025 Shahid Khan