In Claude Code, run:

/plugin

Then:

1. Select "Add marketplace"
2. Enter: willibrandon/pixel-plugin (for GitHub) or ./path/to/local/marketplace (for local)
3. Select "Browse and install plugins"
4. Find and install pixel-plugin

Option B: From command line

# Add the GitHub marketplace
claude plugin marketplace add willibrandon/pixel-plugin

# Install the plugin
claude plugin install pixel-plugin

Option C: Local development/testing

# Clone the repository
git clone https://github.com/willibrandon/pixel-plugin.git
cd pixel-plugin

# Add as local marketplace (from parent directory)
cd ..
claude plugin marketplace add ./pixel-plugin

# Install from local source
claude plugin install pixel-plugin@pixel-plugin

3. Setup

Configure Aseprite path (one-time setup):

/pixel-setup

The command will auto-detect your Aseprite installation. If not found, specify the path manually:

/pixel-setup /Applications/Aseprite.app/Contents/MacOS/aseprite

4. Create Your First Sprite

# Using slash commands
/pixel-new 64x64 gameboy
"Draw a character sprite"
/pixel-export png character.png

# Or natural language only
"Create a 32x32 Game Boy sprite of a character"
"Export it as character.png"

Usage

Slash Commands

| Command | Description | Example | |---------|-------------|---------| | /pixel-new [size] [palette] | Create new sprite | /pixel-new icon nes | | /pixel-palette <action> [args] | Manage palettes | /pixel-palette set gameboy | | /pixel-export <format> [file] | Export sprite | /pixel-export gif anim.gif | | /pixel-setup [path] | Configure plugin | ...