Skip to content
ProductBlogOpen console
CLI

Command reference

These work on every command.

Flag Description
-o, --output Output format: table (default), json, yaml, quiet
-p, --profile Configuration profile to use
--debug Enable debug output
--no-color Disable colored output

Most commands are scoped to a workspace and an app. Both resolve in the order flag, then environment (OMAZY_WORKSPACE / OMAZY_APP), then whatever omazy workspace use pinned.

Admin operations (privileged)

omazy admin [command] [flags]

Admin analytics

omazy admin analytics [command] [flags]

Data-sharing patterns analytics

omazy admin analytics data-sharing [command] [flags]

Audit log

omazy admin audit [command] [flags]

List audit entries

omazy admin audit list [command] [flags]
Flag Description
--action string Filter by action
--actor string Filter by actor ID
--cursor string Pagination cursor
--limit int Page size

Background jobs (Asynq)

omazy admin jobs [command] [flags]

Delete a job

omazy admin jobs delete [command] [flags]

Show one job’s payload

omazy admin jobs get [command] [flags]

List jobs

omazy admin jobs list [command] [flags]
Flag Description
--cursor string Pagination cursor
--limit int Page size
--queue string Queue (critical|default|low)
--status string Status filter

Per-queue stats

omazy admin jobs queues [command] [flags]

Retry a failed job

omazy admin jobs retry [command] [flags]

Admin metrics

omazy admin metrics [command] [flags]

Bot response time percentiles

omazy admin metrics bot-response [command] [flags]

Top-level dashboard metrics

omazy admin metrics dashboard [command] [flags]

Message volume metrics

omazy admin metrics messages-volume [command] [flags]

Token cost metrics

omazy admin metrics token-cost [command] [flags]

Sessions admin

omazy admin sessions [command] [flags]

Force-close a session

omazy admin sessions force-close [command] [flags]
Flag Description
--reason string Required reason

Show one session with metadata

omazy admin sessions get [command] [flags]

List sessions across users

omazy admin sessions list [command] [flags]
Flag Description
--cursor string Pagination cursor
--limit int Page size
--status string Filter by status

Cross-user data-share inventory

omazy admin shares [command] [flags]

Show one grant with audit trail

omazy admin shares get [command] [flags]

List grants across users

omazy admin shares list [command] [flags]
Flag Description
--cursor string Pagination cursor
--limit int Page size

Force-revoke a grant

omazy admin shares revoke [command] [flags]
Flag Description
--notify-user Notify the grantee

User administration

omazy admin users [command] [flags]

Soft-delete a user

omazy admin users delete [command] [flags]

Show one user

omazy admin users get [command] [flags]

List users

omazy admin users list [command] [flags]
Flag Description
--cursor string Pagination cursor
--limit int Page size
--role string Filter by role
--status string Filter by status

Update role / status

omazy admin users patch [command] [flags]
Flag Description
--role string New role
--status string New status

Agent configuration: model, knowledge, and Brief

omazy agent [command] [flags]
Flag Description
-a, --app omazy config set app App handle (default: OMAZY_APP, or omazy config set app)
-w, --workspace omazy config set workspace Workspace handle (default: OMAZY_WORKSPACE, or omazy config set workspace)

The agent’s Brief: structured instructions that compile into its prompt

omazy agent brief [command] [flags]

Append an instruction item to the Brief

omazy agent brief add [command] [flags]
Flag Description
--body string Instruction text
--file string Read instruction from a file (‘-’ for stdin)
--section string Brief section (default “general”)
--title string Short label for the instruction

Remove an instruction item

omazy agent brief delete [command] [flags]

Compile the Brief into the agent’s live system prompt

omazy agent brief publish [command] [flags]

Show the Brief

omazy agent brief show [command] [flags]

Agent knowledge documents

omazy agent knowledge [command] [flags]

Add a knowledge document from –body, –file, or stdin

omazy agent knowledge add [command] [flags]
Flag Description
--body string Document content
--file string Read content from a file (‘-’ for stdin)
--kind string Document kind (default “text”)
--source-url string Origin URL, shown as the citation
--title string Document title (required)

Delete a knowledge document

omazy agent knowledge delete [command] [flags]

Show one knowledge document

omazy agent knowledge get [command] [flags]

List knowledge documents

omazy agent knowledge list [command] [flags]
Flag Description
--limit int Maximum documents to return
--search string Filter by free text

Re-embed a document for retrieval

omazy agent knowledge reindex [command] [flags]

List the agent’s published prompt versions

omazy agent prompts [command] [flags]

Update agent settings

omazy agent set [command] [flags]
Flag Description
--active string Enable or disable the agent (true|false)
--model string Model id (e.g. openai/gpt-4o)
--name string Agent display name
--temperature string Sampling temperature

