Singularity

Reference

Runtime, memory import, onboarding and durable ecosystem commands.

Migrated from docs/cli.md

Command tree

Command

singularity run

Run autonomous cycles continuously while the being remains solvent.

Command

singularity once

Execute exactly one autonomous cycle and print its persisted report.

Command

singularity doctor

Preflight Brama, optional Most, Las, and every required tool surface without starting a cycle.

Command

singularity tools

Print the dynamic Las and built-in tool catalogue as JSON or a tab-separated table.

Command

singularity import

Atomically import attributed memory, knowledge, and profile records into an existing being.

Command

singularity onboarding

Show or replay first use, optionally importing an existing mind before the walkthrough.

Command

singularity ticket

Write the keys and the signed launch ticket singularity-bootstrap starts a managed being from, or start one end to end.

Command

singularity activity

Read a being's activity journal, every event oldest first, without changing its state.

CLI reference

Each command has its own page with inputs, state effects, output and refusals. Run singularity --help or the selected subcommand's --help for the options supported by the installed binary. Source documentation does not establish that an older installation has those commands.

| Command | Purpose | | --- | --- | | [singularity run](/docs/cli/run) | Live continuously while the being remains solvent. | | [singularity once](/docs/cli/once) | Execute one autonomous cycle and print its report. | | [singularity doctor](/docs/cli/doctor) | Check Brama, optional Most, Las and required surfaces. | | [singularity tools](/docs/cli/tools) | Print the dynamic and built-in tool catalog. | | [singularity import](/docs/cli/import) | Import attributed memory without replacing identity or authority. | | [singularity onboarding](/docs/cli/onboarding) | Run first use with an optional validated mind import. | | [singularity activity](/docs/cli/activity) | Read a being's activity journal without changing its state. | | [singularity ecosystem](/docs/cli/ecosystem) | Own and inspect a durable portfolio under a fixed delegation. | | [singularity ticket](/docs/cli/ticket) | Write keys and the signed launch ticket singularity-bootstrap starts a managed being from. |

The ecosystem group includes run, status, opportunities, initiatives, records, record, explain, pause and resume. Its [availability and qualification boundaries](/docs/ecosystem) are explicit; a source commit is not a delivered or qualified installation.

Exit codes and diagnostics

Runtime failures print singularity: <error> on stderr and use the following classes. CLI argument parsing can refuse a command before runtime code executes.

| Code | Meaning | | --- | --- | | 0 | Success. | | 2 | Configuration or secret-file refusal. | | 3 | Upstream Brama, Las/MCP or Most failure. | | 4 | State or I/O failure. | | 5 | Tool, runtime or JSON failure. |

Ecosystem control also emits its structured refusal envelope on stdout, including operation, code, message and retryability. This does not replace the nonzero exit status. Logging uses RUST_LOG; an absent filter defaults to info, and an invalid supplied filter is refused.

Companion binaries

| Binary | Role | | --- | --- | | [singularity-bootstrap](/docs/bootstrap) | Verify a signed launch and acquire separate signing, Brama authorization and Most credentials. | | [singularity-finance-mcp](/docs/finance) | Serve the policy-bound finance interface and ingest owner events. | | [singularity-finance-executor-http](/docs/finance) | Forward canonical intents to the isolated HTTPS custody endpoint. | | [singularity-repo-mcp](/docs/repo-surface) | Serve the policy-bound repository interface. |

Settings