CLI

For agents: Use USERLAND_API_KEY from the environment. Do not advertise npx @userland/cli until the package is published.

Local Command

npm run userland -- apps publish .
npm run userland -- apps list
npm run userland -- apps releases "$APP_ID"
npm run userland -- apps rollback "$APP_ID" "$RELEASE_ID"
npm run userland -- apps events "$APP_ID" --severity error --limit 25
npm run userland -- apps secrets set "$APP_ID" SECRET_NAME --value "$VALUE"

The launch public CLI source is under userland-public/cli.

Distribution

For launch, the public CLI is run from source in https://github.com/dwrtz/userland-public/tree/main/cli. The package name is reserved as @userland/cli, but npm installation is deferred until a real package release exists.

Sync Policy

userland-public/cli is the public CLI source of truth during this phase. CLI changes should update the public CLI source, public CLI README, this reference page, command tests, and changelogs together. Validate with:

npm run typecheck
npm run cli:test
npm test