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

On a Mac, Claude Code stores its credentials in the Keychain under your user; on Windows it uses your own profile. Either way, 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

On a Mac 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.

On Windows the installer is not code-signed yet, so SmartScreen blocks it the first time with "Windows protected your PC": choose More info, then Run anyway. It installs per-user and asks for no administrator rights, so a policy that blocks machine-wide installers is not what is stopping you.

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: