# Install git-url-sub with Homebrew

Recursively substitute remote URLs for multiple repos. Version 1.0.1 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:git-url-sub
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install git-url-sub
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:git-url-sub
- **Package manager:** Homebrew
- **Version:** 1.0.1
- **Source summary:** Recursively substitute remote URLs for multiple repos
- **Homepage:** <https://gosuri.github.io/git-url-sub>
- **Repository:** <https://github.com/gosuri/git-url-sub>
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- git-url-sub (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 1.0.1
## Project history and usage

git-url-sub is a small shell Git utility for recursively substituting remote URLs across multiple repositories.

### Project history

Greg Osuri published git-url-sub as a compact Git helper aimed at changing repository remotes in bulk rather than editing each repository by hand. The official generated man page identifies it as a Git URL substitution utility and dates the man page to August 2011.

### Adoption history

The project had a Homebrew installation path early enough to be documented in the README. Homebrew's formula packages version 1.0.1 in homebrew/core and also exposes a HEAD build, indicating small but durable package-manager presence.

### How it is used

Practitioners use git-url-sub with a pattern and replacement to rewrite remote URLs, for example after a GitHub organization rename, a hosting migration, or a switch between URL styles. The `-c` option commits changes and `-s` suppresses output.

### Why package nerds care

git-url-sub is notable as a Unix-style Git helper: a single-purpose command that automates a repetitive repository-maintenance chore without building a broader synchronization system.

### Timeline

- 2011: Official man page date records August 2011.
- 1.0.1: Homebrew packages git-url-sub as the current stable release.

### Related projects

- git-url-sub is related to `git remote set-url`, shell scripting around Git, and Homebrew-packaged Git helpers.

### Sources

- <https://formulae.brew.sh/formula/git-url-sub>
- <https://github.com/gosuri/git-url-sub#readme>
- <https://gosuri.github.io/git-url-sub>


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals


## Combined YAML source

View the package source record on GitHub. [combined/git-url-sub.yml](https://github.com/mxcl/pkgdb/blob/main/combined/git-url-sub.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated package history
- pkgdb category and tag curation
- cross-ecosystem install command graph