kgit-cli

A fast, human-friendly Git CLI helper

Add, commit, push — all in one command.

Installation

npm install -g kgit-cli
# or
yarn global add kgit-cli

Requires Node.js ≥ 14 and git installed on your system.

Quick Start

# Stage everything, commit, and push
kgit -a -m "feat: add dark mode"

# Stage specific files, commit, and push
kgit src/index.js styles/app.css -m "fix: responsive layout"

# Pull latest changes
kgit --pull

# Check status
kgit -s

Commands

Commit & Push

| Command | Description | |---|---| | kgit -a -m "msg" | Stage all → commit → push | | kgit file1 file2 -m "msg" | Stage files → commit → push | | kgit --add-only -a | Stage all, then stop | | kgit --commit-only -a -m "msg" | Stage + commit, skip push | | kgit --push | Push current branch | | kgit --push --force | Force push | | kgit --pull | Pull current branch |

Info

| Command | Description | |---|---| | kgit -s | Git status | | kgit -l | Git log — last 20 commits (graph) | | kgit diff | Show unstaged diff | | kgit diff --cached | Show staged diff | | kgit diff <file> | Diff a specific file | | kgit -v | Show kgit-cli version |

Branch

| Command | Description | |---|---| | kgit branch | List all branches | | kgit branch <name> | Create and switch to new branch | | kgit switch <name> | Switch to an existing branch | | kgit merge <branch> | Merge branch into current | | kgit --delete-branch <name> | Delete a local branch |

Stash

| Command | Description | |---|---| | kgit stash | Stash working changes | | kgit stash pop | Apply the latest stash | | kgit stash list | List all stashes |

Tags

| Command | Description | |---|---| | kgit tag | List all tags | | kgit tag <name> | Create a lightweight tag |

Repo Setup

| Command | Description | |---|---| | kgit --init | Initialize a git repository | | kgit --clone <url> | Clone a repository | | kgit --remote | Show remote URLs | | kgit --set-remote [url] | Add or update origin | | kgit --remove-git [--force] | Remove .git folder |

Undo / Rollback

| Command | Description | |---|---| | kgit --unstage [file] | Unstage a file (or all) | | kgit --untrack <file> | Remove file from git tracking | | kgit --undo-last | Soft reset HEAD~1 (keep changes) | | kgit --undo-hard | Hard reset HEAD~1 (discard changes) | | kgit --revert-last | Create a revert commit for HEAD | | kgit --reset <ref> | Soft reset to a commit or ref | | kgit --reset-hard <ref> | Hard reset to a commit or ref | | kgit --restore <file> | Discard working file changes | | kgit --restore <file> --from <ref> | Restore a file from a specific commit |

Meta

| Command | Description | |---|---| | kgit update | Self-update kgit-cli (auto-detects npm/yarn) | | kgit --help | Show help |

Examples

# Full workflow: branch → code → commit → push
kgit branch feature/login
# ... write code ...
kgit -a -m "feat: add login page"

# Switch to main and merge
kgit switch main
kgit merge feature/login
kgit --push

# Temporarily stash, fix something, then restore
kgit stash
kgit switch hotfix/crash
# ... fix the bug ...
kgit -a -m "fix: crash on startup"
kgit switch feature/login
kgit stash pop

# View staged changes before committing
kgit diff --cached

# Undo the last commit (keep changes)
kgit --undo-last

# Restore a file to its state 2 commits ago
kgit --restore src/api.js --from HEAD~2

# Tag a release
kgit tag v1.0.0
kgit --push

# Self-update
kgit update

Why kgit?

• Zero dependencies — uses only Node.js built-ins
• Fast startup — no transpilation, no heavy frameworks
• Works everywhere — Windows, macOS, Linux
• Smart defaults — sets upstream on first push automatically
• One command — no more chaining git add && git commit && git push

License

MIT © Watcharapong Namsaeng