Parent directory

README.md

1900 bytes

Pipenv

This plugin provides some features to simplify the use of Pipenv while working on ZSH.

In your .zshrc file, add pipenv to the plugins section

plugins=(... pipenv ...)

Features

  • Adds completion for pipenv (install the argcomplete package to get it working with pipenv >= 2026.5.0)
  • Auto activates and deactivates pipenv shell
  • Adds short aliases for common pipenv commands
    • pch is aliased to pipenv check
    • pcl is aliased to pipenv clean
    • pgr is aliased to pipenv graph
    • pi is aliased to pipenv install
    • pidev is aliased to pipenv install --dev
    • pl is aliased to pipenv lock
    • po is aliased to pipenv open
    • prun is aliased to pipenv run
    • psh is aliased to pipenv shell
    • psy is aliased to pipenv sync
    • pu is aliased to pipenv uninstall
    • pupd is aliased to pipenv update
    • pwh is aliased to pipenv --where
    • pvenv is aliased to pipenv --venv
    • ppy is aliased to pipenv --py

Cache

This plugin caches the Pipenv version to avoid running pipenv --version on every shell startup. The cache is automatically refreshed asynchronously when the plugin is loaded, which is usually when you start a new terminal session.

For legacy Pipenv versions, the generated completion script is also cached.

The cache is stored at:

  • $ZSH_CACHE_DIR/pipenv_version version of Pipenv, used to choose between argcomplete-based completion and legacy Click-based completion.

  • $ZSH_CACHE_DIR/completions/_pipenv legacy Click-based completion script.

Configuration

Shell activation

If you want to disable the shell activation and deactivation feature, add the following style to your .zshrc before sourcing oh-my-zsh.sh:

zstyle ':omz:plugins:pipenv' auto-shell no