cosmo CLI reference.
Every command and flag for the cosmo developer CLI, verified against packages/cli.
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.