CLI · 04

cosmo prism

cosmo prism launches Prism, the browser visualization, and that is its default behaviour - no flag required. It boots a local server (default port 7071) that serves a single-page app and a WebSocket bridge; each connection opens its own Synapse subscriber, so you can switch URL and namespace from the form without restarting. Pre-fill the target with --url and --namespace to skip the form, or set --port to serve elsewhere.

# Launch Prism  -  the browser visualization. This is the default.
$ cosmo prism                                          # opens Prism, enter the synapse URL in the form
$ cosmo prism --port=8080                              # serve on a custom port
$ cosmo prism --url=cosmo://127.0.0.1:7070 -n dev      # skip the form, attach directly

  Prism serving on http://127.0.0.1:7071
  WS bridge   /ws  →  streams one JSON Signal envelope per message

# Prism is a single-page app (Vite + React + TS) bundled into the cosmonapse wheel.
# The Python side serves static assets + a WebSocket bridge; no Node on the install path.

cosmo doppler is a deprecated alias that still works: it prints a warning, and because bare cosmo doppler used to stream to stdout, the alias flips the default back to --tail for scripts that never migrated. The --prism flag is accepted and ignored. Both will be removed in a future release.

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.