gitbash 2.0.1 → 2.1.0

package/README.md

@@ -12,11 +12,35 @@ Pure bash, zero-dependency git utilities. Reduce repetitive typing and superchar
 npm i -g gitbash && gitbash --config
 ```
 
+### Via install script (no npm or node needed)
+
+```bash
+# curl
+curl -fsSL https://raw.githubusercontent.com/jaggli/gitbash/main/install.sh | sh
+
+# wget
+wget -qO- https://raw.githubusercontent.com/jaggli/gitbash/main/install.sh | sh
+```
+
+This downloads the latest GitHub release to `~/.local/share/gitbash` and links `~/.local/bin/gitbash`. Run `gitbash --update` (or the script again) to upgrade. Options are set as environment variables:
+
+```bash
+# Install a specific version
+curl -fsSL https://raw.githubusercontent.com/jaggli/gitbash/main/install.sh | GITBASH_VERSION=2.0.1 sh
+
+# Custom locations (e.g. system-wide)
+curl -fsSL https://raw.githubusercontent.com/jaggli/gitbash/main/install.sh \
+  | sudo GITBASH_INSTALL_DIR=/usr/local/share/gitbash GITBASH_BIN_DIR=/usr/local/bin sh
+```
+
+To uninstall, remove `~/.local/share/gitbash` and `~/.local/bin/gitbash`.
+
 ### Options
 
 ```bash
 gitbash --help         # Show help
 gitbash --version      # Show version
+gitbash --update       # Update to the latest release (npm or install script)
 gitbash --init         # Print shell functions (see Shell integration)
 gitbash --config       # Interactive configuration wizard
 gitbash --config-local # Configure overrides for the current repository (committed)
@@ -46,18 +70,6 @@ eval "$(gitbash --init --prefix=gb-)" # gb-commit, gb-switch, ... (avoids shadow
 
 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"`.
 
-### Upgrading to 2.0
-
-2.0 is a security and safety release. What changes for you:
-
-- **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.
-
 ## Commands
 
 ### branch
@@ -115,7 +127,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 +174,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 +266,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 +307,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 +336,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
@@ -356,13 +371,37 @@ 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 --help | --version | --update
     gitbash --init [--prefix=PREFIX]
     gitbash --config | --config-local | --config-user
 
@@ -371,9 +410,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,6 +426,7 @@ 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, ...)
   --config         Configure gitbash and save to ~/.gitbashrc
@@ -445,6 +487,9 @@ main() {
         -v|--version)
             echo "gitbash $VERSION"
             ;;
+        --update)
+            gb_self_update
+            ;;
         --init)
             shift
             show_init "$@"
@@ -472,6 +517,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" "$@"

package/commands/_self_update.sh

