Installation & Quick Start

A quick start guide to using the @pphatdev/registry CLI.

Usage via npx (Recommended)

You don't need to install anything. Run the CLI directly using npx:

The CLI supports multiple convenient aliases (prefixes), so you can use any of the following interchangeably:

Global Installation (Optional)

If you plan to use the CLI frequently across many projects, install it globally on your machine:

Then use the short commands anywhere:

Step-by-Step Workflow

1. Initialize your project

Run the init command to set up your preferences. It interactively prompts you for configuration and writes a pphatdev.json file at the root of your project:

Example interactive setup:

? What is name of config ? › Default configuration
? What do you want to use ? (required must select one) › Icons

? Which directory you want to use ? (required must select one) › Nextjs format (.tsx)
? Where do you store icon of nextjs ? › components/icons

Success! Configuration saved to pphatdev.json.

2. View & Manage Configuration

View or update your stored configuration anytime using the config command:

Or fetch / set specific keys:

3. Discover Items in the Registry

Browse available icons, components, or installed skills:

4. Add Icons or Components

Download icons or components directly into your project using subcommand or hyphenated grammar:

Subcommand grammar

Hyphenated grammar

npx pphat add react (no subcommand) is preserved as a legacy shortcut for add icon react.

Custom target directory or format

Override your default configuration on the fly using -d (--dir) or -f (--format):

5. Install AI Agent Skills

New in v1.5.1 — install modular AI coding assistant skills (SKILL.md) from GitHub repositories with automated agent detection and lockfile generation:

6. Remove Resources

Cleanly remove previously downloaded icons, components, or skills:

Hyphenated aliases also work (remove-icon, remove-component, remove-skill):