gitbash 2.0.1 → 2.2.0

package/README.md

@@ -6,57 +6,103 @@ Pure bash, zero-dependency git utilities. Reduce repetitive typing and superchar
 
 ## Installation
 
-### Via npm
+Needs git >= 2.23 and bash >= 3.2. fzf (menus), delta (diffs) and bat (previews) are optional but recommended.
+
+### macOS
+
+```bash
+npm i -g gitbash
+brew install fzf git-delta bat
+gitbash --config
+```
+
+Shell integration (lets you type `commit` instead of `gitbash commit`):
 
 ```bash
-npm i -g gitbash && gitbash --config
+## for bash
+echo 'eval "$(gitbash --init)"' >> ~/.bashrc
+
+## for zsh
+echo 'eval "$(gitbash --init)"' >> ~/.zshrc
 ```
 
-### Options
+### Linux
 
 ```bash
-gitbash --help         # Show help
-gitbash --version      # Show version
-gitbash --init         # Print shell functions (see Shell integration)
-gitbash --config       # Interactive configuration wizard
-gitbash --config-local # Configure overrides for the current repository (committed)
-gitbash --config-user  # Configure personal overrides for the current repository
+npm i -g gitbash
+sudo apt install fzf git-delta bat   # Debian/Ubuntu, needs fzf >= 0.36
+gitbash --config
 ```
 
-### Dependencies
+Shell integration:
 
 ```bash
-# Required
-git >= 2.23, bash >= 3.2
+## for bash
+echo 'eval "$(gitbash --init)"' >> ~/.bashrc
 
-# Optional (recommended)
-brew install fzf        # Interactive menus and previews (fzf >= 0.36)
-brew install git-delta  # Better diff highlighting
-brew install bat        # File preview with syntax highlighting
+## for zsh
+echo 'eval "$(gitbash --init)"' >> ~/.zshrc
 ```
 
-### Shell integration
+### Windows
 