Show the app’s agent configuration

omazy agent show [command] [flags]

Show the agent’s open-question suggestion pills

omazy agent suggestions [command] [flags]

Send a message to the agent in a throwaway preview session

omazy agent test [command] [flags]
Flag Description
-m, --message string Message to send (required)

Sign in and manage authorized CLI installs

omazy auth [command] [flags]

List and revoke the CLI installs registered to your account

omazy auth installs [command] [flags]

List installs

omazy auth installs list [command] [flags]

Revoke one install and its whole token family

omazy auth installs revoke [command] [flags]

Sign in and bind this machine as an authorized CLI install

omazy auth login [command] [flags]
Flag Description
--browser Browser consent screen with a loopback listener
--browser-only Print the consent URL instead of opening a browser
--callback-port int Loopback callback port for –browser (0 = auto)
--device Device-code flow: authorize from another machine
--email string Email address to sign in with
--magic Send a magic link instead of a code
--password Prompt for a password instead of emailing a code
--provider string Social provider (google|apple)
--scope strings OAuth scopes (comma-separated; default from profile)

Revoke this install (or –all installs) and clear local credentials

omazy auth logout [command] [flags]
Flag Description
--all Revoke every install for this user

Force a token refresh now

omazy auth refresh [command] [flags]

Create a new Omazy account

omazy auth register [command] [flags]
Flag Description
--email string Email
--first-name string First name
--last-name string Last name
--password string Password

List the scopes the CLI can request

omazy auth scopes [command] [flags]

Show the current install, scopes, and expiry

omazy auth status [command] [flags]

Re-issue tokens bound to a different authorized business

omazy auth switch-business [command] [flags]

Complete email verification

omazy auth verify-email [command] [flags]
Flag Description
--token string Email verification token

Show the authenticated user as the middleware sees them

omazy auth whoami [command] [flags]

Bots: middleware catalog

omazy bot [command] [flags]

Browse the public bot catalog

omazy bot catalog [command] [flags]

Show one catalog bot

omazy bot catalog get [command] [flags]

List catalog bots

omazy bot catalog list [command] [flags]
Flag Description
--app string App ID
--category string Category filter
--cursor string Pagination cursor
--featured-only Featured only
--per-page int Page size
--search string Free-text search

Channels: availability, health, and takeoff

omazy channel [command] [flags]

Channels usable in the current context

omazy channel availability [command] [flags]
Flag Description
--app string App ID
--conversation string Conversation ID
--current string Current channel
--takeoff-only Only takeoff-eligible channels

Channel connectivity health

omazy channel health [command] [flags]

Generate a deep-link channel handoff URL

omazy channel takeoff [command] [flags]
Flag Description
--conversation string Conversation ID
--to string Target channel slug

Chat sessions, messages, and conversation context

omazy chat [command] [flags]

Show agent participation rollup

omazy chat agents [command] [flags]

Archive a session

omazy chat archive [command] [flags]

Context window of messages around a target

omazy chat around [command] [flags]
Flag Description
--message string Target message ID

Read / patch conversation context (OCC)

omazy chat context [command] [flags]

Get current context (and OCC version)

omazy chat context get [command] [flags]

Patch context (uses If-Match unless –force)

omazy chat context patch [command] [flags]
Flag Description
--force Skip OCC and overwrite
--json string Context JSON object (default “{}”)

Show one session

omazy chat get [command] [flags]

List chat sessions

omazy chat list [command] [flags]
Flag Description
--cursor string Pagination cursor
--limit int Page size
--status string Filter by status

List messages

omazy chat messages [command] [flags]
Flag Description
--cursor string Pagination cursor
--limit int Page size

Create or resume a chat session

omazy chat new [command] [flags]
Flag Description
--app string App ID
--bot string Bot profile ID
--type string Session type

Pin a message

omazy chat pin [command] [flags]

List pinned messages

omazy chat pinned [command] [flags]

Send a message

omazy chat send [command] [flags]
Flag Description
--body string Message body
--content-type string Message content type
--reply-to string Parent message ID

Update session status

omazy chat status [command] [flags]

Unpin a message

omazy chat unpin [command] [flags]

Manage CLI configuration + profiles

omazy config [command] [flags]

Read a config value

omazy config get [command] [flags]

Show / switch profiles

omazy config profile [command] [flags]

Write a config value

omazy config set [command] [flags]

GDPR: erasure (Article 17) + export (Article 20)

omazy gdpr [command] [flags]

Erasure operations

omazy gdpr erase [command] [flags]

List erasure requests

omazy gdpr erase list [command] [flags]

Initiate an erasure request

