pwp - Present Working Path Plugin for Oh My Zsh

The pwp plugin provides a convenient way to display the present working path in the terminal prompt and lists the current working directory along with its parent directories. Additionally, it includes custom commands for navigating to parent directories easily, including the newly introduced cdp command for interactive navigation.

Features

• List current working directory and its parent directories.
• Navigate to parent directories using the .. command.
• Interactive parent directory selection with the cdp command (requires fzf).

Installation

Prerequisites

Oh My Zsh should be installed on your system.

Steps

1. Clone the Repository

  git clone https://github.com/ttkalcevic/pwp.git ~/.oh-my-zsh/custom/plugins/pwp

2. Add plugin to your ~/.zshrc

    plugins=(
      # ... other plugins
      pwp
    )

3. Apply changes

  source ~/.zshrc

Usage

Display Current and Parent Directories

Use the pwp command to display the current working directory and its parent directories:

$> pwp
*: /Users/tomislav/.oh-my-zsh/plugins/pwp
1: /Users/tomislav/.oh-my-zsh/plugins
2: /Users/tomislav/.oh-my-zsh
3: /Users/tomislav
4: /Users
5: /

Navigating to Parent Directories

Present working directory (pwd) is listed first (*:), its parent is listed under 1 (first parent), and so on. Root is listed as the last item.

Using ..

Use the .. command (which is part of this plugin) followed by the number of parent directories you want to navigate up. For example, to navigate to /Users/tomislav/.oh-my-zsh:

    $> .. 2
    $> pwd
    /Users/tomislav/.oh-my-zsh

Using cdp

Use the cdp command to interactively select a parent directory to navigate to. It uses the fzf fuzzy finder for selection.

Example:

    $> cdp
    Select directory >
    /Users/tomislav/.oh-my-zsh/plugins
    /Users/tomislav/.oh-my-zsh
    /Users/tomislav
    /Users
    /

After selecting a directory, the terminal will navigate to it automatically.

Customization

You can customize the appearance and behavior of the pwp plugin by modifying the pwp.plugin.zsh file located in ~/.oh-my-zsh/custom/plugins/pwp.

Contributing

Contributions are welcome! If you find any issues or have suggestions for improvements, please create an issue or submit a pull request.

License

This project is licensed under the MIT License. See the LICENSE file for details.

---

This plugin is an enhanced version of a bash function created earlier. Read more:

Medium: Bash and Directory Positioning

Medium: Navigate Your Terminal Like a Pro with the pwp Oh My Zsh Plugin

Medium: Introducing cdp – interactive directory selection for your terminal