pphat.me logoRegistry
Docs/commands

CLI Commands

A complete reference for every command exposed by the @pphatdev/registry CLI (v1.5.1).

You can run the CLI via global installation (pphat) or directly via npx. The following invocations are equivalent:

❯npx pphat <command>
❯npx pphatdev <command>
❯npx @pphatdev/registry <command>

Version & Help

Both short and long version flags are fully supported in v1.5.1+:

❯npx pphat -v
❯npx pphat --version
❯npx pphat --help

init

Interactively initializes project preferences and generates a pphatdev.json file in the project root.

❯npx pphat init

Prompts will guide you through selecting resource types (icons, components), formats (SVG, Next.js, Nuxt.js), and storage paths.

config

View and update configuration settings interactively or programmatically.

Interactive Configuration

❯npx pphat config

Get Configuration

❯npx pphat config get
❯npx pphat config get icons.nextjs.dir

Set Configuration

❯npx pphat config set icons.nextjs.use true

list / ls

Lists available icons, components, or currently installed skills.

❯npx pphat list icons
❯npx pphat ls components
❯npx pphat list skills

add

Parent command that downloads icons, components, or AI agent skills using a subcommand grammar.

add icon <names…>

❯npx pphat add icon react vue github

add component <names…>

❯npx pphat add component button card modal

add skill <sources…>

❯npx pphat add skill pphatdev/skills
❯npx pphat add skill pphatdev/skills --skill api-documentation
❯npx pphat add skill pphatdev/skills -a claude cursor

Legacy shortcut

For backwards compatibility, add <name> with no subcommand is treated as add icon <name>:

❯npx pphat add react vue

Options for Icons & Components

| Flag | Long flag | Description | | --- | --- | --- | | -f | --format <fmt> | Output format (svg, nextjs, nuxtjs) | | -d | --dir <path> | Destination directory |

add-icon

Hyphenated alias for add icon. Downloads one or multiple icons from the registry into your project.

❯npx pphat add-icon react vue github

Options

| Flag | Long flag | Description | | --- | --- | --- | | -f | --format <fmt> | Output format (svg, nextjs, nuxtjs) | | -d | --dir <path> | Destination directory |

Examples

❯npx pphat add-icon react vue -d src/assets/icons
❯npx pphat add-icon github -f nextjs

add-component / add-comp

Hyphenated alias for add component. Downloads one or multiple UI components.

❯npx pphat add-component button card modal

Options

| Flag | Long flag | Description | | --- | --- | --- | | -f | --format <fmt> | Output format (nextjs, nuxtjs) | | -d | --dir <path> | Destination directory |

Examples

❯npx pphat add-component button -f nextjs -d src/components/ui
❯npx pphat add-comp card modal

add-skill

Hyphenated alias for add skill. Installs AI agent skills from GitHub repositories or local directory paths with automated agent detection and lockfile generation.

❯npx pphat add-skill pphatdev/skills

Options

| Flag | Long flag | Description | | --- | --- | --- | | -d | --dir <dir> | Custom target directory for skills (default: .agent/skills) | | -g | --global | Install skills globally to ~/.agent/skills | | -s | --skill <names…> | Install specific skill(s) by name (* for all) | | -a | --agent <agents…> | Target specific coding agents (claude, cursor, agent, etc.) | | -y | --yes | Skip interactive prompts and install with defaults | | | --all | Install all available skills without prompting | | -l | --list | List available skills in the repository without installing |

Examples

❯npx pphat add-skill pphatdev/skills --skill api-documentation
❯npx pphat add-skill pphatdev/skills -a claude cursor
❯npx pphat add-skill pphatdev/skills --all -y

update

Parent command to update installed resources (skills).

update skill [targets…

❯npx pphat update skill
❯npx pphat update skill pphatdev/skills

update-skill

Hyphenated alias for update skill. Updates installed skills to their latest revisions and refreshes hashes in skills-lock.json.

❯npx pphat update-skill pphatdev/skills

Options

| Flag | Long flag | Description | | --- | --- | --- | | -d | --dir <dir> | Custom target directory for skills | | -g | --global | Update globally installed skills in ~/.agent/skills |

remove

Parent command that deletes previously downloaded icons, components, or installed skills.

remove icon <names…>

❯npx pphat remove icon react vue

remove component <names…>

❯npx pphat remove component button card

remove skill <targets…>

❯npx pphat remove skill pphatdev/skills
❯npx pphat remove skill api-documentation

Options for Icons & Components

| Flag | Long flag | Description | | --- | --- | --- | | -f | --format <fmt> | Restrict removal to one format (svg, nextjs, nuxtjs) | | -d | --dir <path> | Restrict removal to a specific directory |

remove-icon

Hyphenated alias for remove icon.

❯npx pphat remove-icon react vue
❯npx pphat remove-icon react -f svg -d public/icons

remove-component / remove-comp

Hyphenated alias for remove component.

❯npx pphat remove-component button card
❯npx pphat remove-comp modal -f nextjs -d src/components/ui

remove-skill

Hyphenated alias for remove skill. Deletes installed skill folders and removes references from .skills.json and skills-lock.json.

❯npx pphat remove-skill pphatdev/skills
❯npx pphat remove-skill api-documentation -g

Options

| Flag | Long flag | Description | | --- | --- | --- | | -d | --dir <dir> | Custom target directory for skills | | -g | --global | Remove from global skills directory (~/.agent/skills) |

stats

Show CLI usage statistics from ~/.pphat/history.jsonl or the remote registry.

❯npx pphat stats
❯npx pphat stats --top-icons
❯npx pphat stats --top-components
❯npx pphat stats --remote

Options

| Flag | Long flag | Description | | --- | --- | --- | | -n | --days <days> | Only include runs from the last N days | | | --top-icons [n] | Show top N most-added icons (default: 10) | | | --top-components [n] | Show top N most-added components (default: 10) | | | --remote | Query aggregated stats endpoint instead of local history | | | --clear | Wipe your own local history file (~/.pphat/history.jsonl) | | -y | --yes | Skip confirmation prompts for destructive actions |

PreviousConfiguration
NextUsing Icons