Troubleshooting

"Salesforce CLI not detected" / commands fail with ENOENT

The app resolves sf (and claude, git, npm) through your login shell, so it finds them even when launched from Finder with a minimal PATH. If sf still isn't found, confirm sf --version works in a normal terminal and that sf is installed. Reopen Settings → Connection status to re-probe.

"Claude CLI not detected"

Install Claude Code, run claude once and sign in, then reopen Settings. The Claude Code CLI provider should show a green ✓ Detected with your version.

Browser org doesn't match my sf org

Connection Status compares the org open in the browser against your sf-authenticated orgs. A no-match means you're logged into that org in the browser but haven't authenticated the sf CLI to it — run sf org login web for that org. *Not on an org page yet* just means the browser is on a login screen.

SSO / IP restrictions / MFA at login

The embedded browser presents a real Chrome user-agent and rides a persistent session, so SSO (Okta/Entra/Ping), Login IP Ranges, MFA, and security keys all work like they do in Chrome. USB security keys and authenticator apps are supported; Touch ID passkeys aren't yet (a future update). If your org blocks embedded browsers specifically, log in once and the trusted-browser token persists.

The agent won't run

Confirm you're signed in with an approved Laki Bits account (the app gate), that a model provider is active in Settings, and that only one run is in flight at a time. The live trace shows a clear error if the model isn't reachable.