CLI — @newinstance/bugwatch-cli
Run: npx @newinstance/bugwatch-cli <command> (or install globally) · Node ≥ 18 · dSYM uploads need a macOS runner with zip.
Auth: --token flag or BUGWATCH_AUTH_TOKEN env — a central secret key. --api-url / BUGWATCH_API_URL defaults to https://api.newinstance.cloud.
| Command | Purpose | Scope |
|---|---|---|
symbols upload <path> | Binary debug symbols: .dSYM / .xcarchive / .zip / Android ELF .so | symbols:upload |
artifacts upload <path> | Text artifacts: R8/ProGuard mapping, source map, Dart symbols (--release --platform --type required) | symbols:upload |
deploy start | Create a deployment; persists id to .bugwatch-deploy / BUGWATCH_DEPLOY_ID | deploy:write |
deploy run --stage <key> -- <cmd…> | Run a command as a stage: PATCH running → stream logs → PATCH result | deploy:write |
deploy finish / deploy fail --summary <text> | Close the deployment | deploy:write |
All commands call the endpoints documented in Source Maps & Symbols and Deployments — the CLI is sugar over this collection, streaming files with flat memory and retrying transient failures.