Commands

Command Purpose
premier demo Seed multi-agent investigation trace
premier record -- <cmd> Record process I/O + local collector
premier emit … Post typed event to active collector
premier open [trace] Serve embedded viewer + open browser
premier serve Serve viewer without opening browser
premier list List traces under a directory
premier verify <trace> Verify digests, framing, event count
premier recover <trace> Safely finalize an abandoned active journal
premier query <trace> Filter bounded local evidence as text or JSON
premier export <trace> Write recursively redacted portable JSON
premier diff <baseline> <current> Compare semantic event structure
premier replay <trace> Replay evidence timing without executing the workload

premier demo

premier demo
premier demo --output .premier/traces/multi-agent-demo.atrace

Refuses to overwrite non-trace directories; may replace an existing .atrace.

premier list

premier list
premier list --trace-dir /path/to/traces

premier verify

premier verify ./review.atrace
# verified <trace_id> (N events)

Security on serve

Flag / env Purpose
--password / PREMIER_PASSWORD HTTP Basic password for local-tenant access
--auth-config / PREMIER_AUTH_CONFIG Hashed bearer credentials with tenant and scopes
--tls-cert / PREMIER_TLS_CERT PEM certificate chain
--tls-key / PREMIER_TLS_KEY Matching PEM private key

Plaintext or anonymous non-loopback binds are rejected.

Capture flags

Flag Purpose
--tenant <id> Immutable trace owner; defaults to local
`–adapter auto none
--redact-field <name> Add a recursively redacted structured field
--redact-literal <text> Redact exact text from persisted terminal evidence
--redact-regex <pattern> Redact matching terminal evidence