Public-safe

platphormctl Trace Client

CLI examples for trace headers, trace runs, site inspection, MCP validation, policy inspection, dry-run discovery, async jobs, and span completion.

Authok
PLATPHORM_API_KEY
Source: platform contract
Updated: 5/25/2026, 6:19:40 AM
Evidence/query
Public readsok
open
Source: public policy
Updated: 5/25/2026, 6:19:40 AM
Evidence/query
Commands
platphormctl trace start
platphormctl trace headers
platphormctl trace list
platphormctl trace get <traceId>
platphormctl trace spans <traceId>
platphormctl trace incomplete
platphormctl trace failed
platphormctl trace report <traceId>
platphormctl trace propagate --service agentui
platphormctl trace run -- <command>
platphormctl trace inspect <traceId>
platphormctl site inspect trace
platphormctl site inspect trace --best-effort
platphormctl mcp validate trace
platphormctl mcp validate trace --best-effort
platphormctl policy inspect trace
platphormctl policy inspect trace --best-effort
platphormctl trace list --dry-run
platphormctl trace incomplete --dry-run
platphormctl harness run trace-propagation-check --dry-run
platphormctl harness run spec-evals-browserops-loop --target https://trace.platphormnews.com --dry-run
platphormctl harness run developer-validation --target https://trace.platphormnews.com --dry-run

curl -X POST https://trace.platphormnews.com/api/v1/spans/start \
  -H "Authorization: Bearer $PLATPHORM_API_KEY" \
  -H "traceparent: 00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01" \
  -H "Content-Type: application/json" \
  -d '{"traceId":"4bf92f3577b34da6a3ce929d0e0e4736","spanId":"00f067aa0ba902b7","name":"platphormctl validation","kind":"tool"}'