omazy gdpr erase request [command] [flags]
Flag Description
--reason string Optional reason
--scope string Erasure scope: full|session|message (default “full”)
--target-id string Target session/message ID (when scope is not full)

Erase a single session

omazy gdpr erase session [command] [flags]

Show one erasure request

omazy gdpr erase status [command] [flags]

Export your data (streams JSON to stdout or –output-file)

omazy gdpr export [command] [flags]
Flag Description
--force Allow streaming to a TTY
--output-file string Write to file instead of stdout

Probe middleware health

omazy health [command] [flags]

Probe middleware detailed health (DB, Redis, etc.)

omazy health detailed [command] [flags]

Live conversations: claim, reply, transfer, resolve

omazy inbox [command] [flags]
Flag Description
-a, --app omazy config set app App handle (default: OMAZY_APP, or omazy config set app)
-w, --workspace omazy config set workspace Workspace handle (default: OMAZY_WORKSPACE, or omazy config set workspace)

Assign the conversation to yourself

omazy inbox claim [command] [flags]

List the resolution reasons configured for this app

omazy inbox dispositions [command] [flags]

Raise the conversation for supervisor attention

omazy inbox escalate [command] [flags]
Flag Description
--reason string Why it needs escalating

Mark yourself online (presence ages out without this)

omazy inbox heartbeat [command] [flags]

List conversations in the inbox

omazy inbox list [command] [flags]
Flag Description
--assignee string Filter by assigned operator id, or ‘me’
--limit int Maximum conversations to return
--status string Filter by status (open, pending, resolved, …)

Show a conversation transcript

omazy inbox messages [command] [flags]
Flag Description
--limit int Maximum messages to return

Show which operators are online

omazy inbox presence [command] [flags]

Send an operator reply into the conversation

omazy inbox reply [command] [flags]
Flag Description
-m, --message string Reply text
--saved-response string Send a saved response by key instead

Close the conversation with a disposition

omazy inbox resolve [command] [flags]
Flag Description
--disposition omazy inbox dispositions Resolution reason key (see omazy inbox dispositions)
--note string Closing note

Show one conversation with its operator metadata

omazy inbox show [command] [flags]

Hand the conversation to another operator

omazy inbox transfer [command] [flags]
Flag Description
--note string Handover note
--to string Target operator user id (required)

Show why the agent answered as it did (retrieval + tool calls)

omazy inbox why [command] [flags]

Browse the public MCP servers catalog

omazy mcp-server [command] [flags]

List public MCP servers

omazy mcp-server list [command] [flags]
Flag Description
--cursor string Pagination cursor
--limit int Page size

User notifications

omazy notification [command] [flags]

List notifications

omazy notification list [command] [flags]
Flag Description
--cursor string Pagination cursor
--limit int Page size
--unread-only Filter to unread

Mark one notification as read

omazy notification read [command] [flags]

Mark every notification as read

omazy notification read-all [command] [flags]

DevOps scripts wrapped over SSH

omazy ops [command] [flags]

Run Postgres + ClickHouse backup

omazy ops backup [command] [flags]

Open an SSH tunnel via the configured host

omazy ops connect [command] [flags]

Build, push, and restart on remote

omazy ops deploy [command] [flags]
Flag Description
--service string Single service to redeploy

Probe endpoints + DB/Redis on remote

omazy ops health-check [command] [flags]

Tail remote service logs

omazy ops logs [command] [flags]
Flag Description
--follow Follow
--service string Service name
--tail int Lines to tail

Database migrations

omazy ops migrate [command] [flags]
Flag Description
--yes Confirm destructive operation

Create a new migration file

omazy ops migrate create [command] [flags]
Flag Description
--name string Migration name

Roll back one migration (destructive: requires –yes)

omazy ops migrate down [command] [flags]

Apply pending migrations

omazy ops migrate up [command] [flags]

docker compose restart

omazy ops restart [command] [flags]
Flag Description
--service string Service name

Initial server provisioning (interactive)

omazy ops setup [command] [flags]

OU AI personal assistant

omazy ouchat [command] [flags]

Show the assistant’s aggregated context

omazy ouchat context [command] [flags]

Ask OU AI to plan a goal

omazy ouchat plan [command] [flags]
Flag Description
--goal string What you want to accomplish (required)

Open an OU AI session

omazy ouchat start [command] [flags]
Flag Description
--app-id string Bind the session to an app

Ask OU AI for next-step suggestions

omazy ouchat suggest [command] [flags]
Flag Description
-q, --query string Context for the suggestions

Realtime WebSocket fan-out

omazy realtime [command] [flags]

Subscribe to realtime events (line-delimited JSON to stdout)

