heroprompt-cli 0.1.0

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. List available prompts
heroprompt list prompts

# 4. Sync prompts to local
heroprompt sync-cmd

# 5. List Skills (PRO Kit required)
heroprompt list skills

# 6. Sync a Skill to local (PRO Kit required)
heroprompt sync-skill mcp-server

Commands

Command	Description	Tier
login --token <token>	Authenticate with PAT	All
logout	Clear credentials	All
status	Show account info	All
list prompts	List all prompts	All
list skills	List Skills	PRO+
sync-cmd	Download prompts to local	All
sync-skill <id>	Download Skill to local	PRO+
get <prompt-id>	Print prompt to stdout	All
run <skill-id>	Interactive Skill runner	PRO+

Configuration

The CLI stores configuration in ~/.heroprompt/:

~/.heroprompt/
├── config.json       # Auth token and user info
├── prompts/          # Synced prompts
└── skills/           # Synced Skills

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:

heroprompt upgrade
# Opens 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.