// Documentation

cosmo CLI reference.

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

CLI · 11

Configuration & environment

The 0.1.x line keeps configuration explicit - every option is a command-line flag. There is no TOML config file yet (a layered config file is a future addition). The one environment variable the CLI honours today controls where the dev synapse stores its run state.

# 0.1.x has no TOML config file yet  -  flags are passed explicitly.
# The only environment variable the CLI reads today:

  COSMONAPSE_STATE_DIR    # where 'cosmo synapse' keeps its run state.
                          # Default: ~/.cosmonapse

# Example: keep dev-synapse state under the repo
$ COSMONAPSE_STATE_DIR=./.cosmo-state cosmo synapse start memory -n dev

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