zsh-git-repo-cache — Documentation

>_ZSH-GIT-REPO-CACHE

Every git repo on disk, instantly searchable. Crawls the root filesystem to locate every git repository and caches results for instant retrieval. Uses fd when available, falls back to find. Integrates with fzf for interactive selection.

Install

# Zinit
zinit light MenkeTechnologies/zsh-git-repo-cache

# Oh My Zsh
git clone https://github.com/MenkeTechnologies/zsh-git-repo-cache \
    "${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-git-repo-cache"
# then: plugins+=(zsh-git-repo-cache)

# Manual
git clone https://github.com/MenkeTechnologies/zsh-git-repo-cache
source zsh-git-repo-cache/zsh-git-repo-cache.plugin.zsh

Data nodes

`ZPWR_ALL_GIT_DIRS`	`~/.zsh-git-repo-cache` — all repos
`ZPWR_ALL_GIT_DIRS_DIRTY`	`~/.zsh-git-repo-cache-dirty` — dirty repos
`ZPWR_ALL_GIT_DIRS_CLEAN`	`~/.zsh-git-repo-cache-clean` — clean repos

Functions

`zsh-git-repo-regenAllGitRepos`	scorched-earth rescan of `/`
`zsh-git-repo-regenAllGitReposDirty`	rebuild dirty cache
`zsh-git-repo-searchAllGitRepos`	query all indexed repos
`zsh-git-repo-searchDirtyGitRepos`	only repos with uncommitted changes
`zsh-git-repo-searchCleanGitRepos`	only clean working trees
`zsh-git-repo-search{Dirty,Clean}GitReposCache`	cached variants — auto-generate if missing

zpwr verbs

When running inside zpwr:

gitreposlist              list all repos
gitreposcleanlist         list clean repos
gitreposdirtylist         list dirty repos
gitreposcleancachelist    list clean repos (cached)
gitreposdirtycachelist    list dirty repos (cached)
gitrepos                  search all repos in fzf
gitreposclean             search clean repos in fzf
gitreposdirty             search dirty repos in fzf
gitreposcleancache        search clean repos in fzf (cached)
gitreposdirtycache        search dirty repos in fzf (cached)

Sibling plugins

Part of the MenkeTechnologies zsh plugin family — the MenkeTechnologiesMeta umbrella:

zsh-better-npm-completion — cache-aware npm install completion
zsh-cargo-completion — live cargo add / cargo install completion
zsh-cpan-completion — live MetaCPAN cpan / cpanm completion
zsh-dotnet-completion — dotnet CLI completion
zsh-expand — spacebar expansion (11,683 tests)
zsh-gem-completion — ruby gem install remote completion
zsh-git-acp — 159 git aliases + add/commit/push keybindings
zsh-learn — MySQL-backed learning collection / quiz
zsh-more-completions — 33,175-file mega completion corpus
zsh-nginx — nginx commands + service-wrapper aliases
zsh-pip-description-completion — pip remote completion with descriptions
zsh-sed-sub — in-place sed substitution on the command line
zsh-sudo — ESC ESC to prepend sudo
zsh-xcode-completions — xcodebuild / xcrun / swift completion