Metadata-Version: 2.4
Name: heroprompt-cli
Version: 0.1.0
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.8
Classifier: Programming Language :: Python :: 3.9
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.8
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. 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:

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