https://github.com/hugoh/hrd
Multi-repo manager (TUI & CLI) for git and jj with parallel dispatch and live status
https://github.com/hugoh/hrd
cli developer-tools devtools git go golang jj jujutsu multi-repo productivity repo-management terminal tui vcs
Last synced: 28 days ago
JSON representation
Multi-repo manager (TUI & CLI) for git and jj with parallel dispatch and live status
- Host: GitHub
- URL: https://github.com/hugoh/hrd
- Owner: hugoh
- License: mit
- Created: 2026-05-06T11:27:06.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-05-30T01:39:46.000Z (about 1 month ago)
- Last Synced: 2026-05-30T02:11:58.273Z (about 1 month ago)
- Topics: cli, developer-tools, devtools, git, go, golang, jj, jujutsu, multi-repo, productivity, repo-management, terminal, tui, vcs
- Language: Go
- Homepage:
- Size: 339 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# hrd
Herd your repos. Run commands across them in parallel. Watch results stream in live.
`hrd` is a multi-repo manager for developers who work across many repositories and use both **git** and **jj** (Jujutsu). It keeps your repos organized into groups, runs VCS commands across all of them at once, and shows a live unified status dashboard — with full awareness of branches, bookmarks, remote tracking, ahead/behind counts, and conflicts.
[](https://github.com/hugoh/hrd/actions/workflows/ci.yml)
[](https://codecov.io/github/hugoh/hrd)
[](https://goreportcard.com/report/github.com/hugoh/hrd)
## Features
- **git and jj as first-class citizens** — both backends are fully supported with native status parsing. Colocated repos (jj on top of git) are handled correctly.
- **Parallel execution** — commands run concurrently across all matched repos, with results streaming in as each one completes.
- **Live status dashboard** — `hrd ls` shows a color-coded table of every repo's ref, remote sync state, dirty flag, and per-bookmark/branch badges, updating in real time.
- **Interactive TUI** — `hrd` (or `hrd tui`) opens a full-screen terminal UI for browsing repos, filtering by group or name, and dispatching commands across multiple repos with live streaming output.
- **Repo groups** — group repos for easier filtering.
- **Three dispatch commands** — `git`, `jj`, and `shell`.
- **Shell completion** — bash, zsh, and fish, with dynamic completion of repo and group names from your live config.
- **Extensible backend system** — new VCS backends implement a single interface and self-register.
## Install
### Homebrew (macOS/Linux)
```sh
brew install hugoh/tap/hrd
```
### Linux (deb/rpm)
Download the `.deb` or `.rpm` from the [releases page](https://github.com/hugoh/hrd/releases) and install with your package manager:
```sh
# Debian/Ubuntu
sudo apt install ./hrd_*.deb
# RHEL/Fedora
sudo dnf install ./hrd_*.rpm
```
### mise
```sh
mise use -g github:hugoh/hrd
```
### Go install
```sh
go install github.com/hugoh/hrd@latest
```
### From source
```sh
git clone https://github.com/hugoh/hrd
cd hrd
go build -o hrd .
```
## Quick start
```sh
# Track some repos
hrd repo add ~/dev/myproject ~/dev/infra
hrd repo add -n dotfiles ~/.local/share/chezmoi
# Start the TUI
hrd
# Add repos to groups
hrd repo group myproject work
hrd repo group infra work
# Live status across all repos in context
hrd ls
# Run a command across all repos
hrd fetch
# Or just the ones you care about right now
hrd jj dotfiles log
# Arbitrary shell commands
hrd shell -- 'echo $(basename $PWD): $(git rev-parse --short HEAD)'
```
**Tip**: Group names are displayed with an `@` prefix (e.g., `@work`, `@oss`) to distinguish them from repo names. The `@` is optional on input — `hrd ls @work` and `hrd ls work` both work.
## Status dashboard
```text
NAME VCS STATUS
myproject git main ↑2* feat: add new feature (2 hours ago)
dotfiles jj main ✓∅⇡5 config: update zshrc (1 day ago)
infra git feat/rework ↑1↓3 refactor: networking layer (3 days ago)
old-service jj legacy ✗✓!‼ fix: critical bug (1 week ago)
```
Status symbols at a glance:
| Symbol | Meaning |
| ------ | -------------------------------------- |
| `✓` | Synced with remote |
| `↑N` | N commits ahead of remote |
| `↓N` | N commits behind remote |
| `⇡N` | Working copy ahead of bookmark (local) |
| `↑N↓N` | Diverged (ahead and behind) |
| `∅` | Local only, no remote |
| `‼` | Unresolved conflict |
| `!` | Bookmark conflict (jj) |
| `✗` | Remote was deleted |
| `*` | Dirty working copy |
| `?` | Unknown remote state |
## Interactive TUI
Run `hrd` (or `hrd tui`) to open the full-screen terminal UI:
- Browse all tracked repos in a sortable table.
- Filter by group with `@` — type `@work` to show only work repos, or select individual repos with `Space`.
- Run VCS commands (`status`, `diff`, `log`, `fetch`, `pull`, `push`) from a single key press — results stream in live as each repo completes.
- The command palette (`:`) gives access to every subcommand without leaving the TUI.
- Shortcuts: `s` (status), `l` (log), `d` (diff), `f` (fetch), `p` (pull), `P` (push), `@` (group picker), `q` or `Esc` (quit).
The TUI mirrors the CLI: the same backends, the same parallel execution, the same status parsing — just in an interactive, always-on view.
## Command reference
```text
NAME:
hrd - manage multiple git and jj repositories
USAGE:
hrd [global options] [command [command options]]
VERSION:
dev
COMMANDS:
repo manage tracked repositories
group list repo groups
ls, ll show status of repos
status, st show detailed status for repos (git status or jj status)
diff show diff for repos (git diff or jj diff)
log show log for repos (git log or jj log)
fetch fetch from remotes (git fetch or jj git fetch)
pull pull from remotes (git pull or jj git pull)
push push to remotes (git push or jj git push)
git run a git command across repos
jj run a jj command across repos
shell run an arbitrary shell command across repos
tui, i interactive terminal UI for browsing and running commands across repos
help, h Shows a list of commands or help for one command
completion Output shell completion script for bash, zsh, fish, or Powershell
GLOBAL OPTIONS:
--config string, -c string path to config file (default: "~/.config/hrd/config.toml")
--help, -h show help
--version, -v print the version
```
## Configuration
Config lives at `~/.config/hrd/config.toml` (respects `$XDG_CONFIG_HOME`).
```toml
[repos.dotfiles]
path = "/home/alice/.local/share/chezmoi"
[repos.myproject]
path = "/home/alice/dev/myproject"
groups = ["work"]
[repos.infra]
path = "/home/alice/dev/infra"
groups = ["work"]
[settings]
concurrency = 8
```
**Note**: Groups are derived from the `groups` field on each repo. Group names are displayed with an `@` prefix (e.g., `@work`) to distinguish them from repo names. The `@` is optional on input — `work` and `@work` are treated identically.
---
## Contributing
Contributions are very welcome! Please open an issue or submit a pull request. See [development instructions](AGENTS.md).
### Adding a backend
Implement the `Backend` interface in a new package, add a `Register()` function that calls `backend.Register()`, and call it from `main.go`'s `Run()` function. The interface is four methods: `Name`, `Detect`, `Status`, and `Run`.
---
## Related tools
[gita](https://github.com/nosarthur/gita) is the direct inspiration for `hrd`.
[Jujutsu (jj) VCS](https://github.com/jj-vcs/jj) motivated creating `hrd` with first-class non-git support.
## Disclaimer
LLMs were used to put together the initial version.