Manage CLI configuration — default instance, output format, API settings.
omni config list # List all config valuesomni config get <key> # Get a valueomni config set <key> <val> # Set a valueomni config unset <key> # Remove a value
Common settings:
omni config set instance <id> # Set default instanceomni config set format json # Default to JSON output
omni events list # List recent eventsomni events list --instance <id> --limit 50 # Filter by instanceomni events search <query> # Search events by content
Manage LLM prompt overrides for media processing. Omni uses prompts for image description, video description, document extraction, and gating decisions.
omni prompts list # List all prompts with override statusomni prompts get <name> # Show current prompt (image|video|document|gate)omni prompts set <name> [value] # Set override (reads stdin for multiline)omni prompts reset <name> # Clear override, revert to default
Bulk close every open turn. This is a destructive admin action and requires the --confirm flag — without it, the command exits with an error and takes no action.
Option
Description
--confirm
Required. Confirm the bulk close.
--reason <text>
Close reason recorded on every closed turn
omni turns close-all --confirm --reason "maintenance window"
Replay missed messages for an agent instance. Useful for recovering messages that arrived while an agent was offline.
omni replay <instanceId> [options]
Option
Description
-s, --since <timestamp>
Replay messages received after this ISO 8601 timestamp (default: lastSeenAt, max 24h ago)
# Replay missed messages since the agent's last seen timeomni replay wa-main# Replay messages received after a specific timestampomni replay wa-main --since 2026-02-27T10:00:00Z
omni settings list [options] # List all server settingsomni settings get <key> # Get a specific settingomni settings set [options] <key> <value> # Set a setting value
Start, stop, and restart the Omni server and NATS:
omni start # Start Omni services (API + NATS)omni stop # Stop servicesomni restart # Restart servicesomni status # API health and connection infoomni update # Update CLI to latest version
These commands are hidden from default omni --help output (visible via omni --help --all). They are useful for troubleshooting, inspecting internals, and automating shell setup.
Inspect and manage failed events that could not be processed.
omni dead-letters list [options] # List dead lettersomni dead-letters get <id> # Get dead letter detailsomni dead-letters stats # Dead letter statisticsomni dead-letters retry <id> # Retry processing a dead letteromni dead-letters resolve [options] <id> # Mark as resolvedomni dead-letters abandon <id> # Abandon retry attempts
Inspect raw event payloads at each processing stage — useful for debugging event pipeline issues.
omni payloads list <eventId> # List payloads for an eventomni payloads get <eventId> <stage> # Get a specific stageomni payloads delete [options] <eventId> # Delete payloads for an eventomni payloads config [options] [eventType] # View/update storage configomni payloads stats # Storage statistics
Set --json once via omni config set format json to avoid retyping it on every command — useful when wiring CLI output into scripts.
omni payloads delete and omni config unset are destructive — payloads can’t be recovered, and unsetting a config key reverts to defaults silently. There’s no undo or audit log.
