singularity ecosystem records

singularity ecosystem records [KIND] --state-dir STATE [--initiative-id ID] [--limit N] [--before CURSOR] --json

KIND (for example observation, review, execution, execution_response, outcome, event, issue) and --initiative-id are optional filters; an unknown kind lists nothing. Each item carries kind, id, created_at, updated_at, total_bytes, a preview and a state. Every matching record is listed unless --limit is given; page with --before and the same filters. Read a body with [record](/docs/cli/ecosystem/record).

Shared control options

--state-dir PATH names the live owner's state directory; its environment equivalent is SINGULARITY_STATE_DIR. It is required: no directory is assumed. --json prints the whole response envelope; without it a successful answer prints only its result, and a refusal prints the whole envelope.

The owner and the client must run as the same Unix user. An owner that is not listening is a refusal — ecosystem owner unavailable at <socket>: <error>; no cached state is presented as live — and every refusal exits nonzero.