# urur
A multi-repo workspace manager for developers who work across many distributed Git repositories.
[](https://crates.io/crates/urur)
[](LICENSE)
## 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.
```bash
# 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
```bash
cargo install urur
```
### From source
```bash
git clone https://github.com/rusenbb/urur.git
cd urur
cargo install --path .
```
### Pre-built binaries
Download from the [releases page](https://github.com/rusenbb/urur/releases).
## Quick Start
```bash
# 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:
```toml
[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
| `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
```bash
urur init [--name NAME] # Initialize a new workspace
urur list [--json] # List all repositories
urur doctor # Health check for your workspace
```
### Repository Operations
```bash
# 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
```bash
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
```bash
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
```bash
# 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
```bash
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
```bash
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:
```bash
# Select a repo
urur select project-a
# 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
# See what's selected
urur which
# Back to multi-repo mode
urur unselect
```
### Shell Integration
Add to your `.bashrc` or `.zshrc`:
```bash
# cd to selected repo
ucd() {
cd "$(urur cd)"
}
```
## Shell Completions
Generate shell completions:
```bash
# 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
```toml
[[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
```toml
[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
```toml
[[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
| 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](LICENSE) file for details.
## Roadmap
- [x] Core workspace management
- [x] Group and tag filtering
- [x] Select mode for single-repo focus
- [x] Shell completions
- [ ] Parallel operations with progress bars
- [ ] Interactive mode
- [ ] Repository templates
- [ ] Cloud config sync
See [ROADMAP.md](ROADMAP.md) for detailed plans.