Troubleshooting (beta-era)
- · Capture exact OS build, OpenHuman version, and error strings before asking for community help.
- · Most empty briefing complaints are impatient auto-fetch—not model failure.
- · When scripts fail, paste the offending lines—not paraphrases.
Install & OS gates
- SmartScreen / Defender — verify download origin, file hash when published, and publisher metadata before clicking Run anyway.
- curl | bash / irm | iex — reread the script whenever upstream rebases; corporate proxies may MITM GitHub raw URLs.
- Architecture mismatch — README notes Linux x64; Apple Silicon users should confirm the packaged binary matches ARM64 builds.
Permissions loops
- On macOS, toggling Accessibility off mid-session breaks automation—fully quit the app before retesting toggles inside System Settings.
- Meeting audio features need camera/microphone; denial can be a silent failure—open System Settings → Privacy to confirm the toggle for OpenHuman.
Accounts & integrations
- Infinite OAuth — clear cookies for the connector domain, re-login to the desktop shell, revoke stale tokens vendor-side.
- Missing context — wait twenty minutes after linking Gmail Slack etc., per integrations doc.
Still stuck?
Discord and GitHub issues linked from the repository are the fastest feedback loops. Include logs the template requests—beta teams cannot debug vibes.