CLI Command Reference

omni auth login

Saves an API key into ~/.omni/config.json after verifying it against https://edge.omnistatic.com/v1/me.

omni auth login --key omni_sk_live_...

omni auth whoami

Prints the current authenticated user ID, key prefix, granted scopes, and deprecation status.

omni auth whoami

Add --json for machine-readable output:

omni auth whoami --json

omni health

Measures round-trip latency to the edge proxy and displays system health.

omni health

Output:

[OK] edge.omnistatic.com (Latency: 42ms)

omni chat "<message>"

Runs a streaming agent session in the terminal, rendering the real-time event pipeline with distinct formatting tags ([thought], [tool_call], [tool_result], [message], [done]).

omni chat "What are the latest launch dates in my notes?"

Optional Flags:

• --workspace <id>: Attach a specific workspace context.
• --model <name>: Override model (default: gpt-4o-mini).
• --json: Output raw JSON SSE stream.

omni usage

Fetches monthly token consumption, remaining guardrail credits, and quota limit.

omni usage

Output:

Billing Cycle:   2026-08
Total Tokens:    142,500 / 1,000,000
Remaining:       857,500 tokens (85.7% available)
Request Count:   58 requests