CLI Commands

The HeroPrompt CLI lets you sync prompts and Skills to your local machine. Available on PyPI.

Installation

bash

pip install heroprompt-cli

Or with pipx for isolated installs:

bash

pipx install heroprompt-cli

Authentication

All authentication uses Personal Access Tokens (PATs). Generate one at Settings.

`heroprompt login`

bash

heroprompt login --token hp_pat_xxxxx

Flag	Description
`--token, -t`	Personal Access Token (required)
`--api-url`	Custom API URL (for self-hosted)

`heroprompt logout`

bash

heroprompt logout

`heroprompt status`

Show account info, tier, and access level.

bash

heroprompt status

Listing Content

`heroprompt list prompts`

List available prompts from the server.

bash

# List all prompts
heroprompt list prompts

# Filter by category
heroprompt list prompts --category technology

# Search by name
heroprompt list prompts --search "react"

# Limit results
heroprompt list prompts --limit 10

Flag	Description
`--role, -r`	Filter by subcategory
`--category, -c`	Filter by category
`--search, -s`	Search in name/description
`--limit, -l`	Max results (default: 50)

`heroprompt list skills`

List available Skills (PRO Kit required).

bash

heroprompt list skills
heroprompt list skills --category development
heroprompt list skills --difficulty expert

Flag	Description
`--category, -c`	Filter by category
`--difficulty, -d`	Filter by difficulty
`--limit, -l`	Max results (default: 50)

Syncing Content

`heroprompt sync sync-cmd`

Download all prompts to ~/.heroprompt/prompts/.

bash

heroprompt sync sync-cmd
heroprompt sync sync-cmd --role frontend
heroprompt sync sync-cmd --force

Flag	Description
`--role, -r`	Filter by subcategory
`--force, -f`	Overwrite existing files

`heroprompt sync sync-skill`

Download a specific Skill to ~/.heroprompt/skills/ (PRO Kit required).

bash

heroprompt sync sync-skill mcp-server
heroprompt sync sync-skill mcp-server --force

Supports partial ID matching — if your query matches multiple Skills, the CLI will list them for disambiguation.

Other Commands

`heroprompt version`

bash

heroprompt version
# heroprompt-cli version 0.1.0

Tier Access

Command	Free	Starter	Pro Kit	Lifetime
`list prompts`	✓	✓	✓	✓
`sync sync-cmd`	✓	✓	✓	✓
`list skills`	✗	✗	✓	✓
`sync sync-skill`	✗	✗	✓	✓
Max PATs	0	1	3	5