@kova1/pullr 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Max Koval
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,72 @@
+# pullr
+
+Fast-forward pull every git repository under a directory.
+
+Built for workspaces made of many independent repositories, where keeping
+everything current means `cd`-ing into each one.
+
+```console
+$ pullr ~/work
++ api (main, 3 new commit(s))
+= web (main)
+- scratch (main has no upstream)
+x infra (main)
+    fatal: Not possible to fast-forward, aborting.
+
+Repos: 4  updated: 1  up to date: 1  skipped: 1  failed: 1
+Failed: infra
+```
+
+## Install
+
+```sh
+# Homebrew
+brew install kova1max/tap/pullr   # after that, plain `pullr` works too
+
+# npm
+npm install -g @kova1/pullr
+```
+
+Or copy [`bin/pullr`](bin/pullr) anywhere on your `PATH` - it is a single bash
+script with no dependencies beyond `git`.
+
+## Usage
+
+```
+pullr [--max-depth N] [DIR]
+```
+
+| Option | Default | Meaning |
+| --- | --- | --- |
+| `DIR` | current directory | Where to look for repositories |
+| `--max-depth N` | `2` | How many directory levels below `DIR` to search. `0` = only `DIR` itself, `1` = `DIR` and its direct children, ... |
+| `-V`, `--version` | | Print the version |
+| `-h`, `--help` | | Show help |
+
+Behaviour:
+
+- Runs `git pull --ff-only`, so it never creates merge commits. A branch that
+  has diverged from its upstream is reported as failed and left untouched.
+- Does not descend into a repository once found - nested repositories and
+  submodules are left to their parent.
+- Skips repositories on a detached `HEAD` and branches with no upstream.
+- Does not follow symlinked directories.
+- Exits `1` if any pull failed, `2` on invalid arguments, `0` otherwise.
+
+Each repository gets one line: `+` updated, `=` already up to date, `-`
+skipped, `x` failed (with git's output indented below it).
+
+## Development
+
+```sh
+npm install     # installs bats
+npm test        # end-to-end tests against real temporary git repos
+npm run lint    # shellcheck
+PULLR_BASH=/bin/bash npm test   # run the suite under macOS's bash 3.2
+```
+
+Releases are cut by GitHub Actions - see [RELEASE.md](RELEASE.md).
+
+## License
+
+[MIT](LICENSE)

package/bin/pullr

@@ -0,0 +1,115 @@
+#!/usr/bin/env bash
+# Recursively find git repos under a directory and fast-forward pull each one.
+# Usage: pullr [--max-depth N] [DIR]
+set -euo pipefail
+
+VERSION="0.1.0" # set by the release workflow
+
+usage() {
+  cat <<'EOF'
+Usage: pullr [--max-depth N] [DIR]
+
+Finds git repositories under DIR (default: current directory) and runs
+`git pull --ff-only` in each. Does not descend into a repository once found.
+
+Options:
+  --max-depth N   How many directory levels below DIR to search (default: 2).
+                  0 = only DIR itself, 1 = DIR and its direct children, ...
+  -V, --version   Print the version.
+  -h, --help      Show this help.
+EOF
+}
+
+max_depth=2
+root=""
+
+while (($#)); do
+  case "$1" in
+    --max-depth) max_depth="${2:-}"; shift 2 || { usage >&2; exit 2; } ;;
+    --max-depth=*) max_depth="${1#*=}"; shift ;;
+    -h|--help) usage; exit 0 ;;
+    -V|--version) echo "pullr $VERSION"; exit 0 ;;
+    -*) echo "Unknown option: $1" >&2; usage >&2; exit 2 ;;
+    *)
+      [[ -z "$root" ]] || { echo "Only one DIR allowed" >&2; exit 2; }
+      root="$1"; shift ;;
+  esac
+done
+
+[[ "$max_depth" =~ ^[0-9]+$ ]] || { echo "--max-depth must be a non-negative integer" >&2; exit 2; }
+root="${root:-.}"
+[[ -d "$root" ]] || { echo "Not a directory: $root" >&2; exit 2; }
+root="$(cd "$root" && pwd)"
+
+if [[ -t 1 ]]; then
+  green=$'\e[32m' yellow=$'\e[33m' red=$'\e[31m' dim=$'\e[2m' reset=$'\e[0m'
+else
+  green="" yellow="" red="" dim="" reset=""
+fi
+
+updated=0 current=0 skipped=0 failed=0
+failed_repos=()
+
+pull_repo() {
+  local repo="$1" rel="${1#"$root"}"
+  rel="${rel#/}"; rel="${rel:-.}"
+
+  local branch
+  if ! branch="$(git -C "$repo" symbolic-ref --quiet --short HEAD)"; then
+    printf '%s-%s %s %s(detached HEAD)%s\n' "$yellow" "$reset" "$rel" "$dim" "$reset"
+    skipped=$((skipped + 1)); return
+  fi
+  if ! git -C "$repo" rev-parse --quiet --verify '@{upstream}' >/dev/null 2>&1; then
+    printf '%s-%s %s %s(%s has no upstream)%s\n' "$yellow" "$reset" "$rel" "$dim" "$branch" "$reset"
+    skipped=$((skipped + 1)); return
+  fi
+
+  local before after out
+  before="$(git -C "$repo" rev-parse HEAD)"
+  if ! out="$(git -C "$repo" pull --ff-only 2>&1)"; then
+    printf '%sx%s %s %s(%s)%s\n' "$red" "$reset" "$rel" "$dim" "$branch" "$reset"
+    printf '    %s\n' "${out//$'\n'/$'\n'    }"
+    failed=$((failed + 1)); failed_repos+=("$rel"); return
+  fi
+  after="$(git -C "$repo" rev-parse HEAD)"
+
+  if [[ "$before" == "$after" ]]; then
+    printf '%s=%s %s %s(%s)%s\n' "$dim" "$reset" "$rel" "$dim" "$branch" "$reset"
+    current=$((current + 1))
+  else
+    local n
+    n="$(git -C "$repo" rev-list --count "$before..$after")"
+    printf '%s+%s %s %s(%s, %s new commit(s))%s\n' "$green" "$reset" "$rel" "$dim" "$branch" "$n" "$reset"
+    updated=$((updated + 1))
+  fi
+}
+
+walk() {
+  local dir="$1" depth="$2"
+  if [[ -e "$dir/.git" ]]; then
+    pull_repo "$dir"
+    return
+  fi
+  ((depth < max_depth)) || return 0
+  local child
+  for child in "$dir"/*/; do
+    [[ -d "$child" && ! -L "${child%/}" ]] || continue
+    walk "${child%/}" $((depth + 1))
+  done
+}
+
+walk "$root" 0
+
+total=$((updated + current + skipped + failed))
+if ((total == 0)); then
+  echo "No git repositories found under $root (max depth $max_depth)"
+  exit 0
+fi
+
+echo
+printf 'Repos: %d  %supdated: %d%s  up to date: %d  %sskipped: %d%s  %sfailed: %d%s\n' \
+  "$total" "$green" "$updated" "$reset" "$current" "$yellow" "$skipped" "$reset" "$red" "$failed" "$reset"
+if ((failed)); then
+  printf 'Failed: %s\n' "${failed_repos[*]}"
+  exit 1
+fi

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@kova1/pullr",
+  "version": "0.1.0",
+  "description": "Fast-forward pull every git repository under a directory",
+  "keywords": [
+    "git",
+    "pull",
+    "cli",
+    "monorepo",
+    "workspace"
+  ],
+  "homepage": "https://github.com/kova1max/pullr#readme",
+  "bugs": "https://github.com/kova1max/pullr/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kova1max/pullr.git"
+  },
+  "license": "MIT",
+  "author": "Max Koval <kova1max99@gmail.com>",
+  "bin": {
+    "pullr": "bin/pullr"
+  },
+  "files": [
+    "bin/pullr"
+  ],
+  "os": [
+    "darwin",
+    "linux"
+  ],
+  "scripts": {
+    "lint": "shellcheck bin/pullr",
+    "test": "bats test"
+  },
+  "devDependencies": {
+    "bats": "^1.13.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}