CLI · 01

Overview

cosmo has a single implementation that ships inside the Python distribution (entry point cosmo.main:cli). pip install cosmonapse puts the binary on your PATH. Requires Python 3.11+. It exposes init, synapse, dispatch, registry, answer, schema, prism, genesis, 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.
  genesis      Open Genesis - name a brain, scaffold it, grow it on a canvas.
  init         Scaffold a standard-skeleton Cosmonapse project.
  prism        Open Prism, the live browser view onto a Synapse namespace.
  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