Platform View

Documentation is adapted for macOS.

Shell commands, launchd paths, and Apple runtime guidance

CLI Version Context

Installed CLI: 1.1.0 (latest compatibility profile)

Support Bundle

Capture a complete diagnostics artifact for support triage.

macos
OUT=~/Desktop/opta-support-$(date +%Y%m%d-%H%M%S).txt; { echo "# Opta Support Bundle"; echo "# Generated: $(date -u +%Y-%m-%dT%H:%M:%SZ)"; echo; opta doctor; echo; opta daemon status; echo; opta daemon logs --lines 200; echo; opta config list; } > "$OUT" && echo "Saved $OUT"
Support FAQ

Learn About

Deep workflow guides aligned to this documentation section.

Browse all Opta Learn guides

Status Overview

The Status section explains how to interpret operational health, release progress, and feature readiness. Use these pages to decide whether to keep moving, mitigate risk, or escalate.

Status Views

Status is split into four views so you can isolate the kind of decision you need to make:

  • Overview -- how the full status system works and when to use each view.
  • Service Cards -- runtime health and reliability signals for live services.
  • Releases -- rollout state, blockers, and post-release confidence.
  • Feature Registry -- feature maturity, availability, and actionability.

Reading Signals

Every status view should be read in this order:

  1. State -- the current explicit status (healthy, degraded, blocked, beta, and so on).
  2. Freshness -- when that status was last updated.
  3. Impact -- which users, teams, or workflows are affected.
  4. Owner and next action -- who owns the item and what should happen next.
Stale status is a risk
Treat old status data as unknown state. If freshness is outside your expected update window, verify directly before making release or incident decisions.

Action Workflow

Once you identify a concerning signal, use a simple response loop:

  1. Confirm whether the signal is current and reproducible.
  2. Classify impact as local, team-wide, or user-facing.
  3. Apply the relevant playbook for service, release, or feature status.
  4. Document the update so the next reader has a clear current state.

Common Playbooks

SignalImmediate ActionNext Action
Service health downgradedFreeze risky changes and verify telemetryOpen incident thread and assign owner
Release blockedPause rollout expansionTrack blocker to resolution or rollback
Feature marked experimentalLimit usage to approved cohortCollect validation data before promotion
Status update is staleRe-check source systemsRefresh status with timestamp and owner

When to Escalate

Escalate immediately when you see user-facing impact, conflicting status signals, repeated regression after rollback, or unknown ownership for a critical item.

Status Escalation Template
State: degraded
Scope: user-facing API latency spike
Observed At: 2026-03-04T11:42:00+11:00
Owner: unassigned
Immediate Action: paused rollout, started incident response
Requested Support: release owner + service owner