Skip to content

Latest commit

 

History

History
97 lines (64 loc) · 1.9 KB

README.md

File metadata and controls

97 lines (64 loc) · 1.9 KB

Zsh Git Relative Path Plugin

Zsh Git Relative Path Plugin Logo

A ZSH plugin that shows your current path relative to the git project root in your prompt.

Features

  • Works with any oh-my-zsh theme
  • Shows path relative to git project root when in a git repository
  • Falls back to normal path display when not in a git repository
  • Special support for popular themes (robbyrussell, agnoster, avit)
  • Zero configuration needed!

Prerequisites

Installation

Using npm (Recommended)

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

That's it! The plugin will be automatically configured and activated after installation.

Alternative: Manual Installation

If you prefer to inspect the code first:

# 1. Clone the repository
git clone https://github.com/cs-magic-open/zsh-git-relative-path
cd zsh-git-relative-path

# 2. Install globally from local
npm install -g .

Usage

Once installed, the plugin will automatically modify your prompt to show paths relative to the git project root. No additional configuration is needed!

Example:

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

# After (same directory)
username src/components $

Updating

To update to the latest version:

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

Uninstallation

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

Development

To contribute or modify the plugin:

# Clone the repository
git clone https://github.com/cs-magic-open/zsh-git-relative-path
cd zsh-git-relative-path

# Install dependencies
npm install

# Make your changes...

# Bump version
npm version patch  # or minor/major

License

MIT

Author

cs-magic-open