Premier is a local-first agent reporter. One PATH-installable binary:
- Records process stdout/stderr into a portable
.atraceartifact - Collects typed multi-actor events (agents, models, tools, approvals) over a loopback collector
- 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 | ./scripts/install.sh |
| Demo investigation | premier demo then premier open … |
| Record a command | premier record -- <cmd> |
| Emit typed events | premier emit … or @premier/sdk |
| Verify integrity | premier verify <trace> |
| Serve viewer | premier serve / premier open |
Honest scope
- Process-only
recordalways captures terminal I/O. - Full multi-actor investigation requires emitters (
premier emit, SDK, or HTTP to the collector). - The viewer is embedded in the binary after install — strangers on PATH do not need this checkout.
premier demo
premier open .premier/traces/multi-agent-demo.atrace Browse the guides
Put premier on PATH with an embedded viewer in one script.
Start QuickstartDemo, record, open, and list — the first ten minutes with Premier.
Record RecordCapture process I/O and spin up a private local collector for agent events.
Emit Emit eventsAttach typed multi-actor evidence via CLI, SDK, or HTTP.
Emit SDKFirst-party TypeScript emitter and shell helper for agent runtimes.
Integrate Provider adaptersCapture native JSONL from Claude, Codex, Grok, Gemini, and OpenCode without hand-writing every event.
Viewer ViewerInvestigate runs with timeline, actors, architecture, analytics, and integrity.
Operate Security modelTrust boundaries, redaction, tenant isolation, transport protection, and data-at-rest responsibilities.
Operate Secure deploymentServe Premier over native TLS with scoped tenant credentials and explicit operational boundaries.
Operate Verify a releaseAuthenticate Premier's Sigstore identity before trusting checksums or installing an archive.
Reference CLI referenceEvery premier subcommand for production PATH use.
Reference Trace schemaStable event envelope, causal fields, manifest metadata, event families, and compatibility rules.
Reference TroubleshootingDiagnose missing events, adapter output, auth, TLS, damaged traces, and viewer connectivity.