CLI

The `menupi` command — scripted workspace operations and CI deploys.

Updated May 18, 2026·4 min read

Install

Shell

npm install -g @menupi/cli
menupi auth login

Common commands

Field	Type	Description
menupi auth login	cmd	Save an API key locally.
menupi screens list	cmd	List screens with status + last-seen.
menupi screens restart <id>	cmd	Restart the device paired to a screen.
menupi content push <file.json>	cmd	Bulk update items from a JSON file.
menupi playlist publish <id> --screen <id>...	cmd	Publish a playlist to screens.
menupi pos sync <connectionId>	cmd	Trigger a manual POS sync.

Use in CI

Auth via env var instead of `menupi auth login`. Drops cleanly into GitHub Actions or any CI runner.

.github/workflows/menu-deploy.yml·YAML

- name: Publish menu update
  env:
    MENUPI_API_KEY: ${{ secrets.MENUPI_API_KEY }}
  run: |
    npm install -g @menupi/cli
    menupi content push ./menus/prod.json
    menupi playlist publish pl_8XR4...

Output formats

All list commands support `--json` for machine-readable output. Default is a TTY-friendly table.