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

Support FAQ

Quick answers for the most common setup, connectivity, and runtime issues in the Opta Local stack.

Need guided help?
For walkthrough-style onboarding, use Opta Learn. Opta Help is the technical reference surface.

Setup & Connectivity

Why does `opta chat` fail to connect?

Verify daemon health first, then LMX reachability. Typical checks are daemon on 127.0.0.1:9999 and LMX on your configured LAN host.

Do I install CLI, LMX, and Code separately?

Distribution is managed through Opta Init Manager. Treat Init as the canonical lifecycle entrypoint for local stack components.

Can I run everything on one machine?

Yes, but production setups typically keep LMX on a high-memory host and run CLI/Code from workstation clients.

Sessions & Models

Where are sessions managed?

Session orchestration is owned by the daemon. CLI and Code Desktop are clients of the same session/control plane.

Why is a model available in LMX but not in my client?

The client view depends on daemon and LMX sync. Re-check daemon model operations and LMX health/model list endpoints.

Security & Permissions

Are prompts and responses sent to cloud services?

Local inference flows remain local by default. Cloud providers are optional and only used when explicitly configured.

Why am I being asked to approve tool calls?

Tool permission prompts are enforced by daemon policy and guardrail mode. Review your current permission profile in CLI configuration.

Web Surfaces

What's the difference between Help and Learn?

Help is reference documentation. Learn is guide-driven onboarding and workflow training.

Where do I check current incidents and release state?

Use Opta Status at status.optalocal.com for live service and feature-state visibility.