zsh-git-relative-path

Show git-relative paths in your ZSH prompt
Oh My Zsh Plugin

Installation • Usage • Themes • Development

---

Features

• Zero configuration needed
• Works with any oh-my-zsh theme
• Special support for robbyrussell, agnoster, avit themes
• Falls back to normal path when not in a git repo

Prerequisites

• Oh My Zsh
• Node.js >= 14.0.0

Installation

npm install -g @cs-magic-open/zsh-git-relative-path

Done! The plugin auto-configures itself.

Usage

# Before (in /Users/username/projects/my-project/src/components)
username ~/projects/my-project/src/components $

# After (same directory)
username src/components $

Supported Themes

Theme	Status
robbyrussell	Native support
agnoster	Native support
avit	Native support
Others	Auto-patched via %~, %c, %C replacement

Development

git clone https://github.com/cs-magic-open/zsh-git-relative-path
cd zsh-git-relative-path
npm install -g .

# Debug mode
ZSH_GIT_PATH_DEBUG=1 source ~/.zshrc

License

MIT