SuperAPI AI Directory

install-desktop

Deployment & operations

View repository

Updated 11-03 23:38

About this skill

Install desktop

There is one Opensteer.app (com.opensteer.opensteer) and one Personal store. Stable and Beta are update channels selected in app Settings; fresh installs default to Stable. Both use accounts.opensteer.com for Account sign-in. Stable promotion copies the verified insider ZIP byte for byte, without another build.

Read signing constraints. Use the root Node/pnpm versions, Go, Xcode tools and the Android/JDK prerequisites in apps/agent-phone/README.md. Never read or operate on key material; the operator supplies a prepared signing configuration outside the checkout.

For an authorized local installation, close other Opensteer copies and use a clean checkout and explicit full source SHA:

pnpm desktop:install-local --source-sha FULL_40_CHARACTER_COMMIT_SHA --config /absolute/install-mac-local.json

Use localInstallConfigSchema in scripts/install-mac-local.ts for inputs. Resume with the same SHA/configuration; receipt or artifact drift fails closed. Inspect <stateDirectory>/<SHA> receipts, command log, app tree and journey result. Diagnose Launch Services errors. This defers Apple notarization and proves no public distribution readiness. Never run two copies against one Personal store; installing an older app does not reverse migrations.

For keyless proof on an arm64 Mac:

pnpm install --frozen-lockfile
pnpm desktop:build-release --unsigned --out /absolute/proof-inputs

Inspect apps/desktop/release/contributor/mac-arm64/. The ad-hoc app uses development trust, version 0.0.0 and no updater metadata; it cannot be prepared for distribution. Never set OPENSTEER_DESKTOP_UPDATE_* for this proof. Do not launch GUI/Electron verification on the host; use the disposable VM.