Skip to main content

​
Required Dependencies

​
ZSH

Repo Manager requires ZSH (Z Shell) version 5.0 or later. Check your version: 
zsh --version
Install ZSH:
ZSH is pre-installed on macOS. To upgrade:
brew install zsh
Set as default shell: 
chsh -s $(which zsh)
Log out and back in for the change to take effect.

​
Optional Dependencies

Optional dependencies enable additional features. Repo Manager works without them but with reduced functionality.

​
fzf (Fuzzy Finder)

Enables: Interactive worktree picker Feature: When you run repo goto on a repository with multiple worktrees, fzf provides an interactive menu to select which worktree to navigate to. Without fzf: Repo Manager defaults to the main branch worktree without prompting. Install fzf: 
brew install fzf
Check installation: 
fzf --version

​
gh CLI (GitHub CLI)

Enables: PR worktree creation Feature: The repo wt pr <number> command requires gh CLI to fetch pull request information and create worktrees for reviewing PRs. Without gh CLI: The repo wt pr command will not work, but all other worktree operations remain functional. Install gh CLI: 
brew install gh
Authenticate with GitHub: 
gh auth login
Follow the prompts to authenticate. Check installation: 
gh --version

​
Feature Availability Matrix

FeatureRequired DependenciesOptional Dependencies
Clone repositoriesZSH-
Create new repositoriesZSH-
Navigate to repositoriesZSH-
List repositoriesZSH-
Basic worktree operationsZSH-
Interactive worktree pickerZSHfzf
PR worktreesZSHgh CLI

​
Verification Script

Check which dependencies are installed: 
echo "Required:"
echo "  ZSH: $(zsh --version 2>/dev/null || echo 'NOT INSTALLED')"
echo ""
echo "Optional:"
echo "  fzf: $(fzf --version 2>/dev/null || echo 'not installed')"
echo "  gh:  $(gh --version 2>/dev/null | head -n1 || echo 'not installed')"

​
Troubleshooting

​
Command not found after installation

If a dependency doesn’t work after installation:
  1. Restart your terminal or run source ~/.zshrc
  2. Check if the binary is in your PATH: 
    which fzf
which gh
  3. If not in PATH, add the installation directory to PATH in .zshrc

​
fzf not appearing in repo goto

Even with fzf installed, the picker only appears when:
  • You’re in a repository with multiple worktrees
  • fzf is available in PATH
Test fzf availability: 
command -v fzf >/dev/null 2>&1 && echo "fzf available" || echo "fzf not found"

​
gh CLI authentication issues

If repo wt pr fails with authentication errors:
  1. Re-authenticate: 
    gh auth login
  2. Check authentication status: 
    gh auth status
  3. Ensure you have access to the repository

Build docs developers (and LLMs) love

Get started for freeTalk to us