@maintainer-pro/setup

One-command onboarding for a host app. The sandbox page in Maintainer Pro admin generates a pinned npx command; this CLI asks where the UI and backend live, writes API keys, then uses the same coding agent as ai-cli (agent / claude / agy) to wire the real project.

A coding agent CLI must be installed and authenticated. Without one, setup stops — chat in the host app would not work anyway.

Happy path for an empty folder: a static HTML page plus a Node server.mjs that serves /api/chat and /embed-config.js (keys stay on the server, not in HTML). Existing apps are patched in place — the agent uses a setup brief and recipes instead of inventing a new framework app.

npx --yes @maintainer-pro/[email protected] --url http://localhost:4100 --token mp_setup_...

Local run (no publish — use this while iterating on setup itself):

node path/to/maintainer-pro/packages/setup/src/setup.mjs --url http://localhost:4100 --token mp_setup_...

It will:

1. Fetch sandbox API keys from Maintainer Pro
2. Ask for the UI project path and the backend project path
3. Suggest installing @maintainer-pro/ai-cli in their parent so the coding agent can edit both
4. Ask for the public app URL (port included, default http://localhost:3000)
5. Write .env, then run the coding agent with a brief + recipes
6. Run doctor (Node 22+, admin health, agent / claude / agy on PATH) and print the agent workspace

Flags

| Flag | Purpose | |------|---------| | --url | Maintainer Pro admin URL | | --token | mp_setup_… token from the sandbox page | | --ui | UI project directory | | --backend | Backend project directory | | --workspace | Directory where ai-cli is installed (agent edit root) | | --app-url | Public origin the browser will open (http://localhost:3000) | | --create | Allow scaffolding HTML + server.mjs without prompting | | --packages-from <sdk-repo> | Install ai-cli / ai-ui from a local checkout (file:…) | | --skip-install | Do not run npm install | | --dry-run | Log writes without touching the disk |

What it writes

• .env on the backend (MAINTAINER_PRO_*, AI_CLI_WORKSPACE, PORT, CORS_ORIGIN)
• Chat widget and /api/chat (via the coding agent)

Start the happy-path backend with npm run dev in the backend folder, then open the app URL you gave setup.