{"id":10051,"library":"poetry-plugin-shell","title":"Poetry Shell Plugin","description":"The `poetry-plugin-shell` is an official Poetry plugin that extends the Poetry CLI with a `shell` command. This command allows users to open a subshell with their project's virtual environment automatically activated, making it easy to interact with installed project dependencies. It is currently at version 1.0.1 and generally releases updates to ensure compatibility with new Poetry versions.","status":"active","version":"1.0.1","language":"en","source_language":"en","source_url":"https://github.com/python-poetry/poetry-plugin-shell","tags":["poetry","plugin","shell","venv","environment","cli"],"install":[{"cmd":"poetry self add poetry-plugin-shell","lang":"bash","label":"Install for Poetry CLI"}],"dependencies":[],"imports":[],"quickstart":{"code":"poetry shell","lang":"bash","description":"After installing the plugin using `poetry self add`, navigate to a Poetry-managed project directory and run `poetry shell`. This will open a new subshell (e.g., bash, zsh, cmd) with your project's virtual environment activated, allowing you to run project executables or Python scripts directly."},"warnings":[{"fix":"Upgrade your Poetry installation to a compatible version using `poetry self update` before adding the plugin.","message":"This plugin requires Poetry version 1.2.0 or newer. Installing it with older Poetry versions will result in a plugin load error.","severity":"breaking","affected_versions":"<1.2.0"},{"fix":"Always use `poetry self add poetry-plugin-shell` to install the plugin. Do not try `pip install poetry-plugin-shell` in a project's virtual environment or globally.","message":"The `poetry-plugin-shell` must be installed as a Poetry self-plugin for the Poetry CLI, not within a project's virtual environment using `pip install`.","severity":"gotcha","affected_versions":"All versions"}],"env_vars":null,"last_verified":"2026-04-17T00:00:00.000Z","next_check":"2026-07-16T00:00:00.000Z","problems":[{"fix":"Ensure Poetry is updated to at least 1.2.0 (`poetry self update`) and then install the plugin using `poetry self add poetry-plugin-shell`.","cause":"The `poetry-plugin-shell` plugin is either not installed for your Poetry CLI, or your Poetry installation is too old to support the plugin system.","error":"Command `shell` not found."},{"fix":"Upgrade your Poetry installation to version 1.2.0 or newer using `poetry self update`.","cause":"Your Poetry CLI version is older than the required 1.2.0, which introduced the plugin system and required API.","error":"poetry.plugins.exceptions.PluginLoadError: Plugin `poetry-plugin-shell` could not be loaded because of an incompatible Poetry version."}]}