@@ -0,0 +1,319 @@
+#!/usr/bin/env bash
+# Self-update for gitbash: 'gitbash --update' and the background update check.
+# Sourced by bin/gitbash; needs SCRIPT_DIR, GITBASH_BIN and VERSION.
+
+GB_REPO="jaggli/gitbash"
+GB_UPDATE_CHECK_INTERVAL=86400   # look for a new version at most once a day
+GB_UPDATE_PROMPT_INTERVAL=172800 # ask about it at most every other day
+
+# GITBASH_NO_UPDATE_CHECKS from the environment wins over the config files
+_GB_ENV_NO_UPDATE_CHECKS="${GITBASH_NO_UPDATE_CHECKS:-}"
+
+# =============================================================================
+# Install method
+# =============================================================================
+
+# Directory of a global package manager install of gitbash, symlinks resolved
+_gb_global_package_dir() {
+    local root
+    root=$("$1" root -g 2>/dev/null) || return 1
+    [[ -n "$root" ]] || return 1
+    (cd -P "$root/gitbash" 2>/dev/null && pwd)
+}
+
+# How this copy of gitbash was installed: npm, pnpm, npx, package, script, git or unknown
+gb_install_method() {
+    case "$SCRIPT_DIR" in
+        */_npx/*)
+            echo "npx"
+            return 0
+            ;;
+        */node_modules/gitbash)
+            local pm
+            for pm in npm pnpm; do
+                if command -v "$pm" >/dev/null 2>&1 &&
+                   [[ "$(_gb_global_package_dir "$pm")" == "$SCRIPT_DIR" ]]; then
+                    echo "$pm"
+                    return 0
+                fi
+            done
+            # A dependency of some project, or a package manager we don't know
+            echo "package"
+            return 0
+            ;;
+    esac
+    if [[ -f "$SCRIPT_DIR/.gitbash-install" ]]; then
+        echo "script"
+    elif [[ -e "$SCRIPT_DIR/.git" ]]; then
+        echo "git"
+    elif [[ -f "$SCRIPT_DIR/package.json" && ! -e "$SCRIPT_DIR/README.md" ]]; then
+        # Installed by an install.sh that did not leave a marker yet
+        echo "script"
+    else
+        echo "unknown"
+    fi
+}
+
+# =============================================================================
+# State (~/.local/state/gitbash/update-check)
+# =============================================================================
+
+_gb_update_state_file() {
+    echo "${XDG_STATE_HOME:-$HOME/.local/state}/gitbash/update-check"
+}
+
+# Read the state into _GB_UC_CHECKED, _GB_UC_LATEST, _GB_UC_PROMPTED and _GB_UC_SKIPPED
+_gb_update_state_load() {
+    local file key value
+    file=$(_gb_update_state_file)
+    _GB_UC_CHECKED=0 _GB_UC_LATEST="" _GB_UC_PROMPTED=0 _GB_UC_SKIPPED=""
+    [[ -f "$file" ]] || return 0
+    while IFS='=' read -r key value; do
+        case "$key" in
+            checked) [[ "$value" =~ ^[0-9]+$ ]] && _GB_UC_CHECKED="$value" ;;
+            latest) _GB_UC_LATEST="$value" ;;
+            prompted) [[ "$value" =~ ^[0-9]+$ ]] && _GB_UC_PROMPTED="$value" ;;
+            skipped) _GB_UC_SKIPPED="$value" ;;
+        esac
+    done < "$file"
+}
+
+# Set one value, keeping the others (re-read first: a background check may have written)
+# Usage: _gb_update_state_set checked|latest|prompted|skipped <value>
+_gb_update_state_set() {
+    local file dir tmp
+    file=$(_gb_update_state_file)
+    dir=$(dirname "$file")
+    _gb_update_state_load
+    case "$1" in
+        checked) _GB_UC_CHECKED="$2" ;;
+        latest) _GB_UC_LATEST="$2" ;;
+        prompted) _GB_UC_PROMPTED="$2" ;;
+        skipped) _GB_UC_SKIPPED="$2" ;;
+    esac
+    mkdir -p "$dir" 2>/dev/null || return 1
+    tmp=$(mktemp "$dir/.update-check.XXXXXX" 2>/dev/null) || return 1
+    if ! printf 'checked=%s\nlatest=%s\nprompted=%s\nskipped=%s\n' \
+            "$_GB_UC_CHECKED" "$_GB_UC_LATEST" "$_GB_UC_PROMPTED" "$_GB_UC_SKIPPED" > "$tmp" ||
+       ! mv -f "$tmp" "$file"; then
+        rm -f "$tmp"
+        return 1
+    fi
+}
+
+_gb_now() {
+    if [[ -n "${EPOCHSECONDS:-}" ]]; then
+        echo "$EPOCHSECONDS"
+    else
+        date +%s
+    fi
+}
+
+# =============================================================================
+# Versions
+# =============================================================================
+
+# Print the contents of a URL
+_gb_fetch() {
+    if command -v curl >/dev/null 2>&1; then
+        curl -fsSL --max-time 10 "$1"
+    elif command -v wget >/dev/null 2>&1; then
+        wget -qO- -T 10 "$1"
+    else
+        return 1
+    fi
+}
+
+# Print the version of the latest GitHub release, e.g. 2.1.0
+gb_latest_version() {
+    local json tag
+    json=$(_gb_fetch "https://api.github.com/repos/$GB_REPO/releases/latest" 2>/dev/null) || return 1
+    tag=$(printf '%s\n' "$json" | sed -n 's/.*"tag_name": *"\([^"]*\)".*/\1/p' | head -n 1)
+    tag="${tag#v}"
+    [[ "$tag" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]] || return 1
+    echo "$tag"
+}
+
+# Returns 0 if version $1 is newer than the running one
+_gb_is_newer() {
+    [[ "$1" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]] && ! _gb_version_ge "$VERSION" "$1"
+}
+
+# =============================================================================
+# Update
+# =============================================================================
+
+# Install version $1 the way this copy was installed
+gb_self_update_to() {
+    local latest="$1" method
+    method=$(gb_install_method)
+    case "$method" in
+        npm|pnpm)
+            local -a cmd=(npm install -g "gitbash@$latest")
+            [[ "$method" == "pnpm" ]] && cmd=(pnpm add -g "gitbash@$latest")
+            print_info "Running: ${cmd[*]}"
+            if ! "${cmd[@]}"; then
+                print_error "Update failed. Run '${cmd[*]}' yourself (it may need more permissions)."
+                return 1
+            fi
+            ;;
+        script)
+            _gb_self_update_script "$latest" || return 1
+            ;;
+        npx)
+            print_info "gitbash runs through npx: use 'npx gitbash@latest' to get the newest version."
+            return 1
+            ;;
+        git)
+            print_info "gitbash runs from a git checkout ($SCRIPT_DIR): update it with 'git pull'."
+            return 1
+            ;;
+        package)
+            print_info "gitbash is a dependency in $SCRIPT_DIR: update it with your package manager."
+            return 1
+            ;;
+        *)
+            print_error "Could not detect how gitbash was installed ($SCRIPT_DIR)."
+            echo "Reinstall it with 'npm i -g gitbash' or the install script (see the README)." >&2
+            return 1
+            ;;
+    esac
+
+    # GITBASH_BIN, not SCRIPT_DIR: pnpm installs the new version in a new folder
+    local installed pkg_dir="${GITBASH_BIN%/bin/gitbash}"
+    installed=$(grep -o '"version": *"[^"]*"' "$pkg_dir/package.json" 2>/dev/null | head -1 | cut -d'"' -f4)
+    if [[ "$installed" != "$latest" ]]; then
+        print_error "Update finished, but gitbash in $pkg_dir is still at ${installed:-an unknown version}."
+        return 1
+    fi
+    print_success "Updated gitbash $VERSION → $latest"
+}
+
+# Re-run the install script of the new release for the same locations
+_gb_self_update_script() {
+    local latest="$1" bin_dir="" key value tmp
+    if [[ -f "$SCRIPT_DIR/.gitbash-install" ]]; then
+        while IFS='=' read -r key value; do
+            [[ "$key" == "bin_dir" ]] && bin_dir="$value"
+        done < "$SCRIPT_DIR/.gitbash-install"
+    fi
+    bin_dir="${bin_dir:-$HOME/.local/bin}"
+
+    local -a vars=(GITBASH_VERSION="$latest" GITBASH_INSTALL_DIR="$SCRIPT_DIR" GITBASH_BIN_DIR="$bin_dir")
+    local hint="curl -fsSL https://raw.githubusercontent.com/$GB_REPO/main/install.sh | sudo ${vars[*]} sh"
+    if [[ ! -w "$(dirname "$SCRIPT_DIR")" ]]; then
+        print_error "No permission to write to $(dirname "$SCRIPT_DIR"). Update with:"
+        echo "  $hint" >&2
+        return 1
+    fi
+
+    tmp=$(mktemp 2>/dev/null || mktemp -t gitbash) || return 1
+    if ! _gb_fetch "https://raw.githubusercontent.com/$GB_REPO/v$latest/install.sh" > "$tmp" 2>/dev/null ||
+       [[ ! -s "$tmp" ]]; then
+        rm -f "$tmp"
+        print_error "Could not download the install script of gitbash $latest."
+        return 1
+    fi
+    print_info "Running the install script of gitbash $latest"
+    if ! env "${vars[@]}" sh "$tmp"; then
+        rm -f "$tmp"
+        print_error "Update failed."
+        return 1
+    fi
+    rm -f "$tmp"
+}
+
+# gitbash --update
+gb_self_update() {
+    local latest
+    print_info "Checking for updates..."
+    if ! latest=$(gb_latest_version); then
+        print_error "Could not check for updates (no network, or GitHub is not reachable)."
+        return 1
+    fi
+    _gb_update_state_set checked "$(_gb_now)"
+    _gb_update_state_set latest "$latest"
+    if ! _gb_is_newer "$latest"; then
+        print_success "gitbash $VERSION is up to date."
+        return 0
+    fi
+    gb_self_update_to "$latest"
+}
+
+# =============================================================================
+# Background check
+# =============================================================================
+
+# Returns 0 if update checks are on: not turned off, not in CI, not a git checkout
+gb_update_checks_enabled() {
+    case "$_GB_ENV_NO_UPDATE_CHECKS" in
+        "") [[ "${GITBASH_NO_UPDATE_CHECKS:-no}" == "yes" ]] && return 1 ;;
+        no|0|false) ;;
+        *) return 1 ;;
+    esac
+    local var
+    for var in CI CONTINUOUS_INTEGRATION BUILD_NUMBER GITHUB_ACTIONS GITLAB_CI TF_BUILD \
+               JENKINS_URL BUILDKITE CIRCLECI TRAVIS TEAMCITY_VERSION BITBUCKET_BUILD_NUMBER; do
+        case "${!var:-}" in
+            ""|false|0) ;;
+            *) return 1 ;;
+        esac
+    done
+    [[ ! -e "$SCRIPT_DIR/.git" ]]
+}
+
+# Run before a command: start a background check when one is due, and offer a
+# known new version (at most every other day, never again for a skipped one).
+# On a successful update, runs the command with the new version instead.
+# Usage: gb_update_check <command> [args...]
+gb_update_check() {
+    # Not when gitbash runs itself from a command (the parent already checked)
+    [[ -z "${GITBASH_NESTED:-}" ]] || return 0
+    gb_update_checks_enabled || return 0
+
+    local now
+    now=$(_gb_now)
+    _gb_update_state_load
+    if (( now - _GB_UC_CHECKED >= GB_UPDATE_CHECK_INTERVAL || _GB_UC_CHECKED > now )); then
+        _gb_update_state_set checked "$now"
+        (
+            local latest
+            latest=$(gb_latest_version) && _gb_update_state_set latest "$latest"
+        ) < /dev/null > /dev/null 2>&1 &
+    fi
+
+    local latest="$_GB_UC_LATEST"
+    _gb_is_newer "$latest" || return 0
+    [[ "$latest" != "$_GB_UC_SKIPPED" ]] || return 0
+    (( now - _GB_UC_PROMPTED >= GB_UPDATE_PROMPT_INTERVAL || _GB_UC_PROMPTED > now )) || return 0
+    # Only ask people at a terminal, never scripts
+    [[ -t 0 && -t 1 && -t 2 && "${GITBASH_ASSUME_YES:-}" != "1" ]] || return 0
+    local arg
+    for arg in "${@:2}"; do
+        [[ "$arg" == "-y" || "$arg" == "--yes" ]] && return 0
+    done
+
+    _gb_update_state_set prompted "$now"
+    print_info "gitbash $latest is available (you have $VERSION)."
+    local choice
+    gb_choice choice "Update now? [y]es, [n]ot now, [s]kip this version (y/N/s):" "yns" "n"
+    case "$choice" in
+        y)
+            if gb_self_update_to "$latest"; then
+                echo
+                exec "$GITBASH_BIN" "$@"
+            fi
+            echo
+            ;;
+        s)
+            _gb_update_state_set skipped "$latest"
+            print_info "You won't be asked about $latest again. Run 'gitbash --update' to update any time."
+            echo
+            ;;
+        *)
+            print_info "Run 'gitbash --update' to update any time."
+            echo
+            ;;
+    esac
+    return 0
+}