Production install

Install the script-free npm launcher globally. npm selects the matching native package for the current operating system and architecture:

npm install --global @premierstudio/premier
premier --version

@premierstudio/premier has no preinstall, install, or postinstall scripts and performs no install-time download. The native binary is carried by an npm optional dependency such as @premierstudio/premier-darwin-arm64. This works with npm 12’s secure install-time defaults without allowScripts configuration. Releases are published from GitHub Actions through npm OIDC trusted publishing with provenance; no long-lived publish token is used.

Project-local install

Pin Premier to a repository and use it from package scripts or npx:

npm install --save-dev @premierstudio/premier
npx premier demo
npx premier record -- npm test

Applications that emit typed runtime evidence should also install the SDK:

npm install @premierstudio/trace

Verify

premier --version
premier demo
premier open .premier/traces/multi-agent-demo.atrace

You should get a multi-agent demo trace and a browser on the embedded viewer — with no apps/viewer/dist required at runtime.

Signed GitHub release alternative

Users who do not want Node/npm can download the matching release archive and Sigstore bundle, then install it from explicit local paths:

./scripts/install.sh \
  --archive ./premier-0.1.0-aarch64-apple-darwin.tar.gz \
  --signature-bundle ./premier-0.1.0-aarch64-apple-darwin.tar.gz.sigstore.json

The archive installer never accepts a URL. It verifies the pinned GitHub workflow identity, release metadata, architecture, paths, and checksums before an atomic install. Verify the release for the full asset-set workflow.

Local update and removal

npm update --global @premierstudio/premier
npm uninstall --global @premierstudio/premier

# project-local
npm update @premierstudio/premier
npm uninstall @premierstudio/premier

Archive installs are managed with the explicit version-check.sh, update.sh, and uninstall.sh lifecycle scripts from the repository’s scripts/ directory (the release archive itself ships only the binary, license, README, metadata, and checksums). Run them from a Premier checkout against your downloaded archive paths.

PATH note

If a global install succeeds but premier is not found, inspect npm’s global binary prefix and add it to PATH:

npm prefix --global

Build from source

From a Premier checkout, ./scripts/install.sh builds the viewer and native binary, then installs to $CARGO_HOME/bin. It requires Rust, Node.js 22+, and npm.

Local UI development

By default, open / serve use the embedded viewer. To iterate on the Svelte app from disk:

npm run build --workspace @premier/viewer
premier serve --viewer-dir apps/viewer/dist