Premier is a local-first agent reporter. One PATH-installable binary:

  1. Records process stdout/stderr into a portable .atrace artifact
  2. Collects typed multi-actor events (agents, models, tools, approvals) over a loopback collector
  3. Serves an embedded investigation viewer — no monorepo, no Node, no separate web app at runtime

Why it exists

Agent runs fail in ways logs cannot explain: which actor delegated, what model was told, which tool returned the bad value, who approved a write. Premier keeps evidence — causal parents, spans, links, status, duration, and structured payloads — so you can investigate instead of re-running and hoping.

Product surface

Surface Command
Install globally npm install --global @premierstudio/premier
Install in a project npm install --save-dev @premierstudio/premier
Demo investigation premier demo then premier open …
Record a command premier record -- <cmd>
Emit typed events premier emit … or @premierstudio/trace
Verify integrity premier verify <trace>
Serve viewer premier serve / premier open

Honest scope

  • Process-only record always captures terminal I/O.
  • Full multi-actor investigation requires emitters (premier emit, SDK, or HTTP to the collector).
  • npm installs are script-free: no lifecycle script or install-time binary download is required.
  • The viewer is embedded in the binary after install — strangers on PATH do not need this checkout.
quick start
premier demo
premier open .premier/traces/multi-agent-demo.atrace

Browse the guides

StartInstall

Install Premier globally or per project from npm without lifecycle scripts.

StartQuickstart

Demo, record, open, and list — the first ten minutes with Premier.

RecordRecord

Capture process I/O and spin up a private local collector for agent events.

EmitEmit events

Attach typed multi-actor evidence via CLI, SDK, or HTTP.

EmitSDK

First-party TypeScript emitter and shell helper for agent runtimes.

IntegrateProvider adapters

Capture native JSONL from seven agent CLIs without hand-writing every event.

ViewerViewer

Investigate runs with timeline, actors, architecture, analytics, and integrity.

OperateSecurity model

Trust boundaries, redaction, tenant isolation, transport protection, and data-at-rest responsibilities.

OperateSecure deployment

Serve Premier over native TLS with scoped tenant credentials and explicit operational boundaries.

OperateVerify a release

Authenticate Premier's Sigstore identity before trusting checksums or installing an archive.

ReferenceCLI reference

Every premier subcommand for production PATH use.

ReferenceTrace schema

Stable event envelope, causal fields, manifest metadata, event families, and compatibility rules.

ReferenceTroubleshooting

Diagnose missing events, adapter output, auth, TLS, damaged traces, and viewer connectivity.