urur 0.2.2

Multi-repo workspace manager - manage distributed Git repositories with a single config
Documentation
urur-0.2.2 has been yanked.

urur

A multi-repo workspace manager for developers who work across many distributed Git repositories.

Crates.io License: MIT

Why urur?

If you work with multiple Git repositories spread across GitHub, GitLab, and other hosts, you know the pain of:

  • Cloning repos one by one
  • Checking status of 10+ repos manually
  • Running the same command in each repo
  • Remembering which repos need to be pulled

urur solves this with a single configuration file that manages all your repositories.

# Clone all your repos
urur clone

# Check status everywhere
urur status

# Pull everything
urur pull

# Run any command across repos
urur exec "git log -1 --oneline"

Installation

From crates.io

cargo install urur

From source

git clone https://github.com/rusenbb/urur.git
cd urur
cargo install --path .

Pre-built binaries

Download from the releases page.

Quick Start

# 1. Initialize a workspace
mkdir my-repos && cd my-repos
urur init --name "my-workspace"

# 2. Add repositories
urur add https://github.com/user/repo1.git --tag work
urur add git@github.com:user/repo2.git --tag personal

# 3. Clone everything
urur clone

# 4. Check status
urur status

Configuration

urur uses a .urur.toml file for configuration:

[workspace]
name = "my-workspace"
description = "All my projects"

[defaults]
branch = "main"
shallow = false
parallel = 4

[[repos]]
name = "project-a"
url = "git@github.com:user/project-a.git"
path = "work/project-a"      # Custom directory structure
branch = "develop"           # Override default branch
tags = ["work", "rust"]

[[repos]]
name = "project-b"
url = "git@github.com:user/project-b.git"
path = "personal/project-b"
tags = ["personal", "python"]

[groups]
work = ["project-a"]
all-rust = ["project-a"]

Repository Options

Field Description Default
name Unique identifier Derived from URL
url Git clone URL (HTTPS or SSH) Required
path Local directory path Same as name
branch Default branch From defaults.branch
tags Tags for filtering []
shallow Shallow clone false
disabled Skip this repo false

Commands

Workspace Management

urur init [--name NAME]     # Initialize a new workspace
urur list [--json]          # List all repositories
urur doctor                 # Health check for your workspace

Repository Operations

# Add/remove repos
urur add <url> [--name NAME] [--path PATH] [--branch BRANCH] [--tag TAG...] [--clone]
urur remove <name> [--delete]   # --delete removes local files too

# Clone
urur clone                      # Clone all repos
urur clone repo1 repo2          # Clone specific repos
urur clone --group work         # Clone repos in a group
urur clone --tag rust           # Clone repos with a tag

Status and Sync

urur status                     # Show all repo statuses
urur status --dirty             # Show only dirty repos
urur dirty                      # List repos with uncommitted changes
urur behind                     # List repos behind remote
urur diff                       # Show diff summary across repos

Git Operations

urur pull [--group GROUP] [--tag TAG]      # Pull all repos
urur fetch [--group GROUP]                  # Fetch all repos
urur push [--group GROUP] [--tag TAG]      # Push all repos
urur checkout <branch>                      # Checkout branch across repos
urur sync                                   # Smart sync: stash, fetch, rebase, unstash
urur gc                                     # Run git gc in all repos

Stash and Branch

# Stash operations
urur stash                      # Stash in all repos
urur stash push                 # Same as above
urur stash pop                  # Pop stash in all repos
urur stash list                 # List stashes in all repos

# Branch operations
urur branch list                # Show current branch in all repos
urur branch create <name>       # Create branch in all repos
urur branch delete <name>       # Delete branch in all repos

Execute Commands

urur exec <command>                         # Run in all repos
urur exec "npm install" --tag nodejs        # Run in tagged repos
urur exec "cargo test" --group rust-projects

Group Management

urur group list                             # List all groups
urur group create <name> [repos...]         # Create a group
urur group add <name> <repo>                # Add repo to group
urur group remove <name> <repo>             # Remove repo from group
urur group delete <name>                    # Delete a group

Select Mode

