Quien sea el primero en llegar por la mañana git status Cualquiera que escriba y luego tome café apreciará esta pequeña herramienta. Especialmente al desarrollar varios proyectos web en paralelo, una visión general concisa es invaluable: ¿Está el árbol de trabajo organizado?, ¿dónde hay cambios sin fusionar? y ¿dónde hay una solicitud de extracción/envío pendiente? Una pequeña herramienta de línea de comandos es todo lo que necesitas, siempre que gestione correctamente los espacios y el código Unicode en las rutas y no presente problemas con repositorios remotos bloqueados.
#!/usr/bin/env bash
set -Eeuo pipefail
export LC_ALL=C
# Check if a command exists (no output).
have() { command -v "$1" >/dev/null 2>&1; }
# Ensure we have a `sort` that supports -z (NUL-delimited) input.
SORT_BIN="sort"
if ! "$SORT_BIN" -z </dev/null 2>/dev/null; then
if have gsort && gsort -z </dev/null 2>/dev/null; then
SORT_BIN="gsort"
else
printf 'Error: This script requires "sort -z" (GNU coreutils). Install coreutils (gsort).\n' >&2
exit 1
fi
fi
# Use GNU `timeout` if available; otherwise try `gtimeout` (macOS); otherwise no timeout.
TIMEOUT_BIN="timeout"
if ! have "$TIMEOUT_BIN"; then
if have gtimeout; then
TIMEOUT_BIN="gtimeout"
else
TIMEOUT_BIN=""
fi
fi
# Require git.
if ! have git; then
printf 'Error: "git" not found.\n' >&2
exit 1
fi
# Remove a leading "./" from a path for cleaner output.
trim_dot_slash() {
case "$1" in
./*) printf '%s\n' "${1#./}" ;;
*) printf '%s\n' "$1" ;;
esac
}
# Legend + divider (as requested)
printf '\n🟢: clean\n🟡: behind/ahead\n🔴: modified\n\n----------------------------------\n\n'
# Find all .git directories, NUL-delimited; sort NUL-delimited; iterate safely.
find . -type d -name .git -print0 \
| "$SORT_BIN" -z \
| while IFS= read -r -d '' gitdir; do
repo="${gitdir%/.git}"
display_path="$(trim_dot_slash "$repo")"
# Skip anything that isn't a proper work tree (safety check).
if ! git -C "$repo" rev-parse --is-inside-work-tree >/dev/null 2>&1; then
continue
fi
# Working tree status; include untracked files for a strict "red" signal.
status_out="$(git -C "$repo" status --porcelain=v1 || true)"
# Upstream divergence check (only if an upstream is configured).
ahead=0
behind=0
if git -C "$repo" rev-parse --abbrev-ref --symbolic-full-name '@{u}' >/dev/null 2>&1; then
# Refresh refs; protect with timeout so a hanging remote doesn't stall the loop.
if [ -n "$TIMEOUT_BIN" ]; then
"$TIMEOUT_BIN" 10s git -C "$repo" fetch --all --prune >/dev/null 2>&1 || true
else
git -C "$repo" fetch --all --prune >/dev/null 2>&1 || true
fi
# Count commits only on our side (ahead) and only on upstream's side (behind).
ahead="$(git -C "$repo" rev-list --count --left-only HEAD...@{u} 2>/dev/null || echo 0)"
behind="$(git -C "$repo" rev-list --count --right-only HEAD...@{u} 2>/dev/null || echo 0)"
fi
# Decide the signal:
# - RED if the working tree isn't clean
# - YELLOW if clean but ahead/behind of upstream
# - GREEN otherwise
if [ -n "$status_out" ]; then
printf '🔴 %s\n' "$display_path"
else
if [ "${ahead:-0}" -gt 0 ] || [ "${behind:-0}" -gt 0 ]; then
printf '🟡 %s\n' "$display_path"
else
printf '🟢 %s\n' "$display_path"
fi
fi
doneEl guion aún necesita ser... chmod +x ~/path/to/script.sh hacerlo ejecutable y puede configurar un alias para ahorrar valioso tiempo de escritura: Aquí lo agrega a su ~/.bashrc / ~/.zshrc / ~/.bash_profile la entrada alias gscan='bash /path/to/script.sh' Además. A partir de entonces, un simple gscan en el directorio raíz deseado.
Una de las razones por las que la segunda ejecución es notablemente más rápida: durante la primera ejecución, el sistema de archivos todavía tiene que escanear todo; posteriormente, los metadatos y muchas otras cosas ya están procesados. .gitLas estructuras ya se han almacenado en la caché de páginas del kernel del sistema operativo, y los gráficos de referencias y confirmaciones ya están listos. El siguiente paso... fetch Ahora solo transmite pequeñas variaciones. Sin panel de control, sin sobrecarga: una instantánea rápida del estado directamente en la terminal.