Skip to content
bermoodabermooda

CLI

The official CLI is @bermooda/cli. The binary is bermooda. It lives in a standalone repository.

On install, the CLI downloads the shop app from bermooda/bermooda (unless you pass --source).

Install

Section titled “Install”
Terminal window
npm i -g @bermooda/cli@latest

Requires Node.js ≥ 24. After install, bermooda is available globally.

What the CLI is for

Section titled “What the CLI is for”

The CLI is lifecycle, not a catalog REPL:

Surface Role
CLI Install, update, plugins, themes, local bootstrap
Admin REST API Source of truth for read/write shop operations
MCP Agent UX over that same Admin API

Day-to-day catalog, settings, and order work belongs on the Admin REST API (or MCP tools that wrap it). Do not put ecommerce domain logic in the CLI.

Quick path

Section titled “Quick path”
Terminal window
bermooda install --local --dir ./my-shop -y \
  --admin-email [email protected] \
  --admin-password 'TestPass123!' \
  --store-name 'Demo Shop'


cd my-shop
bermooda dev

Global flags on most commands: --cwd, -y / --yes, --json, --verbose.

Next steps

Section titled “Next steps”
  • Commands — install flags, plugins, themes, start, and version
  • Agents (MCP) — connect Cursor or Claude to a running shop