Troubleshooting

A provider shows "not installed" but the CLI works in my terminal

Apps launched from the Dock don't inherit your shell's PATH. Synergoi captures a login environment on launch; see what it found under Settings › Advanced › Login environment. If the CLI was installed after the app started, press Rescan on the Providers pane or relaunch the app.

Codex says connected, but turns fail with an auth error

Some Codex releases report a login even when their auth file is empty. Synergoi checks the file and shows the card as disconnected; press Connect and sign in again.

Claude can't find its login

Claude Code stores its credentials in the macOS Keychain under your user. Make sure you ran claude auth login as the same user that runs Synergoi, then Rescan.

Meters look stale or say "estimated"

A meter is only as fresh as the vendor's last report. Hover the meter for its source and age; press the refresh control to probe without spending a turn where the provider supports it. "Estimated" means the last probe failed and the figure was carried forward — the badge is honest, not broken.

A "worker quit … HTTP 405" line in the Grok log

Grok's own MCP client failed to initialize an HTTP MCP server it loaded from another tool's config. Run grok mcp doctor to see which; it is unrelated to Synergoi's hub.

The app won't open

The build is signed and notarized, so Gatekeeper should not object. If macOS says the app is damaged, the download was incomplete — download the DMG again. If the window opens on "Starting the engine" and stays there, quit, then check the engine log (below) for the reason.

Getting logs to us

Settings › Advanced › Engine logs opens the log folder. Turn on Include logs in diagnostics, reproduce the problem, and attach the newest file to an email to [email protected]. Logs contain paths and command lines but never tokens — they are scrubbed before they are written.

Starting fresh

Quit the app, deactivate the machine first if you want the license slot back, then delete the data folder: