tmuxpull 0.1.0__tar.gz

tmuxpull-0.1.0/.gitignore

@@ -0,0 +1,24 @@
+# Python
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+.Python
+.venv/
+venv/
+env/
+.env
+*.egg-info/
+
+# Editors
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Temporary
+*.log
+*.tmp
+.cache/

tmuxpull-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Henry Nguyen
+
+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.

tmuxpull-0.1.0/PKG-INFO

@@ -0,0 +1,181 @@
+Metadata-Version: 2.5
+Name: tmuxpull
+Version: 0.1.0
+Summary: Concurrent git pull --rebase --autostash across multiple repos with tmux attention windows
+Project-URL: Homepage, https://github.com/nguyengg/tmuxpull
+Project-URL: Repository, https://github.com/nguyengg/tmuxpull.git
+Project-URL: Issues, https://github.com/nguyengg/tmuxpull/issues
+Author-email: Henry Nguyen <5065089+nguyengg@users.noreply.github.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: automation,concurrent,git,rebase,tmux
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Version Control :: Git
+Classifier: Topic :: System :: Systems Administration
+Classifier: Topic :: Terminals
+Requires-Python: >=3.11
+Requires-Dist: libtmux>=0.35
+Description-Content-Type: text/markdown
+
+# tmuxpull
+
+Concurrent `git pull --rebase --autostash` across multiple Git repositories with tmux integration.
+
+## Quick Start
+
+### Run instantly with curl (no install)
+
+```bash
+# Python version — requires uv (https://docs.astral.sh/uv/)
+curl -fsSL https://raw.githubusercontent.com/nguyengg/tmuxpull/main/bin/rebase-all.py | uv run - ~/Workspaces
+
+# Zsh version — zero dependencies (just git + tmux)
+curl -fsSL https://raw.githubusercontent.com/nguyengg/tmuxpull/main/bin/rebase-all | zsh -s -- ~/Workspaces
+```
+
+### Install with curl (one-liner)
+
+```bash
+# Download the self-contained script to ~/.local/bin
+curl -fsSL https://raw.githubusercontent.com/nguyengg/tmuxpull/main/bin/rebase-all.py -o ~/.local/bin/tmuxpull && chmod +x ~/.local/bin/tmuxpull
+tmuxpull ~/Workspaces
+```
+
+The script carries its own dependency metadata (PEP 723), so with `uv` on your PATH it bootstraps its own environment on first run — no venv, no pip install.
+
+### Install from PyPI
+
+```bash
+# Install via pip/uv (recommended)
+pip install tmuxpull
+tmuxpull ~/Workspaces
+
+# Or install as a uv tool
+uv tool install tmuxpull
+tmuxpull ~/Workspaces
+```
+
+Both scan for Git repos under the given directories, pull with rebase concurrently, print a summary per repo, and open tmux windows for repos that need your attention (conflicts, failures, etc.).
+
+## Features
+
+- **Concurrent execution** with configurable job limits
+- **Smart repo discovery** with depth limits and noise filtering (skips `node_modules`, `.venv`, etc.)
+- **Per-repo summaries** showing commits pulled and file change stats (Python version)
+- **tmux integration** — opens windows for repos needing attention, landing on `git status`
+- **Multiple modes**: attention-only (default), all repos, or no tmux
+- **PEP 723 packaging** (Python) — zero-setup single file with dependencies declared inline
+
+## Usage
+
+```bash
+tmuxpull [-d DEPTH] [-j JOBS] [--tmux {all,attn,off}] 
+         [-s SESSION] [-v] [--dry-run] DIR [DIR ...]
+```
+
+### Options
+
+- `-d, --max-depth N` — Directory search depth (default: 2)
+- `-j, --jobs N` — Max concurrent rebases (default: min(8, 2×CPU))
+- `--tmux {all,attn,off}` — tmux windows for: all repos, attention-only (default), or none
+- `-s, --session NAME` — tmux session name (default: "rebase") 
+- `-v, --verbose` — Show commit subjects (-v = top 3, -vv = all)
+- `--dry-run` — List repos that would be processed, then exit
+
+### Examples
+
+```bash
+# Morning sync across your workspace
+tmuxpull ~/Workspaces ~/Projects
+
+# High concurrency, all repos get tmux windows
+tmuxpull -j 16 --tmux all ~/Code
+
+# Just print what would happen
+tmuxpull --dry-run ~/Projects
+
+# Verbose output showing commit messages  
+tmuxpull -v ~/Workspaces
+```
+
+## Output
+
+Per-repo summary lines:
+```
+my-project        ✓ 3 commits  8 files changed, 213 insertions(+), 41 deletions(-)
+other-repo        · up to date
+broken-thing      ✗ FAIL: could not apply autostash
+```
+
+Failed repos open tmux windows in the "rebase" session (or `-s NAME`), landing on `git status` so you see what's broken. Attach with `tmux attach -t rebase`.
+
+## Two Versions
+
+### `bin/rebase-all.py` (Recommended)
+
+- **Standard Python package** with proper console script entry point
+- Rich per-repo summaries with git log output and diffstat
+- Better error handling and progress reporting
+- Structured data model for repo state
+
+**Requirements**: Python 3.11+, tmux, git
+
+### `bin/rebase-all` (Fallback)
+
+- **Pure Zsh** — no Python dependencies
+- Basic summaries (commit count only, no diffstat)
+- Simpler concurrency model with job control
+
+**Requirements**: Zsh, tmux, git
+
+## Installation
+
+### From PyPI (Recommended)
+
+```bash
+# Install globally
+pip install tmuxpull
+
+# Or as a uv tool (isolated)
+uv tool install tmuxpull
+```
+
+### From Source
+
+```bash
+# Clone and install
+git clone https://github.com/nguyengg/tmuxpull.git
+cd tmuxpull
+pip install .
+
+# Or for development
+uv sync --dev
+```
+
+### Zsh Fallback
+
+For machines without Python, use the dependency-free Zsh script:
+```bash
+chmod +x bin/rebase-all
+ln -s $PWD/bin/rebase-all ~/.local/bin/
+```
+
+## Design
+
+Finds Git repos by walking the filesystem looking for `.git` directories, up to a configurable depth. Prunes common noise directories (`node_modules`, build artifacts, Python venvs) to avoid slow traversals.
+
+Rebases run concurrently via `asyncio` (Python) or Zsh job control, capped at a reasonable limit to avoid overwhelming git servers. Each repo is isolated — failures don't stop other repos.
+
+The tmux integration is the key workflow piece: clean repos just print their summary and disappear, while repos needing intervention (conflict resolution, stash conflicts, etc.) open interactive windows where you can fix things. `tmux attach -t rebase` becomes your "work queue" for the morning.
+
+## License
+
+MIT

