Ru

What it does

RU is a Bash CLI tool designed to synchronize and manage dozens or hundreds of GitHub repositories. It goes beyond simple synchronization by incorporating an AI-assisted code review system and agent-sweep capability for automatically processing uncommitted changes across your projects. RU aims to automate tedious tasks like manual git pull commands, prevent merge conflicts, and coordinate AI agents working across multiple repositories.

When to use it

• You manage a large number of GitHub repositories (47+).
• You want to automate the synchronization process for your repositories.
• You need assistance with code review using AI tools like Claude Code.
• You have uncommitted changes that you want to automatically process and commit across multiple projects.
• You want to streamline the management of issues and pull requests across many repositories.

Key capabilities

• Repository Synchronization: Synchronizes GitHub repositories, supporting parallel execution for speed.
• AI-Assisted Code Review: Orchestrates AI code review workflows using tools like Claude Code. Includes a two-phase process: discovery (planning) and application (review & quality gates).
• Agent Sweep: Automatically processes uncommitted changes across projects.
• Repo Management: Allows adding, removing, listing, and pruning repositories from the synchronization list.
• Status Checks: Provides read-only status checks for repositories.
• JSON Output: Supports JSON output for scripting and automation.

Example prompts

While RU is a CLI tool, here are examples of how you might instruct an agent to use it:

1. "Run ru sync -j8 to synchronize all my configured repositories in parallel."
2. "Use ru status --json to check the status of my repositories and report any errors."
3. "Execute ru doctor to perform a system health check on RU."

Tips & gotchas

• Git Plumbing: RU relies on Git plumbing commands for reliability, avoiding parsing human-readable output.
• Stream Separation: Human-readable output is directed to stderr, while data is sent to stdout. Use tools like jq to process JSON output effectively.
• No Global cd: All git operations are performed using git -C . to avoid changing the current working directory.