heroprompt-cli 0.1.2

HeroPrompt CLI - Sync prompts and Skills to your local machine

HeroPrompt CLI

Sync prompts and Skills to your local machine

Installation

pip install heroprompt-cli

Or with pipx (recommended for isolation):

pipx install heroprompt-cli

Quick Start

# 1. Login with personal access token (generate at https://heroprompt.store/dashboard/settings)
heroprompt login --token hp_pat_xxxxx

# 2. Check your status
heroprompt status

# 3. Browse content
heroprompt list prompts
heroprompt list skills      # PRO Kit required
heroprompt list packs

# 4. Sync prompts / skills / slash commands to local
heroprompt sync sync-prompts
heroprompt sync sync-skill mcp-server     # PRO Kit required
heroprompt sync sync-commands

# 5. Print a prompt template to stdout (pipe-friendly)
heroprompt cat <prompt-id>

# 6. Install a persona pack into ~/.claude/
heroprompt pack install developer

Commands

Command	Description	Tier
login --token <token>	Authenticate with PAT	All
logout	Clear credentials	All
status	Show account info (use --json for scripts)	All
version	Show CLI version	All
update	Check PyPI for a newer release	All
cat <prompt-id>	Print prompt template (pipe-friendly)	All
rate <prompt-id> <1-5> [--review]	Submit a rating	All
trending [--limit N]	Top prompts by usage	All
list prompts | skills | packs	Browse available content	Mixed
sync sync-prompts	Download prompts to local	All
sync sync-skill <id>	Download a Skill to local	PRO+
sync sync-commands	Download slash commands to local	All
pack list | info | install | uninstall | sync	Persona pack management	All

Configuration

The CLI stores configuration in ~/.heroprompt/:

~/.heroprompt/
├── config.json       # Auth token and user info (chmod 0600)
├── prompts/          # Synced prompts
├── skills/           # Synced Skills
└── commands/         # Synced slash commands

Personal Access Tokens

Generate a personal access token at:

https://heroprompt.store/dashboard/settings

Token format: hp_pat_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Upgrade to PRO Kit

Skills access requires PRO Kit subscription. Browse pricing at https://heroprompt.store/pricing.

Development

# Clone and install in dev mode
git clone https://github.com/heroprompt/cli.git
cd cli
pip install -e ".[dev]"

# Run tests
pytest

# Format code
black heroprompt/
ruff check heroprompt/

License

MIT License - see LICENSE file for details.