In 30 seconds
- What it is — a single-binary
bash wrapper for git. Short interactive commands replace long flag chains.
- Who it's for — developers who want clean conventional commits, smart pull/push/sync, and undo-everything safety without memorizing git plumbing.
- What's different — AI commit messages that can run fully local via Ollama (no key, no network), atomic split, WIP backup across machines, full worktree menu — all in one bash file.
gitb commit push # stage, write a conventional commit, push — in one flow
gitb commit ai # AI-generated commit message
gitb sync # fetch main + rebase your branch
gitb wip up # stash WIP, push backup branch, clean working tree
gitb undo # roll back your last commit / amend / merge / rebase / stash
Install
Pick one — all three install the same single gitb file.
Homebrew (macOS, Linux)
brew install maxbolgarin/tap/gitbasher
Install script — puts gitb in ~/.local/bin, no sudo. Downloads the latest release, verifies its SHA-256, and prints a PATH hint if needed.
curl -fsSL https://raw.githubusercontent.com/maxbolgarin/gitbasher/main/install.sh | bash
npm — Node is only needed for the install; gitb itself is pure bash.
npm install -g gitbasher
System-wide installs, custom locations and pinned versions: More install options. How to upgrade each one: Updating.
Check what you have: gitb version prints the version, the path of the binary that ran, how it was installed, and the right update command. It also warns when two copies are installed and a different one wins on your PATH. gitb -v prints just the version line, for scripts.
Requirements: bash 3.2+ (the macOS system bash is fine) and git 2.23+. AI features also need jq. On Windows, use WSL.
Quick start
cd your-project
gitb # see all commands
gitb cfg user # set your name/email once
gitb cfg ai # (optional) set up AI for smart commits (provider, key, model)
gitb status # what's changed?
gitb commit # interactive conventional commit
gitb push # safe push with conflict handling
gitb pull # smart pull (rebase / merge / ff)
gitb branch new # create a new conventionally-named branch
Every command has a short alias (gitb c, gitb p, gitb pu, gitb b, gitb s, …) and inline help (gitb commit help).
Before & after
You just write what you want to do, and gitbasher will do it for you. All commands have a short alias, for example gitb c is equivalent to gitb commit.
| Task | Plain git | With gitb |
|---|
| Start a feature off updated main | git fetch && git checkout main && git pull --ff-only && git checkout -b feat/x | gitb branch newd |
| Conventional commit + push | git add -A && git commit -m "feat(x): …" && git push -u origin HEAD | gitb commit ai fast push |
| Sync your branch with main | git fetch && git rebase origin/main && git push --force-with-lease | gitb sync push |
| Save WIP & clean tree across machines | git stash -u && git push origin "HEAD:wip/$(git symbolic-ref --short HEAD)" | gitb wip up |
| Undo last commit (keep changes staged) | git reset --soft HEAD~1 | gitb undo |
| Tidy a messy branch into clean commits | (interactive rebase, fold by hand) | gitb squash |
Table of contents
Why gitbasher
- Zero memorization — no flags to remember, no man pages to grep. Interactive menus where it matters, short aliases where it doesn't.
- Conventional commits, free — type/scope/summary picker built-in, with optional ticket prefixes and a multiline editor mode.
- AI commit messages —
gitb c ai writes the message from your diff. OpenRouter (Gemini/Claude/GPT/…), OpenAI direct, or fully local via Ollama — no key, no network, no data leaves your machine.
- Safer git — push/pull detect conflicts up front,
undo rolls back commit/amend/merge/rebase/stash, reset is interactive with a preview.
- Whole workflows, not just commands —
sync, wip, branch newd, merge to-main, squash chain the steps you'd otherwise do by hand.
- One file, no deps — pure bash for every git operation; only the AI features need
jq and curl. Drop the binary anywhere on PATH and go. 1,000+ BATS tests run on Linux, macOS and bash 3.2 in CI.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
