Configuration Reference

Plugin config (~/.prism/config.json)

This file is the only place Prism reads its runtime configuration from.

Field	Type	Default	Editable	Description
show_realtime_summary	boolean	false	yes	Print the server-side realtime summary after a completed turn. Applies on the next hook run.
ingest_url	URL	—	yes	Where Prism sends ingest, realtime, report, config, and OTEL traffic. HTTPS, or an HTTP loopback address. Requires a restart.
apiKey	string	—	no	Your Prism API key. Managed by /prism:setup KEY.
dashboard_url	URL	—	no	Resolved from your API key by the server.
debug	boolean	false	by hand	Also mirror the debug log to your terminal (stderr). Not exposed by /prism:config; edit the file directly.

show_realtime_summary is also accepted under its former name showRealtimeSummary; the value migrates to the current name on the next write.

File permissions: 600 (owner read-write only) · Directory permissions: 700 (owner only)

The file is shared by every plugin version installed on the machine, so fields are only ever added — never renamed or repurposed.

OTEL settings (~/.claude/settings.json)

The plugin writes these on session start, into the settings file for the scope it was installed in:

{
  "env": {
    "OTEL_EXPORTER_OTLP_LOGS_ENDPOINT": "https://ingest.optra-prism.com/v1/logs",
    "OTEL_EXPORTER_OTLP_METRICS_ENDPOINT": "https://ingest.optra-prism.com/v1/metrics"
  }
}

The plugin writes only the logs and metrics endpoints — it does not set OTEL_EXPORTER_OTLP_TRACES_ENDPOINT, since Claude Code does not emit OTLP traces through this pipeline. URLs are resolved from your API key. See Environment Variables for the full list of keys.