tmuxpull-0.1.0/README.md

@@ -0,0 +1,154 @@
+# tmuxpull
+
+Concurrent `git pull --rebase --autostash` across multiple Git repositories with tmux integration.
+
+## Quick Start
+
+### Run instantly with curl (no install)
+
+```bash
+# Python version — requires uv (https://docs.astral.sh/uv/)
+curl -fsSL https://raw.githubusercontent.com/nguyengg/tmuxpull/main/bin/rebase-all.py | uv run - ~/Workspaces
+
+# Zsh version — zero dependencies (just git + tmux)
+curl -fsSL https://raw.githubusercontent.com/nguyengg/tmuxpull/main/bin/rebase-all | zsh -s -- ~/Workspaces
+```
+
+### Install with curl (one-liner)
+
+```bash
+# Download the self-contained script to ~/.local/bin
+curl -fsSL https://raw.githubusercontent.com/nguyengg/tmuxpull/main/bin/rebase-all.py -o ~/.local/bin/tmuxpull && chmod +x ~/.local/bin/tmuxpull
+tmuxpull ~/Workspaces
+```
+
+The script carries its own dependency metadata (PEP 723), so with `uv` on your PATH it bootstraps its own environment on first run — no venv, no pip install.
+
+### Install from PyPI
+
+```bash
+# Install via pip/uv (recommended)
+pip install tmuxpull
+tmuxpull ~/Workspaces
+
+# Or install as a uv tool
+uv tool install tmuxpull
+tmuxpull ~/Workspaces
+```
+
+Both scan for Git repos under the given directories, pull with rebase concurrently, print a summary per repo, and open tmux windows for repos that need your attention (conflicts, failures, etc.).
+
+## Features
+
+- **Concurrent execution** with configurable job limits
+- **Smart repo discovery** with depth limits and noise filtering (skips `node_modules`, `.venv`, etc.)
+- **Per-repo summaries** showing commits pulled and file change stats (Python version)
+- **tmux integration** — opens windows for repos needing attention, landing on `git status`
+- **Multiple modes**: attention-only (default), all repos, or no tmux
+- **PEP 723 packaging** (Python) — zero-setup single file with dependencies declared inline
+
+## Usage
+
+```bash
+tmuxpull [-d DEPTH] [-j JOBS] [--tmux {all,attn,off}] 
+         [-s SESSION] [-v] [--dry-run] DIR [DIR ...]
+```
+
+### Options
+
+- `-d, --max-depth N` — Directory search depth (default: 2)
+- `-j, --jobs N` — Max concurrent rebases (default: min(8, 2×CPU))
+- `--tmux {all,attn,off}` — tmux windows for: all repos, attention-only (default), or none
+- `-s, --session NAME` — tmux session name (default: "rebase") 
+- `-v, --verbose` — Show commit subjects (-v = top 3, -vv = all)
+- `--dry-run` — List repos that would be processed, then exit
+
+### Examples
+
+```bash
+# Morning sync across your workspace
+tmuxpull ~/Workspaces ~/Projects
+
+# High concurrency, all repos get tmux windows
+tmuxpull -j 16 --tmux all ~/Code
+
+# Just print what would happen
+tmuxpull --dry-run ~/Projects
+
+# Verbose output showing commit messages  
+tmuxpull -v ~/Workspaces
+```
+
+## Output
+
+Per-repo summary lines:
+```
+my-project        ✓ 3 commits  8 files changed, 213 insertions(+), 41 deletions(-)
+other-repo        · up to date
+broken-thing      ✗ FAIL: could not apply autostash
+```
+
+Failed repos open tmux windows in the "rebase" session (or `-s NAME`), landing on `git status` so you see what's broken. Attach with `tmux attach -t rebase`.
+
+## Two Versions
+
+### `bin/rebase-all.py` (Recommended)
+
+- **Standard Python package** with proper console script entry point
+- Rich per-repo summaries with git log output and diffstat
+- Better error handling and progress reporting
+- Structured data model for repo state
+
+**Requirements**: Python 3.11+, tmux, git
+
+### `bin/rebase-all` (Fallback)
+
+- **Pure Zsh** — no Python dependencies
+- Basic summaries (commit count only, no diffstat)
+- Simpler concurrency model with job control
+
+**Requirements**: Zsh, tmux, git
+
+## Installation
+
+### From PyPI (Recommended)
+
+```bash
+# Install globally
+pip install tmuxpull
+
+# Or as a uv tool (isolated)
+uv tool install tmuxpull
+```
+
+### From Source
+
+```bash
+# Clone and install
+git clone https://github.com/nguyengg/tmuxpull.git
+cd tmuxpull
+pip install .
+
+# Or for development
+uv sync --dev
+```
+
+### Zsh Fallback
+
+For machines without Python, use the dependency-free Zsh script:
+```bash
+chmod +x bin/rebase-all
+ln -s $PWD/bin/rebase-all ~/.local/bin/
+```
+
+## Design
+
+Finds Git repos by walking the filesystem looking for `.git` directories, up to a configurable depth. Prunes common noise directories (`node_modules`, build artifacts, Python venvs) to avoid slow traversals.
+
+Rebases run concurrently via `asyncio` (Python) or Zsh job control, capped at a reasonable limit to avoid overwhelming git servers. Each repo is isolated — failures don't stop other repos.
+
+The tmux integration is the key workflow piece: clean repos just print their summary and disappear, while repos needing intervention (conflict resolution, stash conflicts, etc.) open interactive windows where you can fix things. `tmux attach -t rebase` becomes your "work queue" for the morning.
+
+## License
+
+MIT

