Metadata-Version: 2.4
Name: heroprompt-cli
Version: 0.1.2
Summary: HeroPrompt CLI - Sync prompts and Skills to your local machine
Author-email: HeroPrompt <hello@heroprompt.store>
License-Expression: MIT
Project-URL: Homepage, https://heroprompt.store
Project-URL: Documentation, https://github.com/heroprompt/cli
Project-URL: Repository, https://github.com/heroprompt/cli
Project-URL: Issues, https://github.com/heroprompt/cli/issues
Keywords: cli,prompts,ai,llm,claude,anthropic
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: typer>=0.9.0
Requires-Dist: rich>=13.0.0
Requires-Dist: httpx>=0.25.0
Requires-Dist: pydantic>=2.0.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Requires-Dist: black>=23.0.0; extra == "dev"
Requires-Dist: ruff>=0.1.0; extra == "dev"
Requires-Dist: mypy>=1.0.0; extra == "dev"
Dynamic: license-file

# HeroPrompt CLI

> Sync prompts and Skills to your local machine

## Installation

```bash
pip install heroprompt-cli
```

Or with [pipx](https://pypa.github.io/pipx/) (recommended for isolation):

```bash
pipx install heroprompt-cli
```

## Quick Start

```bash
# 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

```bash
# 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.
