Master multi-repo synchronization and AI-driven commit automation with RU.
What Is RU?
RU (Repo Updater) is your command center for managing dozens of GitHub repositories. One command syncs everything. AI automation commits your dirty repos intelligently.
Without RU, you'd manually cd into each repo and run git pull. With 20+ repos, that's tedious and error-prone. RU handles it all with parallel workers.
Parallel Sync
Work-stealing queue syncs repos 4x faster
Agent Sweep
AI-driven commit automation
Resume Support
Pick up where you left off
Git Plumbing
No string parsing, locale-safe
Essential Commands
Start with these core commands. They cover 90% of daily usage.
ru sync --resume if sync was interrupted. RU remembers progress!Agent Sweep: AI Automation
Agent Sweep is RU's killer feature. It uses Claude Code to automatically commit dirty repos with intelligent commit messages.
# Phase 1: Understand# Agent reads AGENTS.md, explores codebase, learns conventions# Phase 2: Plan# Agent produces JSON commit plan (files, messages)# RU validates: no secrets, file size limits, schema check# Phase 3: Execute# RU executes validated plan with deterministic git commands
--dry-run first to preview the commit plan!AI Code Review
RU can orchestrate AI-assisted code reviews across your repos using ru review. The review system integrates with ntm's robot mode to spawn Claude agents for thorough analysis.
ubs for comprehensive coverage: run ubs . for static analysis, then ru review for semantic understanding.Configuration
RU follows XDG conventions. Configure once, sync everywhere.
# Base directory for repositoriesPROJECTS_DIR=/data/projects# Parallel workers (1-8)PARALLEL=4# Update strategy: ff-only | rebase | mergeUPDATE_STRATEGY=ff-only# Auto-stash local changes before pullAUTOSTASH=false
# ShorthandDicklesworthstone/ntmDicklesworthstone/beads_viewer# With branchowner/repo@develop# Custom local nameowner/repo as my-fork# SSH URLgit@github.com:owner/repo.git as myrepo
ru init --example to create starter config files.Tool Integration
RU becomes more powerful when combined with other flywheel tools.
RU + NTM
Agent Sweep uses NTM robot mode to spawn Claude sessions. NTM manages the tmux panes, RU orchestrates the workflow.
RU + BV
After syncing repos, use BV to check beads across all projects. Combine ru status with bv --robot-triage.
RU + Mail
Agents can claim repos via Mail to prevent conflicts during parallel agent-sweep runs.
Exit Codes
RU uses meaningful exit codes for scripting and automation.
0Success1Partial failure (some repos failed)2Conflicts (manual resolution needed)5Interrupted (use --resume)