tmuxpull-0.1.0/bin/rebase-all

@@ -0,0 +1,199 @@
+#!/bin/zsh
+# rebase-all -- concurrent git pull --rebase --autostash with tmux attention windows
+#
+# Zsh fallback for machines without Python/uv. For the full-featured version,
+# use rebase-all.py (PEP 723 single-file with libtmux, git log summaries, etc.).
+#
+# Usage: rebase-all [-j JOBS] [-d DEPTH] [-s SESSION] [--dry-run] DIR [DIR...]
+
+set -euo pipefail
+
+# defaults
+max_depth=2
+jobs=8
+session="rebase"
+dry_run=false
+tmux_mode="attn"  # all | attn | off
+
+usage() {
+    cat >&2 <<'EOF'
+Usage: rebase-all [-j JOBS] [-d DEPTH] [-s SESSION] [--dry-run] DIR [DIR...]
+
+Options:
+  -j JOBS      Max concurrent rebases (default: 8)
+  -d DEPTH     Directory search depth (default: 2)  
+  -s SESSION   tmux session name (default: rebase)
+  --tmux MODE  Open tmux windows for: all repos, attn (default), or off
+  --dry-run    List repos and exit
+  -h, --help   Show this help
+
+Examples:
+  rebase-all ~/Workspaces
+  rebase-all -j 4 --tmux all ~/Projects ~/Work
+EOF
+}
+
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        -j) jobs=$2; shift 2 ;;
+        -d) max_depth=$2; shift 2 ;;
+        -s) session=$2; shift 2 ;;
+        --tmux) tmux_mode=$2; shift 2 ;;
+        --dry-run) dry_run=true; shift ;;
+        -h|--help) usage; exit 0 ;;
+        -*) echo "Unknown option: $1" >&2; usage; exit 1 ;;
+        *) break ;;
+    esac
+done
+
+if [[ $# -eq 0 ]]; then
+    echo "Error: no directories specified" >&2
+    usage
+    exit 1
+fi
+
+# find repos
+repos=()
+for root in "$@"; do
+    if [[ ! -d "$root" ]]; then
+        echo "skip: $root is not a directory" >&2
+        continue
+    fi
+    
+    # find .git dirs, respecting max_depth and skipping noise dirs
+    while IFS= read -r -d '' gitdir; do
+        repo="${gitdir%/.git}"
+        repos+=("$repo")
+    done < <(find "$root" -mindepth 1 -maxdepth $((max_depth + 1)) \
+                -name ".git" -type d \
+                -not -path "*/node_modules/*" \
+                -not -path "*/.venv/*" \
+                -not -path "*/venv/*" \
+                -not -path "*/target/*" \
+                -not -path "*/build/*" \
+                -not -path "*/dist/*" \
+                -not -path "*/__pycache__/*" \
+                -print0 2>/dev/null)
+done
+
+if [[ ${#repos[@]} -eq 0 ]]; then
+    echo "no git repos found" >&2
+    exit 1
+fi
+
+if [[ "$dry_run" == "true" ]]; then
+    printf '%s\n' "${repos[@]}"
+    exit 0
+fi
+
+echo "rebasing ${#repos[@]} repo(s) (jobs=$jobs)..." >&2
+
+# set up temp dir for per-repo status files
+tmpdir=$(mktemp -d)
+trap "rm -rf $tmpdir" EXIT
+
+# concurrent rebase function
+rebase_one() {
+    local repo=$1
+    local slug=${repo//\//_}  # sanitize path for filename
+    local old_sha new_sha
+    
+    cd "$repo"
+    old_sha=$(git rev-parse HEAD 2>/dev/null || echo "")
+    
+    if git pull --rebase --autostash >"$tmpdir/$slug.out" 2>"$tmpdir/$slug.err"; then
+        echo "0" > "$tmpdir/$slug.status"
+        new_sha=$(git rev-parse HEAD 2>/dev/null || echo "$old_sha")
+        
+        # simple change detection
+        if [[ -n "$old_sha" && "$old_sha" != "$new_sha" ]]; then
+            local count=$(git rev-list --count "$old_sha..$new_sha" 2>/dev/null || echo "0")
+            echo "✓ $count commit(s)" > "$tmpdir/$slug.summary"
+        else
+            echo "· up to date" > "$tmpdir/$slug.summary"
+        fi
+    else
+        local rc=$?
+        echo "$rc" > "$tmpdir/$slug.status"
+        local err_tail=$(tail -n1 "$tmpdir/$slug.err" 2>/dev/null || echo "exit $rc")
+        echo "✗ FAIL: $err_tail" > "$tmpdir/$slug.summary"
+    fi
+}
+
+# fan out work with job control
+pids=()
+for repo in "${repos[@]}"; do
+    rebase_one "$repo" &
+    pids+=($!)
+    
+    # wait for a slot if we're at the job limit
+    if (( ${#pids[@]} >= jobs )); then
+        wait -n  # wait for next job to complete (zsh 5.9+, bash 4.3+)
+        # rebuild pids array without completed jobs
+        local new_pids=()
+        for pid in "${pids[@]}"; do
+            if kill -0 "$pid" 2>/dev/null; then
+                new_pids+=("$pid")
+            fi
+        done
+        pids=("${new_pids[@]}")
+    fi
+done
+
+# wait for remaining jobs
+wait
+
+# collect results and print report
+fails=0
+needs_attention=()
+
+# find max repo name length for alignment
+max_width=0
+for repo in "${repos[@]}"; do
+    local name=${repo##*/}  # basename
+    (( ${#name} > max_width )) && max_width=${#name}
+done
+
+for repo in "${repos[@]}"; do
+    local slug=${repo//\//_}
+    local name=${repo##*/}
+    local status=$(cat "$tmpdir/$slug.status" 2>/dev/null || echo "999")
+    local summary=$(cat "$tmpdir/$slug.summary" 2>/dev/null || echo "unknown")
+    
+    printf "%-${max_width}s  %s\n" "$name" "$summary"
+    
+    if [[ "$status" != "0" ]]; then
+        (( fails++ ))
+        needs_attention+=("$repo")
+    fi
+done
+
+# open tmux windows for repos needing attention
+if [[ "$tmux_mode" != "off" ]] && command -v tmux >/dev/null; then
+    opened=0
+    target_repos=()
+    
+    case "$tmux_mode" in
+        all) target_repos=("${repos[@]}") ;;
+        attn) target_repos=("${needs_attention[@]}") ;;
+    esac
+    
+    for repo in "${target_repos[@]}"; do
+        local win_name=${repo##*/}  # basename
+        local clean_name=${win_name//[: .]/_}  # sanitize for tmux
+        
+        if tmux has-session -t "$session" 2>/dev/null; then
+            tmux new-window -t "$session:" -n "$clean_name" -c "$repo" \; send-keys 'git status' Enter
+        else
+            tmux new-session -d -s "$session" -n "$clean_name" -c "$repo" \; send-keys 'git status' Enter
+        fi
+        (( opened++ ))
+    done
+    
+    if (( opened > 0 )); then
+        echo >&2
+        echo "$opened tmux window(s) in session '$session'.  attach: tmux attach -t $session" >&2
+    fi
+fi
+
+exit $((fails > 0 ? 1 : 0))