superwitness

Every run, on the record.

What your agents did, how your products behaved while they did it, and whether the work was any good, joined on one run.

run_7f3a superpipeline · draft
GET /v1/runs/superpipeline/brd_01/run_7f3a
agent
hermes 0.9 · sha256:4dd8…
attempts
2 · completed
trace
joined · 41 spans
errors
0
cost
unreported
verdicts
gate: approved · human grader 0.8

sources: superpipeline ok · agentpod ok · traces ok · logs ok · errors ok · verdicts ok

01

Three questions, one run

What did it do?

Attempts, turns, tool calls, spans.

attempts · trace

How did the products run?

Logs and errors that share the run's trace.

log_count · errors

Was it any good?

Gate decisions and recorded verdicts.

verdicts
02

Telemetry and evidence are different things

Telemetry is sampled, lossy and short-lived. Verdicts are append-only and never lost. superwitness keeps them in separate stores and never treats one as the other.

TelemetryVerdicts
lossExpected: sampled, short retentionNever
whereUpstream enginessuperwitness's own database
03

Joined on the run, across products

The configuration that ran it

harnessmodelprofileskills fingerprint sha256:4dd8…
superpipeline
hub · dispatch
attempt
turn · tool
node-agent
gate · review
run.id = run_7f3a
04

Built for agents first

An MCP server: thin tools over the run, spans, logs and verdict operations.

get_run · list_run_spans · list_run_logs · record_verdict
05

Standing on engines you'd pick anyway

VictoriaLogs, VictoriaTraces and the OpenTelemetry Collector: upstream, unforked, permissively licensed. superwitness adds the run, the join and the verdicts. Designed to sit beside VictoriaMetrics and Perses the same way.

06

You host all of it

  • A single Go binary plus Postgres.
  • Release tarballs with SHA256SUMS.
  • A systemd unit.
  • Tailnet-first.

No product requires it: they send plain OTLP and never wait on it.

$ curl -LO https://github.com/SuperJackfruitLabs/superwitness/releases/download/v0.1.1/superwitness_0.1.1_linux_amd64.tar.gz
$ curl -LO https://github.com/SuperJackfruitLabs/superwitness/releases/download/v0.1.1/SHA256SUMS
$ sha256sum --ignore-missing -c SHA256SUMS
$ tar xzf superwitness_0.1.1_linux_amd64.tar.gz
Full install guide →