The numu CLI

numu is the partner command line. It ships in the same npm package as the theme CLI, @numueg/theme-cli, from version 0.9.1.

Not on npm yet

npm still serves @numueg/theme-cli 0.8.0, which has no numu command. Until 0.9.1 is published, do every step in the partner portal: see Register your app.

Or run it without installing: npx -p @numueg/theme-cli numu app --help.

It asks for your NUMU email and password, and keeps the session in ~/.numurc, shared with numu-theme. When a command fails with HTTP 401, the session has expired: run numu login again.

If your account uses two-factor authentication, the CLI cannot sign in yet. Do the same steps in the partner portal at merchant.numueg.app/partners.

Commands

Run the commands in the folder that holds numu.app.json, or pass --dir <folder>. They find your app by the manifest's slug.

Command	Does
`numu app init <slug>`	Creates a folder with a starter `numu.app.json`, and a Claude skill that guides an AI coding assistant through NUMU's rules
`numu app validate`	Checks `numu.app.json` against NUMU's rules. Stores nothing
`numu app create`	Registers the app. Prints the `client_id` and the `client_secret`. The secret is shown once
`numu app version`	Uploads `numu.app.json` as a draft version. `--notes-ar` and `--notes-en` add release notes
`numu app submit`	Sends the newest draft for review
`numu app status`	Lists the versions with their review status and NUMU's notes, and says whether the app is listed in the App Store
`numu app publish`	Makes the approved version live
`numu app install --store <store_id>`	Adds the app to one of your development stores, without the consent screen and without a token. To test the install flow, see Test on a development store
`numu app webhook trigger <event>`	Posts a signed sample of `<event>` to the URL your manifest lists for it. `--secret` takes your client secret (default: `$NUMU_CLIENT_SECRET`), and `--bad-signature` signs with a wrong key

A first run

Then build your server (OAuth and app tokens, App webhooks), test it on a development store, and submit:

When the CLI and these pages disagree, numu app --help describes the version you have installed.

Sign in#

Commands#

A first run#

Sign in

Commands

A first run