paulirish.git-recent/git-watch

#!/bin/bash

#
# git-watch: A streaming perspective of git changes and commits.
#
# Monitors the current repository for:
# - New commits (displays 'git show')
# - Working directory & index changes (displays 'git diff HEAD' and untracked files)
#
# Prefers 'watchexec' for responsiveness but falls back to a loop.
#

# Check if we're in a git repo
[ "$(git rev-parse --is-inside-work-tree 2>/dev/null)" = "true" ] || {
  echo "Error: Not a git repository." >&2
  exit 1
}

if [[ "$1" == "--help" || "$1" == "-h" ]]; then
  echo "git-watch: A streaming perspective of git changes and commits."
  echo
  echo "Usage: git-watch [--debug]"
  echo
  echo "Options:"
  echo "  --debug     Log what would be run instead of running it"
  echo
  echo "Features:"
  echo "  - Shows 'git show' on new commits"
  echo "  - Shows 'git diff HEAD' on working tree/index changes"
  echo "  - Shows content of new untracked files"
  echo "  - Uses 'watchexec' if available for high-speed responsiveness"
  echo "  - Uses your fancy pager (delta/diff-so-fancy) without blocking"
  exit 0
fi

DEBUG_MODE=false
if [[ "$1" == "--debug" || "$2" == "--debug" ]]; then
  DEBUG_MODE=true
fi

# Pager detection (compatible with delta, diff-so-fancy, etc.)
pager_cmd=$(command -v delta || command -v diff-so-fancy)
pipe_to_pager=${pager_cmd:+" | $pager_cmd"}

git_run() {
  if [ "$DEBUG_MODE" = true ]; then
    echo -e "\033[0;35m[DEBUG] Would run: git --no-pager \"$@\" --color=always $pipe_to_pager\033[0m"
    return
  fi
  # Use --no-pager to avoid interactive sessions
  # Use --color=always to preserve color through the pipe
  eval "git --no-pager \"\$@\" --color=always $pipe_to_pager"
}

# Cross-platform hashing for change detection
hash_cmd=$(command -v shasum || command -v sha1sum || echo "cksum")

update() {
  local mode="$1"
  local git_dir state_file
  git_dir=$(git rev-parse --git-dir 2>/dev/null)
  [ -n "$git_dir" ] || return
  state_file="$git_dir/watch-state"

  local current_head last_head current_state_hash last_state_hash
  current_head=$(git rev-parse HEAD 2>/dev/null)
  
  # Capture staged, unstaged, and the presence of untracked files
  local status_output=$(git status --porcelain)
  local diff_output=$(git diff HEAD 2>/dev/null)
  current_state_hash=$( (echo "$status_output"; echo "$diff_output") | $hash_cmd | cut -d' ' -f1)
  
  if [[ -f "$state_file" && "$mode" != "--initial" ]]; then
    read -r last_head last_state_hash < "$state_file"
  fi

  if [ "$DEBUG_MODE" = true ]; then
    echo -e "\033[0;35m[DEBUG] Mode: $mode\033[0m"
    echo -e "\033[0;35m[DEBUG] HEAD: $current_head (Last: $last_head)\033[0m"
    echo -e "\033[0;35m[DEBUG] State Hash: $current_state_hash (Last: $last_state_hash)\033[0m"
  fi

  local did_something=false

  # 1. Commit detection (or initial show)
  if [[ "$current_head" != "$last_head" || "$mode" == "--initial" ]]; then
    echo -e "\n\033[1;34m=== Current Commit: $(git log -1 --format='%h %s' 2>/dev/null) ===\033[0m"
    git_run show --summary --stat -p
    did_something=true
  fi

  # 2. Working directory detection (or initial show)
  if [[ "$current_state_hash" != "$last_state_hash" || "$mode" == "--initial" ]]; then
    if [[ -n "$status_output" ]]; then
      echo -e "\n\033[1;32m=== Changes ===\033[0m"
      
      # Show diff of tracked changes (staged and unstaged)
      git_run diff HEAD
      
      # Show untracked files content
      git ls-files --others --exclude-standard | while read -r f; do
        if [[ -f "$f" ]]; then
          echo -e "\033[1;33m[Untracked: $f]\033[0m"
          git_run diff --no-index /dev/null "$f"
        fi
      done
      did_something=true
    fi
  fi

  if [[ "$did_something" == "true" ]]; then
    if [ "$DEBUG_MODE" = true ]; then
      echo -e "\033[0;35m[DEBUG] Would update state file: $current_head $current_state_hash\033[0m"
    else
      echo "$current_head $current_state_hash" > "$state_file"
    fi
  fi
}

# Internal flag for watchexec to call back into the script
if [[ "$1" == "--step" ]]; then
  update "--step"
  exit 0
fi

# Main execution loop
# Always show the current state on launch
update "--initial"

pass_debug=""
if [ "$DEBUG_MODE" = true ]; then
  pass_debug="--debug"
fi

if command -v watchexec >/dev/null 2>&1; then
  echo -e "\033[0;32mWatching with watchexec...\033[0m"
  # -i .git: ignore most git internal changes
  # -w .: watch working directory
  # -w .git/HEAD: watch for commits
  # --quiet: suppress watchexec status messages
  watchexec --quiet -i .git -w . -w "$(git rev-parse --git-dir)/HEAD" -- "$0" --step $pass_debug
else
  echo -e "\033[0;33mWatching with fallback loop (watchexec not found)...\033[0m"
  while true; do
    update "--step"
    sleep 2
  done
fi