How do you install `poetry shell` on macOS?

I'm not sure what I've done, but, I can't manage to get poetry shell to work - poetry env activate works, though:

poetry was installed using pipx:

brew uninstall poetry
brew install pipx
pipx install poetry

Trying to spawn and activate a virtualenv with poetry shell fails:

poetry shell

Looks like you're trying to use a Poetry command that is not available.

Since Poetry (2.0.0), the shell command is not installed by default. You can use,

  - the new env activate command (recommended); or
  - the shell plugin to install the shell command

Documentation: https://python-poetry.org/docs/managing-environments/#activating-the-environment

Note that the env activate command is not a direct replacement for shell command.

But, poetry env activate works.

I'm not sure how I broke my setup, but, does anyone know what the issue might be, or if I should just use poetry env activate rather than poetry shell?

Start with the reported poetry shell and poetry env activate behavior and review the linked managing-environments documentation. Check how the shell plugin is expected to provide the command on macOS after a pipx installation. Done means the project guidance clearly explains whether to use env activate or how to install and invoke the shell command.