Install the CLI

The HeroPrompt CLI is a Python package that runs on macOS, Linux, and WSL. Pick the install method that fits your existing Python tooling.

Requirements

Python 3.8 or newer
macOS, Linux, or Windows Subsystem for Linux (WSL)
A HeroPrompt account (sign up free)

pipx (recommended)

Pipx isolates the CLI in its own virtualenv so it never clashes with your project deps.

bash

brew install pipx        # macOS
# or: python -m pip install --user pipx

pipx install heroprompt-cli

pip

Standard pip works fine if you don't care about isolation.

bash

python -m pip install --user heroprompt-cli

uv

If you use uv for everything Python, install the CLI as a tool.

bash

uv tool install heroprompt-cli

Verify the install

bash

heroprompt --version

You should see the version number. If your shell can't find heroprompt, your install method didn't add it to PATH — run pipx ensurepath (or the equivalent for your method) and reopen the terminal.

Upgrade

bash

heroprompt update                  # checks PyPI for a newer release
pipx upgrade heroprompt-cli        # apply

heroprompt update only reports the gap — it never invokes pip itself, so it stays neutral about your install method.

Uninstall

bash

pipx uninstall heroprompt-cli       # if installed with pipx
pip uninstall heroprompt-cli        # if installed with pip

Local synced content under ~/.claude/skills/heroprompt-* and ~/.claude/commands/heroprompt-* is not removed automatically — delete those folders if you want a clean slate.