// ZSH-GIT-REPO-CACHE — INDEX EVERY GIT REPO ON THE MACHINE // FAST cd, FAST PROMPT

Overview

The plugin builds three plain-text caches under $HOME — one path per line, sorted and deduped — and exposes 8 autoload functions that read or rebuild them. The flow is three stages:

[ SCAN ] ──> [ CACHE ] ──> [ QUERY ]
   │             │              │
  fd / find   ~/.zsh-git-     fzf / list
   @ /         repo-cache     output + cd

Scan. regenAllGitRepos runs sudo fd '\.git$' / --type d --threads=8 --hidden --no-ignore (or sudo find / -name .git -type d -prune when fd is absent), strips the trailing /.git, removes the macOS /System/Volumes/Data and /System/Volumes/Update/mnt1 mirror prefixes (only when $ZPWR_OS_TYPE == darwin), then sort | uniq into the master cache.

Bisect. regenAllGitReposDirty walks the master list once, runs git diff-index --quiet HEAD + git ls-files --exclude-standard --others on each repo, and writes dirty paths to one cache and clean paths to another via two concurrent file descriptors (exec 3> / exec 4>) — both caches in a single pass.

Query. Search functions either live-walk the master list (always fresh) or read the pre-bisected dirty/clean caches (cheap). In default mode they pipe through fzf, echo the resolved cd "...", and eval it; in list mode they emit raw paths to stdout.

Requirements

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

Functions

Invocation contract

Every search* function reads exactly two positional arguments — no flags, no getopts. The ZPWR_VERBS list entries encode the same two slots (... n list means $1=n, $2=list).

Usage

# fzf-pick any repo on the machine and cd into it (default mode)
zsh-git-repo-searchAllGitRepos

# force a fresh rescan of / first, then fzf-pick
zsh-git-repo-searchAllGitRepos regen

# list dirty repos to stdout — live walk, no fzf, no cd
zsh-git-repo-searchDirtyGitRepos n list

# count repos with uncommitted work on this host
zsh-git-repo-searchDirtyGitRepos n list | wc -l

# read the pre-bisected caches instead of live-walking
zsh-git-repo-searchDirtyGitReposCache n list
zsh-git-repo-searchCleanGitReposCache n list

# rebuild the caches explicitly
zsh-git-repo-regenAllGitRepos       # master cache
zsh-git-repo-regenAllGitReposDirty  # dirty + clean caches

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)

Configuration

Every variable below is defaulted by the plugin only when unset, so a pre-existing zpwr environment keeps its own values:

Two more variables are read but never written by this plugin — the caller (typically zpwr) supplies them:

Troubleshooting

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