omazy realtime connect [command] [flags]
Flag Description
--topic strings Topic filter (repeatable)
--watch Keep streaming until interrupted (default true)

Full-text search via OpenSearch

omazy search [command] [flags]

Search conversations

omazy search conversations [command] [flags]
Flag Description
--cursor string Pagination cursor
--limit int Page size

Search messages

omazy search messages [command] [flags]
Flag Description
--conversation string Limit to one conversation
--cursor string Pagination cursor
--limit int Page size

Autocomplete suggestions

omazy search typeahead [command] [flags]

Wraps middleware cmd/admin over SSH (promote/whoami)

omazy server-admin [command] [flags]

Promote a user (idempotent + audited)

omazy server-admin promote [command] [flags]
Flag Description
--dry-run Print the SSH command without executing
--email string User email
--role string Role (admin|support|analyst)

Read-only user lookup

omazy server-admin whoami [command] [flags]
Flag Description
--email string User email

MCP data-share grants

omazy share [command] [flags]

Audit log for your grants

omazy share audit [command] [flags]
Flag Description
--cursor string Pagination cursor
--limit int Page size

Mint a new data-share grant

omazy share create [command] [flags]
Flag Description
--expires string RFC 3339 expiry timestamp
--mcp-server string MCP server ID
--scopes strings Scopes (comma-separated)

Show one grant

omazy share get [command] [flags]

List your grants

omazy share list [command] [flags]
Flag Description
--status string Filter by status (active|revoked|expired)

Revoke a grant

omazy share revoke [command] [flags]

User self-service

omazy user [command] [flags]

About the current user

omazy user me [command] [flags]

Upload an avatar image

omazy user me avatar [command] [flags]

Read / write settings

omazy user me settings [command] [flags]

Show settings

omazy user me settings get [command] [flags]

Patch one setting

omazy user me settings set [command] [flags]

Show profile

omazy user me show [command] [flags]

Patch profile fields

omazy user me update [command] [flags]
Flag Description
--bio string Bio
--first-name string First name
--language string Language (BCP 47)
--last-name string Last name
--timezone string Timezone (IANA)

Live-chat widget: deployments, config, publish, metrics

omazy widget [command] [flags]
Flag Description
-a, --app omazy config set app App handle (default: OMAZY_APP, or omazy config set app)
-w, --workspace omazy config set workspace Workspace handle (default: OMAZY_WORKSPACE, or omazy config set workspace)

Widget appearance + behaviour config

omazy widget config [command] [flags]

Show the deployment’s feature toggles

omazy widget config features [command] [flags]

Print the widget’s config as JSON

omazy widget config get [command] [flags]

Replace the widget config from a JSON file or stdin

omazy widget config set [command] [flags]
Flag Description
-f, --file string JSON file to read (‘-’ for stdin) (default “-”)

Create a widget deployment

omazy widget create [command] [flags]
Flag Description
--name string Deployment name (required)

List domains the widget has been seen loading on

omazy widget domains [command] [flags]

Recent widget events

omazy widget events [command] [flags]
Flag Description
--limit int Maximum events to return

List the app’s widget deployments

omazy widget list [command] [flags]

Conversation and engagement counters

omazy widget metrics [command] [flags]
Flag Description
--since string RFC3339 start time

Promote the staged config to the live deployment

omazy widget publish [command] [flags]

Show a deployment with its current config

omazy widget show [command] [flags]

Print the HTML embed snippet for a widget

omazy widget snippet [command] [flags]

Check that the embed snippet is live on a page

omazy widget verify [command] [flags]
Flag Description
--url string Page URL to fetch and inspect (required)

Workspaces: membership, apps, and the active selection

omazy workspace [command] [flags]
Flag Description
-a, --app omazy config set app App handle (default: OMAZY_APP, or omazy config set app)
-w, --workspace omazy config set workspace Workspace handle (default: OMAZY_WORKSPACE, or omazy config set workspace)

Apps in the workspace

omazy workspace apps [command] [flags]

Create an app (and its agent) in the workspace

omazy workspace apps create [command] [flags]
Flag Description
--handle string URL handle (defaults to a slug of –name)
--name string Display name (required)

List apps

omazy workspace apps list [command] [flags]

Show the active app

omazy workspace apps show [command] [flags]

Show your resolved permissions in the workspace

omazy workspace capabilities [command] [flags]

Print the pinned workspace and app

omazy workspace current [command] [flags]

List the workspaces you belong to

omazy workspace list [command] [flags]

List workspace members

omazy workspace members [command] [flags]

Show the active workspace

omazy workspace show [command] [flags]

Pin the workspace future commands default to

omazy workspace use [command] [flags]
Flag Description
--app-handle string Also pin this app handle