Focus on a single repository and use urur as a git alias:

# Select a repo (and optionally cd into it)
urur select project-a
# Or with automatic cd:
eval "$(urur select project-a --cd)"

# Now urur commands run on that repo
urur status          # git status in project-a
urur log             # git log in project-a
urur commit -m "..."  # git commit in project-a

# Open in editor or browser
urur open            # Opens in $EDITOR or 'code'
urur web             # Opens remote URL in browser

# See what's selected
urur which

# Back to multi-repo mode (and optionally cd to workspace)
urur unselect
# Or with automatic cd:
eval "$(urur unselect --cd)"

Shell Integration

For seamless cd on select/unselect, add to your .bashrc or .zshrc:

# Shell wrapper for urur select/unselect with automatic cd
urur() {
    case "$1" in
        select)
            shift
            eval "$(command urur select "$@" --cd)"
            ;;
        unselect)
            eval "$(command urur unselect --cd)"
            ;;
        *)
            command urur "$@"
            ;;
    esac
}

# Alternative: simple cd helper
ucd() {
    cd "$(urur cd)"
}

Shell Completions

Generate shell completions:

# Bash
urur completions bash > ~/.local/share/bash-completion/completions/urur

# Zsh
urur completions zsh > ~/.zfunc/_urur

# Fish
urur completions fish > ~/.config/fish/completions/urur.fish

# PowerShell
urur completions powershell > ~\Documents\PowerShell\Modules\urur\urur.ps1

Examples

Organize by Project Type

[[repos]]
name = "frontend"
url = "git@github.com:company/frontend.git"
path = "web/frontend"
tags = ["web", "typescript"]

[[repos]]
name = "backend"
url = "git@github.com:company/backend.git"
path = "api/backend"
tags = ["api", "rust"]

[[repos]]
name = "mobile"
url = "git@github.com:company/mobile.git"
path = "mobile/app"
tags = ["mobile", "react-native"]

Work vs Personal

[groups]
work = ["frontend", "backend", "mobile"]
personal = ["dotfiles", "blog", "side-project"]

# Pull only work repos
# urur pull --group work

# Status of personal projects
# urur status --group personal

Microservices

[[repos]]
name = "auth-service"
url = "git@github.com:company/auth-service.git"
tags = ["service", "critical"]

[[repos]]
name = "user-service"
url = "git@github.com:company/user-service.git"
tags = ["service"]

[[repos]]
name = "payment-service"
url = "git@github.com:company/payment-service.git"
tags = ["service", "critical"]

# Run tests on all services
# urur exec "make test" --tag service

# Check critical services
# urur status --tag critical

Comparison with Other Tools

Feature urur git-repo gita myrepos
Config format TOML XML YAML Config file
Tags/Groups Yes Yes (projects) Yes No
Custom paths Yes Limited No Yes
Select mode Yes No No No
Shell completions Yes Yes Yes No
Written in Rust Python Python Perl

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

New Features

Interactive TUI

Launch an interactive dashboard to view and manage all repositories:

urur tui
# or
urur ui

Import from GitHub/GitLab

Bulk import repositories from your GitHub or GitLab account:

# Import all your GitHub repos
urur import-github myusername

# Import private repos too (requires GITHUB_TOKEN)
urur import-github myusername --private

# Filter by language
urur import-github myusername --language rust

# Import from GitLab
urur import-gitlab myusername

Hooks

Run custom commands before/after operations:

[hooks]
pre_clone = "echo 'Starting clone...'"
post_clone = "npm install"
pre_sync = "echo 'Syncing...'"
post_sync = "notify-send 'Sync complete'"

Search Across Repos

Search for patterns across all repositories:

urur search "TODO"
urur search "function.*Error" --glob "*.ts"

Roadmap

  • Core workspace management
  • Group and tag filtering
  • Select mode for single-repo focus
  • Shell completions
  • Progress bars during operations
  • Interactive TUI mode
  • GitHub/GitLab import
  • Hooks system
  • Search across repos
  • Parallel operations
  • Repository templates
  • Cloud config sync

See ROADMAP.md for detailed plans.