-Add to your `.zshrc` or `.bashrc` to call the commands without the `gitbash` prefix:
+In Git Bash (part of [Git for Windows](https://gitforwindows.org)); in WSL, follow the Linux steps:
 
 ```bash
-eval "$(gitbash --init)"             # commit, switch, status, ...
-eval "$(gitbash --init --prefix=gb-)" # gb-commit, gb-switch, ... (avoids shadowing e.g. /usr/bin/pr)
+npm i -g gitbash
+winget install junegunn.fzf dandavison.delta sharkdp.bat   # needs fzf >= 0.54
+gitbash --config
 ```
 
-This defines small wrapper functions; every command still runs in its own bash process, so nothing else is added to your shell. Individual aliases work too, e.g. `alias commit="gitbash commit"`.
+Shell integration for Git Bash:
 
-### Upgrading to 2.0
+```bash
+echo 'eval "$(gitbash --init)"' >> ~/.bashrc
+```
+
+Shell integration for PowerShell: create the functions in Git Bash, then load them in your profile in PowerShell:
 
-2.0 is a security and safety release. What changes for you:
+```bash
+gitbash --init --shell=pwsh > ~/gitbash.ps1   # switch is a PowerShell keyword: use gitbash switch
+```
+
+This creates your PowerShell profile if needed, loads `gitbash.ps1` from it in every new window, and allows local scripts to run (Windows PowerShell 5.1 blocks them by default):
+
+```powershell
+if (!(Test-Path $PROFILE)) { New-Item -Force $PROFILE }
+Add-Content $PROFILE '. ~/gitbash.ps1'
+Set-ExecutionPolicy -Scope CurrentUser RemoteSigned   # Windows PowerShell 5.1 only
+```
+
+### Without npm
+
+Installation by script on machines without npm available
+
+```bash
+# macOS, Linux, Git Bash (or: wget -qO- ... | sh)
+curl -fsSL https://raw.githubusercontent.com/jaggli/gitbash/main/install.sh | sh
+```
+
+```powershell
+# Windows PowerShell (needs Git for Windows)
+irm https://raw.githubusercontent.com/jaggli/gitbash/main/install.ps1 | iex
+```
 
-- **Restart your shell** after upgrading, so `eval "$(gitbash --init)"` picks up the new wrapper functions.
-- Config files are **read, not executed**: only plain `GITBASH_*="value"` lines are used, other lines are ignored with a warning. `GITBASH_MERGE_COMMAND` is ignored in a committed `.gitbashrc`.
-- `status` no longer commits and pushes after staging. Use `Ctrl-O` to commit.
-- `stale` toggles all/stale branches with `Ctrl-T` (was `Ctrl-A`).
-- Protected branches (base branch and `GITBASH_PROTECTED_BRANCHES`) are never offered for deletion. `cleanup` and `switch` delete with `git branch -d` and ask again before force-deleting unmerged work.
-- When your branch and the remote diverged, `commit -p`, `pr -p` and `update -p` ask whether to rebase, merge or abort instead of rebasing silently.
-- fzf 0.36 or newer is required for the interactive menus.
+It installs to `~/.local/share/gitbash` and links `~/.local/bin/gitbash` (add that folder to your PATH if the script says so); delete both to uninstall. Set `GITBASH_VERSION` for a specific version, and `GITBASH_INSTALL_DIR` / `GITBASH_BIN_DIR` for other locations.
+
+## Options
+
+| Option | Description |
+| --- | --- |
+| `-h`, `--help` | Show the help |
+| `-v`, `--version` | Show the version |
+| `--update` | Update to the latest release (npm, pnpm or install script) |
+| `--init` | Print shell functions to call commands without the `gitbash` prefix |
+| `--init --prefix=gb-` | Prefixed functions: `gb-commit`, `gb-switch`, ... (avoids shadowing e.g. `/usr/bin/pr`) |
+| `--init --shell=pwsh` | PowerShell functions instead of bash/zsh |
+| `--config` | Configuration wizard (`~/.gitbashrc`); offers to install dependencies and the shell integration |
+| `--config-local` | Overrides for the current repository (`.gitbashrc`, committed) |
+| `--config-user` | Personal overrides for the current repository (`.gitbashrc-user`, not committed) |
 
 ## Commands
 
@@ -115,7 +161,7 @@ create enhance login screen             # → feature/enhance-login-screen (pars
 switch [FILTER...]
 ```
 
-Switch branches with fzf. Shows local branches (`merged:` = fully merged into the base branch), then remote branches without a local copy. Preview shows commit history. If exactly one branch name matches the filter, switches directly. After switching, offers to fast-forward a branch that is behind.
+Switch branches with fzf. Shows local branches (`merged:` = fully merged into the base branch), then remote branches without a local copy. Preview shows commit history. Switches directly when the filter is an exact branch name or matches exactly one branch name. After switching, offers to fast-forward a branch that is behind.
 
 - `Del` deletes the selected local branch (asks first, default no; unmerged commits need a second confirmation)
 
@@ -162,6 +208,22 @@ pr [-p|--push] [--print]
 
 Open the pull request in the browser: the existing PR via the GitHub CLI when available, otherwise the create page (GitHub, GitHub Enterprise, GitLab, Bitbucket, Azure DevOps). Offers to commit local changes and to push a branch that is not on the remote yet. `-p` pushes first, `--print` prints the URL.
 
+### repo
+
+```bash
+repo [--print]
+```
+
+Open the repository's web page in the browser: via the GitHub CLI (`gh repo view --web`) when available, otherwise the URL derived from the remote (GitHub, GitHub Enterprise, GitLab, Bitbucket, Azure DevOps). `--print` prints the URL.
+
+### reset-repo
+
+```bash
+reset-repo [-n|--dry-run] [-y|--yes]
+```
+
+Reset the current branch like a fresh clone: fetch, `git reset --hard <remote>/<branch>` and delete all untracked and ignored files (`git clean -dx`). Lists the unpushed commits, local changes and files it removes and asks first. Aborts an unfinished merge or rebase. Files matching `GITBASH_RESET_KEEP` (e.g. `.env`), `.gitbashrc-user` and nested repositories are kept; stashes and other branches are not touched.
+
 ### update
 
 ```bash
@@ -238,14 +300,15 @@ Unpushed commits are shown per branch. Deletes with `git branch -d`; force-delet
 ### commits
 
 ```bash
-commits [COUNT]
+commits [-a|--all] [COUNT]
 ```
 
-List recent commits with option to revert. Multi-select with TAB; selected commits are reverted newest first.
+List the current branch's own commits with option to revert. On a feature branch only commits not in the base branch are shown; on the base branch its first-parent history (merged branches as their merge commit). If the upstream has new commits, offers to fast-forward first. Multi-select with TAB; selected commits are reverted newest first.
 
 ```bash
-commits        # Show last 20 commits
-commits 50     # Show last 50 commits
+commits          # Show the branch's last 20 commits
+commits 50       # Show up to 50
+commits --all    # All recent commits, like git log
 ```
 
 ## Configuration
@@ -278,11 +341,17 @@ GITBASH_CLEANUP_DAYS="7"
 # Branches never offered for deletion, space-separated globs
 GITBASH_PROTECTED_BRANCHES="main master develop release/*"
 
+# Files 'reset-repo' keeps, space-separated .gitignore patterns, e.g. ".env .idea/" (default: "")
+GITBASH_RESET_KEEP=""
+
 # Base branch (default: detected from origin/HEAD, then main, then master)
 GITBASH_BASE_BRANCH=""
 
 # Remote name (default: "origin")
 GITBASH_REMOTE="origin"
+
+# Turn off the automatic update checks: yes or no (default: "no")
+GITBASH_NO_UPDATE_CHECKS="no"
 ```
 
 Config files are **read, never executed**. Only `GITBASH_*="value"` lines are used (double, single or no quotes, optional `export`, `# comments`). Values cannot contain `$`, backticks, backslashes or quotes; anything else is ignored with a warning.
@@ -301,6 +370,18 @@ Run `gitbash --config-user` to create `.gitbashrc-user` for personal overrides i
 2. `.gitbashrc` - Repository settings (committed)
 3. `~/.gitbashrc` - Global settings
 
+#### Updates
+
+`gitbash --update` installs the latest release the same way gitbash was installed: with `npm install -g` (or `pnpm add -g`) for a global package, or by running the release's install script again for the same locations.
+
+gitbash also checks for new releases on its own, at most once a day, in the background while a command runs, so commands never wait for the network. When a new version is known, the next command at a terminal asks (at most every other day) whether to update now, not now, or skip that version for good. It never asks in scripts or pipes.
+
+To turn the checks off, answer "no" in `gitbash --config` or `--config-user`, set `GITBASH_NO_UPDATE_CHECKS="yes"` in any config file, or export `GITBASH_NO_UPDATE_CHECKS=1`. They are also off in CI (`CI` and similar variables) and when running from a git checkout. The check state is kept in `~/.local/state/gitbash/update-check` (`$XDG_STATE_HOME` if set).
+
+#### Colors
+
+gitbash supports [`NO_COLOR`](https://no-color.org): set it to any non-empty value (e.g. `export NO_COLOR=1`) to turn off all colors, including the help, messages, the git output in previews and `bat`. `delta` is not used then, and fzf uses its black-and-white theme. Colors are also left out when the output is not a terminal.
+
 ## License
 
 See [LICENSE](LICENSE) file for details.

package/bin/gitbash

@@ -10,12 +10,20 @@ while [[ -L "$SOURCE" ]]; do
 done
 SCRIPT_DIR="$(cd -P "$(dirname "$SOURCE")/.." && pwd)"
 GITBASH_BIN="$SCRIPT_DIR/bin/gitbash"
+# pnpm keeps each version in its own folder (node_modules/.pnpm/gitbash@X/node_modules/gitbash):
+# run gitbash through the node_modules/gitbash link instead, which follows updates
+if [[ "$SCRIPT_DIR" == */node_modules/.pnpm/gitbash@*/node_modules/gitbash &&
+      -x "${SCRIPT_DIR%%/.pnpm/*}/gitbash/bin/gitbash" ]]; then
+    GITBASH_BIN="${SCRIPT_DIR%%/.pnpm/*}/gitbash/bin/gitbash"
+fi
 COMMANDS_DIR="$SCRIPT_DIR/commands"
 VERSION="$(grep -o '"version": *"[^"]*"' "$SCRIPT_DIR/package.json" | head -1 | cut -d'"' -f4)"
 export SCRIPT_DIR GITBASH_BIN VERSION
 
 # shellcheck source=../commands/_utils.sh
 source "$COMMANDS_DIR/_utils.sh"
+# shellcheck source=../commands/_self_update.sh
+source "$COMMANDS_DIR/_self_update.sh"
 
 # Available commands
 COMMANDS=(
@@ -26,6 +34,8 @@ COMMANDS=(
     "commits"
     "create"
     "pr"
+    "repo"
+    "reset-repo"
     "stale"
     "stash"
     "stashes"
@@ -50,7 +60,7 @@ is_command() {
 # key|type|question
 SETTINGS=(
     "GITBASH_CREATE_BRANCH_PREFIX|prefix|Branch prefix inserted between type and branch name (e.g. 'team' → feature/team/PROJ-123-fix-bug)"
-    "GITBASH_CREATE_NO_ISSUE_PARSING|parsing|Parse Jira issue numbers into branch names? (yes/no)"
+    "GITBASH_CREATE_NO_ISSUE_PARSING|inverted|Parse Jira issue numbers into branch names? (yes/no)"
     "GITBASH_CREATE_ISSUE_PARSING_FALLBACK|text|Fallback issue prefix when no issue number is given"
     "GITBASH_CREATE_AUTO_PUSH|yesno|Push new branches to the remote right after 'create'? (yes/no)"
     "GITBASH_MERGE_COMMAND|command|Merge tool opened by 'update' on conflicts (not allowed in the committed .gitbashrc)"
@@ -58,8 +68,10 @@ SETTINGS=(
     "GITBASH_STALE_MONTHS|number|Stale remote branch threshold in months (used by 'stale')"
     "GITBASH_CLEANUP_DAYS|number|Stale local branch threshold in days (used by 'cleanup')"
     "GITBASH_PROTECTED_BRANCHES|text|Branches never offered for deletion (space-separated globs)"
+    "GITBASH_RESET_KEEP|text|Files kept by 'reset-repo' (space-separated .gitignore patterns, e.g. '.env .idea/')"
     "GITBASH_BASE_BRANCH|text|Base branch (empty = detect from the remote's HEAD, then main/master)"
     "GITBASH_REMOTE|text|Remote name"
+    "GITBASH_NO_UPDATE_CHECKS|inverted|Check for gitbash updates now and then, and offer to install them? (yes/no)"
 )
 
 # Default value of a setting
@@ -74,6 +86,7 @@ setting_default() {
         GITBASH_CLEANUP_DAYS) echo "7" ;;
         GITBASH_PROTECTED_BRANCHES) echo "main master develop release/*" ;;
         GITBASH_REMOTE) echo "origin" ;;
+        GITBASH_NO_UPDATE_CHECKS) echo "no" ;;
         *) echo "" ;;
     esac
 }
@@ -91,10 +104,10 @@ file_value() {
 }
 
 # Convert between the stored value and what the wizard shows.
-# GITBASH_CREATE_NO_ISSUE_PARSING is stored inverted.
+# GITBASH_CREATE_NO_ISSUE_PARSING and GITBASH_NO_UPDATE_CHECKS are stored inverted.
 to_display() {
     local type="$1" value="$2"
-    if [[ "$type" == "parsing" ]]; then
+    if [[ "$type" == "inverted" ]]; then
         [[ "$value" == "yes" ]] && echo "no" || echo "yes"
     else
         printf '%s' "$value"
@@ -109,7 +122,7 @@ to_stored() {
         return 1
     fi
     case "$type" in
-        parsing)
+        inverted)
             case "$answer" in
                 yes) echo "no" ;;
                 no) echo "yes" ;;
@@ -183,7 +196,9 @@ configure_wizard() {
     for entry in "${SETTINGS[@]}"; do
         n=$((n + 1))
         IFS='|' read -r key type question <<< "$entry"
-        [[ "$scope" == "local" && "$key" == "GITBASH_MERGE_COMMAND" ]] && continue
+        if [[ "$scope" == "local" ]]; then
+            [[ "$key" == "GITBASH_MERGE_COMMAND" || "$key" == "GITBASH_NO_UPDATE_CHECKS" ]] && continue
+        fi
 
         default=$(setting_default "$key")
         has_override=false
@@ -284,7 +299,17 @@ exclude_user_config() {
     print_info "Added .gitbashrc-user to $exclude"
 }
 
-# Report missing optional dependencies and offer to install them with Homebrew
+# winget package id of a dependency
+winget_id() {
+    case "$1" in
+        fzf) echo "junegunn.fzf" ;;
+        git-delta) echo "dandavison.delta" ;;
+        bat) echo "sharkdp.bat" ;;
+    esac
+}
+
+# Report missing optional dependencies and offer to install them with
+# Homebrew, or winget on Windows
 check_dependencies() {
     local missing=() dep
     command -v fzf >/dev/null 2>&1 || missing+=("fzf")
@@ -301,18 +326,35 @@ check_dependencies() {
 
     echo "Missing optional dependencies: ${missing[*]}"
     echo "  fzf (>= $GB_FZF_MIN_VERSION) - interactive menus, git-delta - diff highlighting, bat - file previews"
-    if ! command -v brew >/dev/null 2>&1; then
-        echo "Install them with your package manager, e.g.: sudo apt install ${missing[*]}"
+    local -a install
+    local manager
+    if gb_is_windows; then
+        manager="winget"
+        install=(winget install --exact --id)
+    else
+        manager="Homebrew"
+        install=(brew install)
+    fi
+    if ! command -v "${install[0]}" >/dev/null 2>&1; then
+        if gb_is_windows; then
+            echo "Install them with a package manager, e.g.: scoop install ${missing[*]/git-delta/delta}"
+        else
+            echo "Install them with your package manager, e.g.: sudo apt install ${missing[*]}"
+        fi
         return 0
     fi
-    if gb_confirm "Install them with Homebrew?" y; then
+    local package
+    if gb_confirm "Install them with $manager?" y; then
         for dep in "${missing[@]}"; do
-            if brew install "$dep"; then
+            package="$dep"
+            gb_is_windows && package=$(winget_id "$dep")
+            if "${install[@]}" "$package"; then
                 print_success "$dep installed"
             else
                 print_error "Failed to install $dep"
             fi
         done
+        gb_is_windows && print_info "Open a new terminal to pick up the installed programs."
     fi
 }
 
@@ -356,14 +398,38 @@ check_shell_integration() {
 # Help and shell integration
 # =============================================================================
 
-show_help() {
-    cat << EOF
-gitbash $VERSION - Interactive git utilities for bash
+# ASCII art logo with a color gradient, followed by the version.
+# Plain text when stdout is not a terminal or NO_COLOR is set.
+show_banner() {
+    local -a art=(
+        '        _ _   _               _     '
+        '   __ _(_) |_| |__   __ _ ___| |__  '
+        '  / _` | | __| '"'"'_ \ / _` / __| '"'"'_ \ '
+        ' | (_| | | |_| |_) | (_| \__ \ | | |'
+        '  \__, |_|\__|_.__/ \__,_|___/_| |_|'
+        '  |___/                             '
+    )
+    local -a colors=(214 209 204 199 170 135)
+    local i
+    if _gb_color_ok 1; then
+        for i in "${!art[@]}"; do
+            printf '\033[1;38;5;%sm%s\033[0m\n' "${colors[$i]}" "${art[$i]}"
+        done
+        printf '  \033[1;38;5;135mv%s\033[0m \033[2m·\033[0m Interactive git utilities for bash\n' "$VERSION"
+    else
+        printf '%s\n' "${art[@]}"
+        printf '  v%s - Interactive git utilities for bash\n' "$VERSION"
+    fi
+}
 
+show_help() {
+    show_banner
+    echo
+    gb_help << EOF
 Usage:
     gitbash <command> [args...]
-    gitbash --help | --version
-    gitbash --init [--prefix=PREFIX]
+    gitbash --help | --version | --update
+    gitbash --init [--prefix=PREFIX] [--shell=pwsh]
     gitbash --config | --config-local | --config-user
 
 Commands:
@@ -371,9 +437,11 @@ Commands:
   cleanstash  Delete stashes (multi-select)
   cleanup     Find and delete leftover local branches
   commit      Commit with optional push
-  commits     List recent commits with revert option
+  commits     List the branch's commits with revert option
   create      Create feature branch with Jira parsing
   pr          Open PR in browser
+  repo        Open the repository in browser
+  reset-repo  Reset the branch like a fresh clone
   stale       List stale remote branches
   stash       Create named stash
   stashes     Interactive stash menu
@@ -385,8 +453,10 @@ Commands:
 Options:
   -h, --help       Show this help message
   -v, --version    Show version number
+  --update         Update gitbash to the latest release
   --init           Print shell functions for calling commands directly
-                   (--prefix=gb- creates gb-commit, gb-switch, ...)
+                   (--prefix=gb- creates gb-commit, gb-switch, ...;
+                   --shell=pwsh prints PowerShell functions)
   --config         Configure gitbash and save to ~/.gitbashrc
   --config-local   Configure overrides for this repository (.gitbashrc, committed)
   --config-user    Configure personal overrides for this repository (.gitbashrc-user)
@@ -399,6 +469,7 @@ Examples:
 Shell Integration:
   Add to your .zshrc or .bashrc:
     eval "\$(gitbash --init)"
+  PowerShell: see 'gitbash --init --shell=pwsh'
 
   This enables calling commands directly:
     commit fix bug -p
@@ -414,10 +485,12 @@ EOF
 # Print wrapper functions for the interactive shell. Commands still run in
 # their own bash process, so nothing leaks into the user's shell.
 show_init() {
-    local prefix="" arg cmd bin_quoted
+    local prefix="" shell="sh" arg cmd bin_quoted
     for arg in "$@"; do
         case "$arg" in
             --prefix=*) prefix="${arg#--prefix=}" ;;
+            --shell=bash|--shell=zsh|--shell=sh) shell="sh" ;;
+            --shell=pwsh|--shell=powershell) shell="pwsh" ;;
             *) print_error "Unknown option for --init: $arg"; return 1 ;;
         esac
     done
@@ -425,6 +498,10 @@ show_init() {
         print_error "Invalid prefix '$prefix' (use letters, digits, '-' or '_')."
         return 1
     fi
+    if [[ "$shell" == "pwsh" ]]; then
+        show_init_pwsh "$prefix"
+        return
+    fi
     printf -v bin_quoted '%q' "$GITBASH_BIN"
     echo "# gitbash shell integration - add to your .zshrc or .bashrc:"
     echo "#   eval \"\$(gitbash --init${prefix:+ --prefix=$prefix})\""
@@ -433,6 +510,50 @@ show_init() {
     done
 }
 
+# Single-quoted PowerShell string
+pwsh_quote() {
+    local q="'"
+    printf "'%s'" "${1//$q/$q$q}"
+}
+
+# The bash that PowerShell functions run gitbash with. On Windows, Git's
+# bin\bash.exe: it puts git and the Unix tools on PATH, unlike usr\bin\bash.exe.
+pwsh_bash() {
+    local bash_path git_root
+    bash_path=$(command -v bash)
+    if gb_is_windows && command -v cygpath >/dev/null 2>&1; then
+        git_root=$(cygpath -w /)
+        git_root="${git_root%\\}"
+        if [[ -f "$git_root\\bin\\bash.exe" ]]; then
+            printf '%s\n' "$git_root\\bin\\bash.exe"
+        else
+            cygpath -w "$bash_path"
+        fi
+    else
+        echo "$bash_path"
+    fi
+}
+
+# Functions for PowerShell ($PROFILE), running gitbash with bash
+show_init_pwsh() {
+    local prefix="$1" bash_q bin_q cmd bin="$GITBASH_BIN"
+    gb_is_windows && command -v cygpath >/dev/null 2>&1 && bin=$(cygpath -m "$bin")
+    bash_q=$(pwsh_quote "$(pwsh_bash)")
+    bin_q=$(pwsh_quote "$bin")
+    echo "# gitbash shell integration for PowerShell - save it and dot-source it in your \$PROFILE:"
+    echo "#   gitbash --init --shell=pwsh${prefix:+ --prefix=$prefix} > ~/gitbash.ps1"
+    echo "#   . ~/gitbash.ps1"
+    echo "function gitbash { & $bash_q $bin_q @args }"
+    for cmd in "${COMMANDS[@]}"; do
+        # 'switch' is a PowerShell keyword: a function by that name can't be called
+        if [[ -z "$prefix" && "$cmd" == "switch" ]]; then
+            echo "# switch is a PowerShell keyword: use 'gitbash switch', or --prefix (e.g. gb-switch)"
+            continue
+        fi
+        echo "function ${prefix}${cmd} { & $bash_q $bin_q $cmd @args }"
+    done
+}
+
 # =============================================================================
 # Main entry point
 # =============================================================================
@@ -445,6 +566,9 @@ main() {
         -v|--version)
             echo "gitbash $VERSION"
             ;;
+        --update)
+            gb_self_update
+            ;;
         --init)
             shift
             show_init "$@"
@@ -472,6 +596,9 @@ main() {
                 return 1
             fi
             gb_load_config
+            gb_update_check "$cmd" "$@"
+            # Commands run gitbash again (e.g. pr runs commit): no update prompt in there
+            export GITBASH_NESTED=1
             # shellcheck source=/dev/null
             source "$COMMANDS_DIR/$cmd.sh"
             "$cmd" "$@"