// Documentation

cosmo CLI reference.

Every command and flag for the cosmo developer CLI, verified against packages/cli.

CLI · 01

Overview

cosmo is installed when you pip install cosmonapse - the CLI ships inside that single distribution (entry point cosmo.main:cli). Once installed, the binary is on your PATH. It exposes init, synapse, dispatch, registry, answer, schema, doppler, validate, and completion.

$ cosmo --help

Usage: cosmo [OPTIONS] COMMAND [ARGS]...

  Cosmonapse developer tooling.

Options
  --version   Show the version and exit.
  --help      Show this message and exit.

Commands
  answer       Interactively answer CLARIFICATION / PERMISSION requests.
  completion   Print a shell-completion script (bash / zsh / fish).
  dispatch     Dispatch a TASK and print the reply.
  doppler      Attach a read-only Doppler to a Synapse namespace.
  init         Scaffold a minimal Axon + Dendrite project.
  registry     Inspect the Neuron registry of a namespace.
  schema       Print the Signal envelope JSON Schema.
  synapse      Manage Cosmonapse synapse servers (start / view / stop).
  validate     Validate Signal envelopes against the spec.

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.

Run the quickstart →Re-read the envelope spec