CLI · 04b

cosmo prism --tail

A Doppler is any process that subscribes to the channel as a passive, read-only consumer. cosmo prism --tail is the built-in one - it tails every envelope, applies filters, and renders to stdout instead of opening the browser. Pass --json to emit one JSON object per line for piping to jq. Give it a --url and a --namespace (the same shape as cosmo synapse); the legacy --synapse=url/namespace form is still accepted. The --type, --trace, --neuron, --json and --payload filters apply to --tail only.

$ cosmo prism --help

Open Prism, the live browser view onto a Synapse namespace.

Usage
  cosmo prism --url <url> --namespace <ns> [--tail] [filters] [output]

Options
  --url <url>             Synapse URL, e.g. cosmo://127.0.0.1:7070
  --namespace, -n <ns>   Namespace to observe.       Default: dev
  --synapse <url/ns>      Legacy combined form (path-encoded namespace).
  --type <TYPE>            Filter to specific signal types. Repeatable.
  --trace <trc_…>          Filter to a single trace_id.
  --neuron <id>            Filter to a single neuron id.
  --tail                   Stream Signals to stdout instead of opening Prism.
  --json                   Output one JSON object per line (--tail only).
  --payload                Show a payload preview alongside each signal (--tail only).
  --port <n>              Local port for the Prism server. Default: 7071

Examples

$ cosmo prism --tail --url=cosmo://127.0.0.1:7070 -n quickstart
  REGISTER      neuron=hello-neuron
  TASK          trace=trc_…  neuron=hello-neuron
  AGENT_OUTPUT  trace=trc_…  neuron=hello-neuron

$ cosmo prism --tail --url=cosmo://127.0.0.1:7070 -n dev --type=AGENT_OUTPUT --type=ERROR
$ cosmo prism --tail --url=cosmo://127.0.0.1:7070 -n dev --trace=trc_01JV…
$ cosmo prism --tail --url=cosmo://127.0.0.1:7070 -n dev --json | jq 'select(.type=="ERROR")'

Have a feature in mind?

The protocol, SDKs, and CLI are still pre-1.0. If something here is missing, ambiguous, or wrong - open an issue and propose a change. Every breaking change is debated in DECISIONS.md first.