Read the catalog from the CLI

What to expect

The CLI is provided in the GiftGrid source repository as scripts/giftgrid-cli.mjs. It uses Node.js built-in APIs. Run it from the project folder; on Windows PowerShell, npm.cmd can be used if execution policy blocks npm.ps1. Never put API secrets directly in command arguments.

Use the shop command to inspect visible catalog data. This guide covers 3 practical actions, in the order they usually happen.

Do this first

Run npm run giftgrid -- shop list..

Add --category and --page when needed..

Then finish with

Treat an empty catalog as a valid response rather than creating placeholder products..

Good to know

Everything here reflects the current GiftGrid interface. Labels and buttons may move as the product evolves, but the flow stays the same: prepare, act on the page this guide references, and confirm the result before moving on.

When something does not match what you see, the destination page for this guide is the source of truth.