Install the CLI
Sync prompts, skills, and slash commands to your machine. Use them with Claude Code, Cursor, or any agent CLI.
Quick start
~2 minutes- 1
Install the CLI
Pick your installer. Recommended — isolated environment.
Requires Python 3.8+ — check with
python3 --version$ pipx install heroprompt-cli$ heroprompt --version - 2
Authenticate
PROGenerate a Personal Access Token, then log in. CLI tokens require a PRO or Team subscription.
Don't have PRO yet? Upgrade → to unlock CLI tokens & Skills.
Create a token in Settings$ heroprompt login --token hp_pat_xxxxxxxxxxxxxxxx$ heroprompt statusTokens are stored at ~/.heroprompt/config.json, chmod 600.
- 3
Sync content to your machine
Choose what to pull. Files are written to your home directory so any agent or editor can read them.
FreeReusable prompt templates with typed variables. Pipe-friendly via heroprompt cat.$ heroprompt sync sync-prompts✓ Synced 42 prompt(s) to ~/.heroprompt/prompts/Saved to
~/.heroprompt/prompts/
Need help? Run heroprompt --help or open the full documentation.
Wire slash commands into your agent
Symlink the synced folder so commands appear natively in your tool.
$ ln -sfn ~/.heroprompt/commands ~/.claude/commands/heropromptAfter symlinking, commands appear as /heroprompt:<name> inside Claude Code.
Next step
CLI installed — now grab a starter pack
Skip the manual sync. Six role-specific packs bundle curated skills + slash commands. One command, ~80% of your daily flow covered.
Troubleshooting
Command not found: heroprompt
Add the pip user-bin directory to your PATH. Append this to your shell rc (~/.zshrc or ~/.bashrc) then restart your terminal:
$ export PATH="$HOME/.local/bin:$PATH"Authentication required after login
Your token may have been revoked or expired. Re-create one in Settings → CLI Access and run heroprompt login again.
Skills access requires PRO Kit
Skills are PRO-only. Visit Pricing to upgrade — prompts and slash commands stay free on every plan.
Python version mismatch
HeroPrompt CLI needs Python 3.8 or later. Verify with python3 --version and upgrade via pyenv or your OS package manager if older.